Gespräch abrufen
const url = 'https://api.speakki.de/v1/conversations/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0';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/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \ --header 'Authorization: Bearer <token>'Ein Gespräch mit Transkript. Das Transkript ist nur enthalten, wenn für das Gespräch die Aufzeichnung aktiv war und die Löschfrist nicht abgelaufen ist, sonst null.
Berechtigung: calls:read.
Authorizations
Abschnitt betitelt „Authorizations“Parameters
Abschnitt betitelt „Parameters“Path Parameters
Abschnitt betitelt „Path Parameters“ID des Gesprächs.
Responses
Abschnitt betitelt „Responses“Das Gespräch.
Ein Gespräch mit Transkript, soweit es sichtbar ist.
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).
object
assistant der Assistent, user der Gesprächspartner.
Der gesprochene Text.
Zeitpunkt der Äußerung, falls bekannt.
Example
{ "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, "transcript": [ { "role": "assistant", "content": "Guten Tag, wie kann ich helfen?", "timestamp": "2026-11-16T09:00:02.000Z" }, { "role": "user", "content": "Ich hätte gern ein Angebot für die Heizungswartung.", "timestamp": "2026-11-16T09:00:08.000Z" } ]}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." }}Nicht gefunden.
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": "not_found", "message": "Nicht gefunden." }}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." }}