Índice:
- Introducción de nuevas medidas de seguridad
- Nuevo proceso para el envío de SMS
- Cómo solicitar la creación de templates
- Envío de SMS a través de API
- Buenas prácticas del canal SMS
- Soporte
Estamos mejorando nuestros servicios para garantizar la seguridad y eficiencia de nuestra plataforma. En este contexto, nos gustaría informar sobre algunos cambios significativos en el canal SMS y la implementación de medidas de seguridad adicionales.
Introducción de nuevas medidas de seguridad
Estas medidas son esenciales para garantizar la integridad y confidencialidad de la información transmitida a través de nuestros servicios.
Nuevo proceso para el envío de SMS
A partir de ahora, es necesario crear una plantilla para los envíos de SMS. Nuestro equipo ya ha creado algunas plantillas pre-configuradas, pero es de suma importancia que nos informen sobre los mensajes que desean enviar a través de SMS para que podamos crear las plantillas según el contenido.
La creación de templates, se realizará mediante una solicitud a nuestro equipo de soporte o a través de WhatsApp. En caso de dificultades para abrir la solicitud, envíe un e-mail a Support.
Cómo solicitar la creación de templates
Para solicitar la creación de templates para sus envíos de SMS, por favor, abra una solicitud a través de nuestro sistema de soporte con el contenido del mensaje que utilizan en el momento del envío, para que podamos crear la template de manera efectiva, evitando cualquier error futuro.
Ejemplo: Asunto de la solicitud: creación de templates canal SMS
Contenido de la solicitud: incluir aquí la descripción del texto que desea que se implemente en la template.
Nota: Es importante destacar que las solicitudes deben abrirse con un mínimo de 48 horas hábiles antes de la necesidad de utilizar la template para que el equipo pueda realizar el registro de la misma.
Envío de SMS a través de API
El proceso de enviar SMS a través de API es bastante sencillo. Siga los pasos a continuación para realizar su envío:
Nota: Imágenes y vídeos: se envían a través de un link que redirige a la imagen/vídeo enviado.
Antes de enviar su mensaje, preste atención al número de caracteres y a los caracteres especiales de su mensaje, ya que hay un tipo de tarifación para cada cantidad de mensaje.
El texto de un SMS puede contener hasta 160 caracteres, pero al usar caracteres especiales, todos los caracteres de los mensajes se contarán de manera diferente y el límite del mensaje será de 70 en lugar de 160.
| Ejemplo de caracteres considerados especiales: (ç, á, ã, etc.) |
| Atención: Debido al protocolo de funcionamiento del envío de SMS, al enviar un mensaje que exceda el límite de caracteres de un mensaje, el envío de SMS múltiple consume algunos caracteres del mensaje para poder unir el texto en el destino. Es decir, para un mensaje con carácter especial (límite de 70 caracteres para contar como 1 SMS), un texto de 140 caracteres no cobrará dos mensajes, sino tres, ya que el envío del mensaje consumirá 3 caracteres de cada parte del mensaje. Para el envío de un mensaje con límite de 160, el envío consumirá 7 caracteres de cada parte del mensaje. |
Ejemplo de límite de caracteres
| Cantidad de Caracteres | Límite por División del mensaje | Cantidad de Mensajes |
| 70 (con especial) | 70 | 1 |
| 71 (con especial) | 67 | 2 |
| 135 (con especial) | 67 | 3 |
| 160 | 160 | 1 |
| 320 | 153 | 3 |
Ejemplos de palabras y su número de caracteres debido al uso de caracteres especiales, note que estos caracteres están en negrita:
| Palabra | Límite de caracteres del mensaje |
| ¡Hola! | 70 |
| Hola | 160 |
| ¡Atención! | 70 |
| Atención | 160 |
A continuación, se muestra un ejemplo de envío de mensaje con su número de caracteres y la cantidad de mensajes debido al uso de caracteres especiales.
| Mensaje | Número de caracteres | Cantidad de Mensajes |
|
¡Hola chicos! ¿Cómo están? Atención, este es un mensaje de prueba de envío de SMS. Has sido premiado con $10,000 en bonos. ¡Accede a Instagram @testDeMensaje y compruébalo! |
193 | 3 |
| Hola chicos. ¿Cómo estáis? Atención, este es un mensaje de prueba de envío de SMS. Has sido premiado con 10 mil reales en bonos. Accede al link y compruébalo. | 147 | 1 |
(Tabla de caracteres considerados "no especiales")
1) Solicitudes
Para enviar un disparo a través de API, es necesario que acceda a alguna aplicación de solicitudes HTTP, por ejemplo, Postman. En caso de no tenerlo instalado, puede acceder aquí:
Además, solo con fines informativos, la mayoría de las solicitudes en esta documentación tendrán los campos siguientes:
| Campo | Ingrese la información |
| Id | Identificador único del mensaje |
| to | Ingrese el número de teléfono del destinatario ("+" + Código de País + Código de Área + 9º dígito) + @sms.gw.msging.net. Por ejemplo: +5511988887777@sms.gw.msging.net |
| type | text/plain |
| content | Ingrese el texto del mensaje deseado y la plantilla creada; |
Nota: en el campo "to" es obligatorio incluir el "+" antes del Código de País, ya que el "+" se utiliza para SMS internacional.
Para generar el id de las solicitudes a continuación, puede generarlo manualmente o mediante un generador gratuito de GUID.
- Link de la Guía del GUID de Microsoft: Método Guid.NewGuid (System) | Microsoft Docs
- Link del generador de GUID en línea y gratuito: Free Online GUID Generator
2) Disparo individual
Si desea enviar un SMS a un solo número, su disparo será individual.
- Primero, utilice la solicitud ‘Send a Message’. Puede obtener más detalles sobre esta solicitud en: Blip Docs | API Reference
- Modifique el campo 'to' al siguiente patrón a continuación. Este campo indica a quién desea enviar el mensaje:
| "+" + Código de País + Código de Área (con el 9º dígito incluido) + número de teléfono + @sms.gw.msging.net |
| Número | Número con Patrón |
| +5511988887777 | +5511988887777@sms.gw.msging.net |
4) En el campo 'content', que representa el contenido del mensaje, agregue el texto del mensaje deseado y la template creado.
5) Seleccione la opción "POST" para definir el tipo de solicitud y envíe.
6) Su solicitud seguirá el siguiente modelo:
6) ¡Listo, has realizado un envío de SMS a través de la API!
3) Disparos Múltiples:
Si deseas enviar un SMS a varios números, tu envío será para múltiples contactos.
- Crea una lista de distribución utilizando la solicitud ‘Create a List’, método POST. Puedes obtener más detalles sobre esta solicitud en: Blip Docs | API Reference
- Con la lista creada, agrega los usuarios que deseas impactar utilizando la solicitud ‘Add a member to a list’ (Agregar un miembro a una lista) siguiendo el formato a continuación. Puedes obtener más detalles sobre esta solicitud en: Blip Docs | API Reference.
| {{número completo del usuario con el noveno dígito}}@sms.gw.msging.net. |
- Para enviar el mensaje, utiliza la solicitud ‘Send a message’ con el nombre completo de la lista creada en el campo ‘to’, el contenido del mensaje y la plantilla en el campo ‘content’. Puedes obtener más detalles sobre esta solicitud en: Blip Docs | API Reference.
¡Listo, has realizado un envío de SMS a través de la API!
Buenas Prácticas del Canal SMS
1) Activa SMS en un chatbot exclusivo para SMS
Para facilitar el control de mensajes, recomendamos que el flujo de SMS sea exclusivo para un chatbot de SMS, es decir, no se recomienda activar SMS en un chatbot que tenga un flujo de WhatsApp. En este caso, crea un chatbot aparte solo para el flujo de SMS.
Si activas SMS en un chatbot que tenga un flujo de WhatsApp y activas un componente interactivo, como por ejemplo, botones o contenido dinámico, como estos componentes no existen en SMS y ambos canales están utilizando el mismo flujo, el componente no se enviará en el formato esperado y aún se podría cobrar una cantidad mayor de mensajes debido a la cantidad de caracteres que este comportamiento generará. De esta manera, el mensaje no funcionará como se espera, será muy extenso y aún tendrá varios caracteres especiales que se contabilizarán financieramente.
| Tipos de mensajes permitidos en SMS | Tipos de mensajes no permitidos en SMS |
| Textos | Botones |
| Imágenes* | Quick Reply |
| Video | Menú |
| Web link | Audio |
| Carrousel | |
| Busqueda | |
| Localización | |
| Contenido Dinámico |
Imágenes y videos: se envían a través de un enlace que redirige a la imagen/video enviado.
2) Para enviar solo mensajes activos no es necesario un flujo de chatbot
Si solo deseas enviar mensajes a tu usuario sin necesidad de recibir respuestas de este mensaje, simplemente realiza la activación de SMS en un chatbot que no tenga flujo en el Builder. En caso de que exista dicho flujo, esperando respuestas del usuario y continuando la “conversación” entre el cliente y el chatbot, se contabilizará el pago debido a la continuidad de los mensajes enviados.
Observación: Para comprobar el estado de las notificaciones enviadas, es necesario consultar el evento:
Primero necesitas obtener el identificador del mensaje activo enviado vía API en los enlaces:
- Get last messages (per user identity)
- Get logged messages (all users)
Luego, obtenga el estado de ese mensaje activo específico mediante la siguiente solicitud:
Posibles eventos (estado):
- event: Event related to the message. The recipient's events depend on the channel and may not be available. The valid values are:
- accepted: The message has been accepted by the server.
- dispatched: The message has left the server and was dispatched to recipient.
- received: The recipient has received the message.
- consumed: The recipient has read the message.
- failed: The message has failed. In this case, the property reason must be present.
- reason: In case of failed events, it represents the reason of the message failure. It contains the following properties:
- code: The failure's numeric code. This value is mandatory.
- description: Failure's description message.
Suporte
Estamos comprometidos a brindar soporte continuo durante este período de transición. Nuestro equipo de soporte está disponible para ayudarte en el proceso de solicitud de plantillas y para resolver cualquier duda que puedas tener, si es necesario.
Agradecemos tu comprensión y colaboración durante este proceso de mejora de la seguridad. Estamos seguros de que estos cambios fortalecerán aún más la confiabilidad de nuestros servicios.
Para obtener más información, acceda a la discusión sobre el tema en nuestra comunidad o los videos en nuestro canal. 😃