Rapports de statut

Vous pouvez utiliser les rapports de statut pour suivre la livraison réussie d'un SMS et le moment respectif. Il y a fondamentalement deux options : La méthode beaucoup plus efficace et rapide est un webhook directement vers votre serveur. Dès qu'un nouveau statut est disponible, votre URL souhaitée est automatiquement appelée. La méthode alternative consiste à interroger le statut des SMS directement via une requête à l'API. S'il n'y a pas encore de statut, vous devrez peut-être le demander à nouveau plus tard. Veuillez utiliser les webhooks de préférence. Les deux variantes peuvent également être combinées, par exemple si le webhook échoue.

SMS Flowchart

Vous ne recevrez des mises à jour que pour les rapports de statut qui ne sont pas internes (Created, Queued, Processed) mais qui ont été envoyés par l'opérateur réseau :

Rapport de statut	Explication	Statut final
`DELIVERED`	Le SMS a été livré avec succès.
`NOTDELIVERED`	Le SMS n'a pas pu être livré. Veuillez vérifier le numéro du destinataire si nécessaire.
`BUFFERED`	Le SMS a été envoyé avec succès, mais a été temporairement stocké par le SMSC car le destinataire ne peut être joint.
`TRANSMITTED`	Le SMS a été envoyé par le SMSC et devrait arriver bientôt.
`ACCEPTED`	Le SMS a été accepté par le SMSC.
`EXPIRED`	Le SMS n'a pas été reçu avant l'expiration de la période de validité.
`REJECTED`	Le SMS a été rejeté par l'opérateur.
`FAILED`	Une erreur s'est produite lors de l'envoi.

Selon l'opérateur réseau, différents rapports de statut peuvent être envoyés. La plupart des opérateurs réseau n'envoient jamais un statut BUFFERED. Techniquement parlant, le statut "DELIVERED" est une réponse directe de l'appareil final, mais certains réseaux cibles peuvent renvoyer des rapports de statut incorrects. Malheureusement, nous n'avons aucune influence sur cela.

Rapports de statut via webhook

Idéalement, vous devriez vous abonner aux mises à jour SMS via Webhook. C'est la meilleure et la plus rapide façon de recevoir des rapports de statut. Si ce n'est pas possible pour des raisons techniques, par exemple parce que vous n'avez pas de serveur publiquement accessible, vous pouvez demander les rapports de statut via l'API.

GET/api/statusDeprecated

Interroger les rapports de statut

Interroger le statut d'un SMS. Cette requête est possible pendant un maximum de 30 jours après l'envoi d'un SMS. Veuillez noter que cette API est dépréciée et pourrait bientôt être désactivée. Utilisez plutôt Interroger le carnet de bord avec l'ID du message comme paramètre.

Paramètre

Name
msg_id
Type
string
Description
L'ID du SMS pour lequel vous voulez interroger le statut. Plusieurs IDs peuvent être spécifiés, chacun séparé par une virgule.

Requête

GET

/api/status

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

Réponse

[
    {
        "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"
    }
]