https://a.storyblok.com/f/270183/26645/af9c95936d/zendesk_messengerapi.png

Mensagens bidirecionais no Zendesk com a Messages API do Vonage

Publicado em July 26, 2022

Tempo de leitura: 2 minutos

Introdução

Olá! Neste tutorial, apresentaremos uma prova de conceito da integração do Zendesk com as Messages API do Vonage. Um caso de uso típico para essa integração surgiria da necessidade de introduzir canais de comunicação adicionais no departamento de atendimento ao cliente.

O envio de e-mails aos seus clientes sobre atualizações de tickets do Zendesk não está funcionando bem o suficiente? Entre em contato com seus usuários por SMS ou, melhor ainda, pelo WhatsApp!

Vamos usar

  • Messages API da Vonage

  • Gatilhos/automatizações do Zendesk

  • Um aplicativo de exemplo como camada intermediária. Aqui está o SDK do GitHub disponível (desenvolvido em colaboração com Toni Kuschan)

Objetivo

Conecte o WhatsApp ao Zendesk por meio da Messages API do Vonage para criar e atualizar tickets.

Abaixo, você pode assistir a um Video de apresentação do que vamos construir hoje:

Fluxo de trabalho

Uma mensagem recebida no WhatsApp cria um ticket no Zendesk (caso não haja nenhum ticket aberto do mesmo solicitante). Se houver tickets abertos, o solicitante recebe uma mensagem no WhatsApp com os detalhes do ticket. Além disso, as atualizações do ticket acionam o envio de uma mensagem no WhatsApp para o solicitante. Abaixo está o fluxo de trabalho executado por este caso de uso.

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

Pré-requisitos

  • Aplicativo da Vonage

  • Número do WhatsApp

  • Conta no Zendesk (uma conta de teste também serve)

Criar um ticket no Zendesk pelo WhatsApp

  1. Implemente webhooks para executar a lógica relacionada às mensagens recebidas pelo WhatsApp. Você pode implementar esses webhooks em plataformas de código aberto, como o ngrok ou o Groom IDE

  2. O webhook de mensagens recebidas fará o seguinte:

    1. Chame a API de pesquisa do Zendesk para verificar se há algum ticket aberto criado pelo solicitante (nesse caso, o solicitante é o número de celular do usuário que está enviando mensagens pelo WhatsApp)

    2. Se o ingresso estiver disponível, use a Messages API para enviar os detalhes do ingresso ao solicitante pelo WhatsApp

    3. Se não forem encontrados tickets abertos, use a API de criação de tickets do Zendesk para criar um ticket com base na mensagem recebida do usuário. Use a Messages API para confirmar a criação bem-sucedida do ticket

Atualizar um ticket do Zendesk

  1. Implemente um webhook que será acionado ao ocorrer uma ação específica (o webhook é acionado quando um agente adiciona um comentário a um ticket)

  2. No Centro de Administração do Zendesk, acesse “Aplicativos e integrações”, “Webhooks” e crie um novo webhook. Adicione os detalhes do seu webhook conforme indicado abaixo

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. Agora é hora de vincular o webhook a um gatilho. Em “Objetos e regras”, na seção “Regras de negócios”, selecione “Gatilhos”.

  2. Adicione um novo gatilho. Dê um nome ao gatilho e selecione as condições de acordo com o seu caso de uso. Neste exemplo, o webhook é acionado quando um ticket é atualizado por um agente.

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. Adicione uma ação e selecione “Notificar webhooks ativos”

  2. Escolha, entre vários campos de preenchimento, os detalhes do bilhete que você deseja enviar de volta ao seu 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

Conclusão e próximos passos

Hoje você aprendeu a conectar o WhatsApp ao Zendesk usando a Messages API do Vonage. Este tutorial pode ser personalizado e adaptado às necessidades da sua empresa e aos seus casos de uso. Que tal dar um passo adiante? Confira nossa plataforma de IA conversacional, Vonage AI Studio, para criar um fluxo de trabalho completo.

Compartilhar:

https://a.storyblok.com/f/270183/400x400/97e8563d82/nourhan-kandeel.png
Nourhan Kandeel Arquiteto de Soluções para Clientes

Nourhan é arquiteta de soluções para clientes na Vonage, com sede em Dubai. É apaixonada por CPaaS e automação. Ela adora viajar e todas as atividades ao ar livre.