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

POST

{{baseURL}}/api/v3/settings/channels-gateway/whatsapp/official/connect

Última modificação:2026-08-14 20:09:25

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

Exemplo

{
    "channel_config_id": "3f2a91c4-7b60-4d15-9a2e-1c8d5e0b7411",
    "phoneNumberId": "700000000000001"
}

Códigos de solicitação

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --globoff 'https://api-{tenant}.digitalk.com.br/api/v3/settings/channels-gateway/whatsapp/official/connect' \
--header 'api-key: API_TOKEN (disponível no database da plataforma)' \
--header 'Content-Type: application/json' \
--data '{
    "channel_config_id": "3f2a91c4-7b60-4d15-9a2e-1c8d5e0b7411",
    "phoneNumberId": "700000000000001"
}'

Respostas

🟢201Criado

application/json

Conexão iniciada com sucesso.

Bodyapplication/json

Exemplo

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

🟠400Pedido Inválido

🟠401Não Autorizado

🟠403Proibido

🔴500Erro Interno

Modificado em 2026-08-14 20:09:25

Página anterior

Criar conexão de WhatsApp oficial

Próxima página

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