Zum Hauptinhalt springen
⚙️ Petra anpassen

HalloPetra für n8n: Workflows vor und nach jedem Anruf

Zuletzt aktualisiert Vor 13 Tagen

Was n8n für dich tut

HalloPetra gibt es als Community-Paket für n8n, die Workflow-Automatisierung zum Selberhosten oder in der Cloud. Damit binden deine n8n-Workflows Petra in beide Richtungen ein: Sie geben Petra Infos, bevor sie abnimmt, und reagieren auf das, was sie tut.

Vor dem Anruf weiß Petra, wer anruft. Noch während es klingelt, fragt HalloPetra deinen Workflow, zum Beispiel nach dem Kunden in deinem CRM. Petra begrüßt den Anrufer dann mit Namen.

Nach dem Anruf arbeitet dein Workflow weiter. Der Anrufer landet als Kontakt in deiner Buchhaltung, die Zusammenfassung als E-Mail im Büro. Niemand muss abends Notizen abtippen.

Das brauchst du

  • n8n, in der Cloud oder auf deinem eigenen Server.
  • Admin-Rechte in HalloPetra. Nur Admins legen API-Schlüssel an.

Tipp: Du betreibst n8n selbst? Dann muss deine n8n-Instanz ihre öffentliche Adresse kennen (Umgebungsvariable WEBHOOK_URL, besonders hinter einem Reverse Proxy). Sonst erreicht HalloPetra deine Workflows nicht. In der n8n Cloud musst du dafür nichts tun.

Schritt 1: Das Paket installieren

  1. Öffne in n8n „Settings → Community Nodes → Install“.
  2. Trag das Paket @hallopetra/n8n-nodes-hallopetra ein, und installiere es.

Schritt 2: Einen API-Schlüssel anlegen

  1. Öffne in HalloPetra das Kontomenü oben links, und wähle Integrationen.
  2. Öffne den Reiter API-Schlüssel.
  3. Klicke auf Neuen API-Schlüssel erstellen.
  4. Gib dem Schlüssel einen Namen, zum Beispiel „n8n“. Klicke auf API-Schlüssel erstellen.
  5. Kopiere den Schlüssel. Er beginnt mit hp_ck_ und erscheint nur dieses eine Mal.

Schritt 3: Die Verbindung in n8n anlegen

  1. Leg in n8n ein Credential für HalloPetra an.
  2. Füge deinen API-Schlüssel ein.
  3. Prüfe die Verbindung mit „Test“.

Schritt 4: Den Workflow bauen

Das Paket bringt Trigger für vier Ereignisse mit:

  • Wenn ein Anruf eingeht, bevor Petra abnimmt.
  • Während des Anrufs, wenn Petra im Gespräch etwas nachschauen soll.
  • Nach einem Anruf.
  • Wenn ein Formular ausgefüllt wurde.

Dazu kommen Bausteine, mit denen dein Workflow in HalloPetra Kontakte anlegt oder ändert, Aufgaben anlegt und Mitarbeiter verwaltet.

Ein typischer Workflow vor dem Anruf: Trigger „Wenn ein Anruf eingeht“ → CRM nach der Nummer des Anrufers durchsuchen → Antwort an Petra.

Fertig! Aktiviere den Workflow in n8n. Den Webhook dafür legt n8n selbst in HalloPetra an. Du siehst ihn unter Integrationen → Workflow-Integrationen. Schaltest du den Workflow ab, entfernt n8n ihn wieder.

Gut zu wissen

  • Du hast 2,5 Sekunden: Vor dem Anruf wartet Petra höchstens so lange auf deinen Workflow. Ein Anrufer ist in der Leitung, darum lässt sich die Grenze nicht verlängern. Halte den Workflow bei einer einzigen Suche. Ist er zu langsam oder findet nichts, begrüßt Petra den Anrufer wie gewohnt.
  • Nach dem Anruf schickt HalloPetra jedes Ereignis einmal an deinen Workflow. Lass ihn darum aktiv.
  • Jeder Aufruf ist signiert. So kann dein Workflow prüfen, dass er wirklich von HalloPetra kommt.

Für Techniker

Die HalloPetra-API erreichst du unter https://hallopetra-api.hallopetra.de, mit dem API-Schlüssel als Bearer-Token. Alle Daten, Antwortformate und Endpunkte stehen in der API-Referenz. Du öffnest sie auch unter Integrationen → API-Schlüssel mit API-Referenz öffnen. Weitere Details zum Paket stehen im README auf npm.

Häufige Fragen

Ich sehe den Reiter API-Schlüssel nicht. Was tue ich?

Den Reiter sehen nur Admins. Bitte einen Admin deines Betriebs, den Schlüssel für dich anzulegen.

Mein Workflow startet nicht mehr. Woran liegt das?

Sieh unter Integrationen → Workflow-Integrationen nach. Steht der Webhook auf Automatisch pausiert, hat n8n mehrmals mit „nicht gefunden“ geantwortet. Prüfe den Workflow in n8n, und schalte den Webhook dann wieder ein.

Du brauchst Hilfe?

Melde dich bei unserem Support. Wir richten deinen ersten Workflow gern gemeinsam mit dir ein.