Cuando WhatsApp no funciona
No llega nada a la bandeja cuando escribo al número
Los mensajes entrantes o no están llegando a aiku, o llegan y son rechazados. Repasa esto en orden — están ordenados por con qué frecuencia resulta ser cada uno el culpable.
- ¿Sigue verificado el webhook en Meta? WhatsApp → Configuration. Si muestra un error ahí, la dirección de callback o el verify token están mal.
- ¿Está suscrito el campo
messages? Verificar el webhook y suscribirse a sus campos son dos pasos separados en Meta, y es fácil hacer el primero y olvidar el segundo. - ¿Tiene la tienda el Phone Number ID correcto? Un mensaje entrante se asocia a una tienda por ese número. Uno erróneo o en blanco hace que el mensaje llegue y no vaya a ninguna parte.
- ¿Tiene la organización un App Secret? Sin él, todo mensaje entrante se rechaza antes de leerse.
Si las cuatro parecen correctas, pide a tu desarrollador que revise los logs. Ellos pueden distinguir las causas 3 y 4, algo que no es posible desde fuera.
Las respuestas escritas en el teléfono de la tienda no aparecen en aiku
Esto solo se aplica a un número conectado con Connect WhatsApp Business app, que sigue en la app WhatsApp Business de un teléfono. Dos causas:
- La app de Meta no está suscrita a smb_message_echoes. Sin ello, Meta nunca le dice a aiku lo que se escribió en el teléfono. Pide a tu desarrollador que la suscriba, como se explica en conectar WhatsApp a tu tienda.
- Nadie abrió la app en 13 días. Entonces Meta desconecta el número de aiku. Abre la app WhatsApp Business en el teléfono y pulsa Check status (Comprobar estado) en los ajustes de la tienda. Si no vuelve, conéctalo de nuevo con Connect WhatsApp Business app.
Las plantillas se quedan en "pending" aunque Meta las aprobó
El veredicto de Meta no está llegando a aiku, o no se puede asociar a una tienda. Dos cosas que comprobar.
Primero, que message_template_status_update esté suscrito en Meta. Es una casilla separada de messages y suele ser la que falta.
Segundo, que el WABA ID de la tienda esté rellenado. Los veredictos de plantillas se asocian a una tienda por cuenta de negocio y no por número de teléfono, así que una tienda puede estar recibiendo mensajes perfectamente mientras pierde todos los veredictos. Eso es lo que hace tan confuso este síntoma: todo lo demás funciona.
Mientras tanto, Refresh en la plantilla le pide a Meta su estado actual directamente y la desatasca.
"WhatsApp is not configured for this shop"
La tienda no tiene Phone Number ID. Shop settings → Chat → rellena los campos de WhatsApp Connection.
Esto aparece al intentar enviar y no mientras compones, por eso una campaña puede parecer completamente lista y luego negarse en el último paso. Es intencionado: los ajustes de la tienda no forman parte de si una campaña está lista, o cambiar un ajuste de la tienda dejaría de golpe "no lista" a toda campaña de la tienda.
Una campaña se queda atascada diciendo "Sending"
Una campaña sale en lotes de 50 y solo dice Sent cuando todos los lotes han terminado, así que un lote nunca acabó.
Primero dale tiempo — una audiencia grande tarda un rato, y los informes de entrega siguen llegando después de que salga el último mensaje. Si no se ha movido en una hora, pregunta a tu desarrollador: hay comandos para empujar los lotes restantes y cerrar la campaña, y normalmente significa que los workers en segundo plano de aiku se han parado y no que algo vaya mal con la campaña.
Una campaña pasó directamente a "Stopped"
Cuando llegó su hora programada no se pudo enviar, así que terminó en vez de quedarse ahí aparentando que estaba a punto de salir.
La página de la campaña dice por qué. Será uno de estos: no se eligió plantilla, no hay destinatarios, o falta la conexión de WhatsApp de la tienda. Arréglalo y envía una campaña nueva — una detenida no se reanuda.
La audiencia es mucho más pequeña que mi lista de clientes
Normalmente no es ningún fallo.
Por defecto una campaña va solo a los clientes que se suscribieron al boletín de WhatsApp, que ya de por sí es una fracción pequeña de la lista y crece con el tiempo. Además, los números a los que WhatsApp no puede entregar — sin prefijo de país, un email escrito en un campo de teléfono — se descartan sin contarse.
Si de verdad quieres una audiencia más amplia, añade los grupos Contacted o Customers al componer, y lee antes el aviso en enviar una campaña de WhatsApp.
Muchos mensajes fallaron con algo tipo "Missing"
La plantilla tiene un hueco personalizado y a esos clientes les falta el valor para rellenarlo, así que se les saltó en vez de enviarles un mensaje con un agujero.
O bien rellena el campo que falta en esas fichas de cliente, o usa una plantilla cuyos huecos pueda responder cualquier destinatario. No hay forma de enviar una plantilla con un hueco vacío — WhatsApp la rechaza directamente.
Una plantilla no aparece en el selector de campañas
Todavía no está aprobada, o no está en la categoría Marketing. Ambas cosas son obligatorias. La categoría se elige al crear la plantilla y no se puede cambiar después, así que una plantilla Utility hay que reescribirla como Marketing y volver a enviarla.
Todo se paró a la vez y nadie cambió nada
Nueve de cada diez veces, un access token caducado. Meta entrega por defecto un token temporal de 24 horas y es fácil guardar uno por error durante la configuración. Genera uno permanente para un system user y pégalo en los ajustes de la organización, bajo Meta-configuration → Access Key.
Los demás candidatos, por orden de probabilidad: se eliminó el system user de Meta al que pertenecía el token, el número fue limitado por Meta tras reportes o bloqueos, o la app volvió a modo desarrollo.