Webhook de cuenta

En esta modalidad, la URL de tu endpoint receptor queda configurada en tu cuenta. No se envía en la petición: Inalambria ya sabe a dónde notificar cada vez que envías un mensaje con esa cuenta.

Se utiliza con el endpoint POST /mtmessage.

Esta página describe una petición que Inalambria hace hacia tu servidor. Tú implementas el receptor; no es un endpoint que puedas consumir.

1. Solicitar la configuración

Escribe a [email protected] indicando:

📌

La configuración no es inmediata. Una vez aplicada, puede tardar hasta 10 minutos en estar activa.

2. Autenticación de tu endpoint receptor

Inalambria admite dos formas de autenticarse contra tu servidor.

Autenticación Basic. Inalambria envía el encabezado Authorization en cada notificación:

Authorization: Basic dXN1YXJpbzpjb250cmFzZW5h

Para usarla, indica a soporte el usuario y la contraseña que tu endpoint espera.

Parámetro en la URL. La URL se usa exactamente como la registres, así que puedes incluir un token en la cadena de consulta:

https://miservidor.com/notificaciones?token=TU_TOKEN

No se admiten otros mecanismos. Si tu endpoint requiere un esquema distinto, consúltalo previamente con soporte.

3. Enviar el mensaje

Al consumir POST /mtmessage puedes incluir dos campos opcionales cuyo único propósito es que te sean devueltos en la notificación. No intervienen en el procesamiento del mensaje.

Esta tabla solo recoge los campos relacionados con la notificación. Consulta todos los campos del envío en la página del endpoint.

curl -X POST https://rest.inalambria.com/mtmessage \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer XXXXXXXXXXXXXXX" \
  -d '{
    "Type": 1,
    "MessageText": "Mensaje de texto enviado por Inalambria, ejemplo de notificación de estado",
    "Devices": "573001234567",
    "CustomMessageId": "PEDIDO-4471",
    "CallbackData": { "campo1": "valor1", "campo2": "valor2" }
  }'

⚠️

CallbackData se envía aquí como objeto. En POST /mtmessage/massive el campo equivalente se envía como texto. No son intercambiables.

Se recomienda que CallbackData no supere los 200 caracteres una vez convertido a texto.

4. Qué campo de tu petición llega en cada campo de la notificación

📌

Se realiza una petición por cada mensaje, no una por transacción. El array results contiene siempre un único elemento.

Qué debe responder tu endpoint receptor

Responde con un código 2xx. El cuerpo no se interpreta, pero sí se registra.

503 es el único código que provoca un reintento. Si respondes 500, la notificación se pierde.

Recomendaciones: responde rápido y acusa recibo antes de procesar; sé idempotente usando transactionNumber junto con to; y no asumas que las notificaciones llegan ordenadas.