Recursos
Solución de problemas
Las causas más comunes de cada problema y cómo resolverlas. Si después de revisar esto sigue fallando, escríbenos desde el Asistente Waii (se abre en una pestaña nueva) con la URL de la pantalla y los pasos para reproducirlo.
API y API keys
Sección titulada «API y API keys»| Síntoma | Causa | Qué hacer |
|---|---|---|
| 401 | Falta la cabecera Authorization: Bearer <key>, tiene espacios de más o la key fue revocada. | Revisa la cabecera y que la key siga activa en API keys (se abre en una pestaña nueva). Las keys de Waiify empiezan por wai_live_. |
| 403 | La key es de otro espacio de trabajo o el recurso no está disponible por API. | Crea la key estando en el espacio de trabajo correcto. Consulta qué recursos acepta la API en la Referencia de API (se abre en una pestaña nueva). |
| 429 | Superaste el límite de peticiones. | Espera lo que indica la cabecera Retry-After y reintenta. Ver Rate limits (se abre en una pestaña nueva). |
Conexiones con Google y otros servicios
Sección titulada «Conexiones con Google y otros servicios»| Síntoma | Causa | Qué hacer |
|---|---|---|
| La cuenta aparece como «Sin permiso» | Al conectarla no se otorgaron todos los permisos que pide el nodo. | Abre el nodo, pulsa Gestionar cuenta y otorga lo que falte. |
| Un nodo dice que la credencial no es válida | La llave se cambió o revocó en el servicio de origen. | Edita la credencial con el valor nuevo. Ver Integraciones y credenciales (se abre en una pestaña nueva). |
| Error al volver de la pantalla de Google | Una extensión del navegador bloqueó la redirección. | Desactiva temporalmente bloqueadores y vuelve a conectar desde app.waiify.com. |
| Síntoma | Causa | Qué hacer |
|---|---|---|
| No se puede enviar un mensaje libre | Pasaron más de 24 horas desde el último mensaje del cliente. | Fuera de esa ventana solo se pueden enviar plantillas aprobadas (se abre en una pestaña nueva). |
| El número aparece como «Requiere atención» | El número tiene verificación en dos pasos y falta su PIN. | Escribe el PIN de 6 dígitos en el número. Si no lo recuerdas, restablécelo desde Meta Business Manager. |
| No se entregan los mensajes | La cuenta de WhatsApp Business no tiene un método de pago en Meta, el número del cliente no tiene WhatsApp o el cliente bloqueó tu número. | Revisa los ajustes de pago en Meta Business Manager y el formato internacional del número del contacto. |
| Coexistencia: el número se desconectó | La app WhatsApp Business del teléfono no se abrió en 14 días. | Abre la app en el teléfono y vuelve a conectar el número. Ver Coexistencia (se abre en una pestaña nueva). |
Widget web
Sección titulada «Widget web»| Síntoma | Causa | Qué hacer |
|---|---|---|
| El widget no aparece | El script no cargó: lo bloquea la política de seguridad de contenido (CSP) de tu sitio o un bloqueador. | En la consola del navegador busca un error de Content Security Policy o ERR_BLOCKED_BY_CLIENT y permite el dominio de Waiify en script-src y connect-src. Ver Instalar el widget (se abre en una pestaña nueva). |
| Aparece el ícono pero no responde | El asistente está inactivo o no tiene el widget habilitado. | Activa el asistente y su canal de widget web. |
Calendario
Sección titulada «Calendario»| Síntoma | Causa | Qué hacer |
|---|---|---|
| No se genera el enlace de Google Meet | La cuenta se conectó sin permiso para crear eventos o tu empresa tiene Meet deshabilitado en Google Workspace. | Reconecta la cuenta otorgando todos los permisos. Si es una cuenta corporativa, pide a tu administrador que habilite Meet. |
| Horas ocupadas aparecen como libres | El evento de Google Calendar está marcado como «Disponible». | Márcalo como Ocupado en Google Calendar. |
| Síntoma | Causa | Qué hacer |
|---|---|---|
| El SMS cuesta varios segmentos | Un emoji o un carácter especial reduce los caracteres que caben en cada segmento. | Quita emojis y caracteres especiales. La vista previa de la campaña muestra cuántos segmentos ocupa. |
| SMS «No entregado» | El operador del destinatario no lo entregó: número inexistente, apagado o portado. | Revisa el número en el contacto. Ver Estados de entrega (se abre en una pestaña nueva). |
| Síntoma | Causa | Qué hacer |
|---|---|---|
| Los registros DKIM no se verifican | Los CNAME se publicaron con proxy (por ejemplo, la nube naranja de Cloudflare). | Pásalos a DNS only. Ver Dominios de envío (se abre en una pestaña nueva). |
| Gmail o Yahoo rechazan los envíos | El dominio no tiene registro DMARC. | Publica un DMARC empezando con p=none y súbelo cuando los reportes estén limpios, como indica Dominios de envío (se abre en una pestaña nueva). |
| Un contacto no recibe tus campañas | Está en la lista de supresión (se dio de baja, rebotó o marcó spam). | Revísalo en Remitentes y supresiones (se abre en una pestaña nueva). |
Llamadas
Sección titulada «Llamadas»| Síntoma | Causa | Qué hacer |
|---|---|---|
| Una llamada se quedó «En curso» | Se cortó por un fallo técnico. | Waiify la cierra sola. Si ves muchas, escríbenos. Ver Pruebas y diagnóstico (se abre en una pestaña nueva). |
Flow Studio
Sección titulada «Flow Studio»| Síntoma | Causa | Qué hacer |
|---|---|---|
| La ejecución falla por un bucle | El flujo se vuelve a encolar sin fin y superó el máximo de pasos. | Revisa que las condiciones y los bucles tengan una salida. Ver Límites (se abre en una pestaña nueva). |
| La ejecución se detuvo por tiempo | Superó el tiempo activo máximo del flujo. | Para esperar horas o días usa el nodo Esperar (se abre en una pestaña nueva): la espera no cuenta como tiempo activo. |
| No deja guardar el flujo | El flujo supera un límite (nodos, conexiones, código) o tiene campos obligatorios vacíos. | El mensaje dice cuál. Ver Límites (se abre en una pestaña nueva). |
Créditos y plan
Sección titulada «Créditos y plan»| Síntoma | Causa | Qué hacer |
|---|---|---|
| El asistente dejó de responder | El saldo de créditos llegó a 0. Te avisamos por notificación y correo. | Compra créditos o cambia de plan. El asistente vuelve a responder en cuanto hay saldo. Ver Créditos (se abre en una pestaña nueva). |
| No deja crear contactos, flujos o asistentes | Llegaste a un límite de tu plan. | Revisa tus Límites de uso (se abre en una pestaña nueva). |
Permisos y espacio de trabajo
Sección titulada «Permisos y espacio de trabajo»| Síntoma | Causa | Qué hacer |
|---|---|---|
| Un miembro no ve una sección o un botón | Su rol o sus permisos no la incluyen (por ejemplo, el rol Visualizador). | Un propietario o administrador puede cambiarle el rol o darle el permiso. Ver Roles (se abre en una pestaña nueva) y Permisos granulares (se abre en una pestaña nueva). |
| No aparece lo que acabas de crear | Estás en otro espacio de trabajo. | Cambia de espacio de trabajo en el selector. |
