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
- Öffne das Kontomenü oben links, und wähle Integrationen.
- Öffne den Reiter Workflow-Integrationen.
- Klicke auf Webhook hinzufügen.
- Trag einen Name und die URL deines Systems ein.
- Wähle den Typ. Er legt fest, wann Petra dein System aufruft.
- Braucht dein System einen Zugangsschlüssel, trag ihn unter Headers ein.
- Klicke auf Webhook erstellen.
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:
- Öffne Anrufe → Abläufe, und öffne den Ablauf.
- Klicke unter Funktionen aufrufen auf Funktion hinzufügen.
- 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.
War dies hilfreich?
Mehr in ⚙️ Petra anpassen
Stimme und Stil: So klingt Petra am TelefonBegrüßungen: So meldet sich Petra am TelefonAnrufe einrichten: Was Petra im Gespräch für dich erledigtWissen: Petra beibringen, was sie über deinen Betrieb wissen mussBrauchen Sie noch Hilfe? Idee teilen