Wie kann ich die Salesflare-API mit „Webhooks by Zapier“ verwenden?

Manchmal möchtest du etwas Bestimmtes mit der Salesflare-API tun, und die fertigen Zaps reichen nicht aus. Für diese Fälle gibt es „Webhooks by Zapier“.

Hier findest du die offizielle Seite dazu auf der Zapier-Website.

Mit Webhooks by Zapier kannst du alles tun, was über die öffentliche API von Salesflare möglich ist. Ich erkläre dir, wie.

0. Bevor wir anfangen: Was ist eine API? 🙄

Eine API ist eine Anwendungsprogrammierschnittstelle.

Sie ist die Art und Weise, wie Software mit anderer Software kommuniziert. Apps kommunizieren mit Servern. Server kommunizieren miteinander.

Sie ist der Mund UND die Ohren der Software.

Los geht’s:

1. Webhooks by Zapier verwenden

Ganz einfach. Suche einfach nach „webhooks“ oder „zapier“. Auswählen. Weiter. 😎

2. Die richtige Methode auswählen

Es gibt vier grundlegende Methoden, die du mit der REST-API von Salesflare verwenden kannst:

• GET: Objekte abrufen

• PUT: Informationen in Objekte einfügen 

• POST: Neue Objekte erstellen

• DELETE: Objekte löschen

DELETE ist in Webhooks by Zapier nicht verfügbar. Was jedoch möglich ist, ist eine benutzerdefinierte Anfrage. Wie Zapier schreibt: „sehr flexibel, aber unerbittlich“.

3. Die Anfrage konfigurieren

Ich führe dich kurz durch die Felder.

URL: Gib den Endpunkt an, den du verwenden möchtest. 🔗

Einige Beispiele:

https://api.salesflare.com/messages (POST)
https://api.salesflare.com/accounts (GET, POST)
https://api.salesflare.com/contacts/{contact_id} (GET, PUT)

Sieh dir einfach die Möglichkeiten in der Dokumentation an.

Wenn oben etwas wie {contact_id} steht, musst du eine ID angeben. Diese kann mit einem Zapier-Merge-Tag ausgefüllt werden.

Payload-Typ: Wähle „Json“. Das war’s! ✋

Daten: Hier passiert die Magie. 

Hier kannst du die Daten angeben, die du bei einem PUT oder POST an Salesflare übergeben möchtest.

Daten bestehen immer aus Schlüsseln und Werten. Der Schlüssel ist der Name des Feldes/Attributs, der Wert ist der Inhalt.

Hier sind einige Beispiele dafür, was du mit einem Account tun kannst (Schlüssel : Wert):

• name : Salesflare

• domain : salesflare.com

• phone_numbers : [{"type":"work","number":"+32499217782"},{"type":"work","number":"+32496725080"}]

Wie gesagt, alle Möglichkeiten findest du in der Dokumentation.

Dinge wie Arrays mit Telefonnummern werden dort nicht ausführlich beschrieben. Wenn du das verwenden möchtest, kannst du dir die Aufrufe der App in der Entwicklerkonsole ansehen. Oder sprich einfach mit uns im Chat.

Um benutzerdefinierte Felder zu übergeben, verwende „custom__fieldname“ (doppelter Unterstrich zwischen custom und fieldname). Feldnamen werden wie folgt umgewandelt:

• alles wird kleingeschrieben

• Leerzeichen werden zu Unterstrichen

• Sonderzeichen und Emojis werden nicht entfernt 😎

Eine weitere Besonderheit: Wenn du einen PUT ausführst und ein Array mit Objekten übergibst, musst du in jedem Objekt die folgende zusätzliche Schlüssel-Wert-Kombination verwenden: "_dirty":"true". Zum Beispiel:

• phone_numbers : [{"type":"work","number":"+32499217782","_dirty":"true"},{"type":"work","number":"+32496725080","_dirty":"true"}]

Ja, Magie 😏

Anfrage in Array einschließen: Normalerweise muss dies „nein“ sein. Außer wenn du ein Unternehmen aus einem Kontakt erstellst; dann erwartet die API ein Array mit Kontakten.

Datei: Nicht anfassen 🛑

Unflatten: Ja! 👍 Das ist praktisch, wenn du Dinge wie benutzerdefinierte Felder übergeben möchtest.

Basis-Authentifizierung: Hier nicht zutreffend. Die Authentifizierung erfolgt in den folgenden Headern. 👇

Header: Hier authentifizierst du dich bei der Salesflare-API.

Natürlich musst du Salesflare bestätigen, dass du es bist. Dafür benötigst du einen API-Schlüssel. 🔑 Er ist dein geheimes Passwort. Du kannst einen API-Schlüssel unter Einstellungen > API-Schlüssel erstellen.

Übergib ihn einfach wie folgt (Schlüssel : Wert):

Authorization : Bearer {APIKEY}

Hier ist ein vollständiges Beispiel:

4. Zeit zum Testen!

War es erfolgreich? Oder erhältst du einen Fehler? 😜

Wenn der Fehler unverständlich ist, lass es uns über den Chat wissen. Wir sehen ihn uns gemeinsam mit dir an.

Viel Spaß beim Automatisieren! 🤖🎉