EN

Integración SMS con Freshdesk

Envía mensajes SMS utilizando la plataforma LabsMobile integrada con tu cuenta de Freshdesk. Configura tu usuario para que pueda comunicar eventos específicos a un script, lo que te permitirá enviar notificaciones SMS directamente desde Freshdesk.


Funcionalidades

  • Envío de mensajes que notifiquen el estado actual de cada ticket.
  • Personalización del contenido de los mensajes utilizando variables para adaptarlos según tus necesidades específicas.

Requisitos

  • Un usuario en Freshdesk. Más información en freshdesk.com .
  • Un script que reciba los eventos de Freshdesk (Webhook) y comunique con la API de LabsMobile. Más información en API SMS de LabsMobile.
  • Una cuenta de usuario en LabsMobile. Sigue el siguiente enlace para crear una nueva cuenta: Regístrate.

Autenticación

En la integración con Freshdesk la autenticación se realiza con dos parámetros:

  • El nombre de usuario (username) de la cuenta que debe indicarse en la variable $username.
  • El tokenapi que se debe asignar en la variable $toke. Este tokenapi se puede generar desde la sección Configuración API de tu cuenta.

Recomendación Se pueden generar tokens API desde la Configuración API de la cuenta. Recomendamos cambiar el token frecuentemente y utilizar diferentes tokens para cada uso, conexión o integración.


Instalación

  1. Crear o disponer de un script que reciba los eventos (Webhook) de Freshdesk y conecte con la API SMS de LabsMobile. En el siguiente apartado se muestra un script de ejemplo en PHP que se puede personalizar y modificar. Este script se debe alojar en un servicio web y así obtener una URL en la que será accesible públicamente.

Script de ejemplo

Descarga el script de ejemplo en PHP para atender el webhook de Freshdesk.

En este caso se usa la API de LabsMobile, con el fin de notificar vía SMS cuando se conteste o resuelva cualquier ticket abierto. De este modo lograr enviar SMS con el estado actual del ticket y un acceso directo para consultar el contenido del mismo.

  1. Crear una nueva regla de automatización. Se debe acceder a la sección Administración/Automatizaciones/Actualizaciones del ticket y hacer clic en Nueva regla. Se debe indicar un nombre de la regla y finalmente Previsualizar y guardar.
Configuración de automatizaciones en Freshdesk para enviar notificaciones SMS de estados de tickets

  1. Configurar la nueva regla cuando un Agente contesta cualquier ticket.
Configuración de regla en Freshdesk para la actualización de tickets: nombre de la regla, usuario que realiza la acción y propiedades del ticket

  1. Añadir la acción de webhook con el método POST e introduciendo la URL donde se ha publicado el script del paso 1. Finalmente es necesario configurar el formato JSON y el contenido con todas las variables.
Agregar acciones al Webhook de Freshdesk: tipo de solicitud, URL, tipo de codificación y contenido

  1. Generar un token API en la sección Configuración API de tu cuenta LabsMobile. Este token API es el que se utilizará como contraseña en las credenciales del script junto con el email de username.
Generación de tokens API en LabsMobile para el script de notificaciones de tickets de Freshdesk

  1. Activar la acortación de enlaces en la sección Preferencias de tu cuenta LabsMobile. De esta forma cualquier enlace de ticket se acortará al mínimo posible para optimizar los caracteres presentes en el texto del SMS.
Activación de reemplazo de enlaces para acortar los URLs en las notificaciones de Freshdesk utilizando el formato de LabsMobile
  1. Probar la integración SMS con Freshdesk al responder cualquier ticket.
Envío de notificación SMS desde Freshdesk con estado del ticket e idioma de la notificación