Índice:
Disparo de SMS a través de la API
El proceso de envío de SMS a través de la API es muy sencillo. Siga los siguientes pasos para realizar su activación:
Antes de enviar su mensaje, preste atención al número de caracteres y caracteres especiales de su mensaje, ya que para cada cantidad de mensaje hay un tipo de cargo.
El texto de un SMS puede contener hasta 160 caracteres, pero al utilizar caracteres especiales todos los caracteres del mensaje se contarán de forma diferente y el límite del mensaje será de 70 en lugar de 160.
| Ejemplo de caracteres considerados especiales: (ç, á, ã, etc.) |
Por lo tanto, como cada SMS sólo puede contener 160 caracteres, cuando utilicemos un carácter especial debemos recordar que cambia el límite de caracteres del mensaje. Si supera este límite de 160 o 70 caracteres, los mensajes se enviarán, pero se le cobrará un suplemento porque se interpreta como el envío de más de un mensaje.
| Atención: Debido al protocolo de envío de SMS, cuando se envía un mensaje que supera el límite de caracteres de un mensaje, el envío de varios SMS consume algunos caracteres del mensaje para poder unir el texto en 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 consumirá 3 caracteres de cada parte del mensaje. Para el envío de un mensaje con límite de 160 caracteres, el envío consumirá 7 caracteres de cada parte del mensaje. |
Ejemplo de límite de caracteres:
| Número de caracteres | Límite por división de mensajes | Número de mensajes |
| 70 (incluyendo el carácter especial) | 70 | 1 |
| 71 (incluyendo el carácter especial) | 67 | 2 |
| 135 (incluyendo el carácter especial) | 67 | 3 |
| 160 | 160 | 1 |
| 320 | 153 | 3 |
Ejemplos de palabras y su número de caracteres debido al uso de caracteres especiales, observe que estos caracteres están en negrita:
| Palabra | Límite de caracteres del mensaje |
| Hola! | 70 |
| Hola | 160 |
| Atención! | 70 |
| Atencion | 160 |
A continuación, un ejemplo de envío de un mensaje con su número de caracteres y el número de mensajes debido al uso de caracteres especiales.
| Message | Number of characters | Number of Messages |
|
Hello everyone! What's up with you guys? Attention, this is a test message for sending SMS. You have been awarded with R$ 10,000 reais in bonus access the instagram @testeDeMensagem and check it out! |
193 | 3 |
| Hello everybody, how are you? Attention this is a test message for sending SMS. You have been awarded with 10 thousand reais in bonus access the link and check. | 147 | 1 |
(Tabla de caracteres considerados como "no especiales")
1) Solicitudes
Para enviar un disparador a través de la API es necesario acceder a alguna aplicación de peticiones HTTP, por ejemplo Postman . Si no la ha instalado, puede acceder a ella aquí:
Además, a título informativo, la mayoría de las solicitudes de esta documentación tendrán los campos que se indican a continuación:
| Campo | Introduzca la información |
| Id | Identificador único del mensaje |
| to | Introduzca el número de teléfono de la persona que recibirá el mensaje (con el prefijo y el 9º dígito) + @sms.gw.msging.net. Por ejemplo 5511988887777@sms.gw.msging.net |
| type | text/plain |
| content |
Introduzca el texto del mensaje deseado; |
Nota: en el campo “a”, es obligatorio incluir el “+” antes del DDI, ya que el “+” se usa para SMS internacionales.
Para generar el identificador de las solicitudes que aparecen a continuación, puede generarlo manualmente o utilizando un generador de GUID gratuito.
- Enlace a la Guía GUID de Microsoft: Guid.NewGuid Método (System) | Microsoft Docs
- Enlace al generador gratuito de GUIDs en línea: Free Online GUID Generator
2) Tiro único
Si quieres enviar un SMS a un solo número, se enviará individualmente.
- En primer lugar, utilice la solicitud "Enviar un mensaje". Puede obtener más detalles sobre esta solicitud en: Blip Docs | API Reference
- Cambie el campo "para" por el siguiente patrón. Este campo indica a quién quiere enviar el mensaje:
| IDD + DDD (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 "contenido", que representa el contenido del mensaje, añada el texto del mensaje deseado.
5) Seleccione la opción "POST" para establecer el tipo de solicitud y enviar.
6) Su solicitud seguirá el siguiente modelo:
6) Ya está, ¡ha realizado un disparo de SMS a través de la API!
3) Disparos múltiples:
Si quieres enviar un SMS a varios números, tu disparo será a varios contactos.
- Cree una lista de distribución utilizando la solicitud "Crear una lista", método POST. Puede obtener más detalles sobre esta solicitud en: Blip Docs | API Reference
- Con la lista creada, añada los usuarios que desee impactar utilizando la solicitud "Añadir un miembro a una lista" siguiendo el formato que se indica a continuación. Puedes encontrar más detalles sobre esta solicitud en: Blip Docs | API Reference.
- Para enviar el mensaje, utilice la solicitud "Enviar un mensaje" con el nombre completo de la lista creada en el campo "para" y el contenido del mensaje en el campo "contenido”: Blip Docs | API Reference.
- Ya está, ¡ha realizado un disparo de SMS a través de la API!
Mejores prácticas para el canal SMS
1) Activar los SMS en un chatbot exclusivo para SMS
Para facilitar el control de los mensajes, recomendamos que el flujo de SMS sea exclusivo de un chatbot de SMS, es decir, no se recomienda activar los SMS en un chatbot que tenga flujo de WhatsApp. En ese caso, crea un chatbot independiente sólo para el flujo de SMS.
Si activas el SMS en un chatbot que tiene un flujo de WhatsApp y activas un componente interactivo, como botones o contenido dinámico, como estos componentes no existen en el SMS y ambos canales están usando el mismo flujo, el componente no se enviará en el formato esperado y aún se te podrán cobrar más mensajes debido a la cantidad de caracteres que este comportamiento generará. Así, el mensaje no funcionará como se esperaba, será demasiado largo y seguirá teniendo varios caracteres especiales que se contabilizarán económicamente.
| Tipos de mensajes permitidos en los SMS | Tipos de mensajes no permitidos en los SMS |
| Textos | Botones |
| Imágenes* | Quick Reply |
| Vídeo | Menú |
| Enlace web | Audio |
| Carrusel | |
| Busque en | |
| Ubicación | |
| Dynamic Content |
*Fotos y vídeos: se envían a través de un enlace que redirige a la foto/vídeo que has enviado.
2) Para enviar sólo mensajes activos, no se requiere un flujo de chatbot
Si sólo quieres enviar mensajes a tu usuario, sin necesidad de recibir las respuestas a ese mensaje, sólo tienes que hacer la activación de tu SMS en un chatbot que no tenga un flujo en Builder. Si existe dicho flujo, esperando las respuestas del usuario y continuando la "conversación" entre el cliente y el chatbot, el pago será contabilizado debido a la continuidad de los mensajes enviados.
Para obtener más información, acceda a la discusión sobre el tema en nuestra comunidad o los videos en nuestro canal. 😃