Skip to main content
POST
/
calls
/
connect
Iniciar Chamada
curl --request POST \
  --url https://apis.vectalk.com.br/api/calls/connect \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "to": "<string>",
  "session": {
    "session.sdp_type": "<string>",
    "session.sdp": "<string>"
  },
  "biz_opaque_callback_data": "<string>"
}
'

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.

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.

​
Parâmetros

​
Body

​
to
string
required
Número de telefone do destinatário no formato wa_id (código do país + número, sem +). Exemplo: "5511999999999".
​
session
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.
​
biz_opaque_callback_data
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.

​
Exemplo de Requisição

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

{
  "messaging_product": "whatsapp",
  "calls": [
    {
      "id": "wacid.ABGGFjFVU2AfAgo6V"
    }
  ]
}
Os campos messaging_product: "whatsapp" e action: "connect" são adicionados automaticamente pelo proxy — não é necessário enviá-los.