Códigos de error SMS y MMS: ejemplos y soluciones
Consulta códigos de error SMS y MMS, ejemplos prácticos y qué revisar antes de reintentar o contactar a Zonitel.
Utiliza esta referencia cuando un SMS/MMS fallido o sin confirmación incluya un código de error. Compara el código, la descripción y el estado exactos del registro; no todos los reportes muestran un código numérico.
Comienza con Cómo solucionar problemas de entrega SMS y MMS para localizar el mensaje en Analytics → Undelivered Messages. Este artículo explica resultados de entrega individuales; los rechazos del registro de campañas tienen otra guía al final.
Busca el código en esta página y selecciona su fila para desplegar la explicación. Los ejemplos son ilustrativos: muestran una situación posible, no un diagnóstico confirmado de tu mensaje. Si no aparece un código, conserva la descripción exacta sin adivinar uno.
Consulta 82 códigos de cuatro dígitos a continuación. Son resultados de procesamiento y entrega; los estados HTTP de una solicitud API corresponden a otra capa. Usa Buscar en la página del navegador para localizar un código o elige una sección.
Números y configuración del remitente
4302 / 4303 — Formato de número inválido
Qué significa: 4302 identifica al remitente; 4303 identifica al destinatario.
Ejemplo: Al copiar el teléfono de un contacto se omitió un dígito.
Qué hacer: Confirma el destinatario con el cliente y revisa la línea de negocio seleccionada. Corrige el número antes de reintentar; cambiar el texto no resuelve un número inválido.
4403 / 4407 — La línea remitente requiere revisión
Qué significa: El envío está prohibido (4403) o la asociación/configuración de la cuenta del remitente es inválida (4407).
Ejemplo: Una línea recién agregada permite llamadas, pero sus SMS fallan.
Qué hacer: Comprueba que elegiste el número de negocio correcto. Pide a Zonitel verificar la habilitación SMS/MMS y la configuración de la cuenta. Que funcionen las llamadas no confirma que la mensajería esté lista.
4720 — El destino no acepta el mensaje
Qué significa: El destino se rechazó como inválido o no disponible para ese servicio de mensajería.
Ejemplo: El cliente proporciona un teléfono fijo que no recibe SMS.
Qué hacer: Confirma el número y si recibe SMS/MMS de negocios. También puede existir una restricción del destinatario. Si desea los mensajes, puede pedir a su operador móvil que revise sus restricciones; no asumas un error de escritura o bloqueo por spam.
4406 / 4721 — Destinatario sin asignar o inactivo
Qué significa: 4406 indica un destino sin asignar; 4721 identifica un destino desactivado.
Ejemplo: Una ficha antigua todavía contiene un móvil dado de baja.
Qué hacer: Verifica el número actual y el consentimiento antes de actualizar el contacto. Detén los intentos al número anterior. No asumas que un número de reemplazo pertenece al mismo cliente.
4001 / 4493 — Autorización del servicio o remitente
Qué significa: 4001: servicio no permitido. 4493: remitente no autorizado para la cuenta.
Ejemplo: Una integración selecciona una línea que no está autorizada para su cuenta.
Qué hacer: Confirma la línea de negocio y comparte el error exacto con Zonitel. Pide revisar el acceso al servicio y la autorización del remitente. No utilices credenciales de otra cuenta ni repitas la misma solicitud.
4404 — No se permite enviar a este destino
Qué significa: El destinatario no está permitido para esta solicitud de mensajería.
Ejemplo: Una solicitud con varios destinatarios incluye un tipo de número que la ruta no admite.
Qué hacer: Revisa el número, su capacidad de mensajería y el método de envío. Pide a Zonitel identificar el destino rechazado. No asumas que todos los contactos de una lista son inválidos porque falló una solicitud.
4405 / 4740 — El número remitente no se reconoce o acepta
Qué significa: 4405: remitente sin asignar o inactivo en los registros de mensajería. 4740: la red de destino rechazó el origen.
Ejemplo: Una línea recién activada permite llamar, pero la ruta de mensajes todavía no la acepta.
Qué hacer: Revisa la línea seleccionada y pide a Zonitel comprobar su activación, registros de mensajería y compatibilidad con el destino. Indica si afecta a uno o varios destinatarios. No cambies los teléfonos de clientes para corregir un error del remitente.
4408 — Configuración de la cuenta de destino
Qué significa: No se pudo resolver la asociación de cuenta o configuración de recepción del destino.
Ejemplo: El número parece válido, pero no se identifica su configuración para recibir mensajes.
Qué hacer: Confirma el destinatario y comparte el registro completo con Zonitel para revisar la ruta y configuración. Esto no significa que debas agregar al cliente a tu cuenta ni cambiar sus permisos del portal.
4433 / 4434 — Permisos de mensajería toll-free
Qué significa: 4433: mensajería toll-free no habilitada para la cuenta. 4434: envío al destinatario toll-free no permitido.
Ejemplo: La ruta seleccionada no puede enviar un texto a un número toll-free de atención al cliente.
Qué hacer: Indica a Zonitel si el número toll-free es el remitente o destinatario. Pide revisar los permisos y la capacidad de mensajería correspondientes. Distingue estos casos de 4795, que se refiere a verificar el número toll-free remitente.
4492 — Destino de emergencia no permitido
Qué significa: La ruta de mensajería de negocio rechazó un número de emergencia como destino.
Ejemplo: Se introdujo un número de emergencia como destinatario de una prueba.
Qué hacer: Detén el intento y revisa el campo del destinatario. Nunca envíes pruebas a números de emergencia. Este error de mensajería de negocio no debe interpretarse como evidencia de que una solicitud de emergencia llegó a un operador.
Registro y activación
4476 / 4773 / 4774 — Registro o activación 10DLC
Qué significa: 4476: remitente sin registro. 4773: campaña inactiva para el destino. 4774: problema de configuración del número.
Ejemplo: La campaña fue aprobada, pero un remitente recién agregado aún no está completamente activado.
Qué hacer: Proporciona a Zonitel el número remitente y el error exacto. Pide verificar el estado de la campaña, la asignación del número y la activación completa. Si rechazaron el registro, consulta la guía enlazada abajo. Espera confirmación antes de probar.
4795 — Número toll-free sin verificar
Qué significa: El número gratuito remitente no tiene la verificación de mensajería requerida.
Ejemplo: La línea toll-free recibe llamadas, pero su verificación para SMS está pendiente.
Qué hacer: Pide a Zonitel revisar ese número y proporciona los datos de negocio o pruebas de consentimiento que falten. Un registro 10DLC de números locales no verifica un toll-free. Continúa solo después de la confirmación; la verificación no garantiza la entrega.
Consentimiento, filtros y enlaces
4475 / 4775 — El destinatario se dio de baja
Qué significa: Una baja impide más mensajes de este remitente.
Ejemplo: El cliente respondió STOP y después se intentó enviar un recordatorio de cita.
Qué hacer: Detén los envíos y revisa Conversations → Group Messages → Opted-Out (Unsubscribed). Conserva la baja. No elimines el contacto ni cambies el remitente para evitarla; consulta la guía de bajas si el cliente solicita por iniciativa propia volver a suscribirse.
4470 / 4770 — Filtrado de spam
Qué significa: El mensaje se filtró como posible spam.
Ejemplo: Un texto promocional falla aunque el negocio tiene una campaña aprobada.
Qué hacer: Revisa el consentimiento, el uso registrado, el texto real, los enlaces y el patrón de envío. Identifica claramente al negocio. Si continúa, envía a Zonitel un ejemplo del fallo. No rotes números, disfraces palabras ni reenvíes repetidamente para evitar el filtro.
4771 — Rechazo de enlace acortado
Qué significa: Se rechazó la URL acortada incluida en el mensaje.
Ejemplo: Un recordatorio contiene un enlace público acortado que oculta su destino.
Qué hacer: Utiliza un enlace HTTPS claro en el dominio de tu negocio y verifica su destino. Debe ser coherente con el programa registrado. Esto mejora la claridad, pero ninguna URL garantiza entrega; pide a Zonitel investigar si el bloqueo continúa.
4481 / 4482 / 4772 — Un número remitente o receptor está bloqueado
Qué significa: 4481 identifica un bloqueo del remitente; 4482, del destinatario. 4772 puede corresponder a cualquiera de los dos.
Ejemplo: Una campaña está activa, pero su número encuentra un bloqueo en la red.
Qué hacer: Pausa los envíos afectados y pide a Zonitel identificar el número bloqueado y el motivo. Incluye el código y contexto del consentimiento. El bloqueo no demuestra por sí solo una baja ni una infracción específica; no rotes números para evitarlo.
Adjuntos MMS y contenido
4410 / 4710 — No se pudo recuperar el archivo
Qué significa: El servicio de mensajería no pudo descargar el adjunto.
Ejemplo: Una integración utiliza una imagen cuyo enlace venció o requiere iniciar sesión.
Qué hacer: En el portal, vuelve a adjuntar el archivo original y revisa la vista previa. En una integración, pide al responsable comprobar el acceso y la vigencia del enlace. Protege los documentos privados; no publiques información sensible solo para que un enlace sea accesible.
4411 / 4711 — El archivo es demasiado grande
Qué significa: El MMS supera un límite de tamaño aplicable.
Ejemplo: Varias fotos cumplen individualmente, pero su tamaño combinado es excesivo.
Qué hacer: Reduce las dimensiones de las imágenes o la duración del video, comprime los archivos o elimina adjuntos innecesarios. Sigue los límites del compositor y tipo de número. Prueba una vez con el archivo reducido; aceptar la carga no garantiza que el destino lo acepte.
4412 / 4712 — Formato de archivo no compatible
Qué significa: No se pudo aceptar o interpretar el tipo de archivo.
Ejemplo: Una imagen en un formato especializado falla en el dispositivo del cliente.
Qué hacer: Exporta una copia real a un formato ampliamente compatible, como JPEG o PNG, y revisa los tipos admitidos por el compositor. Cambiar la extensión no convierte el archivo. La compatibilidad varía por dispositivo, destino y tipo de número remitente.
4751 — Texto demasiado largo o longitud inválida
Qué significa: El destino rechazó la longitud del mensaje.
Ejemplo: Se pega una página completa de instrucciones en un SMS.
Qué hacer: Resume lo esencial y coloca los detalles restantes en una página adecuada del negocio. Evita convertirlo en una secuencia rápida de textos repetidos. Realiza una prueba con la versión revisada después de confirmar el consentimiento y los límites admitidos.
4409 / 4700 — El destino no admite este servicio de mensajes
Qué significa: 4409: perfil de destino inválido, frecuentemente relacionado con MMS. 4700: tipo de servicio rechazado.
Ejemplo: El destinatario recibe SMS de texto, pero no puede recibir la foto adjunta como MMS.
Qué hacer: Confirma qué tipo de mensaje puede recibir. Si corresponde y mantiene su consentimiento, utiliza un solo texto con lo esencial. Pide a Zonitel investigar errores de compatibilidad repetidos; recibir llamadas no demuestra compatibilidad con MMS.
4301 — Codificación del texto inválida
Qué significa: No se puede procesar el mensaje con su codificación actual de caracteres.
Ejemplo: Una integración genera texto dañado al copiar contenido de otro sistema.
Qué hacer: Conserva el ejemplo fallido y prepara un texto breve y limpio para una prueba autorizada. Si lo generó una integración, pide a su responsable revisar la codificación. Este código no significa que todos los acentos o emojis estén prohibidos.
4350 — Falló la validación durante el envío
Qué significa: El mensaje pasó una revisión inicial, pero resultó inválido al enviarse; puede estar relacionado con el número de destino.
Ejemplo: Una solicitud se acepta inicialmente y falla cuando se procesa el destinatario.
Qué hacer: Revisa el número completo y la descripción exacta. Si son correctos, proporciona el registro a Zonitel. La aceptación inicial no confirma entrega y cambiar solo el texto puede no resolver este resultado.
4752 — Mensaje mal formado o campos inválidos
Qué significa: La red receptora rechazó la estructura del mensaje o alguno de sus valores.
Ejemplo: Una plantilla automática genera un mensaje vacío porque falta un dato necesario.
Qué hacer: Revisa el texto final, adjunto y destinatarios, además de la plantilla guardada. Si procede de una integración, pide a su responsable revisar la solicitud. Corrige el campo identificado antes de probar una vez; el código no establece un límite universal de caracteres.
4435 / 4735 — Demasiados destinatarios en una solicitud
Qué significa: La solicitud o red de destino rechazó la cantidad de destinatarios.
Ejemplo: Una integración incluye demasiadas direcciones en una solicitud de conversación grupal.
Qué hacer: Pide a Zonitel confirmar el límite de ese método de envío. Una conversación grupal compartida y una lista de difusión de Group Messages son flujos diferentes; no apliques un límite de participantes a todas las listas. Revisa los resultados por destinatario antes de reintentar.
Entrega, fallos temporales y resultados desconocidos
4701 / 4702 — No se puede alcanzar al destinatario
Qué significa: El servicio de destino o el destinatario no está disponible.
Ejemplo: El teléfono está apagado o temporalmente fuera de alcance.
Qué hacer: Confirma el número y revisa el resultado más reciente antes de reintentar. Si aún necesita recibirlo y el problema temporal terminó, realiza un único reintento controlado. Pide a Zonitel investigar fallos repetidos; el código no identifica por sí solo un ajuste concreto del teléfono.
4730 — No existe una ruta al destino
Qué significa: La red de destino informa que no hay una ruta de mensajería utilizable.
Ejemplo: Un cliente en roaming no puede recibir el mensaje por la ruta disponible.
Qué hacer: Comparte con Zonitel el destinatario, remitente y fecha/hora. Confirma que el destino sea compatible. No cambies el texto ni crees otra campaña basándote solo en este error; se debe investigar la ruta.
4750 — Rechazo sin causa específica
Qué significa: Se informó un rechazo, pero no se proporcionó su causa exacta.
Ejemplo: Un recordatorio de cita falla y el registro solo muestra un rechazo general.
Qué hacer: Revisa la capacidad del destinatario, el consentimiento y el contenido; después proporciona el registro completo a Zonitel. No lo clasifiques como spam confirmado. Puede existir una restricción o problema del teléfono, pero el código por sí solo no identifica la causa.
4780 / 4781 / 4785 — Restricción de volumen o velocidad
Qué significa: Se excedió un límite aplicable o se restringió el ritmo de envío.
Ejemplo: Un lote grande alcanza la capacidad de envío de la campaña.
Qué hacer: Pausa los envíos adicionales y pide a Zonitel confirmar el límite correspondiente y cuándo continuar. Distribuye los próximos envíos adecuadamente. No asumas un límite universal ni lo evites con más números; algunas restricciones también pueden relacionarse con la calidad de los mensajes.
5100 / 5211 / 5500 / 5600 — Fallo del servicio o congestión
Qué significa: Falló el procesamiento, un servicio estaba ocupado o una cola de destino no aceptó el mensaje.
Ejemplo: Varios envíos válidos fallan durante una interrupción temporal.
Qué hacer: Revisa el estado más reciente y consulta a Zonitel si existe un incidente general. Si el envío figura como fallido, espera la recuperación antes de un único reintento autorizado. Si se repite, detente y contacta a soporte; evita envíos continuos a una cola o ante un resultado incierto.
4360 / 4794 — El mensaje venció
Qué significa: 4360: pasó la fecha límite de envío. 4794: el operador de destino dio el mensaje por vencido.
Ejemplo: Un recordatorio urgente no pudo procesarse antes de su vencimiento.
Qué hacer: Comprueba si la información todavía es útil. Si corresponde enviar otro mensaje, actualiza el momento y contenido, verifica el consentimiento y envíalo una vez. No reenvíes automáticamente recordatorios de citas que ya pasaron.
9902 — Venció la espera de confirmación
Qué significa: No llegó un comprobante dentro del plazo de reporte; el resultado es desconocido.
Ejemplo: El portal no tiene confirmación final, pero el cliente indica que recibió el SMS.
Qué hacer: Registra la confirmación del cliente y revisa el reporte más reciente. El vencimiento no demuestra entrega ni fallo. Evita duplicados; pide a Zonitel investigar si es importante confirmar el resultado. Un comprobante tampoco demuestra que la persona haya leído el mensaje.
9999 — Error informado sin clasificar
Qué significa: Se recibió un error de la red sin una causa reconocida.
Ejemplo: El reporte muestra un error desconocido sin explicación específica.
Qué hacer: Envía a Zonitel el estado, código y descripción exactos junto con los datos del mensaje. No lo interpretes igual que 9902 ni elijas una solución solo por el código. Evita reintentos repetidos mientras se aclara el resultado.
4753 — El dispositivo del destinatario rechazó el mensaje
Qué significa: El rechazo se informó en el teléfono receptor.
Ejemplo: La entrega falla en el dispositivo de un cliente mientras otros reciben el mismo aviso.
Qué hacer: Consulta al cliente por un medio de contacto adecuado si desea recibirlo y admite ese tipo de mensaje. Comparte el resultado con Zonitel. El código por sí solo no identifica un ajuste del dispositivo ni justifica envíos repetidos.
4401 / 4420 / 4421 — Hay que revisar la ruta o acceso al destino
Qué significa: 4401: ruta rechazada. 4420: falta la red de destino en la configuración. 4421: falta un permiso o habilitación del destino.
Ejemplo: Una prueba utiliza por error el mismo número como remitente y destinatario, lo que puede producir 4401.
Qué hacer: Compara ambos números y confirma el destino previsto. Si son correctos, envía a Zonitel el código y la fecha/hora para revisar la ruta. No sustituyas estos códigos por 4730 al reportarlos; el resultado exacto ayuda a localizar el problema.
5101 / 5111 — Se cerró el servicio o la conexión de procesamiento
Qué significa: 5101: una aplicación de procesamiento se estaba cerrando. 5111: la conexión asociada ya se había cerrado.
Ejemplo: Un envío falla durante un reinicio del servicio o una interrupción de conexión.
Qué hacer: Revisa el estado más reciente y si existe un incidente. Consulta a Zonitel si el fallo se repite. Tras la recuperación, realiza como máximo un reintento autorizado de un mensaje confirmado como fallido; actualizar el navegador no demuestra que el servicio se recuperó.
5106 / 5201 — Se agotaron los intentos de entrega
Qué significa: 5106: no se pudo completar la ruta tras los intentos. 5201: el servicio venció el mensaje después de intentos fallidos.
Ejemplo: El servicio intenta procesar un recordatorio, pero no completa la ruta.
Qué hacer: Comprueba si el recordatorio sigue siendo útil y pide a Zonitel revisar los intentos. No inicies otro ciclo de reenvíos ni mandes automáticamente información vencida. Coordina una nueva prueba cuando se resuelva el problema de ruta o servicio.
5220 — El servicio no pudo almacenar el mensaje
Qué significa: Falló el almacenamiento del mensaje durante el procesamiento.
Ejemplo: Un envío se rechaza porque el servicio no puede guardarlo.
Qué hacer: Proporciona a Zonitel la fecha/hora exacta y la referencia del mensaje. Esto no indica que debas liberar memoria del teléfono o borrar conversaciones. Confirma el estado final y la recuperación del servicio antes de una prueba controlada.
5231 — No llegaron todas las partes del mensaje
Qué significa: El servicio no pudo reunir el mensaje completo antes de terminar su plazo de espera.
Ejemplo: Un SMS largo llega al servicio de procesamiento con un segmento faltante.
Qué hacer: Conserva el mensaje original y el error para Zonitel. Si corresponde, revisa el procesamiento de la integración. Después de revisarlo puede convenir un reemplazo más breve; no envíes solo el fragmento faltante ni crees ráfagas de mensajes repetidos.
5501 — No había un destino disponible para enviar
Qué significa: El envío falló porque no se obtuvo un destino disponible.
Ejemplo: El registro contiene un número aparentemente válido, pero el servicio informa que no hay destino para enviar.
Qué hacer: Confirma el destinatario y proporciona a Zonitel el error completo para revisar el servicio y la ruta. No asumas que esto demuestra que el número fue desconectado. Prueba de nuevo después de corregir el problema identificado.
5610 / 5620 / 5650 — La red receptora informó un fallo de procesamiento
Qué significa: 5610: falló una operación de envío o cancelación. 5620: error de aplicación en destino. 5650: falló el envío al destino.
Ejemplo: Varios mensajes fallan mientras la red receptora tiene un problema de procesamiento.
Qué hacer: Indica a Zonitel qué operación intentaste y su estado más reciente. Un error al cancelar no confirma la cancelación. Si el envío figura como fallido, coordina un reintento tras la recuperación; detente si se repite.
5630 — El servicio receptor no confirmó el procesamiento
Qué significa: La red no proporcionó el acuse de procesamiento esperado.
Ejemplo: El servicio informa un error de acuse mientras procesa un envío.
Qué hacer: Pide a Zonitel revisar el resultado final antes de reintentar. Es un acuse de procesamiento, no una respuesta del cliente ni un comprobante de lectura. No asumas que el mensaje no se leyó y distingue 5630 del vencimiento de confirmación de entrega 9902.
5999 — Error sin clasificar del servicio de mensajes
Qué significa: El servicio de mensajería informó un error interno desconocido.
Ejemplo: El reporte contiene 5999 sin un diagnóstico más específico.
Qué hacer: Envía a Zonitel la descripción completa, el estado y la referencia del mensaje. No elijas una solución basándote solo en la palabra «desconocido». Distingue 5999 de 9999, que representa una respuesta sin clasificar de la red de destino.
Rutas especiales e integraciones
Estos casos aplican cuando se informa el código exacto para ese servicio. Algunos corresponden a integraciones, rutas internacionales, códigos cortos u otros canales; incluirlos no significa que estén habilitados en tu cuenta.
4432 — País de destino no habilitado o fuera de cobertura
Qué significa: Este remitente o servicio no puede enviar mensajes al país de destino.
Ejemplo: Un destinatario internacional está fuera de la cobertura disponible para MMS.
Qué hacer: Confirma el país y si utilizas SMS o MMS; consulta a Zonitel si ese destino está admitido y habilitado. La cobertura de llamadas es independiente. No cambies el código de país para forzar una ruta nacional.
4451 / 4452 — Referencia de usuario o aplicación inválida
Qué significa: 4451: identificador de usuario inválido. 4452: identificador de aplicación o asociación con cuenta/remitente inválidos.
Ejemplo: Una integración conserva una referencia de aplicación de otra configuración.
Qué hacer: Pide al responsable de la integración y a Zonitel verificar los identificadores con la cuenta y línea previstas. Comparte las referencias en privado, sin contraseñas, tokens ni claves API. Estos identificadores no necesariamente corresponden al nombre de un usuario editable del portal.
4754 — El dispositivo no admite el canal seleccionado
Qué significa: El dispositivo de destino no admite el canal de mensajería solicitado.
Ejemplo: Un servicio de mensajes conectado intenta utilizar un canal que el dispositivo del cliente no puede recibir.
Qué hacer: Confirma el canal real del registro fallido y consulta a Zonitel qué alternativas ofrece tu configuración. Este caso corresponde únicamente cuando aparece ese código; no significa que tu cuenta incluya todos los canales de mensajería.
4431 / 4790 / 4791 / 4792 / 4793 — Restricciones de ruta, campaña o activación de código corto
Qué significa: 4431: servicio de código corto no habilitado. 4790: restricción del destino para códigos cortos. 4791: campaña de código corto no permitida. 4792: código corto no habilitado en la red receptora. 4793: código corto vencido.
Ejemplo: Un programa existente de código corto encuentra una restricción en una red móvil.
Qué hacer: Utiliza este caso solo si el registro corresponde a un código corto. Pide a Zonitel revisar la restricción o estado de activación exactos. No apliques estos códigos a una campaña 10DLC de números locales ni asumas que tu cuenta incluye códigos cortos.
¿Cuándo debo contactar a soporte?
Contacta a Zonitel si el error continúa después de corregirlo, hay que revisar el registro o la activación de la línea, afecta a varios destinatarios o el resultado sigue siendo incierto.
- Identifica el registro. Incluye el ID del mensaje si aparece, los números de origen y destino, la fecha/hora y la zona horaria de la cuenta.
- Incluye el resultado exacto. Copia el estado, código y descripción. Indica si era SMS o MMS y si afectó a uno o varios destinatarios. Si tenía un adjunto, incluye su tipo y tamaño.
- Explica lo revisado. Describe la corrección o prueba controlada y si el destinatario confirmó que lo recibió. Comparte los datos por un canal privado de soporte; oculta datos de otros clientes en las capturas.