Modificado el: 22 de julio, 2025
Es frustrante cuando un mensaje de texto nunca llega, ya sea un recordatorio de cita, una promoción o un chat bidireccional. Esta guía te lleva a través de cada paso de nuestro pipeline de entrega, te muestra dónde pueden salir mal las cosas y te da soluciones claras y accionables para que puedas volver al buen camino rápidamente.
📋 Contenido de este Tutorial
🔄 Cómo Funciona la Entrega de Mensajes
🔍 Dónde Encontrar Mensajes de Error en CRMHUB
⚠️ Razones Comunes por las que Fallan los Mensajes (Y Cómo Solucionarlas)
🏢 En la Capa de CRMHUB
📡 En la Capa de Twilio/LC Phone
📱 En la Capa de Red del Operador Remitente
✅ Lista de Verificación Súper Rápida Antes de Hacer Clic en "Enviar"
❓ Preguntas Frecuentes
🔄 Cómo Funciona la Entrega de Mensajes
Cuando envías un mensaje desde CRMHUB, viaja a través de múltiples capas:
📊 Pipeline de Entrega de Mensajes:
1️⃣ CRMHUB Envía el Mensaje
🏢 Origen: CRMHUB procesa tu solicitud
📝 Validación inicial: Verificación de formato y contenido
🔄 Procesamiento: Preparación para envío
📤 Transferencia: Envío al proveedor de mensajería
2️⃣ Mensaje Va a Twilio o LC-Phone
📡 Proveedor: CRMHUB entrega el mensaje a tu proveedor de mensajería conectado
🔍 Verificación: Validación de número y formato
💰 Facturación: Aplicación de cargos correspondientes
📤 Reenvío: Envío a la red del operador
3️⃣ Mensajes Enviados a la Red del Operador Remitente
📱 Red del operador: El mensaje se pasa a la red del operador del remitente
🔄 Procesamiento de red: Verificaciones de la red telefónica
🚀 Enrutamiento: Dirección hacia el operador de destino
📊 Monitoreo: Seguimiento del estado de entrega
4️⃣ Verificado por el Operador del Contacto
🏢 Operador de destino: Varias redes involucradas en el transporte y reenvío del mensaje
🔍 Verificaciones de cumplimiento: Para números locales/móviles de EE.UU., se realiza una verificación de cumplimiento (TCR: A2P 10DLC)
🚫 Filtrado: Posible bloqueo por políticas del operador
✅ Aprobación: Autorización para entrega final
5️⃣ Mensaje Entregado al Contacto
📱 Dispositivo final: El contacto recibe el mensaje
✅ Confirmación: Notificación de entrega exitosa
📊 Reporte: Estado final reportado al sistema
🎯 Completado: Proceso de entrega finalizado
⚠️ Nota Importante:
📋 Cumplimiento A2P 10DLC: Para números locales/móviles de EE.UU., se requiere registro A2P 10DLC para asegurar cumplimiento
🚫 Fallas de entrega: Pueden fallar si un paso está bloqueado (ej., por errores de Twilio o filtrado del operador)
🔍 Múltiples puntos de falla: Cada capa puede causar problemas de entrega
🔍 Dónde Encontrar Mensajes de Error en CRMHUB
Si tu mensaje no se envió, verifica la Vista de Conversaciones. En la mayoría de los casos, cuando un mensaje falla al enviar o entregar, mostramos un error en la vista de conversación que aparece así:
🚨 Identificación de Errores:
📍 Ubicación de Errores:
💬 Vista de Conversaciones: Ubicación principal para ver errores
🔴 Insignia roja de error: Indicador visual de problemas
📝 Mensaje de error: Descripción específica del problema
🔢 Código de error: Identificador numérico para diagnóstico
🔍 Información del Error:
📋 Mensaje de error: Proporciona pistas sobre qué está saliendo mal
🔢 Código de error: Indica el tipo específico de problema
🛠️ Pasos siguientes: Cómo proceder desde ahí
📊 Contexto: Información adicional sobre el fallo
📱 Tipos de Indicadores Visuales:
🔴 Error de Envío:
❌ Símbolo: X roja o ícono de error
📝 Descripción: "Mensaje no enviado" o similar
🔢 Código: Número específico del error
🔄 Acción: Opción para reintentar envío
⏸️ Mensaje Pendiente:
⏳ Símbolo: Reloj o ícono de espera
📝 Descripción: "Enviando..." o "Pendiente"
⏰ Tiempo: Duración en estado pendiente
🔄 Estado: Actualización automática del progreso
✅ Mensaje Entregado:
✅ Símbolo: Marca de verificación verde
📝 Descripción: "Entregado" con timestamp
📊 Confirmación: Estado final exitoso
📱 Recepción: Confirmado por el operador
⚠️ Razones Comunes por las que Fallan los Mensajes (Y Cómo Solucionarlas)
🏢 En la Capa de CRMHUB
📞 Problemas de Número Telefónico:
❌ Número Inválido o Mal Formateado:
🚨 Problema: Formato incorrecto del número telefónico
🔍 Síntomas: Error inmediato al intentar enviar
🛠️ Solución: Verificar formato internacional (+1 para EE.UU./Canadá)
✅ Prevención: Usar validación automática de números
🚫 Número Bloqueado o en Lista Negra:
🚨 Problema: Número está en lista de bloqueo
🔍 Síntomas: Mensaje rechazado sin intentar envío
🛠️ Solución: Revisar y actualizar listas de bloqueo
✅ Prevención: Gestión proactiva de listas de contactos
📝 Problemas de Contenido:
📏 Mensaje Demasiado Largo:
🚨 Problema: Excede límite de caracteres por segmento
🔍 Síntomas: Mensaje truncado o rechazado
🛠️ Solución: Dividir en múltiples mensajes o acortar contenido
✅ Prevención: Monitorear contador de caracteres
🚫 Contenido Prohibido:
🚨 Problema: Palabras o frases que activan filtros
🔍 Síntomas: Mensaje bloqueado por políticas
🛠️ Solución: Revisar y modificar contenido problemático
✅ Prevención: Seguir mejores prácticas de contenido
⚙️ Problemas de Configuración:
🔧 Configuración de Número Incorrecta:
🚨 Problema: Número no configurado para SMS
🔍 Síntomas: Error de configuración al enviar
🛠️ Solución: Verificar configuración de número en CRMHUB
✅ Prevención: Validar configuración después de cambios
💳 Problemas de Facturación:
🚨 Problema: Créditos insuficientes o problemas de pago
🔍 Síntomas: Mensajes rechazados por falta de fondos
🛠️ Solución: Verificar balance y métodos de pago
✅ Prevención: Configurar alertas de balance bajo
📡 En la Capa de Twilio/LC Phone
🔢 Errores Comunes de Twilio/LC Phone:
❌ Error 21211 - Número No Válido:
🚨 Problema: Número de destino no es válido
🔍 Código: 21211
🛠️ Solución: Verificar formato del número (+1XXXXXXXXXX para EE.UU.)
✅ Prevención: Usar validación de números antes de enviar
🚫 Error 21610 - Violación de Lista Negra:
🚨 Problema: Número está en lista negra del operador
🔍 Código: 21610
🛠️ Solución: Contactar al destinatario por otro medio para resolver
✅ Prevención: Mantener listas de contactos limpias
⏰ Error 30008 - Timeout de Entrega:
🚨 Problema: Mensaje expiró antes de ser entregado
🔍 Código: 30008
🛠️ Solución: Reintentar envío, verificar estado del número
✅ Prevención: Enviar en horarios de alta actividad
💰 Error 21606 - Número No Habilitado para SMS:
🚨 Problema: Número de origen no puede enviar SMS
🔍 Código: 21606
🛠️ Solución: Verificar configuración del número en Twilio/LC Phone
✅ Prevención: Confirmar capacidades SMS al comprar números
🌍 Problemas Geográficos:
🚫 Restricciones de País:
🚨 Problema: País de destino no permite SMS desde tu región
🔍 Síntomas: Error de restricción geográfica
🛠️ Solución: Usar número local del país de destino
✅ Prevención: Verificar regulaciones antes de campañas internacionales
📋 Problemas de Cumplimiento A2P:
🚨 Problema: Falta registro A2P 10DLC para números de EE.UU.
🔍 Síntomas: Mensajes bloqueados o filtrados
🛠️ Solución: Completar registro A2P 10DLC
✅ Prevención: Registrar campañas antes de envío masivo
📱 En la Capa de Red del Operador Remitente
🚫 Filtrado del Operador:
🤖 Filtros de Spam Automáticos:
🚨 Problema: Mensaje identificado como spam por algoritmos
🔍 Síntomas: Mensaje no llega sin notificación de error
🛠️ Solución: Mejorar contenido, usar números registrados
✅ Prevención: Seguir mejores prácticas anti-spam
📊 Límites de Velocidad:
🚨 Problema: Demasiados mensajes enviados muy rápido
🔍 Síntomas: Mensajes posteriores rechazados o retrasados
🛠️ Solución: Reducir velocidad de envío, espaciar mensajes
✅ Prevención: Configurar límites de velocidad apropiados
📱 Problemas del Dispositivo Receptor:
📵 Dispositivo Apagado:
🚨 Problema: Teléfono del destinatario está apagado
🔍 Síntomas: Mensaje pendiente por tiempo extendido
🛠️ Solución: Esperar a que el dispositivo se conecte
✅ Prevención: Enviar en horarios de alta actividad
📶 Sin Cobertura:
🚨 Problema: Destinatario en área sin cobertura
🔍 Síntomas: Falla de entrega después de timeout
🛠️ Solución: Reintentar más tarde o usar canal alternativo
✅ Prevención: Verificar cobertura en áreas objetivo
💾 Buzón de SMS Lleno:
🚨 Problema: Dispositivo no puede recibir más mensajes
🔍 Síntomas: Mensaje rechazado por dispositivo lleno
🛠️ Solución: Contactar por otro medio para que libere espacio
✅ Prevención: Usar múltiples canales de comunicación
✅ Lista de Verificación Súper Rápida Antes de Hacer Clic en "Enviar"
🔍 Verificaciones Pre-Envío:
1️⃣ Verificar Conversaciones:
👁️ Revisar: Nota cualquier insignia de error roja
📝 Leer: Mensajes de error anteriores
🔄 Estado: Confirmar que no hay mensajes pendientes
✅ Limpiar: Resolver errores previos antes de continuar
2️⃣ Coincidir Código de Error:
🔢 Identificar: Usar las tablas anteriores para encontrar la causa
📋 Documentar: Anotar código específico para referencia
🔍 Investigar: Buscar información adicional si es necesario
📚 Consultar: Usar documentación de códigos de error
3️⃣ Aplicar Solución:
🛠️ Seguir: La columna "Solución" para ese problema específico
⚙️ Implementar: Cambios necesarios en configuración
📝 Modificar: Contenido del mensaje si es requerido
✅ Verificar: Que la solución se aplicó correctamente
4️⃣ Reintentar:
🔄 Reenviar: El mensaje después de los ajustes
⏰ Esperar: Tiempo apropiado entre intentos
📊 Monitorear: Estado del nuevo intento
📝 Documentar: Resultados para referencia futura
5️⃣ Monitorear:
✅ Confirmar: Entrega exitosa
🚨 Notar: Cualquier nuevo código de error
📊 Seguir: Métricas de entrega
🔄 Ajustar: Estrategia según resultados
📋 Checklist Detallado:
📞 Verificación de Número:
✅ Formato correcto: +1XXXXXXXXXX para EE.UU./Canadá
✅ Número válido: Verificar que existe y está activo
✅ No bloqueado: Confirmar que no está en lista negra
✅ Capacidad SMS: Verificar que puede recibir mensajes
📝 Verificación de Contenido:
✅ Longitud apropiada: Dentro de límites de caracteres
✅ Sin contenido prohibido: Evitar palabras que activan filtros
✅ Formato correcto: Texto plano o HTML según configuración
✅ Personalización: Variables reemplazadas correctamente
⚙️ Verificación de Configuración:
✅ Número de origen: Configurado y habilitado para SMS
✅ Créditos suficientes: Balance adecuado para envío
✅ Configuración de campaña: A2P registrado si es necesario
✅ Horario apropiado: Dentro de horas permitidas
🌍 Verificación Regional:
✅ Regulaciones locales: Cumplimiento con leyes del país
✅ Restricciones geográficas: Verificar que el envío está permitido
✅ Horarios locales: Considerar zona horaria del destinatario
✅ Idioma apropiado: Contenido en idioma del destinatario
❓ Preguntas Frecuentes
💰 Facturación y Costos:
❓ ¿Por qué me cobran por mensajes fallidos?
💳 Política de cobro: Los cargos se aplican una vez que se intenta un mensaje, incluso si falla más tarde en el proceso
📊 Punto de cobro: Cuando el mensaje sale de CRMHUB hacia el proveedor
🔄 Procesamiento: Recursos utilizados en el intento de envío
💰 Transparencia: Política estándar de la industria
❓ ¿Puedo obtener reembolso por mensajes no entregados?
📋 Política general: Depende de dónde ocurrió la falla
🏢 Fallas de CRMHUB: Posible reembolso o crédito
📡 Fallas del proveedor: Según políticas de Twilio/LC Phone
📱 Fallas del operador: Generalmente no reembolsables
🔍 Diagnóstico y Logs:
❓ ¿Cómo sé exactamente por qué falló un mensaje?
📊 Logs de Twilio: Puedes verificar los logs de mensajes en Twilio
🔗 Enlace directo: Cómo verificar logs de Twilio
📋 Información detallada: Códigos de error específicos y timestamps
🔍 Análisis profundo: Detalles técnicos del fallo
❓ ¿Dónde puedo ver el historial completo de mensajes?
💬 Vista de Conversaciones: Historial completo en CRMHUB
📊 Panel de reportes: Métricas y estadísticas de entrega
📋 Logs del sistema: Información técnica detallada
📈 Analytics: Tendencias y patrones de entrega
🔄 Reintentos y Recuperación:
❓ ¿Cuántas veces debo reintentar un mensaje fallido?
🔢 Recomendación: Máximo 2-3 intentos
⏰ Espaciado: Esperar al menos 15 minutos entre intentos
🔍 Análisis: Revisar causa del fallo antes de reintentar
🚫 Límite: Evitar spam por reintentos excesivos
❓ ¿Qué hacer si el problema persiste?
🎫 Soporte técnico: Crear ticket con detalles específicos
📋 Información requerida: Códigos de error, números afectados, timestamps
🔄 Canales alternativos: Considerar email o llamadas
📊 Análisis de patrones: Identificar si es problema sistemático
🌍 Consideraciones Internacionales:
❓ ¿Hay restricciones para envío internacional?
🌍 Regulaciones variables: Cada país tiene sus propias reglas
📋 Documentación requerida: Algunos países requieren registro
💰 Costos diferentes: Precios varían según destino
⏰ Horarios restringidos: Algunos países limitan horarios de envío
❓ ¿Cómo mejorar entregabilidad internacional?
📞 Números locales: Usar números del país de destino
📋 Registro local: Completar registros requeridos
🌍 Contenido localizado: Adaptar mensaje al idioma y cultura
⏰ Horarios apropiados: Respetar zonas horarias locales
🛡️ Prevención y Mejores Prácticas:
❓ ¿Cómo evitar que mis mensajes sean marcados como spam?
📝 Contenido de calidad: Evitar palabras que activan filtros
📊 Frecuencia apropiada: No enviar demasiados mensajes muy rápido
✅ Opt-in claro: Asegurar que los contactos consintieron recibir mensajes
🔄 Engagement: Mantener conversaciones bidireccionales
❓ ¿Qué hacer para mantener buena reputación de envío?
📊 Monitorear métricas: Tasas de entrega, quejas, opt-outs
🧹 Listas limpias: Remover números inválidos regularmente
📝 Contenido relevante: Enviar solo mensajes valiosos
⚖️ Cumplimiento: Seguir todas las regulaciones aplicables
🎯 Estrategias Avanzadas de Solución de Problemas
📊 Análisis de Patrones:
🔍 Identificación de Tendencias:
📈 Métricas de tiempo: Identificar horarios con más fallas
🌍 Análisis geográfico: Patrones por región o país
📱 Análisis por operador: Problemas específicos de carriers
📝 Análisis de contenido: Tipos de mensaje con más problemas
📋 Documentación Sistemática:
📊 Registro de errores: Mantener log de problemas frecuentes
🔄 Soluciones aplicadas: Documentar qué funcionó
⏰ Tiempos de resolución: Medir eficiencia de soluciones
📈 Mejora continua: Optimizar procesos basado en datos
🤖 Automatización de Soluciones:
⚡ Respuestas Automáticas:
🔄 Reintentos automáticos: Para errores temporales
📧 Notificaciones: Alertas automáticas para errores críticos
🔀 Failover: Cambio automático a canales alternativos
📊 Reportes: Generación automática de métricas
🛡️ Prevención Proactiva:
✅ Validación previa: Verificar números antes de envío
🔍 Monitoreo continuo: Alertas tempranas de problemas
📊 Análisis predictivo: Identificar problemas antes de que ocurran
🔄 Optimización automática: Ajustes basados en rendimiento
📚 Recursos Adicionales
🔗 Enlaces Útiles:
📋 Mejores Prácticas para Entregabilidad de SMS: Guía completa
📞 Política de Mensajería LC - Phone: Regulaciones y límites
✅ Validación de SMS / Número Telefónico: Herramientas de verificación
📊 Cómo Verificar Logs de Twilio: Tutorial paso a paso
🎓 Capacitación Continua:
📚 Documentación actualizada: Revisar cambios en regulaciones
🎯 Mejores prácticas: Mantenerse al día con estándares de la industria
🤝 Comunidad: Participar en foros y grupos de usuarios
📈 Certificaciones: Obtener certificaciones en plataformas de mensajería
¿Te resultó útil este tutorial? ¡Excelente! Con esta guía completa de solución de problemas de SMS en CRMHUB, tienes todas las herramientas necesarias para diagnosticar y resolver problemas de entrega de mensajes de manera eficiente. ¡Mantén esta guía a mano para resolver rápidamente cualquier problema de mensajería!