https://d226lax1qjow5r.cloudfront.net/blog/blogposts/two-way-messaging-on-zendesk-with-vonage-messages-api/zendesk_messengerapi.png

Messagerie bidirectionnelle sur Zendesk avec l'API Messages de Vonage

Publié le July 26, 2022

Temps de lecture : 2 minutes

Introduction

Bonjour à tous ! Dans ce tutoriel, nous allons présenter une preuve de concept de l'intégration de Zendesk avec les API Messages de Vonage. Un cas d'utilisation typique pour une telle intégration résulterait de la nécessité d'introduire des canaux de communication supplémentaires dans le service d'assistance à la clientèle.

Envoyer un e-mail à vos clients pour les informer des mises à jour des tickets Zendesk ne fonctionne pas assez bien ? Tendez la main à vos utilisateurs par SMS ou, mieux encore, par WhatsApp !

Nous utiliserons

  • API Messages Vonage

  • Déclencheurs/automations Zendesk

  • Un exemple d'application comme couche intermédiaire. Voici le SDK GitHub disponible (développé en collaboration avec Toni Kuschan)

Objectif

Connectez WhatsApp à Zendesk via l'API Messages de Vonage pour créer et mettre à jour des tickets.

Vous pouvez voir ci-dessous une vidéo de présentation de ce que nous allons construire aujourd'hui :

Flux de travail

Un message entrant sur WhatsApp crée un ticket Zendesk (s'il n'y a pas de tickets ouverts pour le même demandeur). S'il y a des tickets ouverts, le demandeur reçoit un message WhatsApp avec les détails du ticket. En outre, les mises à jour de tickets déclenchent l'envoi d'un message WhatsApp au demandeur. Le flux de travail de ce cas d'utilisation est présenté ci-dessous.

Step 1: User sends a message on preferred messaging channel (could be SMS or WhatsApp) Step 2: Inbound webhook added in Vonage application captures the message from step 1 Step 3: The back end application utilizes Zendesk create  or search ticket API to create or search a ticket based on the inbound message Step 4: Upon successful ticket creation or identification, use Vonage messaging API to update the requester on the ticket detailsZendesk and Vonage high level architecture to create tickets

Step 1: Configure webhook and triggers on Zendesk to be triggered based on the required action. In this tutorial, the webhook is triggered when an agent updates a ticket Step 2: Utilize Vonage messages API to update the requester on the ticket details based on the original messaging channel (could be SMS or WhatsApp)Zendesk and Vonage high level architecture to update ticket

Conditions préalables

  • Application Vonage

  • Numéro WhatsApp

  • Compte Zendesk (compte d'essai également)

Créer un ticket Zendesk depuis WhatsApp

  1. Déployez des webhooks pour exécuter la logique des messages WhatsApp entrants. Vous pouvez déployer ces webhooks sur des plateformes open source telles que ngrok ou groom IDE

  2. Le webhook des messages entrants effectue les opérations suivantes :

    1. Appeler l'API de recherche Zendesk pour vérifier s'il y a un ticket ouvert soulevé par le demandeur (dans ce cas, le demandeur est le numéro de mobile de l'utilisateur qui envoie des messages sur WhatsApp).

    2. Si le billet est disponible, utiliser l'API Messages pour envoyer au demandeur les détails du billet sur WhatsApp.

    3. Si aucun ticket ouvert n'est trouvé, utilisez Zendesk create ticket API pour créer un ticket basé sur le message entrant de l'utilisateur. Utilisez l'API Messages pour confirmer la création réussie du ticket.

Mettre à jour un ticket Zendesk

  1. Déployer un webhook qui sera déclenché sur une action choisie (le webhook est déclenché lorsqu'un agent ajoute un commentaire sur un ticket).

  2. Dans le centre d'administration Zendesk, naviguez vers Apps et intégrations, webhooks, et créez un nouveau webhook. Ajoutez les détails de votre webhook comme suit

1. Navigate to Apps and integrations from the left-hand menu options. 2. Select webhooks and click on create a new webhook 3. Add details of your webhook, including name, an optional description, endpoint URL, request method and  authentication mechanismCreate a new webhook

  1. Il est maintenant temps de lier le webhook à un déclencheur. Dans Objets et règles, Règles de gestion, sélectionnez Déclencheurs.

  2. Ajoutez un nouveau déclencheur. Donnez un nom au déclencheur et sélectionnez les conditions en fonction de votre cas d'utilisation. Dans cet exemple, le webhook est déclenché lorsqu'un ticket est mis à jour par un agent.

1. From Objects and rules in the left-hand menu, navigate to Business rules 2. Select Triggers 3. Choose Add a new trigger 4. Add a name to the trigger and select an appropriate category 5. Select the required conditions for the trigger. In this tutorial it is if a ticket is updated by an agentCreate trigger

  1. Ajouter une action et sélectionner Notifier les webhooks actifs

  2. Choisissez parmi différents espaces réservés les détails du billet que vous souhaitez renvoyer à votre webhook.

1. From Actions, select Notify active webhook and choose the webhook added earlier 2. Choose from the available parameter to send back to the webhook. In this tutorial, we are sending the ticket title, ID, comment and requester detailsCreate action

Conclusion et prochaines étapes

Aujourd'hui, vous avez appris à connecter WhatsApp à Zendesk à l'aide de l'API Messages de Vonage. Ce tutoriel peut être personnalisé et adapté aux besoins de votre entreprise et à vos cas d'utilisation. Vous souhaitez aller plus loin ? Jetez un coup d'œil à notre plateforme d'IA conversationnelle, Vonage AI Studiopour créer un flux de travail complet.

Partager:

https://a.storyblok.com/f/270183/400x400/97e8563d82/nourhan-kandeel.png
Nourhan Kandeel Architecte de solutions pour les clients

Nourhan est architecte de solutions clients chez Vonage, basé à Dubaï. Elle est passionnée par le CPaaS et l'automatisation. Elle aime voyager et tout ce qui est en plein air.