Hoe kan ik de API van Salesflare 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 is de officiële pagina hierover op de website van Zapier.

Webhooks by Zapier kan worden gebruikt om alles te doen met de openbare API van Salesflare. Ik leg je uit hoe.

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

Een API is een Application Programming Interface.

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

De mond én oren van software.

Aan de slag:

1. Webhooks by Zapier gebruiken

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

2. De juiste methode kiezen

Er zijn vier basisopties die je kunt gebruiken met 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: "zeer flexibel maar meedogenloos".

3. Het verzoek configureren

Ik neem de velden even 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 hierboven iets staat zoals {contact_id}, moet je een id opgeven. Dit kun je invullen met een Zapier-mergetag.

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

Gegevens: Hier gebeurt de magie. 

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

Gegevens komen altijd in 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) :

• naam : Salesflare

• domein : salesflare.com

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

Nogmaals, alle mogelijkheden vind je 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 via de chat.

Om aangepaste velden door te geven, gebruik je "custom__fieldname" (dubbele underscore tussen custom en fieldname). Veldnamen worden als volgt getransformeerd:

• alles wordt in kleine letters geschreven

• spaties worden underscores

• speciale tekens en emoji worden niet verwijderd 😎

Nog een bijzonderheid: wanneer je een PUT uitvoert en een array van objecten doorgeeft, moet je in elk object de volgende extra key:value-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 van contacten.

Bestand: Niet aanraken 🛑

Unflatten: 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 bij de Salesflare API.

Uiteraard moet je Salesflare ervan overtuigen dat jij het bent. Hiervoor heb je een API-sleutel. 🔑 Dit is je geheime wachtwoord. Je kunt een API-sleutel aanmaken via Instellingen > API-sleutel.

Geef het gewoon 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 fout onbegrijpelijk is. We bekijken het samen met je.

Veel plezier met automatiseren! 🤖🎉