Zum Inhalt springen
Hilfe-Center
Support kontaktierenApp öffnen

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.

Ein Gespräch ist ein geführtes Telefonat Ihres Assistenten, eingehend oder ausgehend.

Terminal-Fenster
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_number ist die Nummer des Gesprächspartners: der Anrufer bei eingehenden, das Ziel bei ausgehenden Gesprächen. Bei unterdrückter Nummer steht dort null.
  • own_number ist Ihre Rufnummer.
  • status ist der Bearbeitungsstand im Posteingang: open, in_progress, done oder archived.
  • captured_data enthält, was Ihr Assistent im Gespräch erfasst hat, je Erfassung mit ihren Feldern. incomplete ist true, wenn der Anrufer vor den letzten Angaben aufgelegt hat.
  • outbound_call_id verweist bei ausgehenden Gesprächen auf den Anruf aus GET /v1/calls/{id}.

Das Transkript liefert nur die Einzelabfrage:

Terminal-Fenster
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.

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
Terminal-Fenster
# Kontakt zu einer Rufnummer finden
curl "https://api.speakki.de/v1/contacts?phone=%2B4915228817386" \
-H "Authorization: Bearer spk_live_IHR_SCHLUESSEL"
# in Name, Firma, Rufnummer und E-Mail suchen
curl "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.

Terminal-Fenster
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.