Chat-Statistiken exportieren

Worum es geht

Zwei Adressen liefern die Chatzahlen Ihres Shops, eine Zeile pro Tag, nur zum Lesen: Gespräche, Nachrichten, Warenkörbe, Käufe, Umsatz aus dem Chat, unbeantwortete Fragen, proaktive Nachrichten, Bewertungen und wie viele Personen den Chat gesehen und geöffnet haben. Die CSV-Adresse funktioniert in Google Sheets, Excel und Power BI, die JSON-Adresse in Make, Zapier, n8n und Ihren eigenen Skripten. Tools, die Google Sheets lesen, etwa Looker Studio oder Swydo, können die Tabelle verwenden.

Schlüssel erstellen

1. Öffnen Sie im Emporiqa-Dashboard Settings > Reporting.
2. Benennen Sie den Schlüssel nach der Tabelle oder dem Tool, für das er gedacht ist, und klicken Sie auf Create key. Liegt Ihre letzte Anmeldung mehr als 15 Minuten zurück, werden Sie zuerst gebeten, sich erneut anzumelden.
3. Kopieren Sie den Schlüssel oder die fertige Google-Sheets-Formel sofort. Der Schlüssel wird nur ein einziges Mal angezeigt.

Nur Shop-Inhaber können Schlüssel erstellen und widerrufen. Ein Shop kann bis zu 5 Schlüssel haben. Ein Schlüssel liest nur Zahlen: Er kann nichts ändern und gibt nie Gespräche, Fragen, Namen oder E-Mail-Adressen heraus.

Die Adressen

Senden Sie den Schlüssel im Header Authorization: Bearer IHR_SCHLUESSEL oder hängen Sie ?key=IHR_SCHLUESSEL an die Adresse an. Nutzen Sie in Make, Zapier oder n8n den Header: So steht der Schlüssel nicht in der Adresse. Eine Tabellenformel kann nur die Adresse verwenden.

Tage auswählen

Ohne Datumsangabe erhalten Sie die letzten 30 Tage. Gezählt wird in UTC-Tagen. Der heutige Tag ist mit dem bisherigen Stand enthalten.

• range=7d, range=30d oder range=90d: die letzten 7, 30 oder 90 Tage, heute eingeschlossen.
• range=mtd: der laufende Monat bis heute.
• range=last_month: der gesamte Vormonat.
• from=2026-10-01&to=2026-10-31: beliebige Tage Ihrer Wahl, im Format YYYY-MM-DD.

Gespräche werden 90 Tage lang aufbewahrt. Deshalb darf from höchstens 89 Tage vor heute liegen und to spätestens heute.

Ein Zeitraum, den der Export nicht liefern kann, wird abgelehnt und nie durch andere Tage ersetzt: Sie erhalten Status 400 und eine verständliche Meldung, was zu ändern ist, etwa „from must be 2026-08-08 or later: conversations are kept for 90 days“. Ein fehlender, falscher oder widerrufener Schlüssel führt zu Status 401.

Die Spalten

Jeder Tag im Zeitraum hat eine Zeile, mit 0, wenn nichts passiert ist. Die Zahlen bedeuten dasselbe wie in Ihrem Dashboard: Addieren Sie die Zeilen für bestimmte Tage, erhalten Sie die Dashboard-Zahlen für dieselben Tage.

date

Der Tag in UTC, im Format YYYY-MM-DD.

conversations

Gespräche, die Kunden an diesem Tag begonnen haben. Ihre eigenen Testchats werden nicht gezählt.

messages

Alle Nachrichten in diesen Gesprächen: die des Kunden, die Ihres KI-Shop-Assistenten, die Ihres Teams und die Hinweise des Chats selbst, wie im Dashboard.

shopper_messages

Nur die Nachrichten, die der Kunde in diesen Gesprächen geschrieben hat. Diese Zahl steht nicht im Dashboard.

conversations_with_cart

In wie vielen der an diesem Tag begonnenen Gespräche ein Produkt in den Warenkorb gelegt wurde.

purchases

Wie viele der an diesem Tag begonnenen Gespräche zu einer Bestellung geführt haben, auch wenn die Bestellung erst Tage später kam.

revenue_from_chat

Der Wert der Bestellungen, die aus einem Gespräch kamen, gezählt am Tag des Bestelleingangs, in der Währung aus revenue_currency.

revenue_currency

Die Währung mit dem höchsten Chat-Umsatz über den gesamten Zeitraum, in jeder Zeile gleich. Bestellungen ohne Währungsangabe werden wie im Dashboard dieser Währung zugerechnet. Leer, wenn im Zeitraum keine Chat-Bestellung eine Währung angegeben hat.

unanswered_questions

Fragen, die an diesem Tag gestellt wurden und die Ihre Seiten nicht beantworten konnten. Solange Handoff ausgeschaltet ist, werden keine erfasst.

unanswered_still_open

Wie viele dieser Fragen Sie noch nicht als erledigt markiert haben.

proactive_shown

Nachrichten Ihrer proaktiven Trigger, die Kunden an diesem Tag angezeigt wurden.

proactive_clicked

Wie viele dieser Nachrichten Kunden angeklickt haben.

proactive_closed

Wie viele dieser Nachrichten Kunden geschlossen haben.

proactive_sent_message

Nach wie vielen dieser Nachrichten der Kunde selbst geschrieben hat.

rated_helpful

Daumen-hoch-Bewertungen von diesem Tag.

rated_unhelpful

Daumen-runter-Bewertungen von diesem Tag.

chat_seen_by

Personen, die an diesem Tag den Chat-Button gesehen haben. Wer an einem anderen Tag wiederkommt, zählt an jenem Tag erneut.

chat_opened_by

Personen, die an diesem Tag den Chat geöffnet haben.

Gingen Chat-Bestellungen in mehr als einer Währung ein, erhält jede weitere Währung danach eine eigene Spalte, etwa revenue_from_chat_USD. Währungen werden nie zusammengerechnet.

Das JSON enthält dieselben Zeilen unter days, dazu from und to (die abgedeckten Tage), Summen für den Zeitraum, aus diesen Summen berechnete Quoten und unanswered_open_now: die Fragen der letzten 30 Tage, die gerade jetzt noch offen sind (die Liste, die Ihr Dashboard zeigt, solange Handoff eingeschaltet ist). In totals ist revenue_from_chat eine Liste mit Währung und Betrag je Eintrag, und eine Quote ist null (kein Wert), wenn der Nenner 0 ist. Ein Fehler kommt im JSON als {"error": "der Grund"} und von der CSV-Adresse als reiner Text zurück.

Einrichten

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

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

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

Gut zu wissen

• Zahlen vergangener Tage können noch steigen. Ein Kauf zählt am Tag, an dem sein Gespräch begann, sein Umsatz am Tag des Bestelleingangs. Eine Bestellung, die Tage nach einem Chat eingeht, erhöht also eine frühere Zeile. Rufen Sie die Zahlen eines Monats am besten etwa eine Woche nach Monatsende ab.
• unanswered_still_open sinkt bei vergangenen Tagen, sobald Sie Fragen als erledigt markieren.
• Der Export reicht 90 Tage zurück. Für einen längeren Verlauf lassen Sie Make oder Zapier jeden Tag die Zeile von gestern in eine Tabelle eintragen.
• Einen Schlüssel in einer Google-Sheets-Formel sieht jeder, der die Tabelle sehen kann. Geben Sie jeder Tabelle und jedem Tool einen eigenen Schlüssel und widerrufen Sie ihn unter Settings > Reporting, wenn Sie ihn nicht mehr brauchen: Er funktioniert dann sofort nicht mehr.
• Beträge verwenden einen Punkt als Dezimaltrennzeichen, etwa 1250.50. Nutzt Ihre Tabellenkalkulation ein Komma (deutsche oder französische Einstellungen), stellen Sie das importierende Google Sheet unter Datei > Einstellungen auf ein englisches Gebietsschema oder legen Sie in Excel und Power BI den Spaltentyp über „Mit Gebietsschema“ > Englisch (USA) fest; sonst werden Beträge falsch gelesen.
• Die Zahlen können bis zu 5 Minuten alt sein.

Limits

• 120 Anfragen pro Stunde je Schlüssel und 600 pro Stunde je Shop.
• Wird ein Limit überschritten, erhalten Sie Status 429 mit einem Retry-After-Header, der angibt, wie viele Sekunden Sie warten sollen.
• Nach 60 Anfragen mit falschem Schlüssel von derselben Adresse innerhalb von 10 Minuten erhalten Sie ebenfalls Status 429.
• Bis zu 5 Schlüssel je Shop.