Limites de velocidad y gestion del ritmo de envio
La API de WhatsApp Business impone por defecto un limite de 80 mensajes por segundo por numero de telefono. Superar el limite genera errores 429 que tu sistema debe manejar con retroceso exponencial.
Para sistemas que necesitan enviar miles de mensajes en poco tiempo, la arquitectura correcta implica una cola de mensajes (RabbitMQ, Redis Queue, AWS SQS) que regula el flujo hacia la API.
Manejo de errores y logica de reintento
Los errores de envio se dividen en dos categorias: transitorios (red, tiempo de espera, limite de velocidad) y permanentes (numero no registrado en WhatsApp, mensaje rechazado por politica). Solo los primeros deben reintentarse.
Implementa logica de reintento con retroceso exponencial: primer reintento tras 1 segundo, segundo tras 2 segundos, tercero tras 4 segundos.
Idempotencia de mensajes
Asocia un ID unico a cada mensaje antes de enviarlo. Si un reintento envia el mismo mensaje dos veces, el ID unico te permite detectar el duplicado e ignorarlo.
Monitorizacion y observabilidad
Un sistema de produccion en WhatsApp requiere metricas operativas en tiempo real: mensajes enviados por minuto, tasa de entrega, tasa de error por tipo, latencia media desde el envio hasta el evento 'entregado'.
Configura alertas automaticas en umbrales criticos: tasa de error superior al 2%, latencia media superior a 5 segundos, cola de mensajes creciente que no se vacia.
Chat API expone eventos de estado mediante webhook para cada mensaje enviado (enviado, entregado, leido, fallido). Consumir estos eventos en una base de datos permite calcular metricas de calidad del servicio en tiempo real.