post https://rest.inalambria.com/momessage
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ón | Tipo de Dato |
---|---|---|---|
MessageText | Sí | Mensaje de texto. | Texto |
PhoneNumber | Sí | Número de celular destino. | Texto |
ShortCode | Sí | Código corto desde el cual se enviará el mensaje. | Texto |
Url | No | URL 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:
Nombre | Descripción | Tipo de Dato |
---|---|---|
Id | Número de transacción, con el cual es posible consultar el estado de los envíos. | Número de 28 dígitos |
Message | Si 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 |
Status | Si 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 |