Come posso usare l'API di Salesflare con "Webhooks by Zapier"?

A volte vuoi fare qualcosa di specifico con l'API di Salesflare e gli zap già pronti non sono sufficienti. In questi casi c'è "Webhooks by Zapier".

Ecco la pagina ufficiale al riguardo sul sito web di Zapier.

Webhooks by Zapier può essere usato per fare qualsiasi cosa sull'API pubblica di Salesflare. Ti spiegherò come.

0. Prima di iniziare: cos'è un'API? 🙄

Un'API è un'Application Programming Interface.

È il modo in cui un software comunica con un altro software. Le app comunicano con i server. I server comunicano tra loro.

È la bocca E le orecchie del software.

Iniziamo:

1. Usa Webhooks by Zapier

Facile. Cerca semplicemente "webhooks" o "zapier". Seleziona. Avanti. 😎

2. Scegli il metodo corretto

Ci sono quattro metodi di base che puoi usare sull'API REST di Salesflare:

• GET: ottenere oggetti

• PUT: inserire informazioni negli oggetti 

• POST: creare nuovi oggetti

• DELETE: eliminare oggetti

DELETE non è disponibile in Webhooks by Zapier. È però possibile usare una richiesta personalizzata. Come scrive Zapier, è "molto flessibile ma non perdona gli errori".

3. Configura la richiesta

Ti guiderò rapidamente attraverso i campi.

URL: Specifica l'endpoint che vuoi usare. 🔗

Alcuni esempi:

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

Verifica semplicemente le possibilità nella documentazione.

Se sopra è indicato qualcosa come {contact_id}, devi specificare un ID. Puoi compilare questo campo con un tag di unione di Zapier.

Tipo di payload: scegli "Json". Tutto qui! ✋

Dati: è qui che avviene la magia. 

Qui puoi specificare i dati che vuoi passare a Salesflare quando esegui un PUT o un POST.

I dati sono sempre costituiti da chiavi e valori. La chiave è il nome del campo/attributo, il valore è il contenuto.

Ecco alcuni esempi di ciò che puoi fare su un'azienda (chiave : valore):

• name : Salesflare

• domain : salesflare.com

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

Ancora una volta, tutte le possibilità sono nella documentazione.

Elementi come gli array di numeri di telefono non sono descritti bene lì. Se vuoi usare questa funzionalità, puoi controllare le chiamate dell'app nella console per sviluppatori. Oppure scrivici semplicemente nella chat.

Per passare campi personalizzati, usa "custom__fieldname" (doppio carattere di sottolineatura tra custom e fieldname). I nomi dei campi vengono trasformati in questo modo:

• tutto viene convertito in minuscolo

• gli spazi diventano caratteri di sottolineatura

• i caratteri speciali e le emoji non vengono rimossi 😎

Un'altra particolarità: quando esegui un PUT e passi un array di oggetti, devi usare la seguente combinazione aggiuntiva chiave:valore in ogni oggetto "_dirty":"true". Ad esempio:

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

Già, magia 😏

Avvolgi la richiesta in un array: di solito deve essere "no". A meno che tu non stia creando un'azienda da un contatto: in quel caso l'API si aspetta un array di contatti.

File: non toccare 🛑

Disannidamento: sì! 👍 È utile se vuoi passare elementi come i campi personalizzati.

Basic Auth: non si applica qui. L'autenticazione viene eseguita nelle intestazioni qui sotto. 👇

Intestazioni: è qui che esegui l'autenticazione con l'API di Salesflare.

Naturalmente, devi assicurare a Salesflare che sei tu. Per farlo ti serve una chiave API. 🔑 È la tua password segreta. Puoi creare una chiave API da Impostazioni > Chiave API.

Passala semplicemente come segue (chiave : valore):

Authorization : Bearer {APIKEY}

Ecco un esempio completo:

4. È il momento di testare!

Ha funzionato? Oppure ricevi un errore? 😜

Se l'errore è incomprensibile, faccelo sapere tramite la chat. Lo analizzeremo insieme a te.

Divertiti ad automatizzare! 🤖🎉