Testar a credencial de um canal
Testa a credencial gravada contra o provedor, sem gravar nada: no Chatwoot, a conta que o token alcança; no WhatsApp oficial, o número que o phone_number_id resolve e a leitura dos templates. Uma recusa do provedor é a resposta do teste (ok = false, com o motivo). A conexão não oficial não tem credencial a testar (422): o estado dela está na sessão.
Autorização
bearer channels:executeCredencial da v3: o JWT da sessão (o mesmo da v2) ou um token pessoal dom_pat_…. A lista de escopos de cada operação diz o que ela exige: uma capacidade (agents:read), authenticated ou session-only. Segredo de máquina (X-Agent-Secret, X-API-Token, sdk_…) não é aceito.
Em: header
Escopo: channels:execute
Parâmetros de caminho
Id do canal
Parâmetros de cabeçalho
Chave opcional de 1 a 255 caracteres ASCII visíveis; quando enviada, vale o mesmo contrato da §8.
Corpo da resposta
application/json
application/json
curl -X POST "https://example.com/channels/string/connection-tests" \ -H "Idempotency-Key: b3f0c1e2-4a5b-4c6d-8e9f-0a1b2c3d4e5f"{ "account_id": 0, "account_name": "string", "display_phone_number": "string", "message": "string", "ok": true, "reason": null, "template_count": 0, "verified_name": "string"}