Índice de resolución de problemas: síntoma, causa y solución
Esta es la tabla general de consulta para los problemas de REDA Connect. Busca la fila que describe el tuyo con la búsqueda del navegador, Ctrl+F / Cmd+F, lee la causa resumida y sigue el enlace a la solución completa. Los errores en estilo de código se citan tal como aparecen en pantalla. Si tu síntoma no está aquí, empieza por las dos guías principales: Un mensaje no se envía y No llegó un mensaje entrante.
Problemas de envío
| Síntoma | Causa | Solución |
|---|---|---|
| Mensaje detenido: Estado sigue vacío y no pasa nada. | El registro se creó sin marcar Enviar mensaje, así que nunca se despachó. | Un mensaje no se envía |
Mensaje Fallido con un error técnico largo que empieza por CONNECT_API ->. | El proceso de Connect informó una excepción. Lee la causa: el prefijo por sí solo no demuestra dónde se detuvo la entrega | Un mensaje no se envía |
El error contiene Configuración de cuenta de conexión incorrecta. | La Cuenta Connect está inactiva, faltan campos obligatorios del canal o no está seleccionado en Canales de mensajería. | Un mensaje no se envía · Crear una Cuenta Connect |
Error: El destinatario ha optado por no recibir mensajes SMS. o la variante de WhatsApp. | El Prospecto/Contacto tiene marcada la exclusión de ese canal. | Campos de exclusión de mensajes en los registros |
Error: Se debe proporcionar el valor del número de teléfono de destino para los mensajes salientes. | El teléfono del registro está vacío o la configuración de objeto apunta al campo incorrecto. | Un mensaje no se envía · Cómo ingresar números de teléfono |
| Todo el envío masivo falla porque una persona se excluyó. | Un destinatario excluido en la selección bloquea todo el lote. | Seguimiento de un envío masivo |
| Un mensaje programado salió inmediatamente al guardar. | Su Fecha/hora de programación ya había pasado; los horarios pasados activan el envío inmediato. | Programar mensajes |
Un mensaje programado o creado como registro falla: 3. Solicitud incorrecta: proporcione el cuerpo del mensaje o la plantilla de conexión. | El mensaje no tiene un cuerpo utilizable ni una plantilla; el procedimiento documentado de creación directa usa una Plantilla Connect | Programar mensajes |
| Falla con error del proveedor de autenticación, autorización o token vencido. | Los tokens de API guardados son incorrectos o vencieron. | Actualizar tus tokens de API de forma segura |
El cliente recibió el texto literal {{FirstName}} en lugar de su nombre. | La casilla Campo(s) de combinación quedó desmarcada y el cuerpo se envió sin cambios. | Campos de combinación |
Enviar algo distinto de texto por SMS falla: 4. Tipo de mensaje no compatible con SMS. | SMS solo admite texto en ambas direcciones. | Qué puedes enviar en cada canal |
Problemas de recepción
| Síntoma | Causa | Solución |
|---|---|---|
| Los mensajes de los clientes no llegan a Salesforce. | El sitio público está inactivo, las dos clases de endpoint perdieron acceso de invitado o el webhook ya no está registrado en Meta/Twilio. | No llegó un mensaje entrante · Crear el sitio público |
| Las respuestas llegan, pero aparecen solo en el feed global, sin registro. | El teléfono no está guardado en el formato exacto solo con dígitos o no coincide ninguna configuración. | No llegó un mensaje entrante · Cómo ingresar números de teléfono · Cómo se vinculan los mensajes entrantes con su registro |
Las marcas de entrega no se actualizan: quedan en Enviado, nunca Entregado/Leído. | Las confirmaciones recorren el mismo sitio/webhook que los mensajes entrantes; en SMS, comprueba además que la URL de estado se haya guardado con su barra final. | No llegó un mensaje entrante · Crear el sitio público · Conectar los webhooks de Twilio |
| Los mensajes entrantes llegan al registro incorrecto. | La búsqueda encontró otro registro del número o la regla de registros relacionados lo vinculó donde no esperabas. | Cómo se vinculan los mensajes entrantes con su registro · Mensajería mediante registros relacionados |
| No se crea un registro nuevo para números desconocidos. | Ninguna configuración está marcada como predeterminada para registros nuevos. | Crear registros automáticamente a partir de mensajes entrantes |
Archivos y multimedia
| Síntoma | Causa | Solución |
|---|---|---|
| No llegan imágenes: se ve el texto de WhatsApp, pero la foto nunca aparece. | Falta la configuración de sitio remoto del servidor de Meta o el archivo venció antes de descargarse. | Los archivos y las imágenes no llegan · La configuración de sitio remoto que necesitan los archivos multimedia de WhatsApp |
| El archivo entrante no tiene extensión y no abre correctamente. | El tipo del archivo no está en la asignación de tipos. | Los archivos y las imágenes no llegan · Opciones de emojis y asignaciones de tipos de archivo |
| El cliente envió una foto por SMS y no llegó nada utilizable. | No se admite multimedia entrante por SMS; el mensaje queda Fallido: Los mensajes multimedia entrantes actualmente no son compatibles con Twilio. | Los archivos y las imágenes no llegan |
| Preocupa quién puede abrir un archivo enviado por WhatsApp. | Los archivos salen mediante un enlace público que cualquiera que lo tenga puede abrir. | Enviar archivos, imágenes y videos |
Consentimiento y exclusión de mensajes
| Síntoma | Causa | Solución |
|---|---|---|
| El cliente respondió STOP, pero sigue recibiendo mensajes. | Verifica la palabra configurada, el canal y la relación con un prospecto o contacto. Pide al cliente que envíe la palabra completa sola; una frase como "please stop" no es la respuesta prevista | Cómo funciona la exclusión de mensajes |
| El cliente se excluyó en una conversación que no está en un Prospecto o Contacto. | La exclusión automática solo actualiza Prospectos y Contactos; las conversaciones de otros objetos requieren gestión manual. | Cómo funciona la exclusión de mensajes |
Plantillas
| Síntoma | Causa | Solución |
|---|---|---|
La plantilla no se activa: La plantilla debe probarse antes de la activación. | Cada plantilla debe aprobar una prueba antes de activarse. | Probar y activar plantillas |
No se puede editar una plantilla: Solo se pueden actualizar las plantillas inactivas. Use el botón "Desactivar plantilla" para desactivar la plantilla antes de realizar cambios. | Las plantillas activas están bloqueadas para edición por diseño. | Probar y activar plantillas |
| Una plantilla que funcionaba muestra de repente Prueba pendiente e inactiva. | Una nueva prueba fallida borra la marca de prueba y desactiva la plantilla de inmediato. | Probar y activar plantillas |
El envío falla con 5. Error de plantilla: Los parámetros de entrada proporcionados no son válidos. | Se envió una plantilla con campos de combinación sin un registro válido de su objeto. | Campos de combinación |
Scripts de chat
| Síntoma | Causa | Solución |
|---|---|---|
El script de chat no empieza: Configuración de plantilla de script de chat incorrecta [Falta el primer paso]. | No está correctamente establecido el primer paso de la plantilla de script. | Crear un script de chat |
| El script de chat se detiene después de la primera respuesta. | La ventana de sesión se cerró o Sesión activa (minutos) quedó vacío en la plantilla, lo que impide que el script avance. | Sesiones de script de chat |
| El script guardó un código confuso en lugar del texto del botón pulsado. | Las respuestas de botones y listas interactivas guardan el id de la opción, no su etiqueta. Diseña los ID como los valores que quieres almacenar. | Pasos del script de chat |
Feed, acceso y monitoreo
| Síntoma | Causa | Solución |
|---|---|---|
| El feed muestra «Nada en el intervalo de tiempo actual». | El mensaje más reciente de la conversación es anterior a la ventana de carga del feed. | Configuración de rendimiento del feed |
| Errores de «Acceso insuficiente» que indican un objeto o campo. | Al usuario le falta un conjunto de permisos de REDA Connect o no tiene el adecuado. | Dar acceso a tu equipo |
| No llegan correos cuando fallan procesos en segundo plano. | REDA Connect no envía actualmente estos correos automáticamente; configura la rutina de monitoreo. | Recibir notificaciones de errores |
| No sabes dónde se registran los errores. | Las fallas en segundo plano se guardan en la pestaña Registros Connect. | Leer y trabajar con los Registros Connect |
Preguntas frecuentes
Busca en Mensaje de error una frase incluida en las tablas de Un mensaje no se envía. Para fallas en segundo plano, lee Excepción del Registro Connect. Si es un error del proveedor, busca el texto exacto en la documentación de Meta o Twilio.
El error exacto copiado, no reescrito; el número de Mensaje Connect o Registro Connect; el canal; el nombre de Cuenta Connect y cuándo ocurrió. Ese conjunto suele permitir resolverlo en la primera respuesta. Contacta a support@reda.one.
Implementa monitoreo: una vista fijada de registros sin resolver y un informe con suscripción. El procedimiento completo está en Recibir notificaciones de errores.
Qué sigue
- Un mensaje no se envía: la guía detallada del lado saliente.
- No llegó un mensaje entrante: la guía detallada del lado entrante.
- Leer y trabajar con los Registros Connect: dónde se registra cada falla en segundo plano.