📘
Contacte a nuestro equipo de experiencia para tramitar códigos exclusivos para envió de SMS, descuentos por volumen, cuentas pospago, priorización de contenidos y desarrollos a medida.

Tipos de SMS

SMS Prioritario (Transaccional)

Los mensajes prioritarios son enviados para comunicar información crítica o sensible, como códigos de verificación (OTP), alertas de seguridad, confirmaciones de transacciones, notificaciones bancarias o mensajes de atención médica. Este tipo de mensajes tiene prioridad en la entrega, incluso durante horas pico, y su contenido no puede tener fines publicitarios o comerciales. Este tipo de SMS genera un cargo adicional.

SMS Mercadeo (Promocional o Publicitario)

Los mensajes de mercadeo son utilizados para campañas publicitarias, promociones, lanzamientos de productos, recordatorios de eventos o cualquier contenido de carácter comercial. Su envío puede estar sujeto a regulaciones de horarios, opt-in del usuario y no tiene prioridad sobre mensajes críticos. Ideal para comunicación masiva no urgente.

Consideraciones regulatorias

Para garantizar el cumplimiento de las regulaciones Colombianas que protegen a los usuarios, ponemos a su disposición en nuestro portal web cuatro módulos de control que pueden ser habilitados según su necesidad.

Estos módulos están diseñados para ayudarle a cumplir con la normatividad vigente; sin embargo, la responsabilidad final sobre su uso adecuado recae en usted como cliente. En caso de una eventual investigación por parte de la Superintendencia de Industria y Comercio (SIC), usted deberá asumir la totalidad de las implicaciones correspondientes.

Registro de Números Excluidos - RNE

En cumplimiento de la regulación colombiana, los usuarios tienen derecho a no recibir mensajes publicitarios si así lo desean. La Comisión de Regulación de Comunicaciones (CRC) administra el Registro de Números Excluidos (RNE), que contiene los números móviles que han solicitado no recibir mensajes de mercadeo. Hablame valida cada envío contra este registro y bloquea automáticamente cualquier intento de enviar SMS Mercadeo a números inscritos en el RNE.

Este control no aplica para mensajes prioritarios.

Baja del Usuario por Palabras Clave (“SALIR” o “CANCELAR”)

En cumplimiento de la regulación colombiana, los usuarios pueden darse de baja de campañas promocionales respondiendo con las palabras clave “SALIR” o “CANCELAR”. Cuando se recibe alguna de estas respuestas, Hablame registra automáticamente ese número como bloqueado para envíos futuros de mercadeo desde el mismo remitente.

Este control no aplica para mensajes prioritarios.

Horario de Envío para SMS Mercadeo

De acuerdo con la regulación vigente en Colombia, los mensajes de texto con fines de mercadeo solo pueden ser enviados en los siguientes horarios:

Lunes a viernes: entre las 7:00 a.m. y las 7:00 p.m.
Sábados: entre las 8:00 a.m. y las 3:00 p.m.
Domingos y festivos nacionales: prohibido el envío de este tipo de mensajes.

Hablame ofrece a sus clientes el control sobre cómo manejar esta restricción desde el portal web:

El cliente puede habilitar o deshabilitar el control automático del horario de envío.
En caso de estar habilitado el control, el cliente podrá seleccionar una de las siguientes opciones para los mensajes que se envíen fuera del horario permitido:
1. Rechazo automático del mensaje. Este será descartado sin costo y se notificará el motivo del rechazo mediante una respuesta de error controlada.
2. Envío diferido automático, en el cual el sistema retendrá el mensaje y lo enviará automáticamente en la siguiente franja horaria permitida.

Esta configuración permite a los clientes cumplir con la normativa nacional y adaptar el comportamiento del envío de mensajes a sus necesidades operativas y comerciales.

Este control no aplica para mensajes prioritarios.

Lista Negra

La lista negra es un mecanismo adicional que permite a los clientes de Hablame registrar manualmente números a los que no desean enviar mensajes bajo ninguna circunstancia, independientemente del tipo de mensaje. Esta lista puede ser gestionada desde el panel de administración o mediante API, y se verifica antes de cada envío.

Puede incluir en esta lista números reportados como abusivos, con historial de quejas o simplemente no deseados para tus campañas.

Importante:

Los SMS Prioritarios —como códigos OTP, notificaciones de seguridad, transacciones, recordatorios médicos, entre otros— no están sujetos a las restricciones del Registro de Números Excluidos (RNE), horarios de envío, ni al mecanismo de desuscripción por palabras como "SALIR" o "CANCELAR".

Esto se debe a que se entiende que el usuario ha aceptado previamente y de forma consciente recibir este tipo de mensajes de manera inmediata, en cualquier momento del día y en cualquier día del año. Esta aceptación suele ocurrir al registrarse, realizar una transacción, activar una cuenta o dar su autorización expresa para recibir notificaciones críticas o de seguridad.

Por esta razón, los SMS prioritarios se consideran de naturaleza informativa urgente y están exceptuados de las regulaciones aplicables a mensajes de mercadeo o publicidad.

Status de los SMS (statusId)

En la respuesta del API, usted debe analizar el estado de cada SMS, independiente de haber recibido un HTTP 200 OK, cada SMS puede tener un estado diferente.

Código	Descripción
1	El SMS ha sido enviado exitosamente
101	El número de destino no existe
102	El país de destino no está autorizado para el envío de mensajes
103	El mensaje fue bloqueado por spam
104	Su cuenta no tiene saldo disponible para realizar el envío
105	El número de destino se encuentra en una lista negra
106	El número de destino está registrado en la lista nacional de exclusión (RNE)
107	El destinatario ha solicitado no recibir mensajes
108	Su cuenta tiene bloqueo por políticas de prevención de fraude
109	Su cuenta tiene bloqueo por una política general
110	Su cuenta tiene bloqueo por cartera
111	No se ha especificado un texto válido para el mensaje
114	La cabecera del SMS enviado, no coincide con la asignada en la configuración

Funcionalidades API

Mensaje SMS certificado (certificate)

Es un tipo de mensaje que permite obtener una confirmación oficial del operador de que el SMS fue entregado al celular del destinatario. Es ideal para notificaciones legales o comunicaciones que requieren respaldo jurídico. Esta funcionalidad tiene un cargo adicional.

Programación de mensajes (sendDate)

Puede programar el envío de tus mensajes de texto con hasta dos meses de anticipación. Solo debes indicar la fecha y la hora en que deseas que se envíen, y nuestro sistema los entregará puntualmente en el momento que haya definido. Ideal para campañas planificadas, recordatorios o notificaciones automáticas.

Campañas de mensajes (campaignName)

Cuando envía dos o más mensajes de texto, puede asignar un nombre de campaña. Esto le permite agruparlos y acceder luego a informes consolidados sobre su desempeño. Al especificar un nombre de campaña en su solicitud al API, recibirá un ID de campaña único en la respuesta. Con ese ID podrá consultar en cualquier momento información detallada sobre los mensajes enviados dentro de esa campaña, como estadísticas de entrega y puntualidad. Esta funcionalidad facilita el seguimiento y análisis de tus envíos masivos.

Remitente (from)

Este campo representa el número desde el cual se enviará el mensaje de texto, ya sea un código corto o un código largo. Es un campo opcional. Si deseas utilizar un número de origen exclusivo para sus envíos, debe contactar a nuestro equipo de experiencia para su habilitación. En caso de que indique un número de origen que no esté autorizado, el sistema asignará automáticamente un número válido que permita el envío del mensaje.

Mensaje tipo Flash (flash)

Es un mensaje de texto que aparece de forma inmediata en una ventana emergente en la pantalla del celular, sin necesidad de que el usuario lo abra manualmente. Está diseñado para captar la atención de forma intrusiva y prioritaria. Dependiendo del modelo del teléfono, el usuario podrá elegir si desea guardar el mensaje o no; en algunos casos, si cierra la ventana, el mensaje no quedará almacenado y no podrá volver a consultarse. Este tipo de mensaje es útil para enviar información urgente o de alta relevancia. Es obligatorio contar con la autorización previa y expresa del usuario para el envío de mensajes tipo Flash.

Tiempos de entrega

En Hablame! nos esforzamos por entregar los mensajes de texto con la mayor rapidez posible. Sin embargo, la velocidad de entrega depende exclusivamente del operador de telefonía celular y puede verse afectada por factores como el volumen de usuarios conectados, la congestión de red o condiciones técnicas del operador. Es importante tener en cuenta que cualquier retraso en la entrega no está relacionado con la operatividad ni con la gestión de Hablame!. Los tiempos de entrega pueden ser consultados en tiempo real a través de nuestro portal web. Por esta razón, recomendamos a nuestros clientes programar sus envíos con anticipación, especialmente si se trata de campañas sensibles o con fechas y horarios estrictos. Utilice SMS Prioritarios si su necesidad y tipo de contenido lo requiere.

Largo de los SMS

Un mensaje de texto tradicional puede tener hasta 160 caracteres si solo contiene letras y números simples (como los del abecedario). Pero si el mensaje tiene acentos, símbolos especiales o emojis, la codificación cambia y el mensaje solo puede tener hasta 70 caracteres.

Si el mensaje es más largo, no hay problema: se divide automáticamente en varias partes y se envía como un mensaje concatenado. El teléfono del usuario lo muestra como un solo mensaje completo. con Hablame puede enviar SMS hasta de 1.500 caracteres.

En Hablame!, cuando usa el API, nosotros recibimos tu texto, lo analizamos y nos encargamos de que llegue perfecto al celular del destinatario. En la respuesta del API le informamos:

Cuántos caracteres tiene su mensaje.
Qué tipo de codificación se usó.
Cuántas partes se enviaron.
Cuánto cuesta ese envío exacto.

Así puede tener el control total de sus costos y de cómo se entrega cada mensaje.

Limites

El Endpoint puede recibir hasta 300 solicitudes por segundo
En cada llamado API puede enviar un máximo de 5.000 SMS
Los SMS prioritarios únicamente se tramitarán a 5/segundo, si envía por encima de esta tasa, haremos nuestro mejor esfuerzo para entregarlos al teléfono en el menor tiempo posible.