> ## Documentation Index > Fetch the complete documentation index at: https://help.messagesync.ai/llms.txt > Use this file to discover all available pages before exploring further. # Mensaje Fallido > El disparador Mensaje Fallido es un disparador de flujo de trabajo personalizado que se ejecuta automáticamente cada vez que un mensaje no se puede entregar. Funciona en todos los canales de mensajería - WhatsApp, iMessage y Android SMS - para que puedas reaccionar ante fallos de entrega, alertar a tu equipo o reintentar los envíos automáticamente. *** ## Beneficios Clave[​](#beneficios-clave "Enlace directo al Beneficios Clave") **Detecta los Fallos al Instante** - Reacciona en el momento en que un mensaje no se entrega **Independiente del Canal** - Funciona en WhatsApp, iMessage y Android SMS **Recuperación Inteligente** - Automatiza reintentos, alternativas o alertas ante fallos **Automatización Filtrada** - Ejecuta el disparador solo en los códigos de error o canales que te importan **Cero Monitoreo Manual** - No necesitas vigilar los registros en busca de envíos fallidos *** ## Quién Debería Usarlo[​](#quién-debería-usarlo "Enlace directo al Quién Debería Usarlo") **Equipos de ventas** - Recibe una notificación en el instante en que un mensaje de prospección falla **Equipos de soporte** - Detecta respuestas no entregadas antes de que te cuesten un cliente **Agencias** - Monitorea la salud de entrega en todas las subcuentas de clientes **Equipos de operaciones** - Activa alternativas y limpia datos de contacto incorrectos automáticamente *** ## Requisitos[​](#requisitos "Enlace directo al Requisitos") Antes de usar este disparador, actualiza tu app de proveedor de mensajería a la última versión: Ve a **Marketplace de Apps → Apps Instaladas** Busca tu app de proveedor de mensajería (**WhatsApp provider**, **iMessage provider** o **SMS(Android) provider**) Haz clic en **Actualizar** si está disponible *** ## Cómo Configurarlo[​](#cómo-configurarlo "Enlace directo al Cómo Configurarlo") ### Paso 1: Crea un Nuevo Flujo de Trabajo[​](#paso-1-crea-un-nuevo-flujo-de-trabajo "Enlace directo al Paso 1: Crea un Nuevo Flujo de Trabajo") Ve a **Automatización → Flujos de Trabajo** Haz clic en **Crear Flujo de Trabajo** o **+ Agregar** Selecciona **Comenzar desde Cero** ### Paso 2: Agrega el Disparador[​](#paso-2-agrega-el-disparador "Enlace directo al Paso 2: Agrega el Disparador") Haz clic en **Agregar Nuevo Disparador** Cambia a la pestaña **Apps** (no los disparadores predeterminados) Busca y haz clic en el ícono de tu app de proveedor de mensajería Selecciona **Mensaje Fallido** en el menú desplegable (Opcional) Agrega **Filtros** para acotar cuándo se ejecuta el disparador Haz clic en **Guardar disparador** Disparador Mensaje Fallido ### Paso 3: Agrega Tus Acciones[​](#paso-3-agrega-tus-acciones "Enlace directo al Paso 3: Agrega Tus Acciones") Agrega las acciones que quieras ejecutar cuando un mensaje falla: * **Enviar Notificación Interna** → Alerta a tu equipo dentro del CRM * **Esperar + Reenviar** → Reintenta el mensaje después de un retraso * **Actualizar Contacto / Campo Personalizado** → Marca el contacto para revisión * **Crear Tarea** → Programa un seguimiento manual ### Paso 4: Guarda y Publica[​](#paso-4-guarda-y-publica "Enlace directo al Paso 4: Guarda y Publica") Revisa tu flujo de trabajo Haz clic en **Guardar** Cambia el flujo de trabajo de **Borrador** a **Publicado** *** ## Filtros Disponibles[​](#filtros-disponibles "Enlace directo al Filtros Disponibles") Usa filtros para controlar exactamente qué mensajes fallidos inician el flujo de trabajo. Cada filtro puede combinarse con un operador (igual a, contiene, etc.). | Filtro | Descripción | | ----------------------- | --------------------------------------------------------------------------------------------------------------- | | Contact ID | El ID único del contacto al que se envió el mensaje | | Location ID | La ubicación del CRM (subcuenta) donde falló el mensaje | | Error Code | El código de fallo específico devuelto (consulta [Códigos de Error](#códigos-de-error) abajo). Elige uno o más. | | Error Type | La categoría del fallo devuelto. Elige una o más. | | Channel Type | El canal por el que se envió el mensaje (p. ej. WhatsApp, iMessage, SMS) | | Contact Phone Number | El número de teléfono del contacto al que se envió el mensaje | | Whatsapp Instance Index | El índice de la instancia de WhatsApp que intentó el envío | | Phone Number Used | El número desde el que se envió el mensaje | *** ## Códigos de Error[​](#códigos-de-error "Enlace directo al Códigos de Error") Usa estos códigos con el filtro **Error Code** para construir flujos de recuperación precisos. | Código | Qué Significa | | ------ | --------------------------------------------------------------------------------------------------------------------------------- | | 101 | No existen instancias de WhatsApp conectadas para la ubicación. Nada puede enviarse. | | 102 | Se usó una anulación manual `{WA#N}` en el cuerpo del mensaje, pero la instancia N no existe. | | 103 | Se usó una anulación manual `{WA#N}`, pero esa instancia no está conectada actualmente. | | 104 | El contacto tiene una etiqueta `wa:`, pero ese número de WhatsApp no está conectado. | | 105 | El usuario asignado al contacto posee una instancia de WhatsApp, pero no está conectada. | | 106 | Se probaron todas las reglas de selección de remitente; no había ninguna instancia conectada disponible. | | 107 | La instancia de WhatsApp del usuario del CRM con sesión iniciada no está conectada. | | 108 | El flujo de trabajo especificó un número de remitente que existe pero está fuera de línea. El sistema reintentó antes de fallar. | | 109 | La API de WhatsApp rechazó el mensaje después de varios reintentos. | | 110 | El destinatario no tiene una cuenta de WhatsApp. El contacto también se etiqueta automáticamente con **Invalid WhatsApp Number**. | | 111 | El flujo de trabajo especificó un número de remitente que no está registrado para esta ubicación en absoluto. | *** ## Ejemplos de Casos de Uso[​](#ejemplos-de-casos-de-uso "Enlace directo al Ejemplos de Casos de Uso") ### Caso de Uso 1: Alerta al Equipo ante un Envío Fallido[​](#caso-de-uso-1-alerta-al-equipo-ante-un-envío-fallido "Enlace directo al Caso de Uso 1: Alerta al Equipo ante un Envío Fallido") Entérate en el momento en que un mensaje saliente no se entrega. **Disparador:** Mensaje Fallido **Acción:** Envía una notificación interna al usuario asignado. *** ### Caso de Uso 2: Limpia Números Inválidos[​](#caso-de-uso-2-limpia-números-inválidos "Enlace directo al Caso de Uso 2: Limpia Números Inválidos") Marca los contactos que no pueden recibir mensajes. **Disparador:** Mensaje Fallido **Filtro:** Error Code **es** 110 **Acción:** Agrega una etiqueta y saca al contacto de la prospección activa. *** ## Notas Importantes[​](#notas-importantes "Enlace directo al Notas Importantes") ### Detalles Técnicos[​](#detalles-técnicos "Enlace directo al Detalles Técnicos") * El disparador se ejecuta **una vez por mensaje fallido** * Los filtros son opcionales: déjalos en blanco para ejecutarse en cada mensaje fallido * **Error Code** y **Error Type** permiten seleccionar varios valores * Usa el filtro **Channel Type** para acotar el flujo de trabajo a un solo canal ### Buenas Prácticas[​](#buenas-prácticas "Enlace directo al Buenas Prácticas") * Usa el filtro **Error Code** para construir flujos de recuperación específicos (p. ej. reintentar en 108, etiquetar en 110) * Usa el filtro **Channel Type** cuando manejes los canales de forma diferente * Prueba tu flujo de trabajo forzando un fallo (p. ej. enviando a un número desconectado) *** ## Preguntas Frecuentes[​](#preguntas-frecuentes "Enlace directo al Preguntas Frecuentes") Todos: WhatsApp, iMessage y Android SMS. Usa el filtro **Channel Type** para acotar a un solo canal. Sí. Los filtros **Error Code** y **Error Type** son de selección múltiple, así que puedes ejecutarlo en una o varias condiciones de fallo. No. Los filtros son opcionales. Sin ellos, el disparador se ejecuta en cada mensaje fallido. *** ## Soporte[​](#soporte "Enlace directo al Soporte") Si necesitas ayuda con la configuración o incorporación: * Email: [**support@messagesync.ai**](mailto:support@messagesync.ai)