Errores de autenticacion y autorizacion
401 Unauthorized: la clave API no es valida o ha sido revocada. Verifique que la clave API en su entorno es correcta y no ha caducado.
403 Forbidden: tiene una clave API valida pero no tiene permiso para la operacion solicitada.
Errores de envio de mensajes
400 con 'recipient not on WhatsApp': el numero de telefono del destinatario no tiene WhatsApp activo.
400 con 'template not found': el nombre de la plantilla en el payload no coincide con ninguna plantilla aprobada. Los nombres de plantilla distinguen mayusculas de minusculas.
429 Too Many Requests: ha superado el rate limit de la API. Implemente backoff exponencial.
Errores de webhook
Webhook no recibido: verifique que su endpoint es accesible publicamente (no localhost), responde con 200 OK en menos de 20 segundos, y que la firma de la cabecera se verifica correctamente.
Herramientas de debug
Use el panel de Chat API para monitorizar los mensajes enviados y sus estados.
Para pruebas locales, use ngrok para exponer su endpoint de webhook local.
