Comment utiliser l'API de Salesflare avec « Webhooks by Zapier » ?

Parfois, vous voulez effectuer une action spécifique avec l'API de Salesflare, et les zaps prêts à l'emploi ne suffisent pas. Dans ce cas, il y a « Webhooks by Zapier ».

Voici la page officielle à ce sujet sur le site web de Zapier.

Webhooks by Zapier peut être utilisé pour effectuer n'importe quelle action sur l'API publique de Salesflare. Je vais vous expliquer comment.

0. Avant de commencer : qu'est-ce qu'une API ? 🙄

Une API est une interface de programmation d'application.

C'est la façon dont les logiciels communiquent avec d'autres logiciels. Les apps communiquent avec les serveurs. Les serveurs communiquent entre eux.

C'est la bouche ET les oreilles des logiciels.

Allons-y :

1. Utiliser Webhooks by Zapier

Facile. Recherchez simplement « webhooks » ou « zapier ». Sélectionnez. Suivant. 😎

2. Choisir la bonne méthode

Il existe quatre méthodes de base que vous pouvez utiliser avec l'API REST de Salesflare :

• GET : obtenir des objets

• PUT : ajouter des informations aux objets 

• POST : créer de nouveaux objets

• DELETE : supprimer des objets

DELETE n'est pas disponible dans Webhooks by Zapier. Il est toutefois possible d'utiliser une requête personnalisée. Comme l'écrit Zapier, c'est « très flexible, mais impitoyable ».

3. Configurer la requête

Laissez-moi vous présenter rapidement les champs.

URL : Spécifiez le endpoint que vous souhaitez utiliser. 🔗

Voici quelques exemples :

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

Consultez la documentation pour découvrir toutes les possibilités.

Si quelque chose comme {contact_id} apparaît ci-dessus, vous devez spécifier un identifiant. Celui-ci peut être rempli avec une balise de fusion Zapier.

Type de payload : choisissez « Json ». C'est tout ! ✋

Données : c'est ici que la magie opère. 

Vous pouvez ici spécifier les données que vous souhaitez transmettre à Salesflare lors d'une opération PUT ou POST.

Les données se présentent toujours sous forme de clés et de valeurs. La clé est le nom du champ ou de l'attribut, et la valeur en est le contenu.

Voici quelques exemples de ce que vous pouvez faire sur une entreprise (clé : valeur) :

• name : Salesflare

• domain : salesflare.com

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

Encore une fois, toutes les possibilités se trouvent dans la documentation.

Les éléments comme les tableaux de numéros de téléphone n'y sont pas très bien décrits. Si vous souhaitez utiliser cette fonctionnalité, vous pouvez consulter les appels de l'app dans la console de développement. Ou simplement nous contacter via le chat.

Pour transmettre des champs personnalisés, utilisez « custom__fieldname » (deux underscores entre custom et fieldname). Les noms des champs sont transformés comme suit :

• tout est écrit en minuscules

• les espaces deviennent des underscores

• les caractères spéciaux et les emoji ne sont pas supprimés 😎

Autre particularité : lors d'une opération PUT et de la transmission d'un tableau d'objets, vous devez utiliser la combinaison clé-valeur supplémentaire suivante dans chaque objet "_dirty":"true". Par exemple :

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

Oui, c'est magique 😏

Envelopper la requête dans un tableau : généralement, il faut choisir « non ». Sauf si vous créez une entreprise à partir d'un contact : l'API attend alors un tableau de contacts.

Fichier : n'y touchez pas 🛑

Déplier : oui ! 👍 C'est pratique si vous souhaitez transmettre des éléments comme des champs personnalisés.

Authentification de base : ne s'applique pas ici. L'authentification se fait dans les en-têtes ci-dessous. 👇

En-têtes : c'est ici que vous vous authentifiez auprès de l'API de Salesflare.

Naturellement, vous devez confirmer à Salesflare qu'il s'agit bien de vous. Pour cela, vous avez besoin d'une clé API. 🔑 C'est votre mot de passe secret. Vous pouvez créer une clé API depuis Paramètres > Clé API.

Transmettez-la simplement comme suit (clé : valeur) :

Authorization : Bearer {APIKEY}

Voici un exemple complet :

4. C'est le moment de tester !

Est-ce que cela fonctionne ? Ou obtenez-vous une erreur ? 😜

Faites-nous savoir via le chat si l'erreur est incompréhensible. Nous l'examinerons avec vous.

Amusez-vous à automatiser ! 🤖🎉