Custom Integrations

Wenn Ihr Assistent mit Ihren eigenen Systemen kommunizieren soll — einem Buchungssystem, einer internen API, einem CRM ohne fertigen Connector — erstellen Sie eine Custom Integration. Dies ist eine vollständige, codefreie Möglichkeit, eine REST-API-Verbindung sowie konkrete aufrufbare Aktionen dafür zu definieren.

Vorab klären

1. Welche Aktion? Verfügbarkeit prüfen, eine Buchung anlegen, Bestellstatus nachschlagen, einen Datensatz erstellen. Eine Aktion pro Zweck.
2. Wer hat API-Zugriff? Zugangsdaten kommen von Ihrem Anbieter oder Ihrer IT.
3. Welche Felder braucht die API, und welche gibt sie zurück?
4. Wie schnell antwortet sie? Für Aufrufe während eines Gesprächs sollten es wenige Sekunden sein.
5. Testen Sie die Aufrufe vorab außerhalb von MIA (z. B. mit Postman) mit echten Werten. Funktioniert der Aufruf dort nicht, funktioniert er auch in MIA nicht — und die Fehlersuche geht dort deutlich schneller.

1. Verbindung erstellen

1. Öffnen Sie Marketplace → Custom Integrations → Add custom integration.

2. Füllen Sie Folgendes aus:

   Feld	Beschreibung
   Name	Eine Bezeichnung für diese Verbindung, z. B. „Salesforce CRM API.”
   Description	Wofür die Verbindung gedacht ist.
   Base URL	Die Root-URL der API, z. B. https://yourinstance.my.salesforce.com/services/data/v59.0.
   Auth type	None, Bearer (ein Token), API Key, Basic (Benutzername/Passwort) oder Headers (beliebige benutzerdefinierte Header) — füllen Sie dann das jeweils passende Zugangsdaten-Feld aus.

3. Speichern Sie. Die Verbindung erscheint nun unter Custom Integrations.

2. Eine Aktion hinzufügen

Öffnen Sie die Verbindung und fügen Sie eine Aktion hinzu — dies ist der konkrete API-Aufruf, den Ihr Assistent ausführen kann:

Speichern Sie die Aktion.

3. In einem Workflow verwenden

1. Öffnen Sie Ihren Workflow → Tab Integration → Panel Integrationen → Add integration.
2. Wählen Sie Ihre Custom Integration und die gewünschte Aktion aus.
3. Handelt es sich um eine In-call-Aktion mit evaluate-data, verweisen Sie in Ihrem Prompt direkt auf die zurückgegebenen Felder (z. B. „bestätige die vom Tool zurückgegebene Buchungsreferenz”).
4. Speichern Sie und veröffentlichen Sie den Workflow anschließend.

Was Sie zusätzlich in den Prompt schreiben müssen

Eine Aktion anzubinden reicht allein nicht aus — der Assistent muss wissen, wann er sie nutzt und was bei Fehlern passiert (siehe Den Prompt schreiben → Tools). Diese drei Punkte werden am häufigsten vergessen:

• Wann sie aufgerufen wird und wann nicht. Sonst ruft der Assistent sie zu früh auf, mit nur der Hälfte der Werte.
• Was er während des Wartens sagt. „Einen Moment, ich schaue nach.” Ohne diese Zeile entsteht Stille.
• Was bei keiner Antwort oder einem Fehler passiert. Ohne Fallback-Regel gerät das Gespräch ins Stocken. Empfehlung: die Anfrage als Nachricht aufnehmen und einen Rückruf versprechen.

Für Aktionen, die etwas anlegen (Buchungen, Bestellungen): Klären Sie mit Ihrer IT, was bei einem Retry passiert. Ohne Absicherung auf Seiten Ihrer API können doppelte Datensätze entstehen.

Vollständiges Praxisbeispiel: Anbindung eines CRM (Salesforce)

Ein typischer Anwendungsfall für Custom Integrations ist die direkte Protokollierung jedes Anrufs in einem CRM, das Ihr Unternehmen bereits einsetzt — zum Beispiel die Erstellung eines neuen Datensatzes in Salesforce, sobald ein Anruf endet, ganz ohne manuellen Eingriff in Salesforce. Die REST-API von Salesforce folgt demselben Anfrage-/Antwortschema, das hier gezeigt wird, sodass sich dieses Beispiel auf die meisten CRMs übertragen lässt (HubSpot, Zoho oder ein internes System) — tauschen Sie einfach Base URL, Auth und Feldnamen aus.

Verbindung:

Aktion — „Create Lead”:

Angebunden an den Integration-Tab eines Vertriebs- oder Support-Workflows, wird nach jedem Anruf mit den vom Assistenten erfassten Angaben (Name, Telefonnummer, E-Mail des Anrufers) automatisch ein neuer Salesforce-Lead erstellt, wobei die id des neuen Datensatzes zur weiteren Verwendung zurückerfasst wird — ganz ohne manuelle Dateneingabe.