> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vectalk.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Iniciar Chamada

> Inicia uma chamada de voz pelo WhatsApp Business para um número de destino.

<Note>
  Requer token de instância associado ao número de telefone. O número é resolvido automaticamente pelo token — não é necessário informar o `phone-number-id`.
</Note>

## Parâmetros

### Body

<ParamField body="to" type="string" required>
  Número de telefone do destinatário no formato `wa_id` (código do país + número, sem `+`). Exemplo: `"5511999999999"`.
</ParamField>

<ParamField body="session" type="object" required>
  Objeto de sessão contendo os parâmetros SDP (Session Description Protocol) da chamada. O SDP deve ser compatível com a RFC 8866.

  <Expandable title="Campos do session">
    <ParamField body="session.sdp_type" type="string" required>
      Tipo do SDP. Deve ser `"offer"` para iniciar uma chamada.
    </ParamField>

    <ParamField body="session.sdp" type="string" required>
      Descrição SDP do dispositivo. Deve ser compatível com a RFC 8866.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="biz_opaque_callback_data" type="string">
  String arbitrária de até 512 caracteres para rastreamento. Será incluída no webhook de `Call Terminate` para apps inscritos no campo de webhook `calls`. A Cloud API não processa este campo.
</ParamField>

## Exemplo de Requisição

```bash theme={null}
curl --request POST \
  --url https://apis.vectalk.com.br/api/calls/connect \
  --header 'Authorization: Bearer {seu_token}' \
  --header 'Content-Type: application/json' \
  --data '{
    "to": "5511999999999",
    "session": {
      "sdp_type": "offer",
      "sdp": "v=0\r\no=- 3626166318745852955 2 IN IP4 127.0.0.1\r\ns=-\r\nt=0 0\r\na=group:BUNDLE 0\r\nm=audio 9 UDP/TLS/RTP/SAVPF 111\r\nc=IN IP4 0.0.0.0\r\na=rtpmap:111 opus/48000/2\r\na=sendrecv\r\n"
    },
    "biz_opaque_callback_data": "tracking_id_123"
  }'
```

## Resposta

```json theme={null}
{
  "messaging_product": "whatsapp",
  "calls": [
    {
      "id": "wacid.ABGGFjFVU2AfAgo6V"
    }
  ]
}
```

<Note>
  Os campos `messaging_product: "whatsapp"` e `action: "connect"` são adicionados automaticamente pelo proxy — não é necessário enviá-los.
</Note>