Hay dos formas verídicas de hacer que WhatsApp funcione con Zendesk, y son muy distintas. El primer camino es el canal de WhatsApp propio de Zendesk: oficial, construido sobre la Business API, lo que significa un número dedicado, aprobaciones de plantillas, cargos por mensaje y nada de grupos de WhatsApp. El segundo camino mantiene WhatsApp en el número que ya usas, con Spun como espacio de trabajo de WhatsApp, y un flujo de trabajo de WhatsApp a Zendesk en tu propio n8n convierte cada conversación en un ticket de Zendesk.
Esta página documenta el segundo camino, y es franca sobre cuándo el primero encaja mejor: si toda tu operación de soporte vive dentro de Zendesk y quieres WhatsApp como un canal de tickets más, con la economía de la API, usa el canal de Zendesk. Si WhatsApp es tu canal principal con los clientes y Zendesk es un sistema entre varios, mantenerlo en tu número real con una bandeja de entrada de equipo suele atender mejor a los clientes.
1. Tickets de WhatsApp en Zendesk: lo que hace el flujo de trabajo
Cada conversación individual de WhatsApp en la línea se convierte en un ticket de Zendesk, sin tener que aplicar antes una etiqueta. Los mensajes posteriores se agregan al mismo ticket, y un comentario público de un agente vuelve al cliente por WhatsApp.
- El solicitante es un usuario de Zendesk que el flujo de trabajo encuentra o crea para el número de teléfono del cliente, y el ticket se crea para ese usuario.
- Los comentarios públicos de los agentes en Zendesk se envían al cliente por WhatsApp como texto, desde tu propio número. Los comentarios privados quedan como internos.
- Las respuestas que tu equipo envía desde la bandeja de entrada de Spun se convierten en comentarios privados en el ticket, así que ambos lados pueden responder y el ticket conserva todo el intercambio.
- Archivar la conversación en Spun resuelve el ticket, y desarchivarla lo reabre. Resolverlo en Zendesk también puede archivar la conversación en Spun, una opción que está desactivada hasta que la actives. En ningún caso el flujo de trabajo le envía al cliente un mensaje de estado.
- Cada respuesta se envía con el id del comentario de Zendesk como clave de idempotencia, así que una respuesta reintentada no se envía dos veces.
Los chats de grupo se omiten. Los archivos multimedia llegan al ticket como un enlace que sigue siendo válido durante 24 horas.
2. Configúralo
Necesitas un administrador de Zendesk que pueda crear webhooks, disparadores y un cliente OAuth, un agente de integración como “Spun WhatsApp” y una instancia de n8n a la que Zendesk y Spun puedan llegar por HTTPS. La guía de configuración enumera cada valor y dónde encontrarlo.
- 1
Crea un cliente OAuth
Con la sesión iniciada como el agente de integración, agrega un cliente OAuth en el “Admin Center” de Zendesk y una credencial OAuth2 en n8n con el tipo de concesión “Client Credentials”. Un token de API es la alternativa.
- 2
Importa el flujo de trabajo
Abre su nodo “Settings” y pega la URL de tu Zendesk y el id de usuario del agente de integración. Un grupo, una marca y un campo de ticket “Spun line” son opcionales.
- 3
Crea el webhook y el disparador de respuestas en Zendesk
Un webhook que apunte a la URL de respuestas del flujo de trabajo, y un disparador que lo llame cuando un ticket con la etiqueta spun reciba un comentario público. Pega el secreto de firma del webhook en el flujo de trabajo.
- 4
Crea una clave API de Spun
“Configuraciones”, luego “Webhooks”, luego “Gestionar claves API”, con el permiso “Send Messages”. Marca también “Cerrar y reabrir conversaciones” si resolver en Zendesk debe archivar la conversación en Spun.
- 5
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.
- 6
Envía un mensaje de prueba
Escríbele a la línea desde otro teléfono. Aparece un ticket en Zendesk; responde con un comentario público y la respuesta llega al teléfono.
POST https://api.spun.com/api/integrations/send-message
Authorization: Bearer wap_YOUR_KEY
Content-Type: application/json
{
"to": "14155552671",
"text": "Thanks for waiting, your replacement ships today.",
"idempotency_key": "<Zendesk comment id>"
}Relacionado: Documentación: Zendesk 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 construir
- Esto es un puente, no una fusión de canales: las conversaciones de WhatsApp viven en Spun, los tickets viven en Zendesk y el flujo de trabajo los mantiene al mismo ritmo. Si necesitas WhatsApp como un canal de Zendesk con su propio número, ese es el primer camino, con sus costos y sus límites.
- Es un flujo de trabajo de n8n que importas, no una app del marketplace de Zendesk. El lado de Spun usa una clave API; el lado de Zendesk usa un cliente OAuth.
- Cerrar desde Zendesk llama a los endpoints de cierre y reapertura de Spun, que necesitan el permiso “Cerrar y reabrir conversaciones” en la clave.
- Zendesk permite 30 actualizaciones por ticket cada 10 minutos, 5 usuarios nuevos por minuto y 5,000 comentarios por ticket. La API de Spun permite 60 solicitudes por minuto por clave.
- Cada evento entregado usa tokens de IA de tu plan de Spun. Todavía se está revisando cómo se mide esto para el uso con mesas de ayuda.
- Muchos equipos descubren que la capa de tickets era la parte opcional: las etiquetas, la asignación y las tareas de Spun cubren por sí solas la gestión de tickets basada en chats. Consulta la página de WhatsApp como mesa de ayuda.
Relacionado: WhatsApp como la propia mesa de ayuda (sin necesidad de Zendesk) · Todas las integraciones de WhatsApp con mesas de ayuda · WhatsApp + Zapier y Make (la API completa)