Journaux de l'API SMS

La page Journaux de l'API SMS vous permet de rechercher et de dépanner les messages SMS envoyés par l'intermédiaire de l'API SMS. Cette page permet d'étudier les problèmes de livraison, de vérifier l'état des messages et de télécharger les journaux en vue d'une analyse plus approfondie.

Remarque : Si vous envoyez des SMS par l'intermédiaire du Messages API, utiliser le Messages API Logs au lieu de cela.

Avant de commencer

  • Les journaux de SMS sont disponibles pour 30 jours seulement
  • Pour les journaux datant de plus de 30 jours, utilisez la fonction Reports API
  • Il y a un délai de quelques minutes avant que les journaux n'apparaissent.
  • Mettre en place un Réception de la livraison webhook pour des mises à jour en temps réel

Accès au journal des SMS

  1. Se connecter à l'application Tableau de bord de l'API Vonage
  2. Naviguez jusqu'à Journaux de l'API SMS
SMS Logs

Méthodes de recherche

La page des journaux de l'API SMS propose cinq méthodes de recherche :

Plage de temps

Rechercher des messages au cours d'une période spécifique afin d'étudier les performances ou de surveiller le trafic.

Filtres disponibles :

  • Durée - Dernière heure, dernières 24 heures, derniers 7 jours, derniers 30 jours ou plage personnalisée
  • Direction - Messages sortants ou entrants

Numéro de téléphone

Recherchez les messages envoyés à ou depuis des numéros de téléphone spécifiques pour enquêter sur les problèmes des clients ou vérifier la livraison à un destinataire particulier.

Filtres disponibles :

  • Numbers "à - Le numéro de téléphone de destination
  • De - L'identifiant ou le numéro de téléphone de l'expéditeur
  • Durée - Date d'envoi du message
  • Direction - Sortie ou entrée

Conseil : Utilisez le format international (code du pays + numéro) pour les numéros de téléphone.

ID du message

Recherchez un ou plusieurs messages spécifiques à l'aide de leur numéro d'identification unique. Cette méthode est idéale lorsque vous disposez d'identifiants de messages provenant de réponses d'API ou de webhooks.

Filtres disponibles :

  • ID des messages - Un ou plusieurs ID de message séparés par des virgules
  • Direction - Sortie ou entrée

Crochet Web

Dépanner les rappels de réception de livraison (DLR) et les webhooks de messages entrants pour s'assurer que votre application reçoit correctement les mises à jour d'état.

Filtres disponibles :

  • Direction - Rappel sortant (statut DLR) ou rappel entrant
  • Durée - Date d'envoi du webhook
  • Numéro de destinataire - Le numéro de téléphone pour la livraison du webhook (par exemple, 447777889900)

Important : Les journaux des webhooks indiquent si Vonage a réussi à transmettre le rappel à votre serveur, et non pas si votre serveur l'a traité correctement.

Non envoyé

Trouver les messages qui ont été rejetés par la plateforme de Vonage avant d'être livrés. Ces messages n'ont pas été programmés pour la livraison, n'ont pas de statut DLR et ne sont pas facturés.

Filtres disponibles :

  • Numbers "à - Le numéro de la destination prévue
  • De - L'identifiant ou le numéro de l'expéditeur
  • Durée - Lorsque le message a été rejeté

Travailler avec des résultats

SMS Logs

Visualisation des détails du journal

Chaque entrée du journal contient des informations clés sur le message :

  • ID du message - Identifiant unique du message
  • De - ID de l'expéditeur ou numéro de téléphone
  • Pour - Numéro de téléphone de destination
  • Statut - État de la livraison (soumise, livrée, échouée, etc.)
  • L'heure - Date d'envoi du message ou de mise à jour de l'état
  • Réseau - Opérateur de réseau mobile
  • Prix - Coût du message

Cliquez sur une entrée du journal pour afficher tous les détails, y compris les codes d'erreur et les informations sur le réseau.

Téléchargement des journaux

Exporter les résultats de la recherche au format CSV pour une analyse hors ligne ou la tenue d'un registre.

Pour télécharger les journaux :

  1. Effectuer une recherche en utilisant n'importe quelle méthode
  2. Cliquez sur Télécharger le CSV
  3. Le fichier CSV comprendra tous les champs des résultats de la recherche.

Remarque : Les téléchargements CSV sont limités aux résultats affichés. Pour les exportations en masse ou l'accès programmatique, utilisez la fonction Reports API.

Comprendre les délais d'enregistrement

  • Journaux réguliers : Disponible dans les 2 à 5 minutes suivant l'envoi
  • Les récépissés de livraison : Dépend du calendrier de l'opérateur de réseau (de quelques secondes à quelques heures)
  • Mises à jour en temps réel : Utilisation Webhooks de réception des livraisons au lieu de

Pour en savoir plus