¿Cómo funciona el WhatsApp de Monely en la API oficial?

En resumen: con ZapClaw. Desde julio de 2026, los números de WhatsApp de Monely funcionan en la API oficial de WhatsApp: los mensajes llegan al webhook de Monely y las respuestas salen por la API REST con una clave de idempotencia, el encabezado que evita que un reintento se convierta en un segundo mensaje. La empresa detrás de Monely también opera ZapClaw, así que este es nuestro propio producto en nuestro propio gateway.

En qué no puede fallar un asistente de WhatsApp

Monely es una app de finanzas personales. Las personas registran sus gastos enviándole un texto, un audio o la foto del comprobante por WhatsApp, y le piden saldos y resúmenes en el mismo chat. Eso solo funciona si cada mensaje llega a Monely, cada respuesta sale una sola vez y cada foto y cada audio se pueden descargar.

Lo que Monely construyó sobre ZapClaw

• Una clave de idempotencia en cada respuesta. Monely envía cada respuesta por la API REST con su propio Idempotency-Key. Cuando un envío ya tiene resultado, repetirlo con la misma clave dentro de 10 minutos devuelve ese resultado y no envía nada.
• Códigos de entrega que sabe tratar. DELIVERY_INDETERMINATE significa que Meta respondió con un error que no descarta la entrega; IDEMPOTENCY_IN_PROGRESS, que la primera llamada con esa clave sigue en curso. En los dos casos, Monely espera en lugar de reenviar de inmediato.
• Cada mensaje en su webhook. Cada uno llega como un POST firmado, con hasta 3 intentos de entrega. Cuando Meta oculta el número de quien escribe, el evento trae data.from_user_id de todos modos y Monely responde a ese id.
• Fotos de comprobantes y audios. Cada mensaje multimedia llega con un media_url listo, y la descarga responde con un estado que dice qué hacer: reintentar ante un 404, esperar el Retry-After de un 429 o de un 503, detenerse ante un 410.

Qué significa para tu integración

• La API oficial. Cada mensaje pasa por la API oficial de WhatsApp, la Cloud API de Meta, sin ninguna librería no oficial en el camino.
• Un webhook de entrada, una llamada REST de salida. Llevar un bot existente a ZapClaw es cambiar el endpoint y el encabezado de autenticación, no reescribirlo.
• Envíos que puedes repetir. La clave de idempotencia, los códigos de entrega y los estados de descarga están en la documentación pública de la API (en inglés).

Más información

• Repetir un envío sin enviarlo dos veces (en inglés)
• Eventos del webhook y verificación de la firma (en inglés)
• Precios: números ilimitados en el plan Negócio, R$ 99 al mes