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

Mensajería bidireccional en Zendesk con Messages API de Vonage

Publicado el July 26, 2022

Tiempo de lectura: 2 minutos

Introducción

¡Hola! En este tutorial, esbozaremos una prueba de concepto de la integración de Zendesk con Messages API de Vonage. Un caso de uso típico para dicha integración surgiría de la necesidad de introducir canales de comunicación adicionales en el departamento de atención al cliente.

¿No te funciona enviar correos electrónicos a tus clientes sobre las actualizaciones de tickets de Zendesk? Comunícate con tus usuarios por SMS o, mejor aún, por WhatsApp.

Utilizaremos

  • Mensajes API de Vonage

  • Activadores/automatizaciones de Zendesk

  • Una aplicación de ejemplo como capa intermedia. Aquí está el SDK disponible en GitHub (desarrollado en colaboración con Toni Kuschan)

Objetivo

Conecta WhatsApp con Zendesk a través de Vonage Messages API para crear y actualizar tickets.

A continuación puede ver un Video de presentación de lo que construiremos hoy:

Flujo de trabajo

Un mensaje entrante en WhatsApp crea un ticket de Zendesk (si no hay tickets abiertos del mismo solicitante). Si hay tickets abiertos, el solicitante recibe un mensaje de WhatsApp con los detalles del ticket. Además, las actualizaciones de los tickets activan un mensaje de WhatsApp al solicitante. A continuación se muestra el flujo de trabajo llevado a cabo 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

Requisitos previos

  • Aplicación de Vonage

  • Número de WhatsApp

  • Account Zendesk (cuenta de prueba también sirve)

Cómo crear un ticket de Zendesk desde WhatsApp

  1. Implemente webhooks para ejecutar la lógica de los mensajes entrantes de WhatsApp. Puede implementar estos webhooks en plataformas de código abierto como ngrok o groom IDE

  2. El webhook de mensajes entrantes hará lo siguiente:

    1. Llama a la API de búsqueda de Zendesk para comprobar si hay un ticket abierto planteado por el solicitante (en este caso, el solicitante es el número de móvil del usuario que envía mensajes por WhatsApp).

    2. Si el billete está disponible, utilice Messages API para enviar al solicitante los detalles del billete por WhatsApp

    3. Si no se encuentran tickets abiertos, utilice la API de creación de tickets de Zendesk para crear un ticket basado en el mensaje entrante del usuario. Utilice Messages API para confirmar de vuelta la creación exitosa del ticket.

Actualizar un ticket de Zendesk

  1. Desplegar un webhook que se activará en una acción elegida (el webhook se activa cuando un agente añade un comentario en un ticket).

  2. En el centro de administración de Zendesk, ve a Aplicaciones e integraciones, webhooks y crea un nuevo webhook. Añade los detalles de tu webhook como se indica a continuación

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. Ahora es el momento de vincular el webhook a un disparador. En Objetos y reglas, Reglas de negocio, seleccione Activadores.

  2. Añada un nuevo disparador. Dé un nombre al disparador y seleccione las condiciones según su caso de uso. En este ejemplo, el webhook se activa cuando un agente actualiza un ticket.

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. Añada una acción y seleccione Notificar webhooks activos

  2. Elija entre varios marcadores de posición los detalles del billete que desea enviar a su 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

Conclusión y próximos pasos

Hoy aprendiste a conectar WhatsApp con Zendesk usando la API Messages API de Vonage. Este tutorial se puede personalizar y adaptar a los requisitos y casos de uso de tu negocio. ¿Quieres ir un paso más allá? Echa un vistazo a nuestra plataforma de IA conversacional, Vonage AI Studiopara crear un flujo de trabajo completo.

Compartir:

https://a.storyblok.com/f/270183/400x400/97e8563d82/nourhan-kandeel.png
Nourhan Kandeel Arquitecto de soluciones para clientes

Nourhan es arquitecto de soluciones para clientes en Vonage, con sede en Dubái. Le apasionan la CPaaS y la automatización. Le encanta viajar y cualquier cosa al aire libre.