Zur Navigation springen

n8n

Führen Sie n8n-Workflows während Anrufen mit einem Webhook-Tool aus.

Verbinden Sie einen n8n-Workflow mit einem Webhook-Tool. Wenn eine Unterhaltung der Beschreibung des Tools entspricht, erfasst Ihr Empfangsassistent die Details, ruft den Workflow auf und liest dem Anrufer die Antwort vor. Über n8n kann der Empfangsassistent jede App erreichen, mit der n8n verbunden ist.

Workflow erstellen

1

Webhook-Trigger hinzufügen

Erstellen Sie in n8n einen Workflow und fügen Sie einen Webhook-Knoten hinzu. Setzen Sie HTTP Method auf POST.

2

Webhook schützen

Setzen Sie Authentication auf Header Auth und erstellen Sie eine Zugangsdatenkonfiguration mit einem Header-Namen wie X-Reception-Key sowie einem langen zufälligen Wert. Reception.ai sendet diesen Header bei jedem Aufruf.

3

Antwort zurückgeben

Setzen Sie Respond auf Using ‘Respond to Webhook’ Node. Fügen Sie Ihre Workflow-Schritte hinzu und beenden Sie ihn dann mit einem Respond to Webhook-Knoten, der JSON zurückgibt, zum Beispiel {"available": true, "next_slot": "Tuesday 10am"}. Ihr Empfangsassistent liest diese Antwort, um zu entscheiden, was er sagen soll.

4

Workflow aktivieren

Aktivieren Sie den Workflow und kopieren Sie die Production URL aus dem Webhook-Knoten. Die Test-URL funktioniert nur, während der Editor lauscht.

Webhook-Tool erstellen

Gehen Sie zu Integrations, wählen Sie Add integration und dann Webhook Tool.

FeldWert
NameWas der Workflow macht, zum Beispiel check_service_area
DescriptionWann es verwendet wird, zum Beispiel „Prüfe, ob wir die Postleitzahl des Anrufers bedienen. Verwende es vor der Buchung eines Vor-Ort-Termins.“
MethodPOST
URLDie Produktions-URL des Workflows
Request HeadersHeader-Name und -Wert aus der n8n-Zugangsdatenkonfiguration
Body ParametersEin Parameter pro Wert, den der Workflow benötigt, zum Beispiel zip_code (String, erforderlich). n8n liest sie aus body.zip_code.
Assign to agentsReceptionist

Wählen Sie Enable und testen Sie Ihren Empfangsassistenten mit einer Unterhaltung, die den Workflow auslösen sollte. Jede Ausführung erscheint in der Liste Executions von n8n.

Body-Parameter sind einfache Werte, die Ihr Empfangsassistent aus der Unterhaltung ausfüllt. Um einen festen Wert zu senden, legen Sie ihn stattdessen im Workflow fest.

Mehrere Workflows über MCP bereitstellen

Um Ihrem Empfangsassistenten viele n8n-Workflows gleichzeitig bereitzustellen, verwenden Sie stattdessen den Knoten MCP Server Trigger von n8n. Verbinden Sie die Workflows oder Tool-Knoten, die Sie bereitstellen möchten, setzen Sie die Authentifizierung des Triggers auf Bearer und aktivieren Sie ihn. Fügen Sie in Reception.ai einen MCP-Server mit der Produktions-URL des Triggers und dem Bearer-Token als Secret Token hinzu. Weisen Sie die Tools dann auf der Registerkarte Tools zu.

Fehlerbehebung

ProblemPrüfen Sie
Keine Ausführung erscheint in n8nDer Workflow muss aktiv sein und das Tool muss die Produktions-URL verwenden.
Der Workflow gibt 403 zurückHeader-Name und -Wert in Reception.ai müssen exakt mit der n8n-Zugangsdatenkonfiguration übereinstimmen.
Der Empfangsassistent sagt, das Tool sei fehlgeschlagenDer Workflow muss innerhalb des Response timeout des Tools abgeschlossen sein. Standardmäßig sind es 20 Sekunden, maximal 120.
Der Empfangsassistent ruft das Tool nie aufNennen Sie in der Beschreibung des Tools die Situationen, in denen es verwendet werden soll. Sie können auch eine Prozedur hinzufügen.