Configurar el webhook de WhatsApp: errores comunes
Configurar el webhook de WhatsApp es el paso donde más se traban los equipos técnicos: token de verificación mal copiado, certificado SSL inválido o el campo 'messages' sin suscribir. Repasamos los errores más comunes y cómo detectarlos rápido.
Qué hace el webhook y por qué falla tanto
El webhook es la URL propia a la que Meta le manda cada evento -mensajes entrantes, cambios de estado, notificaciones- de tu número de WhatsApp. Para activarlo, Meta primero hace una verificación (un request GET con un 'challenge') y después empieza a mandar eventos por POST. Si cualquiera de esos dos pasos falla, el agente simplemente no recibe mensajes, aunque todo lo demás esté bien configurado.
Errores más comunes
| Error | Síntoma | Causa típica |
|---|---|---|
| Token de verificación no coincide | La verificación falla al guardar el webhook | El string configurado en Meta no es idéntico al que espera el servidor |
| Certificado SSL inválido | Meta no puede verificar ni entregar eventos | Certificado autofirmado o vencido; se necesita HTTPS válido |
| No responde el 'challenge' | El webhook no queda verificado | El servidor no devuelve exactamente el valor de hub.challenge |
| Campo 'messages' no suscripto | El webhook está verificado pero no llegan mensajes | Falta marcar ese campo específico en la suscripción de la app |
| Servidor no devuelve 200 | Meta reintenta y eventualmente reduce reintentos | Error interno del servidor no manejado |
El error más frustrante: el webhook queda 'verificado' en el panel de Meta -o sea, pasó la prueba inicial- pero nunca llega un mensaje real. Casi siempre es porque no se suscribió específicamente el campo 'messages' dentro de los webhook fields de la app, algo que es un paso aparte de la verificación inicial.
Cómo depurarlo rápido
Cuando el webhook no funciona, conviene revisar en este orden: primero, que la URL responda públicamente por HTTPS con un certificado válido (probarla desde afuera de la red interna); segundo, que el token de verificación en el código sea exactamente igual, carácter por carácter, al configurado en el panel de Meta; tercero, que el campo 'messages' esté efectivamente suscripto en la configuración de webhooks de la app; y cuarto, revisar los logs del servidor para confirmar que efectivamente está devolviendo un 200 ante cada POST entrante.
Un error más: confundir entornos
Otro error frecuente es mezclar el número de prueba (sandbox) con el número de producción: cada uno tiene su propio phone_number_id y su propia configuración de webhook, y probar en uno mientras se revisa el otro genera confusión sobre por qué 'no llega nada' cuando en realidad el mensaje sí llegó, pero al entorno equivocado. Mantener bien identificado cuál número está conectado a cuál webhook evita horas de depuración innecesaria.
Cómo lo hace agenteala
Todo esto —la parte técnica de WhatsApp— lo resuelve agenteala por vos. Es un servicio gestionado: el equipo se encarga de la API, la configuración, las integraciones, las plantillas y el entrenamiento del agente, y lo mantiene funcionando con soporte continuo. Vos no tocás paneles de Meta ni código; tenés el agente andando, conectado a tus sistemas si hace falta, y con alguien del otro lado si algo falla. Lo probás en vivo antes de decidir, sin tarjeta.
Preguntas frecuentes
¿Por qué mi webhook está 'verificado' pero no recibo mensajes?
Casi siempre porque falta suscribir el campo 'messages' específicamente en la configuración de webhooks de la app, un paso separado de la verificación inicial.
¿Puedo usar un certificado SSL autofirmado?
No. Meta requiere HTTPS con un certificado válido reconocido; uno autofirmado hace fallar la conexión.
¿Qué es el 'challenge' que pide Meta al verificar?
Es un valor que Meta envía en un request GET y que tu servidor debe devolver exactamente igual para confirmar que la URL es tuya y está activa.
¿Qué pasa si mi servidor no responde 200 a tiempo?
Meta reintenta el envío del evento, pero si los fallos persisten puede reducir la frecuencia de reintentos o dejar de enviar eventos a esa URL.
¿Tengo que programar esto yo mismo?
No necesariamente. Con agenteala, el equipo técnico configura y mantiene el webhook, los tokens y las suscripciones como parte del servicio gestionado.
Probá el agente antes de decidir
agenteala arma y mantiene el agente a la medida de tu negocio — no es un bot genérico: atiende, gestiona y vende por tu WhatsApp. Probalo en 2 minutos o hablá con un asesor.
Seguinos en Instagram @agenteala