Los webhooks son una de las herramientas de automatización más poderosas en Zendesk. Permiten que tu plataforma de soporte hable con otros sistemas en tiempo real, enviando datos a donde necesiten ir sin intervención manual.
Piensa en un webhook como un mensajero que corre entre aplicaciones. Cuando algo sucede en Zendesk (se crea un ticket, se actualiza un usuario, cambia una prioridad), el webhook lleva esa información a otro sistema instantáneamente. En lugar de verificar las actualizaciones cada pocos minutos, tus sistemas reciben una notificación en el momento en que algo sucede.
Esta guía te lleva a través de todo lo que necesitas saber sobre los webhooks de Zendesk: qué son, cómo configurarlos y cómo usarlos de manera efectiva. Ya sea que estés conectando Zendesk a Slack, actualizando un CRM o construyendo integraciones personalizadas, encontrarás pasos prácticos que puedes seguir de inmediato.
Si estás buscando automatización sin la complejidad técnica de los webhooks, herramientas como eesel AI ofrecen integraciones nativas de Zendesk que se encargan del trabajo pesado por ti. Nuestro Agente de IA puede resolver tickets de forma autónoma sin ninguna configuración de webhook. Pero si deseas un control total sobre tus flujos de datos, los webhooks son el camino a seguir.
Paso 1: Accede a la sección de webhooks en el Centro de Administración de Zendesk
Para comenzar, inicia sesión en tu cuenta de Zendesk y navega al Centro de Administración. Haz clic en el icono de engranaje en la barra lateral, luego ve a Aplicaciones e integraciones > Webhooks. Para obtener más detalles, consulta la documentación oficial de webhooks de Zendesk.
El panel de control de webhooks muestra todos tus webhooks existentes, su estado (activo o inactivo) y cuándo se activaron por última vez. Si esta es tu primera vez aquí, la lista estará vacía.
Tómate un momento para familiarizarte con la interfaz. Verás opciones para crear nuevos webhooks, editar los existentes y ver los registros de actividad. Los registros de actividad son particularmente útiles cuando estás solucionando problemas más adelante.
Paso 2: Crea un nuevo webhook
Haz clic en el botón Crear webhook para iniciar el proceso de configuración. Verás un formulario con varios campos para configurar.
Nombra tu webhook con algo descriptivo. Te lo agradecerás más tarde cuando tengas múltiples webhooks y necesites recordar lo que hace cada uno. "Notificaciones de tickets urgentes de Slack" es mejor que "Webhook 1".
Elige tu método de conexión. Zendesk ofrece dos formas de conectar webhooks:
- Disparador o Automatización el webhook se activa cuando se cumplen condiciones específicas del ticket (como cuando se crea un ticket de alta prioridad)
- Eventos de Zendesk el webhook se suscribe a eventos del sistema (como cuando se crea o actualiza cualquier usuario)
¿La diferencia clave? Los webhooks basados en disparadores te dan un control preciso sobre cuándo se activan. Los webhooks basados en eventos se activan para cada instancia de ese tipo de evento, sin filtrado a nivel de Zendesk.
Importante: Una vez que creas un webhook, no puedes cambiar su método de conexión. Si comienzas con un webhook basado en disparadores, siempre será basado en disparadores. Elige cuidadosamente según tu caso de uso.
Ingresa tu URL de endpoint: aquí es donde Zendesk enviará los datos del webhook. Para pruebas, puedes usar un servicio como webhook.site para ver las cargas útiles. Para producción, esta debería ser tu endpoint de integración real.
Paso 3: Configura los ajustes de la solicitud
Ahora configurarás cómo el webhook envía datos a tu endpoint.
Selecciona el método HTTP basado en lo que espera tu endpoint:
- POST más común para crear recursos o enviar datos
- PUT/PATCH para actualizar recursos existentes
- GET para recuperar datos (raramente usado con webhooks)
- DELETE para eliminar recursos
Si te estás conectando a eventos de Zendesk (no a disparadores), debes usar POST. Las suscripciones a eventos no admiten otros métodos HTTP.
Elige tu formato de solicitud:
- JSON el estándar para las APIs modernas, legible por humanos y ampliamente compatible
- XML formato más antiguo, todavía utilizado por algunos sistemas empresariales
- Form-encoded pares clave-valor simples, útiles para integraciones básicas
De nuevo, los webhooks basados en eventos requieren JSON. Solo los webhooks basados en disparadores te dan flexibilidad de formato.
Configura la autenticación. La mayoría de los endpoints de producción requieren alguna forma de autenticación. Zendesk admite:
- Token Bearer Zendesk envía un encabezado
Authorization: Bearer <token> - Autenticación básica nombre de usuario y contraseña codificados en la solicitud
- Clave API encabezado personalizado con tu clave API
- Ninguna solo para pruebas o endpoints públicos
Para la autenticación con token Bearer, pega tu token en el campo. Zendesk maneja el formato del encabezado por ti. Si estás usando un encabezado personalizado para las claves API, agrégalo en la sección de encabezados personalizados.
Paso 4: Prueba tu webhook
Antes de guardar tu webhook, pruébalo para asegurarte de que todo funcione.
Haz clic en Probar webhook para abrir el panel de pruebas. Verás una carga útil de muestra que Zendesk enviaría, junto con opciones para personalizar los datos de prueba.
Haz clic en Enviar prueba y observa la respuesta. Una prueba exitosa muestra una marca de verificación verde con un código de estado HTTP de nivel 200. Si ves errores, verifica:
- ¿Es correcta y accesible la URL de tu endpoint?
- ¿Está configurada correctamente la autenticación?
- ¿Está tu endpoint esperando el formato de solicitud correcto?
Los registros de actividad del webhook son tu mejor amigo para la depuración. Ve a Centro de Administración > Webhooks > [tu webhook] > Actividad para ver los intentos de entrega, los códigos de respuesta y los mensajes de error.
Los problemas comunes incluyen:
- Errores 401/403 problemas de autenticación, verifica tus tokens
- Errores 404 la URL del endpoint es incorrecta o el servicio está inactivo
- Errores 500 tu endpoint se está bloqueando, verifica los registros de tu servidor
- Tiempos de espera tu endpoint es demasiado lento para responder (Zendesk espera 10 segundos)
Una vez que tu prueba pase, haz clic en Crear para guardar el webhook.
Paso 5: Conecta a disparadores o eventos
Tu webhook está creado, pero no hará nada hasta que lo conectes a un disparador, automatización o suscripción a eventos.
Para webhooks basados en disparadores:
- Ve a Centro de Administración > Objetos y reglas > Disparadores (o Automatizaciones)
- Crea un nuevo disparador o edita uno existente
- Establece tus condiciones (por ejemplo, "Prioridad es Alta" Y "Estado es Nuevo")
- En Acciones, selecciona Notificar webhook activo y elige tu webhook
- Configura la carga útil JSON usando marcadores de posición de Zendesk como
{{ticket.id}},{{ticket.requester.email}}o{{ticket.subject}}
Para webhooks basados en eventos:
- Edita tu webhook
- En Suscripciones, selecciona los eventos a los que deseas suscribirte
- Los eventos disponibles incluyen eventos de tickets, eventos de usuarios, eventos de organizaciones y más
- Guarda tus cambios
Recuerda: los webhooks basados en eventos se activan para cada instancia de ese evento. Si te suscribes a "ticket creado", obtendrás un webhook para cada ticket individual. Asegúrate de que tu endpoint pueda manejar el volumen.
Casos de uso comunes para los webhooks de Zendesk
Una vez que comprendas los conceptos básicos, comenzarás a ver oportunidades de webhook en todas partes. Estas son algunas de las formas más comunes en que los equipos usan los webhooks de Zendesk:
Notificaciones de Slack para tickets urgentes
Cuando llega un ticket de alta prioridad, publica un mensaje en tu canal #soporte-urgente con los detalles del ticket y un enlace directo. Esto mantiene a todos informados sin la constante verificación de Zendesk.
Actualización de sistemas CRM externos
Cuando un usuario se crea o actualiza en Zendesk, sincroniza esos datos con Salesforce, HubSpot o tu CRM personalizado. Esto mantiene los registros de clientes consistentes en todas las plataformas.
Envío de notificaciones SMS
Conecta Zendesk a un servicio de SMS como 8x8 o Twilio para enviar a los clientes actualizaciones proactivas sobre sus tickets.
Registro de data warehouse
Envía todos los eventos de tickets a un data warehouse como Snowflake o BigQuery para análisis. Esto te da un historial completo de la actividad de soporte para informes y aprendizaje automático.
Acciones automatizadas de tickets a través de llamadas API internas
Usa webhooks para llamar a la propia API de Zendesk para actualizaciones complejas de tickets que los disparadores no pueden manejar. Por ejemplo, copiar datos entre campos personalizados o actualizar tickets relacionados.
Automatización de privacidad y cumplimiento
Conéctate a plataformas de privacidad como Transcend para manejar automáticamente las solicitudes de sujetos de datos cuando los clientes envían un correo electrónico a tu equipo de soporte.
Probar webhooks localmente con ngrok
¿Estás construyendo un endpoint de webhook en tu máquina local? Necesitarás una forma de exponerlo a Internet para que Zendesk pueda alcanzarlo. Ahí es donde entra ngrok.
ngrok crea un túnel seguro desde una URL pública a tu localhost. Aquí te mostramos cómo configurarlo:
- Instala ngrok descarga desde ngrok.com y autentícate con tu authtoken
- Inicia tu servidor local ejecuta tu endpoint de webhook en localhost (generalmente el puerto 3000 u 8080)
- Inicia ngrok ejecuta
ngrok http 3000(reemplaza 3000 con tu puerto) - Copia la URL de ngrok se ve como
https://1a2b-3c4d.ngrok.app - Usa esa URL en Zendesk pégala como tu endpoint de webhook
Ahora, cuando Zendesk envíe webhooks, se enrutarán a través de ngrok a tu máquina local. Puedes inspeccionar la carga útil completa de la solicitud, los encabezados y la respuesta en el panel de control o terminal de ngrok.
Esta configuración es perfecta para el desarrollo y las pruebas. Solo recuerda: las URL de ngrok cambian cada vez que reinicias ngrok (a menos que tengas un plan de pago con dominios reservados). Actualiza la configuración de tu webhook de Zendesk si cambia tu URL de ngrok.
Solución de problemas comunes
Incluso con una configuración cuidadosa, los webhooks a veces fallan. Aquí te mostramos cómo diagnosticar y solucionar problemas comunes:
Webhook no se activa
- Verifica las condiciones de tu disparador ¿realmente se están cumpliendo?
- Verifica que el webhook esté activo, no en pausa
- Mira los registros de actividad del webhook para ver los intentos de entrega
- Para webhooks basados en disparadores, prueba el disparador por separado
Fallos de autenticación
- Verifica tu token Bearer o clave API
- Verifica que el token no haya caducado
- Asegúrate de estar utilizando el método de autenticación correcto para tu endpoint
- Verifica si tu endpoint espera la autenticación en un formato de encabezado específico
Limitación de velocidad
Las cuentas de prueba están limitadas a 60 invocaciones de webhook por minuto. Si excedes esto, Zendesk bloqueará temporalmente las solicitudes adicionales. Soluciones:
- Actualiza a un plan de pago de Zendesk
- Agrupa tus llamadas de webhook
- Usa condiciones de disparador para reducir el disparo innecesario de webhooks
Errores de formato de carga útil
- Verifica que tu endpoint espere el formato que estás enviando (JSON vs. XML)
- Verifica que los campos requeridos estén incluidos en tu carga útil
- Prueba con una herramienta como Postman para validar que tu endpoint funciona de forma independiente
Lógica de reintento y fallos de entrega
Zendesk reintenta automáticamente los webhooks fallidos con retroceso exponencial. Si tu endpoint devuelve un error 5xx o se agota el tiempo de espera, Zendesk reintentará varias veces durante las próximas horas. Verifica los registros de tu endpoint para ver si los reintentos están llegando a tu servidor.
Agilización de la automatización del soporte con eesel AI
Los webhooks te dan flexibilidad, pero también requieren configuración técnica y mantenimiento continuo. Si estás buscando automatización sin escribir código ni administrar endpoints, eesel AI ofrece un enfoque diferente. También puedes explorar nuestro Copiloto de IA para redactar respuestas o Triage de IA para el enrutamiento automatizado de tickets.
En lugar de construir integraciones de webhook, invitas a eesel AI a tu equipo como un compañero de equipo de IA. Se conecta directamente a Zendesk y aprende de tus tickets pasados, artículos del centro de ayuda y macros. En cuestión de minutos, comprende tu negocio y puede comenzar a manejar tickets.
Puedes comenzar con eesel AI redactando respuestas para que tus agentes las revisen. A medida que demuestra su valía, lo subes de nivel para enviar respuestas directamente, manejar tipos de tickets específicos o trabajar las 24 horas del día, los 7 días de la semana. La progresión está controlada: tú decides cuándo expandir su alcance en función del rendimiento real.
Para los equipos que ya usan webhooks, eesel AI puede complementar tu automatización existente. Usa webhooks para integraciones de sistema a sistema y deja que eesel AI maneje la capa de conversación orientada al cliente. Juntos, crean una poderosa pila de automatización que cubre tanto los flujos de trabajo técnicos como las interacciones de soporte similares a las humanas.
Si estás dedicando más tiempo a mantener las integraciones de webhook que a beneficiarte de ellas, podría valer la pena explorar si un enfoque nativo de IA se adapta mejor a tus necesidades.
Preguntas Frecuentes
Compartir esta entrada
Article by
Stevia Putri
Stevia Putri is a marketing generalist at eesel AI, where she helps turn powerful AI tools into stories that resonate. She’s driven by curiosity, clarity, and the human side of technology.
