¿Qué es?
Es el conjunto de protecciones que hace que cada envío sea único, rastreable y seguro. Se integra una vez; la plataforma maneja lo que sucede después de que la API acepta la solicitud. Piense en un edificio con recepción: su código entrega el paquete en la recepción; Notifique gestiona la cola, evita entregar dos veces y registra lo sucedido.¿Contra qué protege Notifique?
Evite envíos duplicados
¿Hubo error de conexión, timeout y su sistema reintentó? En integraciones ingenuas, al cliente se le cobra dos veces. En Notifique, envíe un identificador único en el encabezadoIdempotency-Key (también aceptamos X-Idempotency-Key):
- Genere una clave por operación (por ejemplo, ID de pedido, hash de carga útil)
- Envíela en el encabezado de cada POST crítico
- Si repite la misma clave dentro de 24 h, la API no crea otro mensaje
- La respuesta devuelta proviene de la primera solicitud aceptada
Reintente cuantas veces necesite. El destinatario recibe una vez.
Nada se pierde en tránsito
El servidor se reinicia, WhatsApp se tambalea y la cola no está disponible un momento. En sistemas frágiles, el mensaje desaparece. Aquí, cada paso tiene red de seguridad:
Como la línea de correos: un paquete a la vez, en orden, con registro si algo sale mal.
Para resultados finales, combine webhooks (estado de entrega) con logs de API (si se aceptó la solicitud HTTP).
Sus datos y los de sus clientes
Informes de destinatarios (Ley brasileña 14.230/2021): API de denuncias (FELCA).
Qué hacer de su lado
- Nunca confirme claves API. Utilice
.envo una bóveda de secretos - Utilice
Idempotency-Keyen envíos críticos (facturación, OTP, confirmación) - Responda 2xx rápidamente en webhooks y procese en segundo plano
- Valide la firma HMAC en cada webhook. Consulte Webhooks
- Observe 402 y 403. A menudo hay límites o ámbitos, no errores de código
- Pruebe en Sandbox antes de pasar a producción
Próximos pasos
- Claves API: ámbitos, rotación y límites por clave
- Webhooks: configurar URL y validar firma
- Respuestas de error: códigos HTTP y
code - Trust Factor: reputación y límites de envío
- Sandbox: integrar sin riesgo de producción

