Informes de estado

A través de los informes de estado, puede verificar la entrega exitosa de un SMS y el momento respectivo. Básicamente, tiene dos opciones: el método mucho más eficiente y rápido es un Webhook directamente a su servidor. Tan pronto como haya un nuevo estado disponible, se llamará automáticamente a la URL deseada. El método alternativo es consultar directamente el estado de los SMS a través de una solicitud a la API. Si aún no hay un estado disponible, es posible que deba consultar nuevamente más tarde. Por favor, utilice preferiblemente los Webhooks. Ambas variantes también se pueden combinar, por ejemplo, en caso de que el Webhook falle.

SMS Flowchart

Recibirá actualizaciones exclusivamente para informes de estado que no sean internos (Created, Queued, Processed), sino que hayan sido enviados por el operador de red:

Informe de estado	Explicación	Estado final
`DELIVERED`	El SMS fue entregado con éxito.
`NOTDELIVERED`	El SMS no pudo ser entregado. Por favor, verifique el número del destinatario si es necesario.
`BUFFERED`	El SMS fue enviado con éxito, pero fue almacenado temporalmente por el SMSC ya que el destinatario no está disponible.
`TRANSMITTED`	El SMS fue enviado por el SMSC y debería llegar pronto.
`ACCEPTED`	El SMS fue aceptado por el SMSC.
`EXPIRED`	El SMS no fue recibido antes de que expirara el período de validez.
`REJECTED`	El SMS fue rechazado por el operador.
`FAILED`	Ocurrió un error durante el envío.

Dependiendo del operador de red, se pueden enviar diferentes informes de estado. La mayoría de los operadores nunca envían un estado BUFFERED. Técnicamente, el estado DELIVERED es una respuesta directa del dispositivo final, sin embargo, en algunas redes de destino, se pueden devolver informes de estado incorrectos. Lamentablemente, no tenemos control sobre esto.

Informes de estado por Webhook

Idealmente, debería suscribirse a actualizaciones de un SMS a través de Webhook. Esta es la mejor y más rápida manera de recibir los informes de estado. Si esto no es posible por razones técnicas, por ejemplo, porque no tiene un servidor accesible públicamente, puede consultar los informes de estado a través de la API.

GET/api/statusObsoleto

Consultar informes de estado

Consulte el estado de un SMS. Esta consulta es posible hasta 30 días después del envío de un SMS. Tenga en cuenta que esta API está obsoleta y pronto podría desactivarse. En su lugar, utilice la consulta del registro con el ID del mensaje como parámetro.

Parámetros

Name
msg_id
Type
string
Description
El ID del SMS cuyo estado desea consultar. Se pueden especificar varios IDs separados por comas.

Anfrage

GET

/api/status

curl -G https://gateway.seven.io/api/status \
    -H "X-Api-Key: IHR_API_SCHLÜSSEL" \
    -H "Accept: application/json"
    -d "msg_id=77232007287,77232007195"

Antwort

[
    {
        "id": "77232007287",
        "status": "DELIVERED",
        "status_time": "2024-02-16 15:43:16.905"
    },
    {
        "id": "77232007195",
        "status": "DELIVERED",
        "status_time": "2024-02-16 15:42:19.989"
    }
]