Integrationen

Finn funktioniert am besten, wenn es mit den Systemen verbunden ist, die Sie ohnehin nutzen — Ihrem CRM, Ihrem Kalender, Ihrem Telefonanbieter, dem Chat Ihres Teams. Diese Seite geht jedes davon durch und setzt voraus, dass Sie noch nie zuvor eine Integration eingerichtet haben.

Sie brauchen nicht alle davon. Die meisten Nutzer starten nur mit einem Kalender (damit der Finn Termine buchen kann) und vielleicht einem CRM. Ergänzen Sie weitere, wenn ein konkreter Bedarf besteht.

Alle Verbindungen sind reversibel. Sie können jede Verbindung jederzeit auf demselben Bildschirm trennen, über den Sie sie hergestellt haben. Die Plattform hält Ihre Daten nie zurück.

Wo Sie Integrationen finden

Seitenleiste → Einstellungen → Integrationen.

Sie sehen eine Kachel für jede verfügbare Integration mit einem Label, das den Status anzeigt: Nicht verbunden, Verbunden oder Aktion erforderlich. Klicken Sie auf eine Kachel, um sie einzurichten oder zu verwalten.

CRMs

Ein CRM ist der Ort, an dem Sie Ihre Kunden- und Kontaktdaten pflegen. Die Verbindung Ihres CRM ermöglicht Ihnen:

1. Kontakte importieren, sodass Sie keine CSVs manuell hochladen müssen.
2. Gesprächsergebnisse zurückschreiben, sodass Ihr Vertriebsteam sieht, was in jedem Gespräch passiert ist, ohne das CRM zu verlassen.

HubSpot

Die Einrichtung erfolgt größtenteils per Klick. Rechnen Sie mit 10 Minuten.

1. Einstellungen → Integrationen → HubSpot → Verbinden.
2. Sie werden zu HubSpot weitergeleitet. Melden Sie sich an (falls noch nicht geschehen) und klicken Sie auf Autorisieren.
3. Sie kehren mit einem grünen Badge „Verbunden" zu Finn zurück.
4. Entscheiden Sie nun, was Sie importieren möchten. Klicken Sie auf Listen auswählen. Haken Sie die HubSpot-Listen ab, die Sie als Zielgruppen nutzen wollen.
5. Legen Sie einen Sync-Zeitplan fest — alle 15 Minuten ist ein guter Standard für aktive Kampagnen; täglich genügt für Listen, die sich langsamer ändern.
6. Ordnen Sie Felder zu — teilen Sie Finn mit, welche HubSpot-Eigenschaft der Name, welche die Telefonnummer und welche die Ländervorwahl ist. Optional: Ordnen Sie weitere Eigenschaften benutzerdefinierten Feldern zu, damit der Finn sie im Gespräch nutzen kann.

Das war's. Ihre HubSpot-Listen erscheinen jetzt als Zielgruppen in Finn.

Damit Gesprächsergebnisse zurück nach HubSpot geschrieben werden, aktivieren Sie Outcome Sync während der Einrichtung (oder jederzeit später auf demselben Bildschirm). Jedes abgeschlossene Gespräch wird zu einer HubSpot-Aktivität; Felder aus der Nachbereitung werden zu Eigenschafts-Updates.

Salesforce

Grundsätzlich derselbe Ablauf wie bei HubSpot. Einige Salesforce-spezifische Hinweise:

• Sie können Production oder Sandbox verbinden. Der Einrichtungsablauf fragt danach.
• Berechtigungsanforderungen — Sie benötigen einen Benutzer mit „API Enabled" und Lese-/Schreibrechten auf Leads, Kontakte und (falls genutzt) benutzerdefinierte Objekte. Die meisten CRM-Administratoren können das einrichten.
• Benutzerdefinierte Objekte werden unterstützt. Wenn Ihr Vertriebsprozess ein benutzerdefiniertes Objekt nutzt (z. B. „Opportunity Owner Calls"), können Sie stattdessen darauf mappen.

Pipedrive

Pipedrive nutzt einen API-Token statt OAuth.

1. In Pipedrive: Einstellungen → Persönliche Einstellungen → API → Token generieren.
2. Fügen Sie den Token in Finn ein → Einstellungen → Integrationen → Pipedrive.
3. Führen Sie die restliche Einrichtung wie bei HubSpot durch.

„Mein CRM ist nicht aufgeführt"

Nutzen Sie die Webhook-Integration (weiter unten auf dieser Seite), um Gesprächsergebnisse überall dorthin zu senden, wo Sie HTTP-Anfragen empfangen können. Oder nutzen Sie ein Tool wie Zapier/Make als Brücke — siehe Abschnitt Zapier weiter unten.

Kalender — für Terminbuchungen

Wenn Ihr Finn Termine buchen soll, muss ein Kalender verbunden sein.

Google Calendar

1. Einstellungen → Integrationen → Google Calendar → Verbinden.
2. Melden Sie sich bei Google an und erteilen Sie die Kalenderberechtigungen.
3. Wählen Sie aus, in welchen Kalender gebucht werden soll. Die meisten Menschen haben mehrere — wählen Sie den richtigen.
4. Verfügbarkeitsregeln festlegen:
   • Arbeitszeiten — wann Buchungen erlaubt sind
   • Puffer zwischen Terminen — Mindestabstand zwischen aufeinanderfolgenden Terminen (z. B. 10 Min.)
   • Max. Termine pro Tag — optionale Obergrenze
5. Speichern.

Jetzt können Sie in jedem Finn eine Aufgabe oder Workflow-Aktion "Kalender buchen" hinzufügen, die diesen Kalender verwendet.

Microsoft Outlook / Microsoft 365

Wie bei Google. Über Microsoft autorisieren, Kalender auswählen, Verfügbarkeit festlegen.

Calendly / Cal.com

Diese funktionieren anders — sie erlauben keine direkte Buchung per API wie Google/Outlook. Stattdessen sagt der Finn "Ich sende Ihnen einen Buchungslink" und eine SMS/E-Mail mit der URL geht raus.

Das funktioniert, wirkt aber weniger natürlich als eine direkte Buchung. Wenn Sie die Wahl haben, verbinden Sie stattdessen Google oder Outlook direkt.

Telefonanbieter — wenn Sie Ihre eigene Nummer mitbringen

Wenn Sie bereits eine Telefonnummer bei einem anderen Anbieter haben (Twilio, Vonage, Ihre Büro-Telefonanlage), können Sie diese über Finn weiterverwenden.

Siehe Telefonnummern → Eigene Nummer mitbringen für die vollständige Anleitung.

Unterstützte Anbieter: Twilio, Plivo, Bandwidth, Vonage und generische SIP-kompatible Carrier.

Webhooks — zum Senden von Daten an Ihre eigenen Systeme

Ein Webhook ist eine URL auf Ihrer Seite, an die Finn Daten sendet, wenn etwas passiert (ein Anruf ist beendet, ein Deployment ist abgeschlossen usw.).

Nützlich, wenn:

• Sie möchten, dass jeder abgeschlossene Anruf für eigene Analysen in Ihr Data Warehouse fließt
• Sie bei bestimmten Ereignissen eine Slack-Nachricht oder E-Mail auslösen möchten
• Ihr CRM oder Ihre Business-Anwendung nicht nativ unterstützt wird, Sie aber HTTP-Anfragen empfangen können
• Sie Zapier/Make/n8n für nachgelagerte Automatisierungen nutzen möchten

Einen Webhook einrichten

1. Einstellungen → Integrationen → Webhooks → Endpunkt hinzufügen.
2. Geben Sie die URL ein, an die Finn senden soll.
3. Wählen Sie aus, welche Ereignisse abonniert werden sollen:
   • Anruf gestartet — wird ausgelöst, sobald ein Anruf beginnt
   • Anruf abgeschlossen — wird ausgelöst, wenn ein Anruf endet (Transkript liegt vor, ist aber noch nicht analysiert)
   • Anruf analysiert — wird ausgelöst, wenn die Nachbearbeitungsanalyse abgeschlossen ist (am nützlichsten für nachgelagerte Automatisierung)
   • Deployment gestartet — wird ausgelöst, wenn ein Deployment live geht
   • Deployment abgeschlossen — wird ausgelöst, wenn ein Deployment endet, mit aggregierten Kennzahlen
4. Speichern. Finn zeigt Ihnen ein Signing Secret — kopieren Sie es an einen sicheren Ort (Sie sehen es nur einmal).
5. Prüfen Sie das Signing Secret an Ihrem Endpunkt, um zu bestätigen, dass die Anfragen wirklich von Finn stammen.

Wie die Daten aussehen

Jedes Ereignis sendet JSON an Ihre URL. Ein call.analyzed-Ereignis sieht etwa so aus:

{
  "event": "call.analyzed",
  "call": {
    "id": "call_abc123",
    "deployment_id": "deploy_xyz",
    "started_at": "2026-06-15T10:30:00Z",
    "duration_seconds": 142,
    "contact": { "name": "Alice Chen", "phone_number": "+15551234567" },
    "transcript": [ ...turn-by-turn... ],
    "post_call_analysis": {
      "appointment_booked": true,
      "appointment_time": "2026-06-22 14:00"
    },
    "sentiment": "positive"
  }
}

Das vollständige Schema finden Sie in unserer Entwicklerreferenz unter api.hirefinn.ai/docs.

Wenn Webhooks nicht funktionieren

Wenn Finn Ihren Endpunkt nicht erreichen kann (DNS-Fehler, Timeout, 5xx-Antwort), erfolgen bis zu 24 Stunden lang Wiederholungsversuche mit Backoff. Jede fehlgeschlagene Zustellung erscheint unter Einstellungen → Integrationen → Webhooks → Zustellungsprotokoll mit der Fehlermeldung — hilfreich zur Fehlersuche.

Webhooks während eines Anrufs (Live-Datenabfrage)

Es gibt noch eine andere Art von Webhook: einen, den Ihr Finn während eines Gesprächs aufruft, um Live-Daten abzufragen.

Beispiel: Ein Kunde ruft wegen seiner Bestellung an. Der Finn muss den Bestellstatus kennen, doch dieser liegt in Ihrem System, nicht in Finn. Der Finn ruft Ihren /lookup-Endpunkt mit der Telefonnummer des Kunden auf, Ihr Endpunkt gibt { "order_status": "shipped", "tracking": "1Z..."} zurück, und der Finn nutzt dies in seiner Antwort: "Ihre Bestellung wurde gestern versandt — die Sendungsnummer endet auf..."

Zur Einrichtung: Fügen Sie im Workflow Ihres Finn einen Aktion → Webhook-Knoten hinzu. Konfigurieren Sie die URL und die zu sendenden Daten. Die Antwort steht anschließend als Workflow-Variablen zur Verfügung.

REST API — für programmatische Steuerung

Manche Teams möchten Finn aus ihrem eigenen Code heraus steuern — Deployments programmatisch starten, Anrufdaten in eigene Dashboards laden usw.

Einstellungen → Integrationen → API-Schlüssel → Neuen Schlüssel generieren. Kopieren Sie den Schlüssel und bewahren Sie ihn sicher auf.

Dann die API verwenden:

POST https://api.hirefinn.ai/v1/deployments
Authorization: Bearer your_api_key

{
  "finn_id": "finn_abc",
  "audience_id": "aud_xyz",
  "from_number": "+15551234567"
}

Wir bieten offizielle SDKs für Node, Python, Go und Ruby. Vollständige Referenz unter api.hirefinn.ai/docs.

Falls Sie kein Entwickler sind und dieser Abschnitt einschüchternd wirkt: Sie brauchen ihn nicht. Das Dashboard kann alles, was die API kann. Die API ist nur für Teams gedacht, die Abläufe skripten möchten.

Slack — Benachrichtigungen im Team-Chat

Nützlich für den Überblick im Betrieb — "Deployment X ist abgeschlossen, hier sind die Zahlen" — ohne dass sich alle bei Finn anmelden müssen.

1. Einstellungen → Integrationen → Slack → Zum Workspace hinzufügen.
2. In Slack autorisieren.
3. Einen Kanal für Benachrichtigungen wählen.
4. Auswählen, worüber benachrichtigt wird:
   • Deployment gestartet
   • Deployment abgeschlossen (mit Zusammenfassung der Kennzahlen)
   • Deployment fehlgeschlagen
   • Tägliche Morgenzusammenfassung
   • Schwellenwert-Alarme (z. B. "Erfolgsquote unter X gefallen")

Sie können mehrere Kanäle verbinden — verschiedene Teams benötigen womöglich verschiedene Benachrichtigungsarten.

Zapier / Make / n8n

Für No-Code-Automatisierung nutzen Sie die oben beschriebene Webhook-Integration als Auslöser in Ihrem bevorzugten Automatisierungstool.

Wir arbeiten außerdem an einer nativen Zapier-App — Early Access beantragen unter Einstellungen → Integrationen → Zapier.

SSO (Enterprise)

Mit Single Sign-On meldet sich Ihr Team über die bestehende Unternehmensidentität an (Okta, Azure AD, Google Workspace usw.) statt mit separaten Finn-Passwörtern.

Verfügbar in Enterprise-Tarifen.

• SAML 2.0 — funktioniert mit allen gängigen Identity-Providern.
• SCIM — automatisierte Benutzerbereitstellung. Wenn Sie jemanden in Ihrem IdP der richtigen Gruppe hinzufügen, erhält diese Person automatisch ein Finn-Konto. Beim Entfernen verliert sie den Zugriff.

Die Einrichtung erfolgt unter Einstellungen → Sicherheit → SSO. Die IT-Teams der meisten Unternehmen kennen das bereits — der Ablauf ist Standard.

Compliance & Datenresidenz

Keine Integration im engeren Sinne, aber wissenswert:

• GDPR — vollständig unterstützt. Recht auf Löschung, Export, EU-Datenresidenz.
• HIPAA — nur Enterprise, mit unterzeichnetem BAA.
• SOC 2 Type II — aktuell. Auditberichte unter NDA verfügbar.
• Datenresidenz — Region USA, EU oder Indien bei der Kontoerstellung wählen. (Später nicht ohne manuelle Migration änderbar — bei der Registrierung sorgfältig wählen.)

Mehr unter hirefinn.ai/platform/security.

Häufige Fragen

F: Kann ich mit mehreren CRMs gleichzeitig synchronisieren? A: Ja. Jede CRM-Verbindung ist unabhängig. Verschiedene Zielgruppen können aus verschiedenen CRMs synchronisiert werden.

F: Mein Webhook wird ausgelöst, aber mein System erhält die Daten nicht. A: Prüfen Sie Einstellungen → Integrationen → Webhooks → Zustellungsprotokoll auf den Fehler. Am häufigsten: SSL-Zertifikatsproblem, IP-Sperre oder Ihr Endpunkt gibt nicht 200 zurück.

F: Ich habe mein CRM versehentlich getrennt. Sind Daten verloren gegangen? A: Nein. Das Trennen stoppt nur künftige Synchronisierungen. Alle vorhandenen Zielgruppendaten, der Anrufverlauf usw. bleiben erhalten. Verbinden Sie sich wieder, wenn Sie bereit sind.

F: Kann ich die API und das Dashboard für dasselbe Konto nutzen? A: Ja. Viele Teams nutzen die API für die Automatisierung und das Dashboard für manuelle Vorgänge. Beide spiegeln denselben zugrunde liegenden Zustand wider.

Weiter

• Workflows → — Integrationen als Action-Nodes in einem Finn nutzen.
• Abrechnung → — API- und Webhook-Kontingente nach Tarif.
• Compliance → — womit Ihre Integrationen konform sein müssen.