HILFE - SUPPORT
Wie man Webhooks in Pilotly (Zapier) verwendet
INHALTSVERZEICHNIS
>Einführung
>Was sind Webhooks?
>Wie funktionieren Webhooks?
Wie man Webhooks in Pilotly verwendet
>(A) Eingehender Webhook
>(B) Ausgehender Webhook
Häufig gestellte Fragen
>Was ist Zapier, Make oder Pabbly?
>Einstieg mit Zapier
>Was sind die Unterschiede zwischen API und Webhooks?
Einführung
Benötigen Sie Informationen aus einer anderen von Ihnen verwendeten Anwendung? Webhooks sind sicherlich eine der ersten Wahl für viele Benutzer, da sie die Möglichkeiten, Informationen von einem Ort zum anderen zu senden, erheblich verbessern. Wenn unsere leistungsstarken PilotlyWorkflow-Automatisierungen nicht in der Lage sind, eine Aufgabe für Sie zu erledigen - die Chancen stehen gut, dass ein Webhook es kann... Oder bringt Sie zumindest in die Nähe davon!
In diesem Artikel zeigen wir Ihnen, wie Sie Webhooks in Pilotly verwenden können.
Was sind Webhooks?
HTTPS-Anfragen (oder Webhooks) steuern fast alles, womit Sie im Internet interagieren. Webhooks ermöglichen es Anwendungen wie Pilotly, mit Stripe, Twilio, Mailgun, Zapier und anderen zu kommunizieren. Jetzt haben Sie vollen Zugriff auf Webhooks, um Ihre Geschäftsanforderungen zu erfüllen!
Webhooks sind eine hervorragende Möglichkeit, Anwendungen miteinander zu verbinden. Mit Webhooks können Plattformen kommunizieren, um bestimmte Aufgaben zu erfüllen, indem sie Anwendungen miteinander verbinden. Im Folgenden werden gängige Begriffe bei der Verwendung von Webhooks erläutert.
Hilfreiche Definitionen:
HTTPS-Anfrage - Der offizielle Begriff für die Art der Anfrage, die ein Webhook ist... HTTP ist die primäre Methode, um Informationen zwischen Websites und Webbrowsern zu senden. HTTPS ist eine sicherere Version, bei der die Daten bei der Übertragung verschlüsselt werden.Auslösendes Ereignis- Das eindeutige Ereignis, das eintritt und einer App signalisiert, Informationen an die Webhook-URL einer anderen App zu senden.Webhook-URL- Eine eindeutige URL, die von der App erstellt wird, die eine Webhook-Anfrage erhält. Payload - bezieht sich auf alle Informationen, die verpackt und von einer App an eine andere gesendet werden.Query Params - ähnlich wie UTM-Parameter sind Query Params eine hilfreiche Methode, um Informationen über die Webhook-URL zuzuordnen. Mapping - Wie das Verbinden von Punkten ist das Mapping der Prozess, bei dem die empfangene Nutzlast in die richtigen Felder für die Verwendung in der empfangenden Anwendung "gemappt" wird. Die Nutzdaten enthalten zum Beispiel einen Kontaktnamen, eine E-Mail und den Namen des gekauften Dienstes. Sie müssen diese Informationen aus der Nutzlast in die richtigen benutzerdefinierten Felder für den Kontakt innerhalb des Pilotly-Workflows "mappen" oder verbinden.
Wie funktionieren Webhooks?
Im Allgemeinen werden Webhooks verwendet, um Anwendungen zu verbinden. Sie erfordern ein auslösendes Ereignis, das einer Anwendung signalisiert, die Anfrage an eine andere Anwendung zu senden. Ein Beispiel: Ein Kauf findet in Ihrer Zahlungssoftware Stripe statt, die an Pilotly gesendet wird. Stripe verpackt also die Informationen in eine "Nutzlast" (oder die gesendeten Informationen), die an Pilotly gesendet wird. In Pilotly können die empfangenen Informationen dann zur Ausführung von Aufgaben verwendet werden.
Um Webhooks zu verwenden, muss eine Anwendung die Webhook-URL bereitstellen. Eine Webhook-URL ist eine eindeutige URL, die von der Anwendung erstellt wird, die eine Webhook-Anfrage erhält. Sie ist so etwas wie eine Adresse oder Telefonnummer. Wenn Sie ein Unternehmen anrufen möchten, benötigen Sie die eindeutige Telefonnummer und manchmal sogar eine Durchwahl, um die richtige Abteilung zu erreichen. Mit einer Webhook-URL verhält es sich ähnlich - es handelt sich um eine eindeutige Telefonnummer, an die eine Anrufanfrage gestellt wird.
Anwendungsfall Beispiel
Sie besitzen einen Shopify eCommerce Shop, der Stripe zur Zahlungsabwicklung nutzt. Sie möchten pilotly verwenden, um E-Mails an bestimmte Benutzer zu senden, die einen bestimmten Kurs gekauft haben. Die Informationen zu den Käufen befinden sich jedoch nicht in Pilotly - Sie wissen also nicht, wer was gekauft hat. Um E-Mails an die richtigen Kontakte in Pilotly zu senden, müssen Sie ein Webhook-Ereignis erstellen, das jedes Mal in Pilotly ausgelöst wird, wenn ein bestimmtes Produkt in Stripe gekauft wird. Pilotly kann dann diese Informationen verwenden, um bestimmte Aufgaben auszuführen, wie z.B. das Versenden von E-Mails an die spezifischen Kontakte, die das Produkt gekauft haben.
In diesem Szenario werden Sie den Pilotly-Workflow-Auslöser "Inbound Webhook" verwenden, um die Informationen von Stripe abzufangen. Um es einfacher zu machen, empfehlen wir Ihnen, Zapier oder eine andere Automatisierungssoftware zu verwenden, um den Trigger auszulösen, wenn der Kauf in Stripe getätigt wird (wenn Sie kein Pilotly-Bestellformular oder -Produkt verwenden). Wenn der Kauf getätigt wird, wird ein Payload mit allen Informationen, die Sie in Pilotly benötigen, zusammengestellt. Pilotly fängt die Informationen ab und empfängt sie, die für die Ausführung Ihrer spezifischen Aufgaben verwendet werden. In diesem Fall geht es um die Vermarktung an Ihre Käufer, die dieses spezielle Produkt gekauft haben.
Das ist der Überblick über Webhooks, aber es gibt noch VIEL mehr zu lernen. Für den Anfang reicht das aus. Im Folgenden gehen wir auf die beiden Möglichkeiten ein, wie Sie Webhooks in Pilotly verwenden können.
Wie man Webhooks in Pilotly verwendet
Es gibt zwei Möglichkeiten, Webhooks in Pilotly zu verwenden. Möglicherweise zu vereinfacht ausgedrückt, gibt es "fangende" und "sendende" Webhooks.
Zwei Möglichkeiten zur Verwendung von Webhooks in Pilotly:
(A) Eingehender Webhook
"Abfangen" einer eingehenden Webhook-Anfrage in einem Pilotly-Workflow-Auslöser.
Wie der Name schon sagt, geht es beim "Abfangen" um den Empfang oder das "Abfangen" einer Webhook-Anfrage, die an die Pilotly-Webhook-URL gerichtet ist. In Pilotly
ist dies ein Workflow-Trigger, der "Inbound Webhook" genannt wird.
(B) Ausgehender Webhook
"Senden" einer ausgehenden Webhook-Anfrage mit einer Pilotly-Workflow-Aktion.
Im Gegensatz zur obigen Bewegung "Auffangen"... "Senden" bedeutet, dass Sie eine Anfrage an eine externe Webhook-URL stellen. In Pilotly ist dies eine Workflow-Aktion namens "Webhook".
Im Folgenden werden wir jedes Szenario durchgehen und zeigen, wie man es in Pilotly ausführt.
Bestellung: Auslöser, Aktion, Auslöser, Aktion
Ein weiterer hilfreicher Weg, um etwas über Webhooks zu lernen, besteht darin, das Muster in der Reihenfolge der auftretenden Vorgänge zu erkennen. Unabhängig davon, ob es sich um einen eingehenden oder ausgehenden Webhook handelt, haben wir im Allgemeinen einen Trigger und eine Aktion in einer Anwendung, die dann Informationen an eine andere Anwendung sendet. In dieser zweiten Anwendung gibt es einen weiteren Auslöser und dann die letzte Aktion.
Daher auch der Titel... Ordnung: "Auslöser, Aktion, Auslöser, Aktion". Damit wird der Fluss der Webhooks bezeichnet, die von beiden Anwendungen genutzt werden. Jede hat einen einzelnen Auslöser und eine Aktion, die eine Verbindung zwischen den beiden herstellt.
Sie werden das gleiche Muster in den folgenden Beispielen sehen: Die erste Anwendung hat einen Auslöser und eine Aktion --> die eine Nutzlast an die nächste Anwendung sendet, die ein eingehender Webhook-Auslöser ist, gefolgt von einer weiteren Aktion.
(A) Eingehender Webhook
"Abfangen" einer eingehenden Webhook-Anfrage in einem Pilotly-Workflow-Trigger.
In diesem Szenario möchten wir, dass Pilotly Informationen von einer externen Anwendung abfängt. Die externe Anwendung sendet die Nutzdaten an die Pilotly-Webhook-URL, die bei der Erstellung eines Workflow-Triggers - Inbound Webhook angegeben wurde. In unserem obigen Anwendungsfall handelt es sich zum Beispiel um eine eingehende Webhook-Anfrage, bei der wir Informationen von einem externen Kauf an Pilotly senden, um einzigartige Aufgaben für die spezifischen Kontakte durchzuführen, die das Produkt gekauft haben.
1. Aktivieren Sie eingehende Webhooks
Wenn Sie dies noch nicht getan haben, müssen Sie "LC Premium Triggers & Actions" aktivieren
aktivieren, um fortfahren zu können. Um eine eingehende Anfrage abzufangen, benötigen wir einen "Inbound Webhook", der nur bei LC Premium Triggers & Actions verfügbar ist.
Wussten Sie schon...
Die meisten Pilotly's nutzen gerne Integrations- und Automatisierungssoftware wie Zapier, Make oder Pabbly. Sie bieten einfach zu bedienende Auslöser und Aktionen für viele Anwendungen, die Sie bereits verwenden. In vielen Fällen ist es einfacher und leistungsfähiger, eine dieser Plattformen in Kombination mit Pilotly-Workflows zu nutzen: Erfahren Sie hier mehr über Zapier, Make und Pabbly.
2. Erstellen Sie die Webhook-URL in einem Pilotly-Workflow-Trigger
Nun müssen wir unseren Pilotly-Workflow öffnen und die Webhook-URL erstellen. Öffnen/Erstellen Sie Ihren Workflow und wählen Sie "Inbound Webhooks" als Workflow-Auslöser. Es wird eine Pilotly-Webhook-URL erstellt. Kopieren Sie diese Webhook-URL, um sie im nächsten Schritt zu verwenden.
3. Erstellen Sie in der externen Anwendung einen Webhook-Aktionsschritt
In der externen Anwendung Ihrer Wahl müssen Sie einen Auslöser und einen Webhook-Aktionsschritt erstellen. Zum Beispiel: In Zapier können Sie einen "Payment"-Auslöser verwenden, der ausgelöst wird, wenn eine Zahlung getätigt wird. Wir können den
"Webhooks von Zapier" verwenden, um die Nutzlast an die Pilotly-Webhook-URL zu posten. Fügen Sie die Pilotly-Webhook-URL aus Schritt zwei in den Zapier-Aktionsschritt ein.
4. Einen Test senden
Jetzt müssen wir eine Beispiel-Nutzlast an unsere Pilotly-Webhook-URL senden, um fortfahren zu können. Gehen Sie innerhalb Ihrer externen App, in diesem Beispiel Zapier, zum Ende des Schritts und klicken Sie auf "Test Step". Um einen Test-Payload in Pilotly für eine externe App zu senden, konsultieren Sie bitte die Dokumentation Ihrer externen App und den Support. Warten Sie in Pilotly weiter und aktualisieren Sie den Abschnitt "Mapping Reference", bis Sie eine "Mapping Reference" in Pilotly zur Auswahl haben.
5. Kontakt erstellen/aktualisieren
Für Pilotly benötigen wir für jede einzelne Automatisierung einen Kontakt. Aus diesem Grund öffnet sich die Funktion "Kontakt erstellen/aktualisieren" automatisch. Sie können auch die Aktion "Kontakt suchen" verwenden, um einen Kontakt anhand eines benutzerdefinierten Feldes oder eines anderen Wertes zu finden. Dieses Feld muss ausgefüllt sein, sonst funktioniert es NICHT und der Workflow wird unterbrochen. Erstellen/aktualisieren Sie also mindestens die Telefonnummer oder E-Mail aus der Nutzlast des eingehenden Webhooks oder suchen Sie einen Kontakt auf der Grundlage eines benutzerdefinierten Feldes oder Ähnlichem. Ein gefundener oder abgeglichener Kontakt ist erforderlich, damit dies funktioniert.
Erfahren Sie hier mehr über Inbound Webhooks in Pilotly.
Möchten Sie mehr über Zapier und seine Verwendung erfahren? Erste Schritte mit Zapier.
(B) Ausgehender Webhook
"Senden" einer ausgehenden Webhook-Anfrage mit einer Pilotly Workflow-Aktion.
In diesem Szenario werden Informationen von einer Pilotly-Workflow-Aktion an eine externe Anwendung gesendet. Wenn zum Beispiel jemand ein Formular in Pilotly ausfüllt, möchten wir, dass diese Kontaktinformationen an eine externe App weitergeleitet werden, damit wir die Informationen über den Kontakt dort haben können.
1. Sicherstellen, dass die externe Anwendung den Empfang von Webhook-Daten zulässt
Für einige externe Anwendungen ist der Empfang von Daten von einem Webhook ein Premium Feature. Bei anderen Anwendungen muss der Auslöser einfach nur aktiviert sein.
Sie müssen die Dokumentation der Anwendung konsultieren und bei Bedarf ein Upgrade durchführen.
In Zapier, das wir in diesem Beispiel verwenden werden, müssen Sie ein kostenpflichtiges Konto haben, um eingehende Webhooks (bekannt als Catchhooks) von Zapier zu verwenden.
Sehen Sie keine Webhooks in Ihrer externen App?
In manchen Fällen stehen Webhooks in vielen externen Apps nicht zur Verfügung, damit Sie sie verwenden können. In diesen Fällen können Sie Automatisierungs-/Integrationssoftware wie Zapier, Pabbly oder Make ausprobieren, um die Informationslücke zwischen Ihren Apps zu schließen.
Hier erfahren Sie mehr über Zapier, Make und Pabbly.
2. Erstellen Sie eine Webhook-URL in der externen App
Erstellen Sie in Ihrer externen App einen Trigger für den Inbound Webhook. Nachdem Sie diesen Trigger erstellt haben, sollten Sie eine Webhook-URL generiert haben, die Sie in späteren Schritten verwenden können. Ein Beispiel: In Zapier können Sie den Trigger "Webhooks von Zapier" mit dem Ereignis "Catch Hook" verwenden. Fahren Sie mit dem Schritt "Trigger" fort. Kopieren Sie die von der externen App generierte Webhook-URL.
3. Fügen Sie die externe Webhook-URL zu Ihrer Pilotly-Workflow-Aktion hinzu
Jetzt können wir die externe Webhook-URL zu einer Pilotly-Workflow-Aktion hinzufügen. Erstellen oder öffnen Sie Ihren Pilotly Workflow. Fügen Sie die externe Webhook-URL zu einer Pilotly-Workflow-Aktion hinzu. Speichern Sie den Workflow und veröffentlichen Sie ihn.
4. Senden eines Tests von Pilotly an die externe App
Jetzt brauchen wir einige Beispielinformationen von Pilotly an die externe App. Dazu müssen wir den Workflow auslösen. Wir können zum Beispiel einen Testkauf tätigen, damit der Workflow-Auslöser diese Informationen an Zapier sendet. Es ist am besten, den Workflow-Auslöser so auszuführen, als ob es sich um eine Live-Aktion handeln würde, was passieren wird. Das liegt daran, dass Sie alle Beispieldaten in der Nutzlast haben möchten, wenn Sie sie in der externen App verwenden möchten.
Fahren Sie mit dem Testen fort, bis Sie die Informationen erfolgreich an die Externe App gesendet haben und sie von der Externen App empfangen worden sind.
Gut gemacht! Jedes Mal, wenn der Pilotly-Workflow ausgelöst wird, sendet er diese Informationen zur Verwendung an Ihre externe App. In Zapier können Sie diese Informationen nun verwenden, um Tabellenkalkulationen aufzufüllen oder andere einzigartige Aufgaben durchzuführen.
Informationen in Zapier zuordnen
Wählen Sie ein Feld aus, das Sie in Ihrer Zapier-Aktion aktualisieren möchten. In einem Popup-Fenster wird die Option "Daten einfügen" angezeigt, mit der Sie einen Platzhalter (oder einen benutzerdefinierten Wert, wie er in Pilotly bekannt ist) innerhalb der Zapier-Aktion auswählen können, um die Informationen in der Nutzlast zuzuordnen. Dadurch werden die gewünschten Daten bei jedem Durchlauf dieses Webhooks gestempelt, so dass die richtigen Informationen aus Pilotly an den richtigen Stellen in Zapier oder Ihrer anderen Drittanbieter-App aktualisiert werden.
Möchten Sie mehr über Zapier erfahren und wie Sie es verwenden können?
FAQs
Was ist Zapier, Make oder Pabbly?
Zapier, Make oder Pabbly sind alle Automatisierungs- und Integrationssoftware. Das bedeutet, dass sie dazu dienen, Anwendungen miteinander zu verbinden. Sie tun dies mit vorgefertigten Verbindungen zu Anwendungen, die Sie in sie integrieren können. Nach der Integration können Sie eine Reihe von Auslösern und Aktionen verwenden - ähnlich wie in Pilotly Workflows. Allerdings handelt es sich dabei um Auslöser und Aktionen für andere Anwendungen.
Wussten Sie zum Beispiel, dass wir Integrationen mit diesen Programmen haben? Besuchen Sie die unten stehenden Links zu den gängigsten Plattformen, die wir bei Pilotly gesehen haben.
Zapier LC IntegrationMake LC IntegrationPabbly LC Integration
Die Kombination dieser vorgefertigten Auslöser und Aktionen mit Webhook-Aktionen macht sie noch leistungsfähiger. Dadurch eröffnet sich eine ganze Welt von Möglichkeiten. Man kann sicherlich nicht alles machen... Aber hey... Es ist besser, als eine benutzerdefinierte Integration von Grund auf mit einer API zu programmieren. Zumindest sind sie vorgefertigt und mit Webhooks können die meisten Ihrer Aufgaben vollständig (oder teilweise) automatisiert werden.
Erste Schritte mit Zapier
Zapier ist eine der am häufigsten verwendeten Automatisierungs- und Integrationssoftware. Mit Tausenden von vorgefertigten Auslösern und Aktionen zwischen Anwendungen oder Plattformen ist es ein praktisches Tool. Wenn Sie mit Zapier beginnen und nicht sicher sind, wie Sie es verwenden sollen, sehen Sie sich die schnellen und informativen Kurse an.
https://zapier.com/resources/guides/quick-start/automation-basics
https://learn.zapier.com/intro-to-automation
https://learn.zapier.com/path/a-complete-guide-to-lead-management
Schauen Sie sich die obigen Links an, um noch heute mit Zapier zu beginnen!
Was sind Query Params?
Query Params sind eine hervorragende Möglichkeit, Informationen über einen Webhook zu übermitteln. Ähnlich wie UTM-Parameter fügen sie Informationen hinzu, die von der empfangenden Anwendung verwendet werden können. Ein Beispiel: ClickUp ist eine beliebte App zur Aufgabenverwaltung. Wenn Sie Informationen von ClickUp an Pilotly senden, kommt das benutzerdefinierte Feld nicht sauber an. Das ist schade, denn benutzerdefinierte Felder sind ein wichtiger Teil der Informationen, die wir benötigen. Daher können wir die benötigten Informationen mit Query Params sauberer übergeben.
Dazu müssen Sie lediglich einen Abfrageschlüssel und dann den benutzerdefinierten Wert zur Webhook-URL hinzufügen.
Unsere Webhook-URL lautet zum Beispiel
"https://services.leadconnectorhq.com/hooks/pgWooooooooG57D/webhook-trigger/ce000-800f-4bec-0090-f000000000".
Dann können wir der URL einen Abfrageschlüssel und einen Wert hinzufügen wie "
"
Nachdem Sie dies an Pilotly gesendet haben, können Sie den Abfrageparameter sauber auswählen. Sie können so viele hinzufügen, wie Sie möchten.
Was sind die Unterschiede zwischen API und Webhooks?
Die Anwendungsprogrammierschnittstelle (API) ist die Backend- (oder Hintertür-) Verbindung zwischen Anwendungen. Wenn Sie es nicht nativ innerhalb der Anwendung tun können, ist es wahrscheinlich, dass Sie eine API-Dokumentation finden können, die Ihnen dabei hilft, es zu erreichen oder dem nahe zu kommen. Das einzige Problem ist, dass die Verwendung der API komplex ist, daher die Bezeichnung "Sprache". Es handelt sich um eine separate (und komplexe) Sprache, die zwischen den Anwendungen gesprochen wird und deren Verwendung Sie erst erlernen müssen. Erschwerend kommt hinzu, dass jede Anwendung einen eigenen Dialekt oder eine eigene Art hat, diese Sprache zu sprechen.
Die API ist schwer zu benutzen, aber sie ist leistungsfähig und eine Überlegung wert.
Unsere Pilotly-Entwicklerdokumentation finden Sie hier: Webhooks sind dagegen etwas benutzerfreundlicher. Sie erfordern ein auslösendes Ereignis und werden verwendet, um Informationen als Reaktion auf einen Auslöser zu senden - z. B. das Ausfüllen eines Formulars, das Anklicken eines Links usw.
Im Vergleich zu APIs erfordern Webhooks viel weniger Wissen, um sie zu nutzen. Webhooks sind viel einfacher zu verwenden als API, weshalb sie empfohlen werden, bevor eine API-Verbindung hergestellt wird.
Mehr über Webhooks erfahren Sie hier in diesem Artikel.