Gespräche, Kontakte und Termine lesen
Die API liefert, was Ihr Assistent am Telefon erledigt hat: Gespräche mit Zusammenfassung und erfassten Angaben, dazu Kontakte und Termine. So landen die Daten in Ihrem CRM oder Ihrer Auswertung. Diese Anfragen lesen nur, ändern lässt sich darüber nichts.
Für das Lesen reichen der Tarif Professional und ein Schlüssel mit der passenden Berechtigung. Eine Freischaltung für ausgehende Anrufe brauchen Sie dafür nicht.
| Daten | Anfragen | Berechtigung |
|---|---|---|
| Gespräche | GET /v1/conversations, GET /v1/conversations/{id} |
calls:read |
| Kontakte | GET /v1/contacts, GET /v1/contacts/{id} |
contacts:read |
| Termine | GET /v1/appointments, GET /v1/appointments/{id} |
appointments:read |
Alle Listen blättern mit limit und cursor, siehe Überblick.
Gespräche
Abschnitt betitelt „Gespräche“Ein Gespräch ist ein geführtes Telefonat Ihres Assistenten, eingehend oder ausgehend.
curl "https://api.speakki.de/v1/conversations?direction=inbound&from=2026-11-01T00:00:00%2B01:00&limit=50" \ -H "Authorization: Bearer spk_live_IHR_SCHLUESSEL"| Filter | Bedeutung |
|---|---|
direction |
inbound nur eingehende, outbound nur ausgehende Gespräche |
from |
Beginn ab diesem Zeitpunkt, einschließlich |
to |
Beginn vor diesem Zeitpunkt, ausschließlich |
from und to sind ISO 8601 mit Zeitzone. In einer Adresse schreiben Sie das Pluszeichen als %2B.
Die Liste kommt neueste zuerst und enthält je Gespräch unter anderem:
{ "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}phone_numberist die Nummer des Gesprächspartners: der Anrufer bei eingehenden, das Ziel bei ausgehenden Gesprächen. Bei unterdrückter Nummer steht dortnull.own_numberist Ihre Rufnummer.statusist der Bearbeitungsstand im Posteingang:open,in_progress,doneoderarchived.captured_dataenthält, was Ihr Assistent im Gespräch erfasst hat, je Erfassung mit ihren Feldern.incompleteisttrue, wenn der Anrufer vor den letzten Angaben aufgelegt hat.outbound_call_idverweist bei ausgehenden Gesprächen auf den Anruf ausGET /v1/calls/{id}.
Transkript
Abschnitt betitelt „Transkript“Das Transkript liefert nur die Einzelabfrage:
curl https://api.speakki.de/v1/conversations/c1a7e3f9-2b4d-4c6e-9f8a-0d3b5e7a9c21 \ -H "Authorization: Bearer spk_live_IHR_SCHLUESSEL"Die Antwort enthält zusätzlich transcript, eine Liste aus role (assistant oder user), content und timestamp.
transcript ist null, wenn für das Gespräch die Anrufaufzeichnung nicht eingeschaltet war. Das ist dieselbe Regel wie im Dashboard. Nach Ablauf Ihrer Löschfrist entfernt SpeakKI Zusammenfassung, erfasste Angaben und Transkript. Dann ist content_deleted gleich true.
Gespräche oder Anrufe?
Abschnitt betitelt „Gespräche oder Anrufe?“GET /v1/conversations |
GET /v1/calls |
|
|---|---|---|
| Inhalt | geführte Gespräche, eingehend und ausgehend | Aufträge für ausgehende Anrufe |
| Ohne Gespräch | nicht enthalten | enthalten, zum Beispiel not_reached |
| Zusammenfassung und erfasste Angaben | ja | nein |
Kontakte
Abschnitt betitelt „Kontakte“# Kontakt zu einer Rufnummer findencurl "https://api.speakki.de/v1/contacts?phone=%2B4915228817386" \ -H "Authorization: Bearer spk_live_IHR_SCHLUESSEL"
# in Name, Firma, Rufnummer und E-Mail suchencurl "https://api.speakki.de/v1/contacts?q=Mustermann" \ -H "Authorization: Bearer spk_live_IHR_SCHLUESSEL"| Filter | Bedeutung |
|---|---|
phone |
genau diese Rufnummer. Deutsche Schreibweisen rechnet die API um, aus 0152... wird +49152.... |
q |
Suche in Name, Firma, Rufnummer und E-Mail |
Ein Kontakt enthält id, name, company, phone, email, notes, calls_blocked, created_at und updated_at. calls_blocked ist true, wenn eingehende Anrufe dieses Kontakts gesperrt sind. Verworfene Kontakte und Teammitglieder sind nicht enthalten.
Termine
Abschnitt betitelt „Termine“curl "https://api.speakki.de/v1/appointments?from=2026-11-16T00:00:00Z&to=2026-11-23T00:00:00Z&status=planned" \ -H "Authorization: Bearer spk_live_IHR_SCHLUESSEL"| Filter | Bedeutung |
|---|---|
from |
Beginn ab diesem Zeitpunkt, einschließlich |
to |
Beginn vor diesem Zeitpunkt, ausschließlich |
status |
planned, done oder canceled |
Termine kommen nach Beginn aufsteigend. Ein Termin enthält unter anderem:
| Feld | Bedeutung |
|---|---|
type |
appointment Termin, callback_deadline Frist für einen Rückruf, other sonstiger Eintrag |
status |
planned, done oder canceled |
title, customer_name, description |
Titel, Name, auf den der Termin läuft, und Beschreibung |
starts_at, ends_at |
Beginn und Ende in UTC |
service |
gebuchte Leistung mit id und name, sonst null |
party_size |
Personenzahl bei Reservierungen, sonst null |
contact_id |
Kontakt für GET /v1/contacts/{id} |
conversation_id |
Gespräch, in dem der Termin entstand, für GET /v1/conversations/{id} |
Alle Felder mit Typen stehen in der API-Referenz.