{
"title": "Cómo configurar un webhook de Zendesk para eventos de creación de tickets",
"slug": "zendesk-webhook-ticket-created",
"locale": "es",
"date": "2026-03-02",
"updated": "2026-03-02",
"template": "default",
"excerpt": "Una guía completa para configurar webhooks de Zendesk para notificaciones de nuevos tickets, incluyendo los pasos de configuración, ejemplos de carga útil y escenarios comunes de resolución de problemas.",
"categories": [
"Zendesk",
"Guides"
],
"tags": [
"Zendesk",
"Webhooks",
"Automation",
"Customer Support",
"API"
],
"readTime": 10,
"author": 16,
"reviewer": 14,
"seo": {
"title": "Cómo configurar un webhook de Zendesk para eventos de creación de tickets",
"description": "Una guía completa para configurar webhooks de Zendesk para notificaciones de nuevos tickets, incluyendo los pasos de configuración, ejemplos de carga útil y escenarios comunes de resolución de problemas.",
"image": "https://wmeojibgfvjvinftolho.supabase.co/storage/v1/object/public/public_assets/blog-gen/banner-60c5f122-d5be-430f-ba9b-eb77123be95f"
},
"coverImage": "https://wmeojibgfvjvinftolho.supabase.co/storage/v1/object/public/public_assets/blog-gen/banner-60c5f122-d5be-430f-ba9b-eb77123be95f",
"coverImageAlt": "Imagen de banner para Cómo configurar un webhook de Zendesk para eventos de creación de tickets",
"coverImageWidth": 1920,
"coverImageHeight": 1080,
"faqs": {
"heading": "Preguntas Frecuentes",
"type": "blog",
"answerType": "html",
"faqs": [
{
"question": "¿Puedo configurar un webhook de Zendesk para eventos de creación de tickets sin programar?",
"answer": "Parcialmente. La creación del webhook en sí es de apuntar y hacer clic en el Centro de Administración de Zendesk. Sin embargo, aún necesita una URL de punto final para recibir los datos. Servicios como Zapier o Make pueden manejar el lado de recepción sin código personalizado, actuando como un puente entre Zendesk y sus otras herramientas."
},
{
"question": "¿Cuál es la diferencia entre las suscripciones a eventos y los webhooks conectados a disparadores?",
"answer": "Las suscripciones a eventos se activan para cada ocurrencia de un tipo de evento con una carga útil fija. Los webhooks conectados a disparadores solo se activan cuando se cumplen condiciones específicas, y puede personalizar la carga útil. Las suscripciones a eventos son más simples pero menos flexibles. No puede cambiar el método de conexión de un webhook después de la creación."
},
{
"question": "¿Con qué rapidez se activan los webhooks de Zendesk después de que se crea un ticket?",
"answer": "Zendesk hace un 'mejor intento' para entregar webhooks casi en tiempo real. La mayoría se activan a los pocos segundos de que ocurra el evento. Sin embargo, durante los períodos de alto volumen o incidentes, puede haber retrasos. No cree sistemas que dependan de la entrega de webhooks en menos de un segundo."
},
{
"question": "¿Puedo filtrar qué tickets activan mi webhook?",
"answer": "Solo con webhooks conectados a disparadores. Puede agregar condiciones como 'Prioridad es Alta' o 'Grupo es Soporte' para limitar cuándo se activa el webhook. Las suscripciones a eventos se activan para cada ticket sin filtrar."
},
{
"question": "¿Qué sucede si mi punto final de webhook está inactivo?",
"answer": "Zendesk reintenta las entregas fallidas con retroceso exponencial. Para la mayoría de los códigos de error, se reintenta hasta 3 veces. Para los tiempos de espera, se reintenta hasta 5 veces. Si su punto final falla constantemente, el disyuntor de Zendesk deshabilitará el webhook después de alcanzar los umbrales de error."
},
{
"question": "¿Existe una alternativa más simple a los webhooks de Zendesk para la automatización?",
"answer": "Sí. Las herramientas de soporte impulsadas por IA como eesel AI pueden automatizar el manejo de tickets sin ninguna configuración de webhook. Conecta su cuenta de Zendesk y la IA aprende a etiquetar, enrutar y responder a los tickets en función de sus datos históricos. Sin puntos finales que mantener, sin análisis de carga útil, sin lógica de reintento que administrar."
}
],
"supportLink": null
}
}
---
Los webhooks son una de las herramientas más poderosas en el arsenal de automatización de [Zendesk](https://www.zendesk.com). Le permiten enviar notificaciones en tiempo real a sistemas externos cada vez que sucede algo en su mesa de ayuda. Cuando un cliente envía un nuevo ticket, un webhook puede alertar instantáneamente a su equipo en Slack, actualizar su CRM o activar flujos de trabajo personalizados en sus propias aplicaciones.
Configurar un webhook de Zendesk para eventos de creación de tickets no es complicado, pero hay algunas decisiones importantes que tomar en el camino. Esta guía lo guía a través de todo el proceso, desde la configuración inicial hasta las pruebas y la resolución de problemas.
## Lo que necesitará
Antes de comenzar, asegúrese de tener:
- Una cuenta de [Zendesk Support](https://www.zendesk.com) en el plan Team o superior (los webhooks no están disponibles en el plan Essential)
- Acceso de administrador o un rol personalizado con permisos de creación de webhook
- Una URL de punto final que pueda recibir solicitudes HTTP POST (esto podría ser un servicio como Zapier, una API personalizada o un sitio de prueba de webhook)
- Un token de API si planea usar la autenticación (recomendado para producción)
Las cuentas de prueba tienen algunas limitaciones: un máximo de 10 webhooks y 60 invocaciones por minuto. Eso es suficiente para las pruebas, pero querrá actualizar antes de poner en marcha la automatización pesada.
## Paso 1: Crear el webhook en Zendesk
Primero, debe crear el webhook en sí. Esto define dónde Zendesk enviará los datos y cómo se autenticará.
Navegue a **Centro de administración** → **Aplicaciones e integraciones** → **Webhooks**. Haga clic en **Acciones** en la parte superior derecha, luego seleccione **Crear webhook**.
Verá un formulario con varios campos para configurar:
**Nombre y descripción:** Dele a su webhook un nombre claro como "Notificación de nuevo ticket" para que pueda identificarlo más tarde. La descripción es opcional pero útil si tiene varios webhooks.
**URL del punto final:** Aquí es donde Zendesk enviará los datos del webhook. Debe ser una URL HTTPS válida que pueda aceptar solicitudes POST. Para las pruebas, puede usar un servicio como webhook.site para ver las cargas útiles sin construir su propio punto final.
**Método HTTP:** Para las suscripciones a eventos, esto debe ser POST. Si se está conectando a disparadores en su lugar, puede elegir GET, POST, PUT, PATCH o DELETE dependiendo de lo que espere su punto final.
**Formato de solicitud:** Para las suscripciones a eventos, esto debe ser JSON. Los webhooks conectados a disparadores también admiten formatos XML y codificados en formulario.
**Autenticación:** Esto es muy recomendable para la producción. Zendesk admite tres métodos:
- **Clave API (API key):** Agrega un encabezado personalizado con su clave
- **Autenticación básica (Basic auth):** Nombre de usuario y contraseña, codificados en base64
- **Token de portador (Bearer token):** Token estilo OAuth 2.0 en el encabezado de autorización
Una vez que haya completado todo, haga clic en **Crear** en la parte inferior. Su webhook ahora está creado pero aún no está conectado a ningún evento. Ese es el siguiente paso.
## Paso 2: Elija su método de conexión
Aquí es donde debe tomar una decisión importante. Zendesk ofrece dos formas de conectar webhooks a la actividad de los tickets, y no puede cambiar esto más tarde sin eliminar y volver a crear el webhook.
### Opción A: Suscripción a eventos (zen:event-type:ticket.created)
Este enfoque suscribe su webhook directamente al flujo de eventos de Zendesk. Cuando se crea cualquier ticket, su webhook se activa.
**Pros:**
- Se activa para cada ticket creado, garantizado
- Configuración simple: no se necesitan disparadores
- Entrega casi en tiempo real
**Contras:**
- Estructura de carga útil fija (no puede personalizar qué datos se envían)
- Sin filtrado: obtiene cada ticket, incluso el spam
- Debe usar POST y JSON
### Opción B: Webhook conectado a disparador
Este enfoque conecta su webhook a un disparador de Zendesk. El disparador decide cuándo disparar en función de las condiciones que defina.
**Pros:**
- Control total sobre cuándo se activa el webhook (grupos específicos, prioridades, etiquetas)
- Carga útil personalizable utilizando marcadores de posición de Zendesk
- Puede filtrar el ruido (spam, tickets de prueba, etc.)
**Contras:**
- Requiere crear y mantener un disparador
- Configuración un poco más compleja
**¿Cuál debe elegir?** Si necesita cada ticket y no le importa filtrar en su extremo, use suscripciones a eventos. Si solo desea tickets específicos (como problemas de alta prioridad o tickets de ciertas organizaciones), use webhooks conectados a disparadores.
## Paso 3: Configurar el disparador (para webhooks conectados a disparadores)
Si eligió la Opción B, ahora necesita crear un disparador que invoque su webhook.
Navegue a **Centro de administración** → **Objetos y reglas** → **Disparadores**. Haga clic en **Agregar disparador**.
**Establezca sus condiciones:**
Como mínimo, agregue: **Ticket** | **Es** | **Creado**
Puede agregar más condiciones para filtrar qué tickets activan el webhook:
- La prioridad es alta o urgente
- El grupo es "Soporte técnico"
- Las etiquetas contienen "escalado"
- La organización es un cliente VIP específico
**Agregar la acción del webhook:**
En **Acciones**, seleccione **Notificar webhook activo** en el menú desplegable. Elija el webhook que creó en el Paso 1.
**Configurar la carga útil JSON:**
Aquí es donde define qué datos se envían a su punto final. Use marcadores de posición de Zendesk para insertar datos de tickets:
```json
{
"ticket_id": "{{ticket.id}}",
"subject": "{{ticket.title}}",
"description": "{{ticket.description}}",
"requester_email": "{{ticket.requester.email}}",
"requester_name": "{{ticket.requester.name}}",
"priority": "{{ticket.priority}}",
"status": "{{ticket.status}}",
"group": "{{ticket.group.name}}",
"assignee": "{{ticket.assignee.name}}",
"created_at": "{{ticket.created_at}}",
"tags": "{{ticket.tags}}",
"url": "{{ticket.link}}"
}
Zendesk reemplazará cada marcador de posición con los datos reales del ticket cuando se active el webhook. También puede usar el marcado Liquid para la lógica condicional.
Importante: Agregue una condición de anulación para evitar bucles infinitos. Dado que el disparador se activa cuando se crea un ticket, y el webhook podría actualizar el ticket, necesita una condición que impida que el disparador se active nuevamente. Un patrón común es agregar una etiqueta en su respuesta de webhook y excluir los tickets con esa etiqueta.
Paso 4: Pruebe su webhook
Antes de confiar en su webhook en producción, debe verificar que funcione.
Prueba a través de la configuración del webhook:
Vuelva a Centro de administración → Aplicaciones e integraciones → Webhooks. Encuentre su webhook y haga clic en el menú de tres puntos, luego en Probar webhook.
Zendesk enviará una carga útil de prueba a su punto final. La prueba utiliza un secreto de firma estático (dGhpc19zZWNyZXRfaXNfZm9yX3Rlc3Rpbmdfb25seQ==) para que pueda verificar la validación de la firma.
Prueba con un ticket real:
Cree un ticket de prueba en Zendesk. Verifique su punto final para verificar:
- Llegó la solicitud
- La carga útil contiene los datos esperados
- Los encabezados de autenticación están presentes (si están configurados)
- La firma se valida (si usa HMAC)
Verifique los registros de actividad del webhook:
Zendesk mantiene registros de las invocaciones de webhook durante 7 días. Puede acceder a estos a través de la API de Webhooks para ver el estado de entrega, los códigos de respuesta y cualquier error.
Comprender la carga útil del webhook
Cuando Zendesk envía un webhook para un evento de creación de tickets, la estructura de la carga útil difiere según su método de conexión.
Carga útil suscrita a eventos
Para las suscripciones directas a eventos, la carga útil sigue un esquema fijo:
{
"type": "zen:event-type:ticket.created",
"account_id": 22129848,
"id": "cbe4028c-7239-495d-b020-f22348516046",
"time": "2025-01-08T10:12:07.672Z",
"zendesk_event_version": "2022-11-06",
"subject": "zen:ticket:5158",
"detail": {
"actor_id": "8447388090494",
"assignee_id": "8447388090494",
"brand_id": "8447346621310",
"created_at": "2025-01-08T10:12:07Z",
"description": "I need help with my order",
"id": "5158",
"is_public": true,
"organization_id": "8447346622462",
"priority": "LOW",
"requester_id": "8447388090494",
"status": "OPEN",
"subject": "Order help needed",
"tags": ["order", "help"],
"via": { "channel": "web_service" }
},
"event": { "meta": { "sequence": { "id": 12345, "position": 1 } } }
}
Los campos clave incluyen el ID del ticket, el asunto, la descripción, el ID del solicitante, la prioridad, el estado y la marca de tiempo de creación.
Carga útil conectada a disparador
Para los webhooks conectados a disparadores, la carga útil es lo que haya definido en la acción del disparador. Tiene control total sobre la estructura y el contenido.
Autenticación y seguridad
Los webhooks pueden transportar datos confidenciales de los tickets, por lo que es importante protegerlos.
Métodos de autenticación:
- Clave API (API key): Agregue un encabezado como
X-API-Key: your-secret-key - Autenticación básica (Basic auth): Nombre de usuario:contraseña codificado en Base64 en el encabezado de autorización
- Token de portador (Bearer token): Estilo OAuth 2.0
Authorization: Bearer your-token
Verificación de firma HMAC:
Zendesk admite firmas HMAC-SHA256 para verificar la autenticidad del webhook. Cada webhook obtiene un secreto de firma único. Zendesk firma cada solicitud calculando un HMAC sobre la marca de tiempo y el cuerpo de la solicitud.
Su punto final debería:
- Extraer la firma del encabezado
x-zendesk-webhook-signature - Extraer la marca de tiempo del encabezado
x-zendesk-webhook-signature-timestamp - Calcular la firma esperada utilizando su secreto de firma
- Comparar usando la comparación de tiempo constante para evitar ataques de tiempo
Mejores prácticas:
- Siempre use puntos finales HTTPS
- Verifique las firmas en producción
- Almacene los secretos de firma de forma segura (no en repositorios de código)
- Implemente la idempotencia para manejar entregas duplicadas
- Devuelva el estado 200 rápidamente; procese de forma asíncrona si es necesario
Solución de problemas comunes
Incluso con una configuración cuidadosa, los webhooks a veces no funcionan como se espera. Estos son los problemas más comunes y cómo solucionarlos.
Webhook no se activa:
- Verifique las condiciones del disparador: ¿realmente se cumplen?
- Verifique que el disparador esté activo (no deshabilitado)
- Busque condiciones de anulación que puedan impedir la ejecución
- Confirme que el estado del webhook sea "activo"
Errores de punto final (respuestas 4xx, 5xx):
- 410 Gone: Su punto final devolvió un error; verifique los registros de su servidor
- 429 Too Many Requests: Está siendo limitado por la velocidad; implemente el retroceso
- Errores 5xx: Problemas del lado del servidor en su extremo
Problemas de tiempo de espera:
Zendesk tiene un tiempo de espera estricto de 10 segundos. Si su punto final no responde dentro de los 10 segundos, Zendesk lo marca como fallido y vuelve a intentarlo. Asegúrese de que su punto final responda rápidamente, procesando el trabajo pesado de forma asíncrona si es necesario.
Disyuntor activado:
Si su webhook falla a una tasa de error del 70% o acumula más de 1,000 errores en 5 minutos, Zendesk lo desactiva automáticamente. Deberá solucionar el problema subyacente y volver a habilitar el webhook manualmente.
Faltan registros de actividad:
Zendesk solo mantiene los registros de actividad del webhook durante 7 días. Si necesita una retención más prolongada, deberá registrar los eventos del webhook en su propia infraestructura.
Alternativa: Automatización sin webhooks
Los webhooks son poderosos, pero no siempre son la herramienta adecuada. Requieren configuración técnica, mantenimiento continuo y manejo de errores. Si desea la automatización sin la complejidad, existen alternativas.
Creamos eesel AI para manejar la automatización del soporte sin requerir webhooks o desarrollo personalizado. En lugar de configurar puntos finales y analizar cargas útiles JSON, simplemente conecta eesel AI a su cuenta de Zendesk. Aprende de sus tickets anteriores y artículos del centro de ayuda, luego maneja las tareas rutinarias automáticamente.
Aquí está la diferencia:
| Enfoque | Tiempo de configuración | Habilidad técnica necesaria | Mantenimiento |
|---|---|---|---|
| Webhooks | 2-4 horas | Se requiere desarrollador | Monitoreo continuo |
| eesel AI | 10 minutos | Ninguno | Automático |
Con eesel AI, puede:
- Etiquetar y enrutar automáticamente los tickets según el contenido
- Borrar respuestas para sus agentes
- Manejar preguntas comunes de principio a fin
- Escalar problemas complejos a humanos
¿La mejor parte? Puede probarlo en tickets anteriores antes de ponerlo en marcha. No hay riesgo de interrumpir los flujos de trabajo de producción mientras ajusta la configuración.
Comience a automatizar sus flujos de trabajo de Zendesk hoy mismo
Configurar un webhook de Zendesk para eventos de creación de tickets le brinda visibilidad en tiempo real de las nuevas solicitudes de soporte. Ya sea que esté notificando canales de Slack, sincronizando con un CRM o activando flujos de trabajo personalizados, los webhooks proporcionan el pegamento entre Zendesk y el resto de su pila.
El proceso es sencillo: cree el webhook, elija su método de conexión, configure un disparador (si es necesario) y pruebe a fondo. Preste atención a la autenticación y el manejo de errores para garantizar un funcionamiento confiable.
Si los webhooks le parecen exagerados para sus necesidades, considere si un enfoque impulsado por IA podría funcionar mejor. Herramientas como eesel AI pueden automatizar el manejo de tickets sin ninguna configuración de webhook o administración de puntos finales. Puede probar eesel AI gratis y ver cómo maneja sus tipos de tickets específicos antes de comprometerse con una solución basada en webhook.
De cualquier manera, el objetivo es el mismo: dedicar menos tiempo a la administración manual de tickets y más tiempo a ayudar a los clientes.
Compartir esta entrada
Article by
