Zum Hauptinhalt springen
DocumentationAPI ReferenceVideo Tutorials

Integrationen

Integrationen erweitern Ihre Sprachagenten um Anbindungen an externe Dienste. Dieser Abschnitt beschreibt alle verfügbaren Integrationen und ihre Einrichtung.

Verfügbare Integrationen​

IntegrationZweckStatusTarife
Phone NumbersTelefonnummern und AnrufeVerfügbarAlle
SIP TrunkEigenen Carrier mitbringen (sipgate, Placetel, TENIOS, easybell, Zadarma, Twilio BYO, Telnyx, Custom)VerfügbarAlle — Compliance-Freigabe erforderlich
Google CalendarTerminbuchungen via GoogleVerfügbarAlle
Outlook CalendarTerminbuchungen via Microsoft OutlookVerfügbarAlle
HubSpot CRMKontakte und Deals aus Ihrem Sprachagenten heraus lesen/schreibenVerfügbarAlle
MCP serversEigenen MCP-kompatiblen Tool-Server mitbringen und dessen Tools Agenten bereitstellen — siehe MCP ServersVerfügbarAlle
API KeysZugriff für externe AnwendungenVerfügbarAlle
WebhooksEchtzeit-Event-BenachrichtigungenVerfügbarAlle
Alle Tarife

Kalender-Integrationen, SIP, HubSpot, MCP servers, API-Zugang und Webhooks sind in allen Tarifen verfügbar, einschließlich Free. SIP-Trunking erfordert eine einmalige Compliance-Freigabe, bevor der Verbindungs-Wizard 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 Phone Numbers
  2. Klicken Sie auf „Buy Number"
  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-Carrier mit — HANC spricht SIP nativ und leitet eingehende Anrufe in Ihren Sprachagenten (sowie ausgehende Anrufe zurück über Ihren Trunk). Verfügbar in allen Tarifen einschließlich Free nach einer einmaligen Compliance-Freigabe.

Unterstützte Carrier​

HANC bietet abgestimmte Adapter für die folgenden Carrier sowie eine generische Option für alle anderen:

CarrierAuto-Import von Nummern via APIHinweise
sipgateJa (Personal Access Token)EU-SIP-Trunking
PlacetelManuellDeutscher VoIP-Anbieter, Webportal-Zugangsdaten
TENIOSManuellEuropäisches SIP
easybellManuellDeutscher Carrier, Kundencenter-Zugangsdaten
ZadarmaJa (optionaler API-Key)Weltweite Nummern
Twilio (BYO)JaAccount SID + Auth Token
TelnyxJaAPI-gesteuertes SIP und DIDs
Custom SIP trunkManuellBeliebiger anderer Anbieter — Host, Port und Transport angeben

Compliance-Freigabe​

SIP-Carrier-Verbindungen nutzen denselben Compliance-Flow wie Outbound-Kampagnen. Bis Ihr Konto freigegeben ist, öffnet der Button Connect SIP ein Showcase-Modal mit allen unterstützten Carriern und einer mailto:support@hanc.ai-Schaltfläche. Die Freigabe erfolgt in der Regel am selben Werktag.

Einrichtungsschritte (nach Freigabe)​

  1. Gehen Sie zu Phone Numbers → Connect SIP.
  2. Wählen Sie Ihren Carrier.
  3. Geben Sie die SIP-Zugangsdaten ein (sowie optional API-Key/Secret, falls Ihr Carrier Auto-Import unterstützt).
  4. Bei Custom SIP zusätzlich Host, Port (Standard 5060) und Transport (UDP / TCP / TLS) angeben.
  5. Klicken Sie auf Connect — HANC registriert Ihren SIP-User und listet, wo unterstützt, Ihre Telefonnummern.
  6. Wählen Sie Nummern zum Import aus (oder fügen Sie sie manuell per E.164 hinzu).
  7. Weisen Sie jeder Nummer einen eingehenden und/oder ausgehenden Agenten zu.

SIP vs. Nummer kaufen — wann was​

SzenarioEmpfehlung
Neu im TelefoniebereichNummern direkt über HANC kaufen (einfacher — kein Compliance-Schritt)
Bestehende PBX oder Carrier-VertragPer SIP anbinden — Nummer behalten
Enterprise-Telefonie mit strikten Carrier-AnforderungenSIP für volle Kontrolle
Mehrere Regionen / NummernpoolsSIP für maximale Flexibilität

Google-Calendar-Integration​

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

Einrichtungsschritte​

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

Angeforderte Berechtigungen:

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

Kalender-Konfiguration​

Nach dem Verbinden konfigurieren Sie das Kalender-Tool an Ihrem Agenten:

EinstellungBeschreibung
calendar_idWelcher Google-Kalender 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 durch Agenten​

Sobald verbunden und konfiguriert, können Agenten:

  • Verfügbarkeiten für bestimmte Daten und Uhrzeiten prüfen
  • Termine automatisch buchen
  • Arbeitszeiten und Pufferzeiten berücksichtigen
  • Umbuchungsanfragen bearbeiten

Beispielgespräch:

Kunde: „Kann ich am Dienstag um 15 Uhr einen Termin buchen?"

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

Outlook-Calendar-Integration​

Verbinden Sie Microsoft Outlook Calendar, um Terminbuchungen über Ihre Sprachagenten zu ermöglichen.

Einrichtungsschritte​

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

Angeforderte Berechtigungen:

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

Kalender-Konfiguration​

Nach dem Verbinden konfigurieren Sie das Kalender-Tool an Ihrem Agenten:

EinstellungBeschreibung
CalendarWelcher Outlook-Kalender 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)

Unterschiede zu Google Calendar​

Aus Sicht des Agenten arbeiten beide Kalender-Integrationen identisch. Der einzige Unterschied liegt im Anmeldeprozess — wählen Sie den Kalenderdienst, den Sie bereits nutzen.

tipp

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

Termine stornieren​

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

HubSpot-CRM-Integration​

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

Was das ermöglicht​

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

Einrichtungsschritte​

  1. Öffnen Sie die Seite Integrations und klicken Sie auf Connect HubSpot.
  2. Autorisieren Sie HANC in Ihrem HubSpot-Konto.
  3. Wählen Sie unter CRM → Pipeline-Einstellungen, welche Pipelines gespiegelt werden sollen und welche Agent-Phasen-Updates erlauben.
  4. Fügen Sie jedem Agenten, der HubSpot während des Anrufs berühren soll, das Tool HubSpot CRM hinzu.
tipp

Sie müssen HubSpot nicht einsetzen, um das CRM von HANC zu nutzen. Das eingebaute CRM funktioniert eigenständig — die HubSpot-Integration richtet sich an Organisationen, die ohnehin in HubSpot arbeiten und beide Welten synchron halten möchten.

MCP Servers​

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 einmalig auf der Integrationsseite registrieren und dessen Tools von Ihren Agenten mitten im Gespräch aufrufen lassen.

Einrichtungsschritte (Überblick)​

  1. Gehen Sie zu Integration → MCP servers.
  2. Klicken Sie auf Connect MCP server, geben Sie ein Label und die HTTPS-URL Ihres Servers an, wählen Sie die Authentifizierung (None oder Bearer token) und speichern Sie.
  3. Öffnen Sie den Agenten, der die Tools nutzen soll, gehen Sie zu Actions → Add Action → MCP servers und aktivieren Sie die Verbindungen, die dieser Agent verwenden soll.

Der Agent entdeckt die Tools des Servers zu Beginn jedes Anrufs und nutzt sie automatisch.

Vollständige Einrichtung, Fehlerbehebung und das Zusammenspiel von MCP mit den integrierten Tools finden Sie auf der eigenen Seite MCP Servers.

API Keys​

Erstellen Sie API-Keys, um Hanc.AI in eigene Anwendungen zu integrieren.

Einen API-Key erstellen​

Sie können bis zu 3 API-Keys pro Nutzer anlegen.

  1. Gehen Sie zu Integration → API Keys
  2. Klicken Sie auf „Create API Key"
  3. Geben Sie einen Namen ein (z. B. „CRM Integration")
  4. Setzen Sie Berechtigungen (read, write, admin)
  5. Kopieren Sie den Key sofort (er wird nur einmal angezeigt)

Sicherheit von API-Keys​

Wichtig
  • Keys sicher speichern (Umgebungsvariablen, Secrets Manager)
  • Keys niemals in die Versionsverwaltung einchecken
  • Keys regelmäßig rotieren
  • Ungenutzte Keys löschen

API-Keys verwenden​

In API-Anfragen einbinden:

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

Berechtigungen für API-Keys​

BerechtigungZugriff
ReadAgenten, Anrufe und Analytik einsehen
WriteAgenten erstellen/ändern, KB-Dateien hochladen
AdminAlle Operationen, Löschen, Einstellungen

Verfügbare Endpoints​

Die vollständige Liste der API-Endpoints, gruppiert nach Ressource (Anrufe, Agenten, Knowledge Base, Telefonnummern, Stimmen, Abonnement, Kunden, Workspaces), finden Sie auf einer eigenen Seite:

→ Vollständige API-Referenz

Webhooks​

Konfigurieren Sie Webhooks, um Echtzeit-Benachrichtigungen über Ereignisse in Ihrem Hanc.AI-Konto zu erhalten.

Einrichtung​

  1. Gehen Sie zu Integration → Webhooks
  2. Geben Sie die URL Ihres Webhook-Endpoints ein
  3. Wählen Sie die Events aus, die abonniert werden sollen
  4. Speichern Sie die Konfiguration

Webhooks senden HTTP-POST-Anfragen an Ihren Endpoint mit den Event-Daten im JSON-Format.

Post-Call-Aktionen​

Post-Call-Aktionen werden automatisch ausgelöst, nachdem ein Gespräch mit einem Sprachagenten endet. Konfigurieren Sie sie pro Agent.

Verfügbare Aktionstypen​

AktionBeschreibung
EmailEine E-Mail-Zusammenfassung des Anrufs senden (an den Geschäftsinhaber, den Kunden oder beide)
SMSEine SMS-Benachrichtigung nach dem Anruf senden
WhatsAppEine WhatsApp-Nachricht nach dem Anruf senden
API CallEine HTTP-Anfrage an einen externen Endpoint mit den Anrufdaten ausführen

Einrichtung​

  1. Gehen Sie zu Voice Agents → wählen Sie Ihren Agenten
  2. Öffnen Sie den Actions-Tab
  3. Klicken Sie auf „Add Action"
  4. Wählen Sie den Aktionstyp und konfigurieren Sie:
    • Trigger: Wann die Aktion ausgelöst wird (z. B. nach jedem Anruf, nur bei bestimmten Ergebnissen)
    • Recipients: Wer die Benachrichtigung erhält
    • Content: Nachrichtenvorlage mit Variablen aus den Anrufdaten

Eigene Integrationen​

Mit der API​

Bauen Sie eigene Integrationen mit der Hanc.AI-API:

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

API-Dokumentation​

Die API-Referenz enthält die vollständige Liste der verfügbaren Endpoints.

Best Practices für Integrationen​

Sicherheit​

  • Zugangsdaten sicher speichern
  • API-Keys regelmäßig rotieren
  • Berechtigungen auf das nötige Minimum beschränken

Zuverlässigkeit​

  • Alle Integrations-Events protokollieren
  • Gesundheit der Integrationen überwachen

Tests​

  • Integrationen zuerst im Staging testen
  • Datenfluss in beide Richtungen verifizieren
  • Fehlerszenarien testen
  • Integrations-Setup dokumentieren

Fehlerbehebung​

Integration verbindet sich nicht​

  1. Zugangsdaten auf Korrektheit prüfen
  2. Auf Tippfehler achten
  3. Sicherstellen, dass das Drittanbieter-Konto aktiv ist
  4. Trennen und neu verbinden

Kalender synchronisiert nicht​

  1. Kalenderzugriff neu autorisieren
  2. Kalenderberechtigungen prüfen
  3. Sicherstellen, dass der richtige Kalender ausgewählt ist
  4. Auf Synchronisierungs-Verzögerungen achten (bis zu 5 Minuten)

Verwandte Themen​