Zum Inhalt springen

Make: KI-Telefonie individuell anbinden

smao mit Make verbinden: Gesprächsdaten über die Public API abrufen und in einem eigenen Szenario weiterverarbeiten. Mapping und Fehlerfälle erklärt.

Dokumentationsstand: · smao Team

Individuelle Anbindung. Ein individuell eingerichtetes Make-Szenario kann Anrufdaten aus smao abrufen und an die gewünschten Apps übergeben. Die Zielaktion und ihre Berechtigungen werden pro Szenario festgelegt.

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 lässt sich smao in ein Make-Szenario einbinden?

Der dokumentierte Ausgangspunkt ist die smao Public API. Ein geplantes Szenario liest mit einem HTTP-Modul die Anrufliste über GET /calls und anschließend die Details der relevanten Anrufe über GET /calls/{call_id}. Der Zugriff benötigt einen API-Key der passenden smao-Organisation.

Die Felder für das Zielsystem werden aus den tatsächlich verfügbaren Gesprächs- und Analyseergebnissen abgeleitet. Das Vorhandensein einer App in Make bedeutet nicht, dass jede gewünschte Aktion oder jede Lizenz diese Aktion unterstützt.

Beispiel: Aus einem Rückrufwunsch wird eine Aufgabe

Ein eigener Ablauf kann einen abgeschlossenen Anruf mit Rückrufwunsch in eine Aufgabe im gewählten System überführen. Das Beispiel beschreibt die Zuordnung; es ist keine fertig aktivierte smao-Vorlage.

  • Anruf-ID → eindeutige Referenz, damit wiederholte Szenarioausführungen dieselbe Aufgabe erkennen.
  • Rückrufwunsch aus der konfigurierten Analyse → Beschreibung der Aufgabe.
  • Telefonnummer und Kontaktbezug → nur nach geprüftem Treffer dem richtigen Kunden zuordnen.
  • Zuständigkeit und Fälligkeit → aus euren Regeln setzen, fehlende Angaben zur manuellen Klärung weitergeben.

Was wird vor dem Start eingerichtet?

Konfiguriert HTTP-Zugangsdaten, Zeitplan und die Verbindung zur Ziel-App. Die smao-Antwort enthält data und bei Listen zusätzlich meta. Der Cursor muss weitergegeben werden, wenn weitere Seiten existieren. Noch nicht abgeschlossene Anrufe und ausstehende Analysen bleiben für einen späteren Durchlauf vorgemerkt.

Speichert die Zuordnung von Anruf-ID und Ziel-ID erst nach einer erfolgreichen Zielaktion. Prüft im Testkonto den ersten Durchlauf, eine Wiederholung und den Fall, dass die Ziel-App nicht erreichbar ist. API-Zugangsdaten gehören in die geschützte Verbindungskonfiguration, nicht in sichtbare Notizen.

Welche Grenzen hat die Verbindung?

Dieser Weg verspricht keinen nativen smao-Baustein in Make. Ein Custom Webhook ist ein alternativer Eingang für einen gezielt konfigurierten Aufruf; er ist nicht automatisch eine Benachrichtigung über jeden beendeten Anruf.

Ausführungsintervall, Kontingente, erlaubte Zielaktionen und Fehlerbehandlung hängen vom Make-Szenario und den beteiligten Konten ab. Die Verbindung muss deshalb mit euren Daten und Berechtigungen geprüft werden.

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 Make und weiteren beteiligten Diensten. Übergebt nur die benötigten Felder und legt Zugriffe, Aufbewahrung und Fehlerbehandlung fest.

Quellen und technische Dokumentation

Passende Anwendungsfälle

Die Anbindung an Make planen

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