| Voraussetzung | Anforderung |
|---|---|
| Safina-Tarif | Pro oder Business |
| Deine Rolle in Safina | Inhaber oder Admin des Teams |
Mit einem API-Schlüssel nutzt ein Automatisierungstool die Safina REST-API für Dein Team. Mit einem Schlüssel können Zapier, n8n, Make oder Dein eigenes Skript Deine Anrufe und ihre Zusammenfassungen lesen, Kontakte finden und anlegen und nach jedem Anruf einen Workflow starten. Der Schlüssel funktioniert nur für die Safina-API. KI-Apps wie Claude oder ChatGPT verbinden sich auf einem anderen Weg, siehe Safina mit Deinem KI-Assistenten verbinden.
API-Schlüssel erstellen
- Öffne in der Safina-App den Tab Profil und tippe auf API-Schlüssel.

- Tippe neben Deine API-Schlüssel auf +. Wenn Du noch keinen Schlüssel hast, tippe unter der leeren Liste auf API-Schlüssel erstellen.

- Tippe oben auf der Seite Neuer API-Schlüssel auf den Titel und gib einen Namen ein, an dem Du erkennst, wo Du den Schlüssel nutzt, zum Beispiel „Zapier“.

-
Wähle unter Was darf dieser Schlüssel?:
- Nur lesen: Er kann Anrufe, Kontakte und Assistenten lesen.
- Lesen und schreiben: Er kann auch Kontakte und Webhooks anlegen und ändern.
Das kannst Du später nicht ändern. Für anderen Zugriff erstellst Du einen neuen Schlüssel.
-
Wähle unter Läuft ab nach, wann der Schlüssel abläuft: nach 30 Tagen, nach 90 Tagen (vorausgewählt), nach 1 Jahr oder nie (Kein Ablauf).
-
Tippe auf API-Schlüssel erstellen.

- Die Seite zeigt jetzt Dein neuer API-Schlüssel. Tippe auf Schlüssel kopieren und füge den Schlüssel in Deine Automatisierung ein. Er beginnt mit
safina_api_. Safina zeigt den vollständigen Schlüssel nur einmal.

- Tippe auf Fertig, um zur Liste zurückzukehren.
Jede Anfrage sendet den Schlüssel im Header Authorization: Bearer <Schlüssel>. Die Liste Deine API-Schlüssel zeigt, wann jeder Schlüssel erstellt wurde, wann er abläuft und wann er zuletzt genutzt wurde. Um einen Schlüssel sofort zu stoppen, tippe neben ihm auf den Papierkorb und bestätige mit Löschen. Automatisierungen, die ihn nutzen, schlagen dann fehl.
Was ein API-Schlüssel kann
| Bereich | Nur lesen | Lesen und schreiben |
|---|---|---|
| Assistenten | Die Assistenten des Teams auflisten | Dasselbe |
| Anrufe | Anrufe auflisten (neueste zuerst, Filter für Telefonnummer, Datum und Dauer) und einen Anruf mit Zusammenfassung, Anrufer und Dauer abrufen | Dasselbe |
| Kontakte | Kontakte durchsuchen, einen Kontakt über die Telefonnummer finden | Zusätzlich Kontakte anlegen und aktualisieren |
| Webhooks | – | Das Event call.ended abonnieren und das Abo löschen |
Alle Routen, Felder und Antworten stehen in der API-Referenz (auf Englisch).
Zapier
- Safina AI App für Zapier: Die App hat den Trigger New Call, die Actions Create Contact und Update Contact und die Searches Find Call, Find Contact, Find Contact by Text und Find or Create Contact. Du verbindest sie mit einem API-Schlüssel. Die App steht noch nicht im App-Verzeichnis von Zapier. Für Zugang schreib an info@safina.ai.
- Webhooks by Zapier: Ein Catch Hook empfängt nach jedem Anruf die Anrufdaten, ohne API-Schlüssel. Die Schritte stehen auf Safina + Zapier.
n8n
- Safina-Node für n8n: Das Paket
@sk-thinking/n8n-nodes-safinabringt zwei Nodes mit. Safina liest Assistenten und Anrufe und legt Kontakte an, findet und aktualisiert sie. Der Node funktioniert auch als Tool des n8n AI Agent. Safina Trigger startet einen Workflow, wenn ein Anruf endet, und prüft die Signatur jedes Events. Du hinterlegst den Schlüssel als Credential vom Typ Safina API. Der Node steht noch nicht in der Liste der n8n Community Nodes. Für Zugang schreib an info@safina.ai. Der Quellcode ist öffentlich auf GitHub. - HTTP-Request-Node: Ruft jede Route der API mit dem Header
Authorization: Bearer <Schlüssel>auf. - Webhook-Node: Empfängt nach jedem Anruf die Anrufdaten. Die Schritte stehen auf Safina + n8n.
Make
Make hat noch keine Safina-App. Nutze das Modul HTTP > Make a request mit dem Header Authorization: Bearer <Schlüssel>, um die API aufzurufen. Um nach jedem Anruf ein Szenario zu starten, nutze einen Custom webhook, wie auf Safina + Make beschrieben.
Dein eigenes Skript
Die Adresse der API ist https://api.backend.safina.ai. Dieses Beispiel liest die fünf neuesten Anrufe:
curl "https://api.backend.safina.ai/calls/me?limit=5" \
-H "Authorization: Bearer safina_api_..."
Werte in der Query sind JSON. Ein Textwert braucht doppelte Anführungszeichen, eine Zahl nicht:
curl -G "https://api.backend.safina.ai/contacts/me" \
--data-urlencode 'search="Miller"' \
-H "Authorization: Bearer safina_api_..."
Ein Webhook nach jedem Anruf
Mit einem Schlüssel zum Lesen und Schreiben abonniert POST /webhooks mit einem name und einer url das Event call.ended. Safina sendet dann pro Anruf ein Event, sobald die Zusammenfassung fertig ist.
- Setze
"create_signing_secret": true, um die Events zu signieren. Die Antwort enthält das Secret einmal. Wie Du den HeaderX-Safina-Signatureprüfst, steht in So prüfst Du, ob ein Webhook wirklich von Safina kommt. - Safina versucht jede Zustellung bis zu dreimal. Eine wiederholte Zustellung hat dieselbe
event_id. Verwirf also ein Event, das Du schon verarbeitet hast. - Ein Team kann bis zu 20 Webhooks haben. Lösche ein Abo, das Du nicht mehr brauchst, mit
DELETE /webhooks/{id}. - Antwortet die Adresse bei drei Anrufen in Folge bei jedem Versuch mit
410 Gone, schaltet Safina den Webhook aus und sendet eine E-Mail. Du kannst ihn in der App unter Safina AI > Anrufe erfassen > Webhooks wieder einschalten.
Wenn eine Anfrage fehlschlägt
| Antwort | Bedeutung |
|---|---|
401 | Der Schlüssel ist falsch, gelöscht oder abgelaufen: Erstelle einen neuen Schlüssel und aktualisiere Deine Automatisierung. 401 kommt auch, wenn die Person, die den Schlüssel erstellt hat, nicht mehr Inhaber oder Admin des Teams ist oder das Team keinen aktiven Tarif hat. |
403 api_keys_not_enabled | Dein Konto hat noch keinen Zugang zu API-Schlüsseln. |
403 plan_required | Das Team braucht den Pro-Tarif oder höher. |
403 mit einem Schlüssel zum Nur-Lesen | Die Anfrage ändert Daten. Nutze einen Schlüssel zum Lesen und Schreiben. |
409 | Die Telefonnummer gehört schon zu einem Kontakt, oder das Team hat schon 20 Webhooks. |
Häufige Fragen
Kann ich statt eines API-Schlüssels einen KI-Verbindungscode nutzen?
Nein. Ein Verbindungscode funktioniert nur für KI-Assistenten. Ein API-Schlüssel funktioniert nur für die REST-API.
Funktioniert ein Schlüssel für alle meine Teams?
Nein. Ein Schlüssel gehört zu dem Team, das beim Erstellen aktiv war. Für ein anderes Team wechselst Du in der App das Team und erstellst dort einen Schlüssel.
Was passiert, wenn ein Schlüssel abläuft?
Anfragen mit diesem Schlüssel bekommen 401. Erstelle einen neuen Schlüssel und ersetze den alten in Deiner Automatisierung.
Dein Safina-Team