Para quem constrói
REST, JSON e um evento para cada coisa que acontece.
Texto, imagem, vídeo, áudio de voz, documento, localização, contato, reação, edição e exclusão seguem o mesmo padrão de envio. São mais de 100 tipos de evento, no formato tipo.ação: text.sent, image.read, connection.update.
Os eventos chegam por webhook, SSE ou WebSocket. O SSE retoma do último cursor quando a conexão volta.
Ver documentação
terminal
curl -X POST https://api.catcher.one/v1/instances/$INSTANCIA/messages/text \
-H "X-API-Key: $CATCHER_API_KEY" \
-H "Idempotency-Key: pedido-4821" \
-d '{"to":"5541999990000","text":"Seu pedido saiu para entrega"}'
# 202 Accepted
{ "status": "queued",
"message_id": "550e8400-e29b-41d4-a716-446655440000" }
# depois, no seu webhook
{ "type": "text.read",
"data": { "message_ids": ["550e8400-…"] } }