Documentação do KiraGo

Quando um evento ocorre, o KiraGo envia uma requisição POST para o webhook configurado com os dados do evento. Abaixo estão os formatos dos principais tipos de evento:

Mensagem recebida

{
  "event": "Message",
  "instance": "5491155553934.0:53@s.whatsapp.net",
  "data": {
    "id": "3EB0ABCD123456789",
    "pushName": "Nome do Contato",
    "fromMe": false,
    "timestamp": 1647878528,
    "chat": "5491199999999@s.whatsapp.net",
    "sender": "5491199999999@s.whatsapp.net",
    "message": {
      "conversation": "Olá, como vai?"
    }
  }
}

Confirmação de leitura

{
  "event": "ReadReceipt",
  "instance": "5491155553934.0:53@s.whatsapp.net",
  "data": {
    "sender": "5491199999999@s.whatsapp.net",
    "chat": "5491199999999@s.whatsapp.net",
    "ids": ["3EB0ABCD123456789"],
    "timestamp": 1647878650
  }
}

Presence

{
  "event": "Presence",
  "instance": "5491155553934.0:53@s.whatsapp.net",
  "data": {
    "sender": "5491199999999@s.whatsapp.net",
    "status": "available",
    "timestamp": 1647878750
  }
}

Para usar a API do KiraGo com eficiência e evitar problemas, considere estas melhores práticas:

Segurança

• Mantenha seus tokens de autenticação em segurança e não os exponha publicamente.
• Use HTTPS em toda comunicação com a API e com seus webhooks.
• Implemente validação adequada dos webhooks recebidos para evitar processar dados maliciosos.

Limites de uso

• Evite enviar muitas mensagens em pouco tempo para reduzir risco de bloqueio pelo WhatsApp.
• Implemente tentativas (retry) com backoff exponencial para lidar com falhas temporárias.
• Monitore o status da conexão e reconecte quando necessário.

Webhooks

• Garanta que seu endpoint de webhook processe requisições rapidamente (menos de 5 segundos).
• Se o processamento for demorado, use uma fila para processar eventos de forma assíncrona.
• Prepare seu servidor para picos de tráfego, especialmente se você gerenciar vários números.