n8n: KI-Telefonie individuell anbinden

Individuelle Anbindung. n8n übernimmt die Verarbeitung zwischen smao und deinem Zielsystem. Der Anbindungsweg nutzt HTTP-Anfragen an die smao Public API oder ein eigens konfiguriertes Webhook-Tool.

Dieser Leitfaden beschreibt eine Verbindung über API oder Automatisierung. Sie erfordert eigene Konfiguration und ist keine native One-Click-Integration. Die Beispiele zeigen ein mögliches Mapping; Zugang und Zielaktionen werden vor dem produktiven Einsatz im jeweiligen Konto geprüft.

Wie kommen Anrufdaten aus smao in n8n?

Für eine Verarbeitung nach dem Gespräch kann ein zeitgesteuerter n8n-Workflow die smao Public API abfragen. GET /calls liefert die Anrufliste; GET /calls/{call_id} ergänzt Transkript, Analyseergebnisse und Notizen. Der API-Key wird als Bearer-Token hinterlegt und gilt für die zugehörige Organisation.

Verarbeitet nur abgeschlossene Anrufe. Eine abgeschlossene Telefonverbindung bedeutet noch nicht, dass jede Analyse fertig ist: Prüft den Status der benötigten Analyse und ruft ausstehende Ergebnisse später erneut ab.

Beispiel: Vom Anruf zum Ticket im Zielsystem

Angenommen, eine konfigurierte Analyse erfasst das Anliegen „Drucker ausgefallen“. n8n ordnet diese Felder einem nachgelagerten Ticketsystem zu. Das Ticket entsteht dort; n8n steuert die Verarbeitung. Das folgende Mapping ist ein Beispiel und kein festes smao-Exportformat.

• Anruf-ID → eigene Gesprächsreferenz im Zielsystem und Schlüssel gegen doppelte Verarbeitung.
• phone_number → Suche nach einem vorhandenen Kontakt; fehlende oder mehrdeutige Treffer zur Prüfung vorlegen.
• analyses[].body_result → die von eurer Analyse tatsächlich gelieferten Angaben, etwa Fehlerbild und Rückrufwunsch.
• Ticketantwort → Ziel-ID speichern; den Anruf erst nach erfolgreicher Übergabe als verarbeitet markieren.

Welche Einstellungen braucht der Workflow?

Hinterlegt den smao API-Key in den n8n-Zugangsdaten und stellt den HTTP-Request-Node auf GET. Filtert die Anrufliste nach eurem Zeitraum und Assistenten. Arbeitet alle Seiten über meta.next_cursor ab, solange meta.has_more gesetzt ist.

Behaltet noch laufende Anrufe und ausstehende Analysen für spätere Durchläufe vor. Ein wiederholter Abruf darf kein zweites Ticket erzeugen. Testet fehlende Kontaktdaten, verspätete Analysen und einen Ausfall des Zielsystems mit eurem eigenen Testkonto.

Wann ist ein Webhook sinnvoll?

Für eine Aktion während des Gesprächs kann ein separat eingerichtetes smao-Webhook-Tool einen n8n-Webhook aufrufen. Verwendet die Produktions-URL und eine passende Authentifizierung. Die smao API dokumentiert dafür HTTPS-Endpunkte; private oder lokale Zieladressen sind nicht zulässig.

Ein Tool-Aufruf im Gespräch und die spätere Auswertung eines beendeten Anrufs sind unterschiedliche Abläufe. Richtet keinen vermeintlichen Standard-Webhook „call completed“ ein, ohne dass dieser für euren Anbindungsweg dokumentiert ist. Interne Zielsysteme benötigen eine geeignete, kontrollierte Vermittlung.

Datenfluss und Verantwortung

Die smao Cloud verarbeitet Gespräche in Deutschland, ohne OpenAI und ohne US-KI-Subprozessoren in der Gesprächsverarbeitung. Für übertragene Daten gelten zusätzlich die Einstellungen und Verarbeitungsbedingungen von n8n und weiteren beteiligten Diensten. Übergebt nur die benötigten Felder und legt Zugriffe, Aufbewahrung und Fehlerbehandlung fest.

Quellen und technische Dokumentation

• smao Public API: Anrufe, Analyseergebnisse und Webhook-Tools
• n8n: Webhook-Node, Test- und Produktions-URL
• n8n: HTTP Request

Passende Anwendungsfälle

• Strukturierte Gesprächsdaten auswerten
• Integrationen für Partner und Agenturen
• Architektur und Datenverarbeitung

Die Anbindung an n8n planen

Kläre Zielprozess, Berechtigungen und Umsetzung mit deinem Integrationspartner oder dem smao Team.