Webhooks mit POST-Anfragen
Aus Planfix
Um zu verstehen, wie Webhooks mit POST-Anfragen funktionieren, sehen wir uns ein einfaches Beispiel an: Erstellen eines Kontakts in Planfix für eine Person, die ein Feedback-Formular auf Ihrer Website ausgefüllt hat.
Beispiel-Webhook mit einer POST-Anfrage:
https://ваш_аккаунт.planfix.ru/webhook/POST/create_contact
So richten wir den Webhook ein, der Kontakte erstellt:
- Geben Sie POST als Anfrage-Typ an:
- Webhook-Links enthalten einen eindeutigen Code, den wir bei Bedarf durch etwas aussagekräftigeres ersetzen können:
- Fügen Sie in den Webhook-Parametern die Feldnamen aus dem Feedback-Formular hinzu:
- Geben Sie den Namen der Person an, der die Aktion in Planfix nach Auslösen des Webhooks zugeschrieben wird:
- Wählen Sie die Art der Operation aus und konfigurieren Sie sie. Letztlich wird Planfix einen neuen Kontakt mithilfe der angegebenen Vorlage erstellen, einen Name aus dem name-Parameter im Link und eine Phone Number aus dem phone-Parameter im Link hinzufügen und anschließend die erforderliche/n Mitarbeiter/in über den neuen Kontakt benachrichtigen:
- Fügen Sie dann bei Bedarf weitere Operationen hinzu und legen Sie im letzten Schritt fest, welche Art von Antwort Sie vom Webhook erhalten möchten: JSON, Weiterleitung zu Planfix oder Weiterleitung zu Ihrer Website:
- Fügen Sie anschließend den Webhook-Link in den Code des Feedback-Formulars auf Ihrer Website ein:
<form method="post" action="https://own_account.planfix.ru/webhook/POST/create_contact">
<input type="text" name="name" placeholder="First name">
<input type="text" name="phone" placeholder="Phone">
<input type="submit" name="submit" value="Submit">
</form>
- Wenn ein Kunde im Feedback-Formular seinen Namen und seine Telefonnummer eingibt und anschließend auf die Schaltfläche Submit klickt:
- Die Werte aus den Formularfeldern werden an den Webhook angehängt und an Planfix gesendet, wo automatisch ein neuer Kontakt erstellt wird:
