> ## Documentation Index
> Fetch the complete documentation index at: https://developer.z-api.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectar com telefone

> Conecta à instância usando número de telefone ao invés do QRCode

## Conceituação

Permite a conexão sem a necessidade de escanear o QRCode, utilizando o recurso "Conectar com número de telefone".

***

## Atributos

### Header

<ParamField path="instanceId" type="string" required>
  ID da sua instância. Disponível no painel Z-API em **Instâncias**.
</ParamField>

<ParamField path="token" type="string" required>
  Token da sua instância Z-API.
</ParamField>

### Path

<ParamField path="phone" type="string" required>
  Número de telefone com DDI (ex: 5511999999999)
</ParamField>

***

## Response

### 200

<Warning>
  O endpoint pode retornar o código de conexão padrão ou, em dispositivos que exigem a **[Chave de Acesso](/tips/extension-guide)**, retornar o objeto Challenge para dar continuidade ao processo de autenticação.
</Warning>

**Exemplo de retorno do código de conexão**

```json theme={"theme":{"light":"github-light","dark":"poimandres"}}
{
  "value": "A1B2C3D4E5"
}
```

**Exemplo de retorno para dispositivos que precisam da [Chave de Acesso](/tips/extension-guide)**

```json theme={"theme":{"light":"github-light","dark":"poimandres"}}
{
  "challenge": {
    "allowCredentials": [],
    "challenge": "V275tRcRUu2XjHiF9a6GTKFaZj8G4W_EEuRwdW5zCAM",
    "extensions": {
      "uvm": true
    },
    "rpId": "whatsapp.com",
    "timeout": 600000,
    "userVerification": "required"
  }
}
```

Em casos desse retorno, é necessário concluir a autenticação que foi solicitada por meio do Challenge, para isso temos o endpoint para **[Concluir o Challenge](/instance/passkey-prologue)**

### 405

Neste caso certifique que esteja enviando corretamente a especificação do método, ou seja verifique se você enviou o POST ou GET conforme especificado no início deste tópico.