Obtenir l'enregistrement du message avec le dernier état de livraison
Il existe de nombreux scénarios dans lesquels vous pouvez vouloir stocker les données de l'API Reports dans votre propre base de données. Ce guide explique trois méthodes différentes pour récupérer le dernier état de livraison (livré ou non livré) des messages envoyés à l'aide des API de Vonage.
Il est important de noter que l'état final de la livraison d'un message donné est généralement disponible en quelques minutes. Toutefois, dans de rares cas, cela peut prendre jusqu'à 72 heures.
Il existe trois façons différentes d'obtenir l'enregistrement de message avec le dernier état de livraison. La première méthode consiste à utiliser l'API Reports, que nous recommandons, et il existe également deux autres méthodes que vous pouvez envisager :
- Utilisation de Reports API
- Utilisation de l'ID du message du magasin
- Utilisation de Webhooks et de Reports API
Utiliser Reports API (recommandé)
Cette méthode est la plus efficace pour obtenir l'enregistrement du message avec le dernier état de livraison. C'est non seulement la plus simple, mais elle ne nécessite pas non plus de stocker des données ou des identifiants dans votre espace de stockage. Suivez les étapes ci-dessous pour l'exécuter :
- Obtenir des enregistrements pour une période donnée à l'aide de la fonction point de terminaison synchrone ou le point de terminaison asynchroneet les conserver dans votre entrepôt (si nécessaire).
- Pour les enregistrements qui n'ont pas encore atteint leur état final, vous pouvez vérifier leur statut par
id. - Mettez à jour les enregistrements que vous avez stockés à l'étape 1 à l'aide de la fonction point de terminaison synchrone ou le point de terminaison asynchrone avec le statut actuel.
Utilisation de Store Message ID
Cette méthode est une alternative que vous pouvez utiliser. Cependant, sachez qu'elle n'est peut-être pas la meilleure option pour les utilisateurs ayant un trafic plus important. Suivez les étapes ci-dessous pour l'exécuter :
- Enregistrez l'ID du message dans votre base de données.
- Appeler Reports API par
idpour chaque message afin de vérifier le dernier état.
Utilisation de Webhooks et de Reports API
Il s'agit de la deuxième méthode alternative que vous pouvez utiliser. Dans ce cas, vous devez savoir qu'elle effectue un contrôle de la délivrabilité, mais qu'elle ne stocke pas les données avec l'état réel dans le stockage. Suivez les étapes ci-dessous pour l'exécuter :
- Utiliser un callback/webhook pour les SMS API ou pour le Messages API pour être informé de la modification de l'état de chaque message.
- Utilisez l'API Reports pour recouper et stocker les données avec le statut final.