Índice:
- Nuevo proceso para el envío de SMS
- Cómo solicitar la creación de plantillas
- 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 la eficiencia de nuestra plataforma. En este contexto, nos gustaría informar sobre algunos cambios importantes en el canal SMS e implementar medidas de seguridad adicionales.
Nuevo proceso para el envío de SMS
A partir de ahora, es necesario crear y aprobar una plantilla para los envíos de SMS (también conocida como Message Template). A diferencia de las plantillas de mensajes de WhatsApp, que se crean en Blip o directamente en la cuenta de WhatsApp de su empresa, en el canal SMS es necesario abrir una solicitud en nuestro sistema de soporte con el contenido del mensaje deseado. El equipo analiza la conformidad del contenido solicitado antes de hacerlo disponible para su uso.
La información de la plantilla se registra en nuestra base de datos, añadiendo una capa extra de seguridad al uso del canal. Esta medida tiene como objetivo prevenir el envío de mensajes maliciosos a números asociados con canales de clientes, garantizando la protección e integridad del proceso de comunicación.
Cómo solicitar la creación de plantillas
Para solicitar la creación de plantillas para sus envíos de SMS, debe abrir una solicitud a través de nuestro sistema de soporte, ya sea por el sitio web o por WhatsApp, con al menos 48 horas hábiles de antelación al uso de la plantilla. Esta solicitud debe incluir el contenido del mensaje que se utilizará en el momento del envío del SMS, para que el equipo pueda analizar y crear la plantilla de manera adecuada, evitando futuros errores.
Antes de crear su plantilla de mensaje, tenga en cuenta la cantidad de caracteres y los caracteres especiales de su mensaje, ya que por cada cantidad de mensaje hay un tipo de cobro. Además, las imágenes y los videos se envían a través de un enlace que redirige a la imagen/video enviado. Se permite el uso de variables en las plantillas. Para ello, debe indicar los puntos específicos del texto donde se utilizarán las variables, colocando el contenido entre {{}} y especificando el tipo de cada variable (solo texto, solo números o alfanumérica).
El texto de un SMS puede contener hasta 160 caracteres, pero al usar caracteres especiales, todos los caracteres del mensaje se contarán de manera diferente y el límite de la mensaje pasa a ser 70 en lugar de 160. Consulte más detalles en la sección Envío de SMS a través de API a continuación.
Nota: los caracteres de las variables también se cuentan en la cantidad total de caracteres del mensaje.
Solicitud: Ahora que ha creado la estructura de su plantilla siguiendo las indicaciones anteriores, abra una solicitud con nuestro equipo de soporte, siguiendo el ejemplo a continuación:
Asunto de la solicitud: creación de plantilla canal SMS
Contenido de la solicitud: incluya aquí la descripción del texto que desea que se implemente en la plantilla. Ej:
Ejemplos 1:
“¡Hola {{1}}! Tu boleto está disponible en este momento en el sitio www.blipid.com.br/{{2}}”
{{1}} = variable de texto
{{2}} = variable alfanumérica (texto y números)
Cantidad de caracteres, sin el contenido de las variables: 74
Ejemplos 2:
“Tu código es: {{1}}”
{{1}} = variable numérica, de 6 dígitos
Cantidad total de caracteres de la plantilla: 19
Ejemplos 3:
“Oferta EXCLUSIVA para saldar tu deuda hoy, {{1}}! No pierdas la oportunidad: https://blipbank.com.br/{{2}}”
{{1}} = variable de texto
{{2}} = variable alfanumérica (texto y números)
En este ejemplo, observe que incluimos las palabras sin los acentos correctos, para evitar que se transformen en caracteres especiales y se reduzca el límite de caracteres.
Cantidad de caracteres, sin el contenido de las variables: 100
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. 😃