Zum Hauptinhalt springen
DocumentationAPI ReferenceVideo Tutorials

Integrationen

Integrationen erweitern Ihre Voice Agents durch die Anbindung an externe Dienste. Dieser Abschnitt behandelt alle verfügbaren Integrationen und ihre Konfiguration.

Verfügbare Integrationen​

IntegrationZweckStatusTarife
TelefonnummernTelefonnummern und AnrufeVerfügbarAlle
SIP-TrunkEigenen Anbieter mitbringen (sipgate, Placetel, TENIOS, easybell, Zadarma, Twilio BYO, Telnyx, Custom)VerfügbarAlle — erfordert Compliance-Freigabe
Google CalendarTerminvereinbarung über GoogleVerfügbarAlle
Outlook CalendarTerminvereinbarung über Microsoft OutlookVerfügbarAlle
eTerminVerfügbarkeit prüfen und Termine live buchen/verschieben/stornieren — siehe eTerminVerfügbarAlle
resmioRestauranttische live in Ihr Reservierungsbuch buchen — siehe resmioVerfügbarAlle
HubSpot CRMKontakte und Deals aus Ihrem Voice Agent lesen/schreibenVerfügbarAlle
MCP-ServerEigenen MCP-kompatiblen Tool-Server mitbringen und seine Tools für Agenten bereitstellen — siehe MCP-ServerVerfügbarAlle
API-SchlüsselZugriff für externe AnwendungenVerfügbarAlle
WebhooksEchtzeit-EreignisbenachrichtigungenVerfügbarAlle
Alle Tarife

Kalenderintegrationen, SIP, HubSpot, MCP-Server, API-Zugriff und Webhooks sind in allen Tarifen verfügbar, einschließlich Free. SIP-Trunking erfordert eine einmalige Compliance-Freigabe, bevor der Verbindungsassistent freigeschaltet wird.

Einrichtung von Telefonnummern​

Telefonnummern ermöglichen es Ihren Agenten, echte Telefonanrufe entgegenzunehmen und zu tätigen.

Einrichtungsschritte​

  1. Gehen Sie in der Seitenleiste zu Telefonnummern
  2. Klicken Sie auf „Nummer kaufen"
  3. Wählen Sie Land und Nummerntyp
  4. Schließen Sie den Kauf ab
  5. Weisen Sie der Nummer einen Agenten zu

Nummern werden nach dem Kauf automatisch konfiguriert und sind sofort einsatzbereit.

SIP-Trunk-Integration​

Bringen Sie Ihren eigenen SIP-Anbieter mit — HANC spricht nativ SIP und leitet eingehende Anrufe in Ihren Voice Agent (und ausgehende Anrufe zurück über Ihren Trunk). Verfügbar in allen Tarifen einschließlich Free nach einer einmaligen Compliance-Freigabe.

Unterstützte Anbieter​

HANC verfügt über abgestimmte Adapter für die folgenden Anbieter sowie eine generische Option für alles andere:

AnbieterNummern automatisch per API importierenHinweise
sipgateJa (Personal Access Token)EU-SIP-Trunking
PlacetelManuellDeutsches VoIP, Webportal-Zugangsdaten
TENIOSManuellEuropäisches SIP
easybellManuellDeutscher Anbieter, Kundencenter-Zugangsdaten
ZadarmaJa (optionaler API-Schlüssel)Globale Nummern
Twilio (BYO)JaAccount SID + Auth Token
TelnyxJaAPI-gesteuertes SIP und DIDs
Custom SIP-TrunkManuellJeder andere Anbieter — Host, Port, Transport angeben

Compliance-Freigabe​

SIP-Anbieterverbindungen durchlaufen denselben Compliance-Prozess wie ausgehende Kampagnen. Solange Ihr Konto nicht freigegeben ist, öffnet die Schaltfläche SIP verbinden ein Showcase-Fenster, das alle unterstützten Anbieter mit einem mailto:support@hanc.ai-CTA auflistet. Die Freigabe erfolgt in der Regel noch am selben Geschäftstag.

Einrichtungsschritte (nach der Freigabe)​

  1. Gehen Sie zu Telefonnummern → SIP verbinden.
  2. Wählen Sie Ihren Anbieter.
  3. Geben Sie die SIP-Zugangsdaten ein (und optional API-Schlüssel/Secret, falls Ihr Anbieter Auto-Import unterstützt).
  4. Für Custom SIP geben Sie außerdem Host, Port (Standard 5060) und Transport (UDP / TCP / TLS) an.
  5. Klicken Sie auf Verbinden — HANC registriert Ihren SIP-Benutzer und listet, wo unterstützt, Ihre Telefonnummern auf.
  6. Wählen Sie die zu importierenden Nummern aus (oder fügen Sie sie manuell im E.164-Format hinzu).
  7. Weisen Sie jeder Nummer einen eingehenden und/oder ausgehenden Agenten zu.

Wann SIP statt Nummernkauf verwenden​

SzenarioEmpfehlung
Neu im TelefondienstNummern über HANC kaufen (einfacher — kein Compliance-Schritt)
Bestehende Telefonanlage oder AnbietervertragÜber SIP verbinden — Nummer behalten
Unternehmenstelefonie mit strengen AnbieteranforderungenSIP für volle Kontrolle
Mehrere Regionen / NummernpoolsSIP für Flexibilität

Google-Calendar-Integration​

Verbinden Sie Google Calendar, damit Ihre Voice Agents während Anrufen Verfügbarkeiten prüfen und Termine buchen können.

Einrichtungsschritte​

  1. Gehen Sie zu Integration → Kalender
  2. Klicken Sie auf „Google Calendar verbinden"
  3. Melden Sie sich mit Google an
  4. Autorisieren Sie den Zugriff von Hanc.AI

Angeforderte Berechtigungen:

  • Kalenderereignisse ansehen (zur Verfügbarkeitsprüfung)
  • Kalenderereignisse erstellen (zur Terminbuchung)

Kalenderkonfiguration​

Konfigurieren Sie nach dem Verbinden das Kalendertool auf Ihrem Agenten:

EinstellungBeschreibung
calendar_idWelcher Google Calendar für die Terminplanung verwendet wird
timezoneZeitzone für die Terminplanung (z. B. Europe/Vienna)
work_hoursVerfügbare Zeiten für Buchungen (z. B. Montag–Freitag 9:00–18:00)
slot_durationStandard-Termindauer (z. B. 30 Minuten)
bufferPufferzeit zwischen Terminen (z. B. 15 Minuten)

Kalendernutzung in Agenten​

Nach dem Verbinden und Konfigurieren können Agenten:

  • Verfügbarkeit für bestimmte Daten und Zeiten prüfen
  • Termine automatisch buchen
  • Arbeitszeiten und Pufferzeiten berücksichtigen
  • Anfragen zum Verschieben bearbeiten

Beispielgespräch:

Kunde: "Kann ich für Dienstag um 15 Uhr einen Termin buchen?"

Agent: [Prüft den Kalender]
       "Ja, Dienstag um 15 Uhr ist verfügbar.
        Darf ich Ihren Namen haben, um die Buchung abzuschließen?"

Outlook-Calendar-Integration​

Verbinden Sie Microsoft Outlook Calendar, um die Terminplanung über Ihre Voice Agents zu ermöglichen.

Einrichtungsschritte​

  1. Gehen Sie zu Integration → Kalender
  2. Klicken Sie auf „Outlook Calendar verbinden"
  3. Melden Sie sich mit Ihrem Microsoft-Konto an
  4. Autorisieren Sie den Zugriff von Hanc.AI

Angeforderte Berechtigungen:

  • Kalenderereignisse ansehen (zur Verfügbarkeitsprüfung)
  • Kalenderereignisse erstellen (zur Terminbuchung)

Kalenderkonfiguration​

Konfigurieren Sie nach dem Verbinden das Kalendertool auf Ihrem Agenten:

EinstellungBeschreibung
KalenderWelcher Outlook-Kalender für die Terminplanung verwendet wird
ZeitzoneZeitzone für die Terminplanung (z. B. Europe/Vienna)
ArbeitszeitenVerfügbare Zeiten für Buchungen (z. B. Montag–Freitag 9:00–18:00)
TermindauerStandard-Termindauer (z. B. 30 Minuten)
PufferPufferzeit zwischen Terminen (z. B. 15 Minuten)

Unterschiede zu Google Calendar​

Beide Kalenderintegrationen funktionieren aus Sicht des Agenten identisch. Der einzige Unterschied ist der Anmeldevorgang — wählen Sie den Kalenderdienst, den Sie ohnehin nutzen.

tipp

Sie können Google- und Outlook-Kalender gleichzeitig verbinden, aber jeder Agent kann nur ein Kalendertool verwenden.

Termine stornieren​

Anrufer, die einen Termin gebucht haben, erhalten einen Stornier-Link. Sie können ihren Termin direkt stornieren, ohne erneut anrufen zu müssen.

eTermin Terminbuchung​

Verbinden Sie eTermin, damit Ihre Agenten während des Anrufs Verfügbarkeiten prüfen und Termine buchen, verschieben oder stornieren können, direkt in Ihre eTermin-Kalender und -Leistungen — mit integriertem Schutz vor Doppelbuchungen. Verwenden Sie eTermin statt eines einfachen Kalenders, wenn Ihre Termine bereits in eTermin liegen und Sie eigenständige Leistungen mit eigenen Dauern und Regeln anbieten.

Die vollständige eTermin-Seite enthält Verbindungsschritte, die Konfiguration pro Agent und den Schutz vor Doppelbuchungen.

resmio Tischreservierungen​

Verbinden Sie resmio, damit Ihre Agenten während eines Anrufs Restauranttische direkt in Ihr Reservierungsbuch buchen können — mit Prüfung der echten Verfügbarkeit nach Zeit und Gruppengröße sowie Verschieben und Stornieren. Verwenden Sie resmio, wenn Ihr Restaurant Reservierungen bereits darüber annimmt.

Die vollständige resmio-Seite enthält Verbindungsschritte und Details.

Handeln über verbundene Konten in Workflows​

Über die stets aktiven Tools hinaus, die ein Agent während eines Live-Anrufs nutzt, verfügen Workflows über einen eigenen Integration-Schritt (hinzugefügt in v2.8). Fügen Sie einen Integration-Schritt in einen Workflow ein, damit dieser in einem einzigen Schritt über ein verbundenes Google Calendar-, Outlook- oder HubSpot-Konto handelt — zum Beispiel ein Kalenderereignis erstellen oder einen HubSpot-Deal als Teil eines größeren automatisierten Ablaufs aktualisieren. Der Schritt nutzt dieselben Verbindungen auf Kontoebene, die Sie auf dieser Seite einrichten, sodass nichts zusätzlich autorisiert werden muss.

HubSpot-CRM-Integration​

Verbinden Sie Ihren HubSpot-Workspace, damit Ihre Voice Agents während des Anrufs Kontakte und Deals lesen und schreiben können und damit das integrierte CRM von HANC Ihre HubSpot-Pipelines spiegeln kann.

Was es ermöglicht​

  • Live-Tool — HubSpot CRM im Tab Aktionen des Agenten. Der Agent kann den Anrufer per Telefonnummer einem HubSpot-Kontakt zuordnen, die Deal-Phase abrufen und Eigenschaften aus dem laufenden Gespräch aktualisieren. Siehe Aktionen & Tools.
  • Pipeline-Spiegelung im CRM von HANC. Ihre HubSpot-Deal-Phasen erscheinen im Deals-Kanban, sodass Sie Anrufe und HubSpot-Kontext nebeneinander sehen.
  • KI-Umschalter pro Pipeline — legen Sie fest, auf welchen HubSpot-Pipelines die KI handeln darf; alles andere bleibt schreibgeschützt.

Einrichtungsschritte​

  1. Öffnen Sie die Seite Integrationen und klicken Sie auf HubSpot verbinden.
  2. Autorisieren Sie HANC in Ihrem HubSpot-Konto.
  3. Wählen Sie, welche Pipelines gespiegelt werden sollen (sichtbar unter den Einstellungen CRM → Pipeline) und welche Phasenaktualisierungen durch den Agenten zulassen sollen.
  4. Fügen Sie das HubSpot CRM-Tool zu jedem Agenten hinzu, der während des Anrufs auf HubSpot zugreifen soll.
tipp

Sie müssen HubSpot nicht nutzen, um das CRM von HANC zu verwenden. Das integrierte CRM funktioniert eigenständig — die HubSpot-Integration ist ausschließlich für Organisationen gedacht, die bereits in HubSpot arbeiten und beide Welten synchron halten möchten.

MCP-Server​

Das Model Context Protocol (MCP) ist ein offener Standard zur Anbindung von KI-Assistenten an externe Tools. Wenn Sie einen MCP-kompatiblen Server betreiben, können Sie ihn einmal auf der Integration-Seite registrieren und Ihre Agenten seine Tools mitten im Gespräch aufrufen lassen.

Einrichtungsschritte (Überblick)​

  1. Gehen Sie zu Integration → MCP-Server.
  2. Klicken Sie auf MCP-Server verbinden, geben Sie eine Bezeichnung und die HTTPS-URL Ihres Servers ein, wählen Sie die Authentifizierung (Keine oder Bearer-Token) und speichern Sie.
  3. Öffnen Sie den Agenten, der die Tools nutzen soll, gehen Sie zu Aktionen → Aktion hinzufügen → MCP-Server und aktivieren Sie die Verbindungen, die dieser Agent verwenden soll.

Der Agent erkennt und nutzt die Tools des Servers zu Beginn jedes Anrufs.

Die vollständige MCP-Server-Seite enthält die detaillierte Einrichtung, Fehlerbehebung und wie MCP neben den integrierten Tools passt.

API-Schlüssel​

Generieren Sie API-Schlüssel, um Hanc.AI in Ihre eigenen Anwendungen zu integrieren.

Einen API-Schlüssel erstellen​

Sie können bis zu 3 API-Schlüssel pro Benutzer erstellen.

  1. Gehen Sie zu Integration → API-Schlüssel
  2. Klicken Sie auf „API-Schlüssel erstellen"
  3. Geben Sie einen Namen ein (z. B. „CRM-Integration")
  4. Legen Sie Berechtigungen fest (Lesen, Schreiben, Admin)
  5. Kopieren Sie den Schlüssel sofort (wird nur einmal angezeigt)

Sicherheit von API-Schlüsseln​

Wichtig
  • Bewahren Sie Schlüssel sicher auf (Umgebungsvariablen, Secrets-Manager)
  • Committen Sie Schlüssel niemals in die Versionskontrolle
  • Rotieren Sie Schlüssel regelmäßig
  • Löschen Sie ungenutzte Schlüssel

API-Schlüssel verwenden​

In API-Anfragen einfügen:

curl -X GET "https://api.hanc.ai/v1/agent/list" \
  -H "x-api-key: YOUR_API_KEY"

Berechtigungen von API-Schlüsseln​

BerechtigungZugriff
LesenAgenten, Anrufe, Analysen ansehen
SchreibenAgenten erstellen/ändern, KB hochladen
AdminAlle Vorgänge, Löschen, Einstellungen

Verfügbare Endpunkte​

Die vollständige Liste der API-Endpunkte, gruppiert nach Ressource (Calls, Agents, Knowledge Base, Phone Numbers, Voices, Subscription, Customers, Workspaces), finden Sie auf einer eigenen Seite:

→ Vollständige API-Referenz

Webhooks​

Nach jedem Anruf kann Hanc.AI das Gespräch — Zusammenfassung, Gesprächsverlauf und Ihre extrahierten Felder — als JSON an Ihren eigenen Endpunkt senden. Richten Sie das als Aktion API-Aufruf nach dem Anruf am Agenten ein (Folgeaktionen → Post call) oder als Schritt API-Aufruf in einem Workflow.

Ist Ihr Server nicht erreichbar, wird die Anfrage nach einem Zeitplan wiederholt (standardmäßig 8 Versuche über rund 3,4 Tage), jeder Versuch wird protokolliert, und eine fehlgeschlagene Zustellung kann erneut gesendet werden.

Wiederholungen, Zustellprotokoll, Firewall-Anforderungen und Datenformat: siehe Webhooks & Zustellung.

Aktionen nach dem Anruf​

Aktionen nach dem Anruf werden automatisch ausgelöst, nachdem ein Gespräch mit einem Voice Agent endet. Konfigurieren Sie diese auf einzelnen Agenten.

Verfügbare Aktionstypen​

AktionBeschreibung
E-MailEine E-Mail-Zusammenfassung des Anrufs senden (an Geschäftsinhaber, Kunde oder beide)
SMSEine SMS-Benachrichtigung nach dem Anruf senden
WhatsAppEine WhatsApp-Nachricht nach dem Anruf senden
API-AufrufEine HTTP-Anfrage mit Anrufdaten an einen externen Endpunkt senden

Einrichtung​

  1. Gehen Sie zu Voice Agents → wählen Sie Ihren Agenten
  2. Öffnen Sie den Tab Aktionen
  3. Klicken Sie auf „Aktion hinzufügen"
  4. Wählen Sie den Aktionstyp und konfigurieren Sie:
    • Auslöser: Wann die Aktion ausgelöst wird (z. B. nach jedem Anruf, nur bei bestimmten Ergebnissen)
    • Empfänger: Wer die Benachrichtigung erhält
    • Inhalt: Nachrichtenvorlage mit Variablen aus den Anrufdaten

Individuelle Integrationen​

Die API verwenden​

Erstellen Sie individuelle Integrationen mit der Hanc.AI-API:

Base URL: https://api.hanc.ai/v1
Authentication: Bearer token (API key)
Format: JSON

API-Dokumentation​

Die vollständige Liste der verfügbaren Endpunkte finden Sie in der API-Referenz.

Best Practices für Integrationen​

Sicherheit​

  • Bewahren Sie Zugangsdaten sicher auf
  • Rotieren Sie API-Schlüssel regelmäßig
  • Beschränken Sie Berechtigungen auf das nötige Minimum

Zuverlässigkeit​

  • Protokollieren Sie alle Integrationsereignisse
  • Überwachen Sie den Zustand der Integrationen

Testen​

  • Testen Sie Integrationen zuerst in einer Staging-Umgebung
  • Überprüfen Sie den Datenfluss in beide Richtungen
  • Testen Sie Fehlerszenarien
  • Dokumentieren Sie die Integrationseinrichtung

Fehlerbehebung​

Integration lässt sich nicht verbinden​

  1. Prüfen Sie, ob die Zugangsdaten korrekt sind
  2. Achten Sie auf Tippfehler
  3. Stellen Sie sicher, dass das Drittanbieterkonto aktiv ist
  4. Versuchen Sie, zu trennen und erneut zu verbinden

Kalender synchronisiert nicht​

  1. Autorisieren Sie den Kalenderzugriff erneut
  2. Prüfen Sie die Kalenderberechtigungen
  3. Vergewissern Sie sich, dass der ausgewählte Kalender korrekt ist
  4. Prüfen Sie auf Synchronisierungsverzögerungen (bis zu 5 Minuten)

Verwandte Themen​