Exporter les statistiques de votre chat

De quoi s'agit-il ?

Deux adresses en lecture seule donnent les chiffres du chat de votre boutique, une ligne par jour : conversations, messages, paniers, achats, chiffre d'affaires généré par le chat, questions sans réponse, messages proactifs, avis, et combien de personnes ont vu et ouvert le chat. L'adresse CSV fonctionne dans Google Sheets, Excel et Power BI. L'adresse JSON fonctionne dans Make, Zapier, n8n et vos propres scripts. Les outils qui lisent Google Sheets, comme Looker Studio ou Swydo, peuvent partir de la feuille.

Créer une clé

1. Dans le tableau de bord Emporiqa, ouvrez Settings > Reporting.
2. Donnez à la clé le nom de la feuille ou de l'outil auquel elle est destinée, puis cliquez sur Create key. Si votre dernière connexion date de plus de 15 minutes, il vous sera d'abord demandé de vous reconnecter.
3. Copiez tout de suite la clé, ou la formule Google Sheets toute prête. La clé ne s'affiche qu'une seule fois.

Seuls les propriétaires de la boutique peuvent créer et révoquer des clés. Une boutique peut avoir jusqu'à 5 clés. Une clé ne lit que des chiffres : elle ne peut rien modifier et ne donne jamais accès aux conversations, aux questions, aux noms ni aux e-mails.

Les adresses

Envoyez la clé dans l'en-tête Authorization: Bearer VOTRE_CLE, ou ajoutez ?key=VOTRE_CLE à l'adresse. Dans Make, Zapier ou n8n, utilisez l'en-tête : la clé n'apparaît pas dans l'adresse. Une formule de tableur, elle, ne peut passer que par l'adresse.

Choisir les jours

Sans date, vous obtenez les 30 derniers jours. Les jours sont des jours UTC. La journée en cours est incluse, avec ses chiffres à l'heure actuelle.

• range=7d, range=30d ou range=90d : les 7, 30 ou 90 derniers jours, aujourd'hui compris.
• range=mtd : le mois en cours jusqu'à aujourd'hui.
• range=last_month : tout le mois dernier.
• from=2026-10-01&to=2026-10-31 : les jours de votre choix, au format YYYY-MM-DD.

Les conversations sont conservées 90 jours : from peut donc remonter au plus à 89 jours avant aujourd'hui, et to ne peut pas dépasser aujourd'hui.

Une période que l'export ne peut pas fournir est refusée, jamais remplacée par d'autres dates : vous recevez le statut 400 et un message clair qui dit quoi corriger, par exemple « from must be 2026-08-08 or later: conversations are kept for 90 days ». Avec une clé absente, erronée ou révoquée, vous recevez le statut 401.

Les colonnes

Chaque jour de la période a sa ligne, avec 0 quand il ne s'est rien passé. Les chiffres ont le même sens que sur votre tableau de bord : additionnez les lignes de plusieurs jours et vous obtenez les chiffres du tableau de bord pour ces mêmes jours.

date

Le jour, en UTC, au format YYYY-MM-DD.

conversations

Les conversations commencées par des clients ce jour-là. Vos propres chats de test ne sont pas comptés.

messages

Tous les messages de ces conversations : ceux du client, ceux de votre assistant IA de boutique, ceux de votre équipe et les notifications du chat lui-même, comme sur le tableau de bord.

shopper_messages

Seulement les messages écrits par le client dans ces conversations. Ce chiffre ne figure pas sur le tableau de bord.

conversations_with_cart

Parmi les conversations commencées ce jour-là, combien ont ajouté un produit au panier.

purchases

Parmi les conversations commencées ce jour-là, combien ont abouti à une commande, même passée plusieurs jours plus tard.

revenue_from_chat

Le montant des commandes issues d'une conversation, compté le jour où la commande est arrivée, dans la devise indiquée par revenue_currency.

revenue_currency

La devise qui pèse le plus dans le chiffre d'affaires généré par le chat sur toute la période, identique sur chaque ligne. Les commandes envoyées sans devise y sont comptées, comme sur le tableau de bord. Vide quand aucune commande venue du chat sur la période n'indique de devise.

unanswered_questions

Les questions posées ce jour-là auxquelles vos pages n'ont pas répondu. Aucune n'est enregistrée tant que Handoff est désactivé.

unanswered_still_open

Le nombre de ces questions que vous n'avez pas encore marquées comme résolues.

proactive_shown

Les messages de vos déclencheurs proactifs affichés aux clients ce jour-là.

proactive_clicked

Le nombre de ces messages sur lesquels les clients ont cliqué.

proactive_closed

Le nombre de ces messages que les clients ont fermés.

proactive_sent_message

Le nombre de ces messages après lesquels le client a envoyé un message.

rated_helpful

Les avis « pouce levé » donnés ce jour-là.

rated_unhelpful

Les avis « pouce baissé » donnés ce jour-là.

chat_seen_by

Les personnes qui ont vu le bouton du chat ce jour-là. Une personne qui revient un autre jour est comptée à nouveau ce jour-là.

chat_opened_by

Les personnes qui ont ouvert le chat ce jour-là.

Si les commandes venues du chat sont arrivées dans plusieurs devises, chaque autre devise a sa propre colonne après celles-ci, par exemple revenue_from_chat_USD. Les devises ne sont jamais additionnées entre elles.

Le JSON donne les mêmes lignes sous days, avec from et to (les jours couverts), les totaux de la période, des taux calculés à partir de ces totaux, et unanswered_open_now : les questions des 30 derniers jours encore ouvertes en ce moment (la liste que votre tableau de bord affiche tant que Handoff est activé). Dans totals, revenue_from_chat est une liste de devises, chacune avec son montant, et un taux vaut null (aucune valeur) quand le dénominateur est 0. Une erreur revient sous la forme {"error": "la raison"} en JSON et en texte brut depuis l'adresse CSV.

Mise en place

=IMPORTDATA("https://emporiqa.com/reports/v1/daily.csv?key=VOTRE_CLE&range=last_month")

https://emporiqa.com/reports/v1/daily.csv?key=VOTRE_CLE&range=last_month

GET https://emporiqa.com/reports/v1/daily.json?range=last_month
Authorization: Bearer VOTRE_CLE

Bon à savoir

• Les chiffres des jours passés peuvent encore augmenter. Un achat compte le jour où sa conversation a commencé, et son montant le jour où la commande est arrivée : une commande passée quelques jours après un chat fait donc monter une ligne plus ancienne. Pour un mois complet, récupérez les chiffres environ une semaine après sa fin.
• Sur les jours passés, unanswered_still_open baisse à mesure que vous marquez des questions comme résolues.
• L'export remonte au plus à 90 jours. Pour garder un historique plus long, configurez Make ou Zapier pour ajouter chaque jour la ligne de la veille à une feuille.
• Une clé placée dans une formule Google Sheets est visible par toute personne qui voit la feuille. Donnez à chaque feuille ou outil sa propre clé, et révoquez-la dans Settings > Reporting quand vous n'en avez plus besoin : elle cesse aussitôt de fonctionner.
• Les montants utilisent le point comme séparateur décimal, par exemple 1250.50. Si votre tableur utilise la virgule (réglages français ou allemands), choisissez des paramètres régionaux anglophones pour la feuille Google Sheets qui importe les données, dans Fichier > Paramètres, ou, dans Excel et Power BI, définissez le type de la colonne avec Utilisation des paramètres régionaux > Anglais (États-Unis) : sinon les montants sont mal lus.
• Les chiffres peuvent avoir jusqu'à 5 minutes de retard.

Limites

• 120 requêtes par heure pour chaque clé, et 600 par heure pour chaque boutique.
• Au-delà d'une limite, vous recevez le statut 429, avec un en-tête Retry-After qui indique combien de secondes attendre.
• Depuis une même adresse, après 60 requêtes avec une clé erronée en 10 minutes, vous recevez aussi le statut 429.
• Jusqu'à 5 clés par boutique.