Guía de inicio rápido de códigos cortos de Atmosphere® SMS Messaging

Perspectiva general

Para lograr clientes más comprometidos dentro del mundo móvil actual, es necesario ir más allá de las comunicaciones de voz básicas. Con Atmosphere® Messaging, usted podrá habilitar los números de teléfono de su empresa para enviar y recibir SMS, lo cual se está convirtiendo rápidamente en el método de comunicación preferido. Los SMS se pueden enviar de varias formas en todo el mundo. En los EE.UU., IntelePeer soporta el envío a través de un Código Corto Dedicado Personalizado o Dedicado Aleatorio, ambos habilitados para comunicaciones bidireccionales.

Fuera de los Estados Unidos, las opciones de mensajería incluyen códigos cortos bidireccionales, códigos largos bidireccionales, y mensajes unidireccionales.


Guía de inicio

Bien, solicité un código corto. ¿Qué debo hacer ahora?

 

  1. Luego de haber hecho su pedido en el portal de clientes de IntelePeer, la aprobación de su campaña podrá tomar entre 6 y 14 semanas.
  2. IntelePeer construirá un SmartFlow para facilitar el testeo y aprobación de su campaña, basado en el formulario de campaña que usted envíe. Sin embargo, deberá utilizar este tiempo para integrarse a la API de IntelePeer para empezar a probar su código y poder usar su campaña tan pronto como sea aprobada.

 

Empecemos a programar

 

  1. Primero necesitará obtener un token de Autorización. Esto se puede hacer a través de la API; sin embargo, debe tener en cuenta que los tokens adquiridos a través de la API expirarán cada 24 horas, por lo que será necesario obtener nuevos tokens. Ok, obtengamos nuestro token.

  • IntelePeer soporta muchos de los lenguajes de programación más conocidos, pero si no tiene mucha experiencia con las API, podría utilizar un programa como Postman o cURL para enviar sus comentarios también.
  • Enviaremos un comando POST al terminal de autorización de IntelePeer SMS: https://api.intelepeer.com/_rest/v4/app/sms/authenticate/get_portal_auth_token
  • Al utilizar cURL, el comando lucirá de la siguiente manera:

 

curl -X POST  https://api.intelepeer.com/sms/v4/authenticate/get_portal_auth_token 
-H 'Content-Type: application/json'
-d '{ 
           "username":"USER_NAME",
           "password":"PASSWORD"
}'

  • USERNAME y PASSWORD deberán reemplazarse con su nombre de usuario y contraseña de IntelePeer. Deberá utilizar un usuario de Intelepeer con acceso a SMS, tal como se establece en el portal de IntelePeer.
  • Una vez que haya ejecutado el comando anterior, recibirá una respuesta como la siguiente:

 

{
"token": "xxxxxxxx",
"expires": "2019-03-08 03:30:34"
}

Donde «xxxxxxxxx» es el token que podrá utilizar para autenticarse al acceder a los comandos de la API y enviar mensajes y donde «expires» es la hora GMT en la que el token expirará y dejará de funcionar.

 

3. Ahora, a enviar un mensaje. En el siguiente texto, sustituya TOKEN por el token que recibió de la solicitud de autenticación:

 

curl -X POST 
https://api.intelepeer.com/_rest/v4/app/sms/send
-H 'Authorization: TOKEN'
-H 'Content-Type: application/json'
-d '{
           "from":"1-55555",
           "to":"+13035551212",
           "text":"Hello!"
}

4. Recibirá una respuesta como la siguiente:

 

{
"state": "Queued",
"code": 202,
"refid": "REFERENCE_ID_HERE",
"numparts": 1
}

5. Su destinatario debería recibir su mensaje en breve. ¡Felicidades! ¡Acaba de enviar su primer mensaje usando la plataforma IntelePeer!