Hoe kan ik de Salesflare API gebruiken met "Webhooks by Zapier"?

Soms wil je iets specifieks doen met de Salesflare API, en zijn de kant-en-klare zaps niet voldoende. Voor die momenten is er "Webhooks by Zapier".

Hier vind je de officiële pagina hierover op de website van Zapier.

Met Webhooks by Zapier kun je alles doen met de openbare API van Salesflare. Ik leg je uit hoe.

---

0. Voordat we beginnen: wat is een API? 🙄

Een API is een Application Programming Interface.

Het is de manier waarop software met andere software praat. Apps die met servers praten. Servers die met elkaar praten.

Het is de mond én de oren van software.

Laten we beginnen:

1. Webhooks by Zapier gebruiken

Eenvoudig. Zoek gewoon naar "webhooks" of "zapier". Selecteer. Volgende. 😎

2. De juiste methode kiezen

Er zijn vier basismethoden die je kunt gebruiken in de REST API van Salesflare:

• GET: objecten ophalen

• PUT: informatie in objecten plaatsen 

• POST: nieuwe objecten aanmaken

• DELETE: objecten verwijderen

DELETE is niet beschikbaar in Webhooks by Zapier. Wat wel mogelijk is, is een aangepast verzoek. Zoals Zapier schrijft: "very flexible but unforgiving".

3. Het verzoek configureren

Ik neem de velden snel met je door.
​
​URL: Geef het eindpunt op dat je wilt gebruiken. 🔗

Enkele voorbeelden:

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

Bekijk gewoon de mogelijkheden in de documentatie.

Als er hierboven iets staat zoals {contact_id}, moet je een id opgeven. Dit kan worden ingevuld met een samenvoegtag van Zapier.

Payloadtype: kies "Json". Dat is alles! ✋

Gegevens: hier gebeurt de magie. 

Hier kun je de gegevens opgeven die je aan Salesflare wilt doorgeven bij het uitvoeren van een PUT of POST.

Gegevens bestaan altijd uit sleutels en waarden. De sleutel is de naam van het veld/attribuut, de waarde is de inhoud.

Hier zijn enkele voorbeelden van wat je met een account kunt doen (sleutel : waarde) :

• name : Salesflare

• domain : salesflare.com

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

Nogmaals, alle mogelijkheden staan in de documentatie.

Dingen zoals arrays met telefoonnummers worden daar niet goed beschreven. Als je dit wilt gebruiken, kun je de oproepen van de app bekijken in de ontwikkelaarsconsole. Of praat gewoon met ons in de chat.

Gebruik "custom__fieldname" om aangepaste velden door te geven (twee underscores tussen custom en fieldname). Veldnamen worden als volgt getransformeerd:

• alles wordt omgezet naar kleine letters

• spaties worden underscores

• speciale tekens en emoji's worden niet verwijderd 😎

Nog een bijzonderheid: wanneer je een array met objecten doorgeeft bij een PUT, moet je in elk object de volgende extra sleutel:waarde-combinatie gebruiken "_dirty":"true". Bijvoorbeeld:

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

Ja, magix 😏

Request in array verpakken: meestal moet dit "no" zijn. Tenzij je een account aanmaakt vanuit een contact; dan verwacht de API een array met contacten.

Bestand: Niet aanraken 🛑

Flattening ongedaan maken: Ja! 👍 Dit is handig als je dingen zoals aangepaste velden wilt doorgeven.

Basic Auth: Hier niet van toepassing. De authenticatie gebeurt in de onderstaande headers. 👇

Headers: Hier authenticeer je je met de Salesflare API.

Natuurlijk moet je Salesflare ervan verzekeren dat jij het bent. Hiervoor heb je een API-sleutel nodig. 🔑 Het is je geheime wachtwoord. Je kunt een API-sleutel aanmaken via Instellingen > API-sleutel.

Geef deze als volgt door (sleutel : waarde) :

Authorization : Bearer {APIKEY}

Hier is een volledig voorbeeld:

4. Tijd om te testen!

Is het gelukt? Of krijg je een foutmelding? 😜

Laat het ons via de chat weten als de foutmelding onbegrijpelijk is. We bekijken het samen met je.

Veel plezier met automatiseren! 🤖🎉