Hay dos maneras de usar WhatsApp con Freshdesk. Freshdesk ofrece su propio canal de WhatsApp a través de la WhatsApp Business API, lo que implica un número registrado en la API, plantillas aprobadas para los mensajes fuera de la ventana de 24 horas y tarifas por mensaje. La otra manera mantiene WhatsApp en el número que tus clientes ya usan, con Spun como espacio de trabajo de WhatsApp, y conecta WhatsApp y Freshdesk mediante un flujo de trabajo en tu propio n8n.
Esta página cubre la segunda ruta, el flujo de trabajo de WhatsApp con Freshdesk: cada conversación individual se convierte en un ticket de Freshdesk, los mensajes posteriores se agregan a él, y la nota pública de un agente vuelve al cliente por WhatsApp. Si todo tu soporte ya funciona en Freshdesk y te conviene el precio de la Business API, el canal propio de Freshdesk es la opción más sencilla.
Qué hace el flujo de trabajo de WhatsApp con Freshdesk
- Cada conversación individual de WhatsApp se convierte en un ticket con el origen “Chat”, las etiquetas spun y whatsapp, y el id del chat de Spun en un campo personalizado.
- El solicitante se empareja con un contacto de Freshdesk por teléfono y luego por celular, en formato internacional. Si no hay coincidencia, se crea un contacto solo con el nombre y el número. Los contactos existentes nunca se editan y nunca se agrega una dirección de correo electrónico.
- Los mensajes posteriores se agregan como notas públicas del lado del cliente en el hilo, precedidos por el nombre y el número de quien escribe. Un ticket en “Pending” o “Resolved” vuelve a “Open”.
- Los agentes responden con una nota pública, y la nota le llega al cliente por WhatsApp como texto. Las notas privadas se quedan internas.
- Las respuestas que tu equipo envía desde la bandeja de entrada de Spun aparecen como notas privadas, así que ambos lados pueden responder.
- Archivar en Spun cierra el ticket (o lo resuelve, según un ajuste), y desarchivar lo reabre. Cerrar en Freshdesk también puede archivar la conversación en Spun, una opción que está desactivada hasta que la actives.
- Después de que un ticket queda en “Closed”, el siguiente mensaje abre un ticket nuevo que menciona el número del ticket anterior.
La API de Freshdesk no tiene un origen de ticket WhatsApp, así que estos tickets usan el origen “Chat” más la etiqueta whatsapp. Los informes filtrados por el canal de WhatsApp propio de Freshdesk no los incluyen; filtra por la etiqueta.
Responde con una nota pública, no con el botón “Reply”
En un ticket de WhatsApp, los agentes responden con “Add note” y cambian la nota a pública. El botón “Reply” envía un correo electrónico, y un cliente creado por el flujo de trabajo no tiene dirección de correo. La nota pública es lo que la regla de automatización envía al flujo de trabajo, y lo que le llega al cliente por WhatsApp.
Configuración, paso a paso
Necesitas Freshdesk Growth o superior para la sincronización en ambos sentidos, porque las notas de los agentes llegan al flujo de trabajo mediante una regla de automatización que llama a un webhook. En Free y Sprout, los mensajes de WhatsApp igual se convierten en tickets, pero las notas no se pueden enviar de vuelta. También necesitas un administrador de Freshdesk, un agente de integración como “Spun WhatsApp” con su propia clave de API, y una instancia de n8n a la que Freshdesk y Spun puedan llegar por HTTPS.
- 1
Crea la credencial de la clave de API
Con la sesión iniciada como el agente de integración, copia la clave de API desde “Profile settings” y agrégala a n8n como una credencial “Basic Auth”.
- 2
Agrega un campo de ticket “Spun chat id”
Un campo de texto de una sola línea, no obligatorio para los agentes ni para cerrar, más un campo opcional “Spun line”.
- 3
Importa el flujo de trabajo
Abre su nodo “Settings” y pega la URL de tu Freshdesk, el nombre de API del campo del id del chat y el id del agente de integración.
- 4
Elige la URL de respuesta y el secreto
Dale al nodo de respuesta una ruta aleatoria larga, define una segunda cadena aleatoria como secreto de Freshdesk y activa el flujo de trabajo.
- 5
Crea la regla de automatización
En la pestaña “Ticket Updates”, una regla que se ejecute cuando un agente agrega una nota en un ticket con la etiqueta spun, y que llame a la URL de respuesta del flujo de trabajo con el encabezado X-Spun-Secret.
- 6
Crea una clave de API de Spun
“Configuraciones”, luego “Webhooks”, luego “Gestionar claves API”, con el permiso “Enviar mensajes”. Marca también “Cerrar y reabrir conversaciones” si cerrar en Freshdesk debe archivar la conversación en Spun.
- 7
Suscribe Spun al flujo de trabajo
Agrega un webhook para mensajes entrantes, mensajes salientes, conversación cerrada y conversación reabierta, con el “Formato de carga útil” en “Crudo (predeterminado)”, y pega su secreto de firma en el flujo de trabajo.
- 8
Envía un mensaje de prueba
Escríbele a la línea desde otro teléfono. Aparece un ticket en Freshdesk; respóndelo con una nota pública y la respuesta llega al teléfono. Revisa las notificaciones por correo al solicitante durante esta primera prueba.
Relacionado: Documentación: Freshdesk con n8n, la guía de configuración completa · WhatsApp + n8n: la API y los webhooks que hay debajo
Lo que debes saber antes de construirlo
- Freshdesk no firma sus webhooks, así que el flujo de trabajo verifica un encabezado con un secreto compartido en cada respuesta. Los eventos propios de Spun van firmados con HMAC.
- Los archivos multimedia entran al ticket como un enlace válido durante 24 horas, no como un adjunto. Los adjuntos de la nota de un agente no se reenvían.
- Los chats de grupo se omiten.
- El límite de API de Freshdesk es por cuenta y por minuto (Growth 100, Pro 400, Enterprise 700) y se comparte con tus otras apps. Una conversación nueva usa hasta 5 llamadas y un mensaje posterior, 2 o 3. Freshdesk permite 1.000 llamadas de webhook por hora y pone el resto en cola.
- Cada evento entregado usa tokens de IA de tu plan de Spun. Cómo se mide esto para el uso con mesas de ayuda todavía está en revisión.
Relacionado: Todas las integraciones de WhatsApp con mesas de ayuda · WhatsApp como la mesa de ayuda en sí