Novidades

Mudanças que quebram compatibilidade são anunciadas com antecedência e ganham uma nova versão de rota (/v2). Campos novos em respostas e novos tipos de evento podem chegar a qualquer momento: ignore o que você não conhece.

Outubro de 2026

• Nova documentação da API em docs.zynzap.com.br, com especificação OpenAPI 3.1 gerada do código, playground, coleção Postman e exemplos em 8 linguagens.
• Endereço público da API: https://api.zynzap.com.br/v1 (equivale ao antigo /api/v1 do painel, que continua funcionando).
• Webhooks por chave de API: até 5 endereços por chave, assinatura HMAC (X-Zynzap-Signature: v1=...), novas tentativas por cerca de 8 horas, desativação após 15 falhas seguidas e evento de teste webhook.ping.
• Chaves de API: novos prefixos zz_live_/zz_test_ (os antigos wl_live_/wl_test_ continuam válidos), IPs permitidos, limite por minuto da chave, rotação com carência e estatísticas de uso.
• Janela grátis de 24 horas: respostas pelo atendimento (SendConversationMessage) a quem escreveu nas últimas 24 horas saem com coverage: "inbox_window" e custo zero.
• Paginação por cursor (cursor + limit → next_cursor) nas listas grandes.
• Atendimento, CRM, público, fluxos, chamadas e indicadores disponíveis na API, com as mesmas permissões do painel.

Antes

• API RPC sobre HTTP (POST /api/v1/rpc/{método}), cotação obrigatória para operações pagas, stream de eventos SSE com retomada por cursor e pareamento de números por SSE.