Exporter et planifier les rapports d’utilisation des transactions SMS et téléphoniques

Générez des rapports CSV planifiés pour suivre l’utilisation des SMS et de WhatsApp, surveiller les quotas et analyser la consommation par groupe.

Les exports d’utilisation des transactions offrent une visibilité sur l’activité SMS et WhatsApp de votre compte, y compris les quantités achetées, les totaux de consommation et l’utilisation au niveau du groupe. Ces exportations comprennent :

• Authentification par SMS
• Diffusion SMS
• Authentification par WhatsApp
• Transactions de diffusion WhatsApp .

Les exports sont générés sous forme d’instantanés planifiés, et non de requêtes en temps réel. Utilisez les plannings pour une surveillance continue, ou préparez manuellement l’export pour le régénérer lorsque vous avez besoin de données mises à jour immédiatement.

Fonctionnement des exports de données

Les données de transaction sont exportées sous forme de fichiers CSV dans une période définie et avec des filtres spécifiés.

• Les exports sont générés de manière asynchrone et ne sont pas en temps réel.
• Les exports sont actualisés selon un planning configuré.
• Sélectionner Préparer permet de régénérer l’export avec les dernières données disponibles.

Chaque ligne du CSV représente un seul accord et inclut les données d’utilisation des transactions SMS et WhatsApp.

Création d’un rapport d’utilisation des transactions

Créez un rapport CSV depuis l’onglet Rapports .

L’export est généré de manière asynchrone et apparaît dans la liste Rapports récents une fois qu’il est terminé.

Configuration des données précises au niveau du groupe

L’utilisation au niveau du groupe nécessite à la fois le filtrage et la sélection de colonnes.

• Appliquez un ou plusieurs filtres de groupe lors de la définition de l’export.
• Incluez la colonne Groupe d’expéditeurs dans l’export.

Si l’une ou l’autre de ces exigences n’est pas respectée, l’utilisation au niveau du groupe ne sera pas représentée avec précision dans les données exportées.

Vérification de la précision des données d’utilisation du contrat

Pour générer un rapport sur la période de contrat appropriée :

• Utilisez la date (début) effective de quota téléphonique comme date de début du rapport.
• Cette valeur est disponible dans : Paramètres de compte > Paramètres d’envoi

L’utilisation de la date de début correcte garantit que toutes les transactions sous le contrat actuel sont incluses et que les totaux d’utilisation et les résumés au niveau du groupe sont précis.

Planification d’un rapport

Planifiez un rapport pour générer automatiquement des données de transaction mises à jour.

Les rapports programmés sont générés automatiquement et peuvent être téléchargés depuis la liste Rapports récents ou livrés par e-mail.

Mise à jour d’un export avec les dernières données

Pour mettre à jour un export :

• Sélectionnez Préparer pour régénérer l’export immédiatement.
• Ou attendez la prochaine exécution planifiée.
• Vous pouvez également créer un nouvel export avec les mêmes paramètres si nécessaire.

Téléchargement d’un export via l’API

Récupérez le dernier export généré via l’API.

• Point d’entrée : POST /api/rest/v6/reportDownload
• Paramètre requis : scheduleId

Point d’entrée :

• Nécessite un planning d’export créé dans l’interface utilisateur des rapports.
• Renvoie l’URL de téléchargement pour le fichier CSV le plus récent uniquement.
• Ne génère pas de nouvel export à la demande.

Si l’export n’a pas été mis à jour, le fichier CSV généré précédemment est renvoyé.

Lors du téléchargement de fichiers CSV volumineux, le traitement peut prendre plus de temps car tous les enregistrements doivent être préparés. Configurez une temporisation client d’au moins 5 minutes pour garantir des téléchargements réussis.

Disponibilité et conservation des exports

• Les fichiers CSV exportés sont stockés pendant 7 jours.
• Après 7 jours, le fichier expire et n’est plus disponible au téléchargement.
• Pour accéder aux données mises à jour, régénérez l’export en utilisant Préparer ou attendez la prochaine exécution planifiée.

Ce qu’il faut savoir

• Les exports doivent être créés ou planifiés avant de pouvoir être accessibles par l’API.
• Seul le fichier CSV le plus récent d’un planning est disponible via l’API.
• La création de rapports au niveau du groupe nécessite à la fois :
  • Un filtre de groupe
  • La colonne Groupe d’expéditeur
• L’utilisation de la date (début) effective de quota téléphonique correcte est requise pour le reporting précis au niveau du contrat.
• Les fichiers d’export expirent après 7 jours et doivent être régénérés si nécessaire.

Articles connexes

• Vue d’ensemble des rapports
• Créer des exports de données
• Actualiser un export de données
• Planification des exports de données
• Télécharger un export de données