Intégration Zapier

Zapier relie Deskwoot à des milliers d'autres apps, sans code. Il existe deux façons de l'utiliser. La bonne dépend de votre forfait Deskwoot, et de ce que vos Zaps doivent faire : seulement réagir à Deskwoot, ou aussi y changer des choses.

Quelle façon choisir

	App Deskwoot pour Zapier	Webhooks by Zapier
Forfait Deskwoot	Enterprise	Tous les forfaits
Se connecte avec	Un jeton d'API REST	Rien : vous collez une URL de Zapier dans Deskwoot
Déclencheurs	6, avec des champs prêts à l'emploi	7 événements en JSON
Actions dans Deskwoot	Oui	Non, les événements ne font que sortir
Forfait Zapier	Dépend de vos Zaps	Un forfait payant, car Webhooks by Zapier est une app premium de Zapier

L'app Deskwoot pour Zapier (Enterprise)

1. Dans Deskwoot, allez dans Paramètres > Jetons d'API et créez un jeton, par exemple nommé Zapier, avec les autorisations Lecture et Écriture. Copiez-le : il ne s'affiche qu'une seule fois. Créez-le en tant qu'administrateur : seul le jeton d'un administrateur peut activer les déclencheurs Deskwoot.
2. Allez dans Paramètres > Intégrations, cliquez sur Connecter sur la carte Zapier (Gérer si Webhooks by Zapier est déjà connecté), puis sur Ouvrir l'app Deskwoot dans Zapier.
3. Dans Zapier, ajoutez un déclencheur ou une action Deskwoot à un Zap. Quand Zapier vous demande de connecter un compte, collez le jeton d'API. Zapier donne à la connexion le nom de votre espace de travail Deskwoot et votre adresse e-mail.

Sur les forfaits inférieurs à Enterprise, la carte de l'app Deskwoot sur la page Zapier indique Verrouillé sur votre forfait, et Paramètres > Jetons d'API est aussi verrouillé. L'essai gratuit de 7 jours ne les déverrouille pas. Utilisez plutôt Webhooks by Zapier (voir plus bas), ou cliquez sur Passer à Enterprise.

Déclencheurs

• New Conversation : une conversation commence, qu'un client ait écrit ou que votre équipe l'ait lancée.
• New Customer Message : un client écrit dans une conversation. Les réponses et les notes de votre équipe ne comptent pas.
• Conversation Assigned : une conversation reçoit un nouveau responsable. Le Round Robin sur une nouvelle conversation et les règles d'automatisation ne le déclenchent pas.
• Conversation Resolved : une conversation est marquée comme résolue.
• New Contact : un membre de l'équipe ajoute un contact dans Deskwoot, ou une app en ajoute un via l'API. Les contacts que Deskwoot crée à partir des messages entrants ne le déclenchent pas ; pour ceux-là, utilisez New Conversation.
• New CSAT Rating : un client note une conversation.

Chaque déclencheur transmet à Zapier un enregistrement avec des champs simples. Une conversation arrive avec son numéro, son lien, son statut, son objet, son canal, sa boîte de réception, son responsable, son équipe, ses étiquettes, le nom, l'adresse e-mail et le numéro de téléphone du client, ainsi que le premier message du client. Pendant que vous créez le Zap, Zapier affiche vos enregistrements les plus récents comme exemples.

Actions

• Start Conversation : envoie un premier message à un contact depuis l'une de vos boîtes de réception. Deskwoot trouve le contact par adresse e-mail, numéro de téléphone ou Contact ID. Elle convient aux canaux où une entreprise peut écrire en premier, comme l'e-mail ou les SMS. Sur WhatsApp, elle ne fonctionne que dans les 24 heures qui suivent le dernier message du client à cette boîte de réception, car l'action n'envoie aucun modèle ; sinon, Deskwoot la refuse et le Zap en affiche la raison.
• Reply in Conversation : envoie une réponse au client sur le canal de la conversation.
• Add Private Note : ajoute une note que seule votre équipe voit.
• Assign Conversation : à un membre de l'équipe, à une équipe, ou aux deux.
• Add Label : ajoute l'une de vos étiquettes à une conversation.
• Find Contact : recherche un contact par adresse e-mail, numéro de téléphone ou nom.
• Create or Update Contact : met à jour le contact qui a cette adresse e-mail, ou le crée s'il n'existe pas.

Les réponses et les notes envoyées depuis Zapier affichent le nom de la personne qui a créé le jeton d'API.

Webhooks by Zapier (tous les forfaits)

1. Dans Zapier, créez un Zap avec le déclencheur Webhooks by Zapier et l'événement Catch Hook, puis copiez l'URL que Zapier affiche.
2. Dans Deskwoot, allez dans Paramètres > Intégrations, cliquez sur Connecter sur la carte Zapier, collez l'URL dans URL du webhook, cliquez sur Tester la connexion, puis sur Connecter.
3. De retour dans Zapier, testez le déclencheur et ajoutez les étapes suivantes.

Deskwoot envoie alors 7 événements à cette URL : nouvelle conversation, nouveau message, conversation attribuée, conversation résolue, nouveau contact, contact mis à jour et note CSAT envoyée. Chacun arrive en JSON avec les champs event, timestamp, account_id et data : un Zap filtre donc sur event pour réagir à l'un d'eux. Cette façon ne fait qu'envoyer des données vers l'extérieur : un Zap ne peut rien changer dans Deskwoot par ce biais. Webhooks by Zapier est une app premium dans Zapier, elle nécessite donc un forfait Zapier payant.

Questions fréquentes

Quelle façon dois-je utiliser ?

Sur Enterprise, l'app Deskwoot : ses déclencheurs fournissent des champs prêts à l'emploi, et ses actions écrivent en retour dans Deskwoot. Sur tout autre forfait, Webhooks by Zapier, qui envoie uniquement des événements.

Pourquoi Zapier indique-t-il que l'API REST nécessite le forfait Enterprise ?

L'app Deskwoot pour Zapier se connecte avec un jeton d'API REST, et l'API REST fait partie du forfait Enterprise. Changez de forfait dans Paramètres > Facturation, ou utilisez Webhooks by Zapier, qui fonctionne sur tous les forfaits.

Pourquoi ne puis-je pas activer un Zap avec un déclencheur Deskwoot ?

Seul un jeton d'API créé par un administrateur peut activer les déclencheurs Deskwoot, car un déclencheur reçoit les événements de toutes les conversations, comme un webhook. Reconnectez le compte Deskwoot dans Zapier avec le jeton d'un administrateur.

Que se passe-t-il si je révoque le jeton ?

Tous les déclencheurs que ce jeton a activés s'arrêtent aussitôt, et les actions des Zaps échouent avec une erreur de connexion. Créez un nouveau jeton et reconnectez le compte Deskwoot dans Zapier.

Zapier peut-il répondre aux clients ?

Oui, avec l'app Deskwoot sur Enterprise : Reply in Conversation envoie le message sur le canal de la conversation. Webhooks by Zapier ne peut rien changer dans Deskwoot.

Les données des clients sont-elles en sécurité avec Zapier ?

Zapier déclare être conforme au RGPD et à SOC 2, mais les données passent par les serveurs de Zapier, y compris hors de l'UE. Pour un flux de données strictement dans l'UE, envoyez plutôt les événements à votre propre endpoint avec les webhooks Deskwoot.

Les tickets arrivent-ils dans Zapier ?

Non. Les tickets sont le travail interne de votre équipe : ni les déclencheurs de l'app Deskwoot ni Webhooks by Zapier n'envoient d'événements de tickets, et les événements New Customer Message et nouveau message laissent de côté les commentaires d'un ticket. Pour envoyer des événements de tickets à votre propre serveur, cochez-les dans Paramètres > Webhooks.