Los webhooks se crean y administran en la página de webhooks en el Centro de administración de Zendesk.
Para crear grupos es necesario ser un administrador o un agente con un rol personalizado que tenga permiso para administrar webhooks.
Editar y administrar webhooks
En la mayoría de los casos, los administradores pueden editar, clonar, desactivar y borrar los webhooks. Sin embargo, los webhooks creados por los requisitos de una aplicación se pueden editar pero no se pueden clonar ni borrar. Los webhooks creados por los requisitos de una aplicación pueden ser actualizados por el desarrollador de la aplicación y anulan los cambios realizados por los administradores de la cuenta. Una vez creado el webhook, no se puede cambiar su método de conexión.
Para editar un webhook
- En el Centro de administración, haga clic en Aplicaciones e integraciones en la barra lateral y luego seleccione Acciones y webhooks > Webhooks.
- Ubique el webhook en la lista, haga clic en el icono del menú de opciones () en la fila del webhook y luego haga clic en Editar.
- Modifique el webhook según se necesite.
Todos los campos se pueden editar. Sin embargo, cuando se usa la autenticación, no se podrá ver la clave, el token ni la contraseña una vez que se haya creado o actualizado el webhook. Para eliminar un encabezado personalizado, haga clic en el icono para borrar ().
- (Opcional) Pruebe los cambios que haya hecho al webhook.
- Haga clic en Guardar.
Para clonar un webhook
- En el Centro de administración, haga clic en Aplicaciones e integraciones en la barra lateral y luego seleccione Acciones y webhooks > Webhooks.
- Ubique el webhook en la lista, haga clic en el icono del menú de opciones () en la fila del webhook y luego haga clic en Clonar.
- Edita el Nombre del webhook y modifique el webhook según se necesite.
- Haga clic en Actualizar.
Para desactivar un webhook
- En el Centro de administración, haga clic en Aplicaciones e integraciones en la barra lateral y luego seleccione Acciones y webhooks > Webhooks.
- Ubique el webhook en la lista, haga clic en el icono del menú de opciones () en la fila del webhook y luego haga clic en Desactivar.
- En el cuadro de diálogo de confirmación, haga clic en Desactivar.
Para borrar un webhook
- En el Centro de administración, haga clic en Aplicaciones e integraciones en la barra lateral y luego seleccione Acciones y webhooks > Webhooks.
- Ubique el webhook en la lista, haga clic en el icono del menú de opciones () en la fila del webhook y luego haga clic en Borrar.
- Haga clic en Borrar.
Ver la actividad de un webhook
Cada webhook tiene su propio registro de actividades. Además de un registro detallado de las invocaciones, también puede ver el número de solicitudes hechas en los últimos siete días.
Una invocación de webhook se vuelve a probar automáticamente hasta tres veces si los extremos devuelven ciertos códigos de respuesta HTTP. Si desea obtener más información y ver ejemplos de situaciones de reintento, consulte Webhook retry logic en la documentación para desarrolladores.
Zendesk hace lo posible por entregar acciones a los webhooks una sola vez. Sin embargo, no se puede garantizar que vaya a ser así. Es posible que un webhook sea invocado por la misma acción varias veces, o en determinadas circunstancias como cuando se gatilla el interruptor del webhook, las acciones podrían no ser entregadas. Para detectar las invocaciones duplicadas, podría utilizar firmas de webhooks. Si esto es problemático para su flujo de trabajo, asegúrese de que las acciones generadas por sus webhooks sean idempotentes.
- En el Centro de administración, haga clic en Aplicaciones e integraciones en la barra lateral y luego seleccione Acciones y webhooks > Webhooks.
- Ubique el webhook en la lista, haga clic en el icono del menú de opciones () en la fila del webhook y luego haga clic en Ver detalles.
- Haga clic en la pestaña Actividad.
- Haga clic en Filtrar para filtrar el registro de actividades por fecha de inicio, hora de inicio, fecha de terminación, hora de finalización o estado y luego haga clic en Aplicar filtros.
Depurar un webhook
Si un webhook no funciona correctamente, se podrán ver las invocaciones fallidas en el registro de actividades del webhook. El registro de actividades se puede filtrar por el estado que indica que Falló, o bien por un tipo de error en particular. En la pestaña Actividad también puede hacer clic en la ID de invocación para ver la solicitud y la respuesta de una invocación dada del webhook.
En la mayoría de los casos, la respuesta viene del servicio de terceros que recibe la solicitud del webhook, no de Zendesk mismo. Normalmente, es necesario trabajar con este servicio para corregir errores.
Se puede usar el código numérico en el estado de la respuesta para diagnosticar problemas. Estos códigos de estado de la respuesta son estándar en todas las solicitudes de HTTP. Si desea ver una lista de los códigos de estado de la respuesta de HTTP estándar y sus significados, consulte HTTP response status codes en los documentos web de MDN.
Las solicitudes de webhook tienen un tiempo de espera de 10 segundos. Un estado de respuesta "Failed: 504 Gateway Timeout" indica que un servicio no respondió a la solicitud de un webhook dentro del tiempo de espera establecido. El periodo de tiempo de espera no se puede ajustar.