Conectar o número oficial (ativar a conexão)

POST

/api/v3/settings/channels-gateway/whatsapp/official/connect

Dispara a conexão do número oficial na Pontal Tech. É o passo seguinte ao
POST /whatsapp/official — depois dele o status da configuração passa de
disconnected para active.

Use pra:

Ativar uma conexão recém-cadastrada

Reconectar um número que caiu para disconnected

Diferente do WhatsApp não-oficial, aqui não há QR Code — a conexão é feita
direto pelos ids da Meta.

Requisição

Parâmetros Header

Parâmetros Bodyapplication/jsonObrigatório

Examples

Respostas

🟢201Criado

application/json

Conexão iniciada com sucesso.

Bodyapplication/json

🟠400Pedido Inválido

🟠401Não Autorizado

🟠403Proibido

🔴500Erro Interno

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v3/settings/channels-gateway/whatsapp/official/connect' \
--header 'api-key: {{api-key}}' \
--header 'Content-Type: application/json' \
--data '{
    "channel_config_id": "3f2a91c4-7b60-4d15-9a2e-1c8d5e0b7411",
    "phoneNumberId": "700000000000001"
}'

Response Example

201 - Conectado

{
    "channelConfigId": "3f2a91c4-7b60-4d15-9a2e-1c8d5e0b7411",
    "status": "active"
}

Modificado em 2026-11-04 02:31:07

Página anterior

Criar conexão de WhatsApp oficial

Próxima página

Anexar gravação de ligação (telefonia de terceiros)