CZapyChat
POST/public/messages

Enviar mensagem para um telefone

Envia uma mensagem de texto para um número de telefone, por um canal de WhatsApp. O contato e a conversa são criados se ainda não existirem.

Chave com permissão de escrita (write)

Cabeçalhos

NomeTipoDescrição
AuthorizationobrigatóriostringBearer pk_sua_chave — a chave de API criada em Configurações › API Keys.
Content-Typeobrigatóriostringapplication/json

Corpo da requisição (JSON)

NomeTipoDescrição
channelIdobrigatóriostringCanal de WhatsApp (veja GET /public/channels).
phoneobrigatóriostringTelefone com DDD. Aceita com ou sem +55 e símbolos.
textobrigatóriostringTexto da mensagem (até 4096 caracteres).
namestringNome do contato, usado se ele ainda não existir.

Observações

  • Limite de 60 mensagens por minuto por chave.
  • Contato que pediu para não receber mensagens: erro 409. Fora da janela de 24 h do WhatsApp oficial: erro 409.
curl -X POST "https://api.zapychat.com.br/api/v1/public/messages" \
  -H "Authorization: Bearer pk_sua_chave" \
  -H "Content-Type: application/json" \
  -d '{ "channelId": "cmf0abc123", "phone": "(71) 99999-0000", "text": "Olá! Seu pedido saiu para entrega.", "name": "Maria Souza" }'
Resposta · 200
{
  "data": {
    "status": "queued",
    "conversationId": "cmf3k9x1a0001"
  },
  "meta": {
    "timestamp": "2026-10-05T14:32:10.000Z"
  }
}