Gespräche auflisten
const url = 'https://api.speakki.de/v1/conversations?direction=inbound';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://api.speakki.de/v1/conversations?direction=inbound' \ --header 'Authorization: Bearer <token>'Geführte Telefongespräche Ihrer Assistenten, eingehend und ausgehend, neueste zuerst. Mit Zusammenfassung, Einordnung und erfassten Daten, ohne Transkript. GET /v1/calls zeigt dagegen die Aufträge für ausgehende Anrufe, auch solche ohne Gespräch.
Berechtigung: calls:read.
Authorizations
Abschnitt betitelt „Authorizations“Parameters
Abschnitt betitelt „Parameters“Query Parameters
Abschnitt betitelt „Query Parameters“Nur eingehende oder nur ausgehende Gespräche.
Beginn ab diesem Zeitpunkt (einschließlich).
Beginn vor diesem Zeitpunkt (ausschließlich).
Gespräche je Seite, 1 bis 100, Standard 25.
next_cursor der vorigen Seite.
Responses
Abschnitt betitelt „Responses“Eine Seite Gespräche.
Eine Seite Gespräche, neueste zuerst.
object
Die Einträge dieser Seite.
Ein geführtes Telefongespräch, eingehend oder ausgehend, ohne Transkript.
object
ID des Gesprächs (dieselbe wie interactionId im Webhook).
inbound eingehend, outbound ausgehend.
Beginn des Gesprächs.
Nummer des Gesprächspartners in E.164: der Anrufer bei eingehenden, das Ziel bei ausgehenden Gesprächen. null bei unterdrückter Nummer.
Ihre Rufnummer: die angerufene Nummer bei eingehenden, der Absender bei ausgehenden Gesprächen.
Name des Gesprächspartners, falls bekannt.
Name des Assistenten, wie er im Dashboard steht.
Bearbeitungsstand im Posteingang.
Zusammenfassung des Gesprächs.
Daten, die der Assistent im Gespräch erfasst hat.
object
Name der Erfassung im Assistenten.
Bezeichnung der Erfassung.
Nur bei „Anliegen aufnehmen“: Schlüssel des Falls.
Nur bei „Anliegen aufnehmen“: Name des Falls.
true, wenn der Anrufer vor den letzten Angaben aufgelegt hat.
Zeitpunkt der Erfassung.
Die erfassten Angaben.
object
Name des Felds.
Typ des Felds, zum Beispiel string oder boolean.
Der erfasste Wert, Typ je Feld.
true, wenn Inhalte nach Ablauf der Löschfrist entfernt wurden (Zusammenfassung, erfasste Daten, Transkript).
Für die nächste Seite als cursor senden. null = keine weitere Seite.
Example
{ "data": [ { "id": "c1a7e3f9-2b4d-4c6e-9f8a-0d3b5e7a9c21", "direction": "inbound", "started_at": "2026-11-16T09:00:00.000Z", "ended_at": "2026-11-16T09:03:00.000Z", "duration_seconds": 180, "phone_number": "+4915228817386", "own_number": "+493023125010", "caller_name": "Max Mustermann", "assistant_id": "5e2a9c1b-7f43-4c1d-8b0a-3d9e6f2a1c44", "assistant_name": "Empfang", "contact_id": "a4d2c8e6-5f1b-4a3d-8c7e-9b0f2d4a6c81", "status": "open", "category": { "slug": "REQUEST_RECORDED", "label": "Anliegen aufgenommen" }, "summary": "Herr Mustermann möchte ein Angebot für die jährliche Heizungswartung und bittet um Rückruf.", "captured_data": [ { "tool_name": "rueckruf_erfassen", "label": "Rückrufwunsch erfassen", "case_key": null, "case_name": null, "incomplete": false, "captured_at": "2026-11-16T09:02:40.000Z", "fields": [ { "name": "name", "type": "string", "value": "Max Mustermann" } ] } ], "outbound_call_id": null, "content_deleted": false } ]}Ungültige Anfrage.
Einheitliches Fehlerformat aller Antworten unter /v1.
object
Der Fehler.
object
Fester Code für Programme. Neue Codes können dazukommen, bestehende ändern sich nicht.
Meldung für Menschen, auf Deutsch.
Zusatz je Code, z. B. fields bei invalid_request oder missing_variables bei missing_variables.
object
Examples
{ "error": { "code": "invalid_request", "message": "Die Anfrage ist ungültig." }}API-Schlüssel fehlt oder ist ungültig.
Einheitliches Fehlerformat aller Antworten unter /v1.
object
Der Fehler.
object
Fester Code für Programme. Neue Codes können dazukommen, bestehende ändern sich nicht.
Meldung für Menschen, auf Deutsch.
Zusatz je Code, z. B. fields bei invalid_request oder missing_variables bei missing_variables.
object
Examples
{ "error": { "code": "unauthorized", "message": "Der API-Schlüssel fehlt oder ist ungültig. Senden Sie ihn als „Authorization: Bearer spk_live_…“." }}Nicht erlaubt: Tarif, Freischaltung oder Berechtigung des Schlüssels.
Einheitliches Fehlerformat aller Antworten unter /v1.
object
Der Fehler.
object
Fester Code für Programme. Neue Codes können dazukommen, bestehende ändern sich nicht.
Meldung für Menschen, auf Deutsch.
Zusatz je Code, z. B. fields bei invalid_request oder missing_variables bei missing_variables.
object
Examples
{ "error": { "code": "insufficient_scope", "message": "Diesem API-Schlüssel fehlt die Berechtigung für diese Anfrage." }}{ "error": { "code": "plan_required", "message": "Ausgehende Anrufe sind ab dem Tarif Professional enthalten." }}Zu viele Anfragen. retry-after und x-ratelimit-reset nennen die Sekunden, bis wieder Anfragen möglich sind.
Einheitliches Fehlerformat aller Antworten unter /v1.
object
Der Fehler.
object
Fester Code für Programme. Neue Codes können dazukommen, bestehende ändern sich nicht.
Meldung für Menschen, auf Deutsch.
Zusatz je Code, z. B. fields bei invalid_request oder missing_variables bei missing_variables.
object
Examples
{ "error": { "code": "rate_limited", "message": "Zu viele Anfragen. Bitte versuchen Sie es gleich noch einmal." }}Interner Fehler.
Einheitliches Fehlerformat aller Antworten unter /v1.
object
Der Fehler.
object
Fester Code für Programme. Neue Codes können dazukommen, bestehende ändern sich nicht.
Meldung für Menschen, auf Deutsch.
Zusatz je Code, z. B. fields bei invalid_request oder missing_variables bei missing_variables.
object
Examples
{ "error": { "code": "internal_error", "message": "Interner Fehler. Bitte versuchen Sie es später noch einmal." }}