ReferenceCanais
Criar canal
Cria um novo canal de WhatsApp. O id_channel retornado é o token usado nos demais endpoints.
x-api-key<token>
Chave de API no formato sk_live_..., no header x-api-key.
In: header
Header Parameters
Idempotency-Key?string
Chave de idempotência (opcional). Reenviar o MESMO POST com a mesma chave devolve a resposta original em vez de re-executar — evita disparo duplicado de campanha quando o cliente re-tenta um POST que deu timeout.
Length
length <= 255Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/api/external/create-channel" \ -H "Content-Type: application/json" \ -d '{ "name": "Vendas" }'{ "success": true, "name": "string", "id_channel": "channel_550e8400-e29b-41d4-a716-446655440000", "channel_ref": "string", "timestamp": "2019-08-24T14:15:22Z"}{ "success": false, "error": "Bad Request", "message": "O campo \"name\" é obrigatório no body da requisição."}{ "success": false, "error": "Unauthorized", "message": "Chave de API inválida ou ausente."}{ "success": false, "error": "Forbidden", "message": "Limite de canais atingido.", "current": 5, "max": 5}{ "success": false, "error": "Too Many Requests", "code": "rate_limited", "message": "Muitas requisições. Tente novamente em instantes."}{ "success": false, "error": "Internal Server Error", "message": "Erro interno ao processar a requisição."}