Assistenten auflisten
const url = 'https://api.speakki.de/v1/assistants';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/assistants \ --header 'Authorization: Bearer <token>'Assistenten, bei denen ausgehende Anrufe eingeschaltet sind und eine Absendernummer hinterlegt ist.
Berechtigung: calls:read.
Authorizations
Abschnitt betitelt „Authorizations“Responses
Abschnitt betitelt „Responses“Die Assistenten.
Alle Assistenten, die für ausgehende Anrufe bereit sind.
object
Die Einträge dieser Seite.
Assistent, der für ausgehende Anrufe bereit ist.
object
ID des Assistenten, für assistant_id.
Name, wie er im Dashboard steht. Tragen mehrere Assistenten denselben Namen, steht die Rolle dahinter (zum Beispiel „Mia · Empfang“).
Absendernummer des Assistenten in E.164.
Namen der Platzhalter in Begrüßung und Auftrag. Für jeden ist beim Anlegen ein Wert nötig.
Example
{ "data": [ { "id": "5e2a9c1b-7f43-4c1d-8b0a-3d9e6f2a1c44", "name": "Mia · Terminerinnerung", "from_number": "+493023125010", "variables": [ "name" ] } ]}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." }}