Zapier, n8n und Make mit einem Safina-API-Schlüssel verbinden

Erstelle einen API-Schlüssel in der Safina-App und nutze ihn in Zapier, n8n, Make oder Deinem eigenen Skript: Anrufe und Zusammenfassungen lesen, Kontakte finden und anlegen und nach jedem Anruf einen Workflow starten.

Liniengrafik: Ein Schlüssel mit Code-Zeichen in einer Kette aus Workflow-Bausteinen: Blitz als Auslöser, Zahnrad, Kontaktkarte, Telefonhörer mit grünem Haken und ein Laptop mit Code. Integration
David Schemm David Schemm
Aktualisiert

VoraussetzungAnforderung
Safina-TarifPro oder Business
Deine Rolle in SafinaInhaber 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

  1. Öffne in der Safina-App den Tab Profil und tippe auf API-Schlüssel.

Tab Profil in der Safina-App. Im Bereich Konto ist der Eintrag API-Schlüssel hervorgehoben.

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

Seite API-Schlüssel mit der Liste Deine API-Schlüssel: ein Schlüssel für Zapier und einer für n8n. Der Button + neben dem Listentitel ist hervorgehoben.

  1. 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“.

Seite Neuer API-Schlüssel mit dem Namen Zapier als Titel, der hervorgehoben ist. Darunter die Auswahl Was darf dieser Schlüssel? mit Lesen und schreiben.

  1. 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.

  2. 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).

  3. Tippe auf API-Schlüssel erstellen.

Seite Neuer API-Schlüssel mit Läuft ab nach 90 Tagen. Der Button API-Schlüssel erstellen unten ist hervorgehoben.

  1. 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.

Seite Dein neuer API-Schlüssel mit einem Demo-Schlüssel. Der Button Schlüssel kopieren ist hervorgehoben.

  1. 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

BereichNur lesenLesen und schreiben
AssistentenDie Assistenten des Teams auflistenDasselbe
AnrufeAnrufe auflisten (neueste zuerst, Filter für Telefonnummer, Datum und Dauer) und einen Anruf mit Zusammenfassung, Anrufer und Dauer abrufenDasselbe
KontakteKontakte durchsuchen, einen Kontakt über die Telefonnummer findenZusä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-safina bringt 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 Header X-Safina-Signature prü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

AntwortBedeutung
401Der 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_enabledDein Konto hat noch keinen Zugang zu API-Schlüsseln.
403 plan_requiredDas Team braucht den Pro-Tarif oder höher.
403 mit einem Schlüssel zum Nur-LesenDie Anfrage ändert Daten. Nutze einen Schlüssel zum Lesen und Schreiben.
409Die 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

9:41

Safina führte diese Woche 51 Telefonate

46

Vertrauensvoll

4

Verdächtig

1

Gefährlich

Letzte 7 Tage
Filter
EM
Emma Martin 67s 15:30

Möchte das Angebot für die neue Kampagne besprechen und hat Fragen zum Zeitplan.

LS
Laura Wagner 54s 14:45

Fragt nach dem Status der Bestellung und wann die Lieferung kommt.

TH
Tim Hoffmann 34s 13:10

Termin für Projektbesprechung nächste Woche vereinbaren.

Unbekannt 44s 11:30

Gewinnversprechen – wahrscheinlich Spam.

SK
Sophie Meyer 10s 09:15

Reklamation zum letzten Auftrag, bittet um Rückruf.

MM
Martin Neumann 95s 13. Dez

Möchte eine mögliche Zusammenarbeit besprechen.

AR
Anna Richter 85s 13. Dez

Ist Deine Kollegin und möchte über das Projekt sprechen.

JK
Jonas König 42s 12. Dez

Erkundigt sich nach verfügbaren Terminen nächste Woche.

LB
Lina Berg 68s 12. Dez

Hat Fragen zur Rechnung und bittet um Klärung.

Anrufe
Safina
Kontakte
Profil
9:41
Anruf von Emma Martin
12. Dez
11:30
67s
+491723456789

Möchte das Angebot für die neue Kampagne besprechen und hat Fragen zum Zeitplan.

Wichtigste Punkte

  • Rückruf an Emma Martin
  • Fragen zu Zeitplan & Konditionen klären
Zurückrufen
Kontakt bearbeiten

KI-Einblicke

Stimmung der Person Sehr gut

Der Anrufer war kooperativ und hat die benötigten Informationen bereitgestellt.

Dringlichkeit Niedrig

Der Anrufer kann auf eine Rückmeldung warten.

Audio & Transkript

0:16

Hallo, hier spricht Safina AI, die digitale Assistentin von Peter. Wie kann ich Ihnen helfen?

Hallo Safina, hier ist Emma Martin. Ich wollte über das Angebot und den Zeitplan sprechen.

Danke, Emma. Geht es bei Ihrer Entscheidung vor allem um das Standard- oder Pro-Paket für den Launch?

Genau. Wir brauchen das Pro-Paket und möchten nächsten Monat starten, wenn das Onboarding in der ersten Woche möglich ist.

Sag Ciao zu deiner altmodischen Mailbox.

Teste Safina kostenlos und beginne deine Anrufe intelligent zu verwalten.

Safina Support Bot
Safina Support Bot

Hi! 👋 Ich bin der Safina-Support-Assistent. Frag mich alles rund um Einrichtung, Rufumleitung, Tarife oder dein Konto. Hinweis: Deine Eingaben werden gemäß unserer Datenschutzerklärung verarbeitet.

Deine Eingaben werden gemäß unserer Datenschutzerklärung