Zum Hauptinhalt springen
⚙️ Petra anpassen

Webhooks: Petra mit deinem eigenen System verbinden

Zuletzt aktualisiert Vor 13 Tagen

Was Webhooks für dich tun

Mit einem Webhook ruft Petra dein eigenes System auf, wenn etwas passiert: vor einem Anruf, im Gespräch, danach oder wenn ein Formular ankommt. So landen die Anrufdaten in deinem CRM, oder Petra kennt den Anrufer schon vor der Begrüßung. Das klappt mit n8n, Make, Zapier oder deiner eigenen Software.

Das brauchst du

  • Admin-Rechte in HalloPetra. Nur Admins sehen im Kontomenü den Eintrag Integrationen.
  • Eine Adresse (URL) deines Systems, die Daten über HTTPS annimmt.

Tipp: Du arbeitest mit n8n oder Make? Dann nimm die fertige App. Sie legt die Webhooks selbst an: HalloPetra für n8n, HalloPetra für Make.

Schritt 1: Einen Webhook anlegen

  1. Öffne das Kontomenü oben links, und wähle Integrationen.
  2. Öffne den Reiter Workflow-Integrationen.
  3. Klicke auf Webhook hinzufügen.
  4. Trag einen Name und die URL deines Systems ein.
  5. Wähle den Typ. Er legt fest, wann Petra dein System aufruft.
  6. Braucht dein System einen Zugangsschlüssel, trag ihn unter Headers ein.
  7. Klicke auf Webhook erstellen.
TypWann Petra dein System aufruft
Vor dem AnrufSobald ein Anruf eingeht, bevor Petra spricht. Dein System kann Petra Infos zum Anrufer zurückgeben.
Während des AnrufsWenn Petra im Gespräch etwas nachschauen soll, zum Beispiel einen Liefertermin.
Nach dem AnrufWenn Petra den Anruf ausgewertet hat.
Bei FormulareingangWenn jemand ein Formular ausfüllt und abschickt.
Bei neuem KontaktSobald ein neuer Kontakt angelegt ist. Einmal pro Kontakt.
Bei erfassten KontaktdatenSobald ein Kontakt zum ersten Mal einen Namen hat. Einmal pro Kontakt.
Bei TerminbuchungWenn ein Termin gebucht wird.

Im Formular siehst du zu jedem Typ ein Beispiel für die Daten, die Petra schickt, und für die Antwort, die sie versteht.

Schritt 2: Festlegen, wann der Webhook läuft

Bei Vor dem Anruf und Nach dem Anruf wählst du den Ausführungstyp:

  • Alle Anrufe: Petra ruft den Webhook bei jedem Anruf auf.
  • Nur wenn ausgewählt: Petra ruft ihn nur auf, wenn du ihn in einer Aktion auswählst.

Einen Webhook Während des Anrufs gibst du Petra in einem Ablauf:

  1. Öffne Anrufe → Abläufe, und öffne den Ablauf.
  2. Klicke unter Funktionen aufrufen auf Funktion hinzufügen.
  3. Wähle deinen Webhook.

Die übrigen Typen laufen immer für deinen ganzen Betrieb.

Schritt 3: Den Webhook testen

Klicke in der Liste beim Webhook auf Testen. HalloPetra schickt eine Testanfrage an deine URL. Du siehst sofort, ob sie geklappt hat.

Fertig! Alle Webhooks findest du später unter Integrationen → Workflow-Integrationen. Dort stehen auch die Webhooks, die n8n oder Make selbst angelegt haben.

Gut zu wissen

  • Kein Anruf geht verloren: Vor dem Anruf wartet Petra höchstens 2,5 Sekunden auf dein System, im Gespräch höchstens 10 Sekunden. Kommt keine Antwort, führt Petra das Gespräch ohne die Zusatzinfos weiter.
  • Nach dem Anruf schickt HalloPetra die Daten einmal. Die Antwort deines Systems liest Petra nicht. Willst du Daten zurück in HalloPetra schreiben, nutze die API.
  • Jeder Webhook hat einen eigenen Schlüssel. Du kopierst ihn über das Menü mit den drei Punkten: Signatur-Schlüssel kopieren. Damit prüft dein System, dass ein Aufruf wirklich von HalloPetra kommt.
  • Mit dem Schalter in der Zeile pausierst du einen Webhook, ohne ihn zu löschen. Er steht dann auf Pausiert.
  • Antwortet deine URL mehrmals hintereinander mit „nicht gefunden“, pausiert HalloPetra den Webhook selbst. Er steht dann auf Automatisch pausiert. Prüfe dann deinen Zap oder dein Szenario, trag bei Bedarf eine neue URL ein, und schalte den Webhook wieder ein.

Daten und Antwortformat

Welche Daten Petra schickt und was dein System antworten kann, steht in der API-Referenz: hallopetra-api.hallopetra.de/reference. Du öffnest sie auch unter Integrationen → API-Schlüssel mit API-Referenz öffnen.

Häufige Fragen

Mein Webhook wird nicht aufgerufen. Woran liegt das?

Prüfe, ob er auf Pausiert oder Automatisch pausiert steht. Steht der Ausführungstyp auf Nur wenn ausgewählt, muss der Webhook in einer Aktion ausgewählt sein.

Kann ich Zapier nutzen?

Ja. Leg in Zapier einen Webhook-Trigger an, und trag seine URL in HalloPetra ein.

Kann Petra mir im Gespräch Daten aus meinem System vorlesen?

Ja, mit einem Webhook Während des Anrufs. Dein System antwortet mit einem kurzen Text, und Petra sagt ihn dem Anrufer.

Du brauchst Hilfe?

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