Un mensaje no se envía
Cada mensaje saliente de REDA Connect es un registro de Mensaje Connect que indica exactamente qué ocurrió: Estado muestra hasta dónde llegó y Mensaje de error explica por qué se detuvo. Este artículo avanza por síntomas: encuentra el tuyo, comprueba y corrige. Los textos de error se citan tal como aparecen en pantalla para que puedas compararlos letra por letra.
- Abre el registro del mensaje: encuéntralo en el Feed Connect y haz clic en el ícono del canal junto a la hora, o abre la pestaña Mensajes Connect (Iniciador de aplicación →
Mensajes Connect) y usa All Outbound Messages o Failed Messages. - Ten visibles Estado, Mensaje de error y Enviar mensaje. Si no aparecen, consulta al administrador: el acceso viene con los conjuntos de permisos de REDA Connect; consulta Dar acceso a tu equipo.
Síntoma 1: el mensaje está detenido, Estado está vacío y no pasa nada
Un mensaje con Estado vacío se creó, pero nunca se entregó a WhatsApp o Twilio. REDA Connect solo despacha un mensaje creado como registro cuando se marca Enviar mensaje. La ayuda explica que al marcarlo la automatización intenta enviarlo por el canal seleccionado. Los mensajes del Feed Connect no usan esa casilla: salen inmediatamente. Por eso, un mensaje detenido con estado vacío casi siempre viene de un registro creado directamente por ti o una automatización.
| Comprobación | Qué encuentras | Solución |
|---|---|---|
| ¿Enviar mensaje está desmarcado? | El mensaje se guardó sin la instrucción de envío. | Edita y marca Enviar mensaje: REDA Connect lo despacha de inmediato. Solo funciona mientras Estado siga vacío. |
| ¿Fecha/hora de programación tiene un valor futuro? | Es un mensaje programado que espera intencionalmente. | No hay nada que corregir: sale a la hora prevista. Consulta Programar mensajes. |
| Enviar mensaje está marcado, pero Estado sigue vacío. | El trabajo de envío en segundo plano encontró un problema del sistema. | Busca en la pestaña Registros Connect un registro creado cerca de la misma hora. |
Resultado esperado: en un minuto después de marcar Enviar mensaje, Estado cambia a Enviado en WhatsApp o En cola/Aceptado en SMS si funciona; si falla, cambia a Fallido con un Mensaje de error que puedes buscar abajo.
Síntoma 2: Estado es Fallido y Mensaje de error empieza por CONNECT_API ->
Un mensaje de error que comienza con CONNECT_API -> identifica una excepción del proceso de envío de Connect. La configuración y el contenido son causas frecuentes, pero el prefijo por sí solo no demuestra que no se haya llamado al proveedor. Lee la causa incluida en el error:
| Texto dentro del error | Causa | Solución |
|---|---|---|
Configuración de cuenta de conexión incorrecta. | La Cuenta Connect no puede enviar por el canal: Activo está desmarcado, falta un campo obligatorio —en WhatsApp, endpoint de API, token o número; en SMS, endpoint, número remitente o credenciales— o el canal no está seleccionado en Canales de mensajería. | Abre la cuenta, marca Activo, completa los campos y confirma que Canales de mensajería incluya el canal. Consulta Crear una Cuenta Connect. |
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, incluidos los mensajes programados, usa una Plantilla Connect; el feed construye el cuerpo a partir de lo que escribes. | Agrega una Plantilla Connect activa o envía desde el feed. Consulta Programar mensajes. |
4. Solicitud incorrecta: no se encuentra el archivo. | No se encontró un enlace de archivo utilizable para este envío de imagen o documento sin plantilla | Adjunta el archivo al mensaje o reenvía desde el feed con el archivo; consulta Enviar archivos, imágenes y videos. |
4. Tipo de mensaje no compatible con SMS. | SMS solo admite Texto y el mensaje tiene otro tipo. | Cambia Tipo de mensaje a Texto o usa WhatsApp para multimedia; consulta Qué puedes enviar en cada canal. |
5. Error de plantilla: seguido de 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 para combinar. | Asegura que el mensaje tenga un registro del Objeto aplicable de la plantilla; consulta Campos de combinación. |
Solicitud incorrecta: no se puede generar el cuerpo de la solicitud. | REDA Connect no puede enviar ese tipo de mensaje por ese canal. | Crea otro mensaje con un tipo admitido; consulta Qué puedes enviar en cada canal. |
Síntoma 3: Estado es Fallido y Mensaje de error es texto sin CONNECT_API ->
Sin el prefijo CONNECT_API ->, el texto puede ser una respuesta del proveedor. Para confirmar por qué se rechazó el mensaje, revisa Mensaje de error y los detalles de respuesta disponibles. El formato del texto por sí solo no demuestra el recorrido de entrega.
| Qué sugiere el texto del proveedor | Solución |
|---|---|
| Autenticación, autorización, token vencido o credenciales no válidas. | El token o las claves de API guardadas son incorrectos o vencieron. Actualízalos de forma segura: Actualizar tus tokens de API de forma segura. |
| Número de destinatario no válido, no verificado o no compatible. | Comprueba que sea un celular real en formato internacional solo con dígitos; consulta Cómo ingresar números de teléfono. |
| Restricciones de plantillas, ventana de mensajería o políticas de WhatsApp. | Fuera de la ventana de atención de 24 horas, WhatsApp solo admite plantillas aprobadas; consulta Plantillas de mensajes de WhatsApp y aprobación de Meta. |
| Cualquier texto que no puedas interpretar. | Copia el texto exacto en la búsqueda de documentación de códigos de error del proveedor; Meta y Twilio publican la suya. O contacta al soporte de REDA con el número de Mensaje Connect. |
Cuerpo de la respuesta conserva la respuesta completa sin procesar del proveedor para diagnóstico; resulta útil al contactar a soporte.
Síntoma 4: Salesforce ni siquiera permite crear el mensaje
Estos errores aparecen al guardar, o en pantalla durante un envío, porque una regla bloquea el mensaje antes de despacharlo:
| Texto exacto del error | Causa | Solución |
|---|---|---|
El destinatario ha optado por no recibir mensajes SMS. | El Prospecto o Contacto vinculado tiene marcada la exclusión de SMS. | Respétala o, con el consentimiento renovado del cliente, consulta Campos de exclusión de mensajes en los registros. |
El destinatario ha optado por no recibir mensajes de WhatsApp. | Lo mismo para WhatsApp. | Igual que arriba. |
Se debe proporcionar el valor del número de teléfono de destino para los mensajes salientes. | El mensaje no tiene número destinatario; normalmente el campo del registro está vacío o no está configurado. | Completa el teléfono en el formato correcto (Cómo ingresar números de teléfono) y comprueba que la configuración apunte al campo adecuado (Descripción general de la configuración de objetos). |
En envíos masivos, un solo destinatario excluido bloquea todo el lote con ese error; consulta Seguimiento de un envío masivo.
Ejemplo práctico
Un mensaje muestra Estado Fallido con Mensaje de error CONNECT_API -> Configuración de cuenta de conexión incorrecta. -> Line Number: …. El prefijo indica que REDA Connect lo detuvo y la frase interna señala la configuración de cuenta. Abres la cuenta y encuentras Activo desmarcado durante la rotación de tokens de la semana pasada. Lo marcas y vuelves al mensaje, pero su estado ya está establecido, así que envías uno nuevo desde el feed. Sale con Estado Enviado.
Preguntas frecuentes
No con el mismo registro: una vez establecido Estado, ese registro no vuelve a despacharse. Corrige la causa y envía uno nuevo, desde el feed o como registro nuevo con Enviar mensaje marcado.
En cola, Enviando, Aceptado, Enviado, Entregado, Leído, Fallido, No entregado, Recibiendo y Recibido: el ciclo completo se explica en Entender los estados de entrega.
Enviado significa que el proveedor lo aceptó. Si no avanza a Entregado, el problema está después: teléfono apagado, número inaccesible o confirmaciones que no llegan. Para confirmaciones de SMS, consulta la nota de la barra final en Crear el sitio público para recibir mensajes.
En Failed Messages de la pestaña Mensajes Connect, o crea un informe: Informes y tableros y Recibir notificaciones de errores.
Qué sigue
- Índice de resolución de problemas: cada síntoma en una tabla que puedes buscar.
- No llegó un mensaje entrante: el problema equivalente de recepción.
- Actualizar tus tokens de API de forma segura: corregir rechazos por credenciales sin romper el cifrado.