Como o Monely roda o WhatsApp na API oficial?

Em resumo: pelo ZapClaw. Desde julho de 2026, os números de WhatsApp do Monely rodam na API oficial do WhatsApp: as mensagens chegam no webhook do Monely, e as respostas saem pela API REST com uma chave de idempotência, o header que impede uma nova tentativa de virar uma segunda mensagem. A empresa do Monely também mantém o ZapClaw, então este é o nosso próprio produto no nosso próprio gateway.

O que um assistente no WhatsApp não pode errar

O Monely é um aplicativo de finanças pessoais. As pessoas registram gastos mandando um texto, um áudio ou a foto do comprovante pelo WhatsApp, e pedem saldos e resumos na mesma conversa. Isso só funciona se toda mensagem chegar ao Monely, se cada resposta sair uma vez só e se toda foto e todo áudio puderem ser baixados.

O que o Monely construiu no ZapClaw

• Uma chave de idempotência em cada resposta. O Monely manda cada resposta pela API REST com um Idempotency-Key próprio. Quando um envio já tem resultado, repeti-lo com a mesma chave em até 10 minutos devolve esse resultado e não envia nada.
• Códigos de entrega que ele trata. DELIVERY_INDETERMINATE quer dizer que a Meta respondeu com um erro que não descarta a entrega; IDEMPOTENCY_IN_PROGRESS, que a primeira chamada com aquela chave ainda está em andamento. Nos dois casos, o Monely espera em vez de reenviar na hora.
• Toda mensagem no webhook. Cada uma chega como um POST assinado, com até 3 tentativas de entrega. Quando a Meta esconde o número de quem escreveu, o evento traz data.from_user_id mesmo assim, e o Monely responde para esse id.
• Fotos de comprovante e áudios. Cada mensagem de mídia chega com um media_url pronto, e o download responde com um status que diz o que fazer: tentar de novo num 404, esperar o Retry-After de um 429 ou de um 503, parar num 410.

O que isso quer dizer para a sua integração

• A API oficial. Toda mensagem passa pela API oficial do WhatsApp, a Cloud API da Meta, sem biblioteca não oficial no caminho.
• Webhook na entrada, chamada REST na saída. Trazer um bot que já existe para o ZapClaw é trocar o endpoint e o header de autenticação, não reescrever o bot.
• Envios que dá para repetir. A chave de idempotência, os códigos de entrega e os status de mídia estão na documentação pública da API (em inglês).

Saiba mais

• Repetir um envio sem mandar duas vezes (em inglês)
• Eventos do webhook e verificação da assinatura (em inglês)
• Preços: números ilimitados no plano Negócio, R$ 99 por mês