Mensaje SMS Bidireccional

Esta API permite el envío de mensajes por código corto. Los desarrolladores pueden interactuar con este servicio utilizando el endpoint proporcionado, enviando un payload en formato JSON.

{
    "MessageText": "Queremos contactarte y contarte lo nuevo que tenemos. Responde 1 para Si, 2 Para No",
    "PhoneNumber": "573XXXXXXXXX",
    "ShortCode": "12345"
}

Reglas y requisitos

  • Al igual que el servicio unidireccional, es necesario contar con la configuración de la cuenta establecida, para hacer el consumo del servicio bidireccional.
  • El cliente previamente debe tener un código corto asignado.

Posibles Campos a Enviar en la Petición

Al consumir nuestro servicio, tenemos los siguientes campos a enviar:

Nombre¿Obligatorio?DescripciónTipo de Dato
MessageTextMensaje de texto.Texto
PhoneNumberNúmero de celular destino.Texto
ShortCodeCódigo corto desde el cual se enviará el mensaje.Texto
UrlNoURL larga a acortar e insertar en el mensaje a enviar.Texto

Posibles Estados HTTP de Respuesta

  • 200: Mensaje recibido y en procesamiento.
  • 400: Estructura de payload inválida.
  • 401: No autorizado. Es necesario verificar las credenciales de autenticación.
  • 403: Permisos insuficientes. Es posible que las credenciales estén validas, pero no se tiene permitido acceder al recurso (por ejemplo, la petición de consumo se genera desde una dirección IP no permitida).
  • 500: Error interno del servidor. Se recomienda intentar en unos minutos, o en su defecto, contactar el servicio de soporte de Inalambria Internacional.

Campos de Respuesta

En la respuesta obtenida al consumir nuestro servicio, se encuentran los siguientes campos:

NombreDescripciónTipo de Dato
IdNúmero de transacción, con el cual es posible consultar el estado de los envíos.Número de 28 dígitos
MessageSi el mensaje fue recibido de manera correcta, el valor de este campo será la palabra OK. Si ocurrió algún fallo en la validación, el valor de este campo será la palabra ERROR.Texto
StatusSi el mensaje fue recibido de manera correcta, el valor de este campo será True. Si ocurrió algún fallo en la validación, el valor de este campo será False.Booleano
Language
URL
Click Try It! to start a request and see the response here!