Administración de webhooks

Acceso rápido: Centro de administración > Aplicaciones e integraciones > Webhooks > Webhooks

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.

En este artículo se tratan los siguientes temas:

• Editar y administrar webhooks
• Ver la actividad de un webhook (beta)
• Depurar un webhook

Para acceder a webhooks en el Centro de administración

• En el Centro de administración, haga clic en Aplicaciones e integraciones en la barra lateral y luego seleccione Webhooks > Webhooks.

  En la página Webhooks, puede abrir una vista detallada de cada webhook.

  

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.

Editar un webhook

1. En el Centro de administración, haga clic en Aplicaciones e integraciones en la barra lateral y luego seleccione Webhooks > Webhooks.
2. 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.
3. Use la pestaña Detalles para modificar el webhook según sea necesario.
4. (Opcional) Pruebe los cambios que haya hecho al webhook.
5. Haga clic en Guardar.

Clonar un webhook

1. En el Centro de administración, haga clic en Aplicaciones e integraciones en la barra lateral y luego seleccione Webhooks > Webhooks.
2. 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.
3. Edita el Nombre del webhook y modifique el webhook según se necesite.
4. Haga clic en Actualizar.

Desactivar un webhook

1. En el Centro de administración, haga clic en Aplicaciones e integraciones en la barra lateral y luego seleccione Webhooks > Webhooks.
2. 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.
3. En el cuadro de diálogo de confirmación, haga clic en Desactivar.

Borrar un webhook

1. En el Centro de administración, haga clic en Aplicaciones e integraciones en la barra lateral y luego seleccione Webhooks > Webhooks.
2. 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.
3. Haga clic en Borrar.

Ver la actividad de un webhook (beta)

Sugerencia: El registro de actividades de los webhooks se encuentra en fase beta abierta. Tenga en cuenta que si su cuenta se mueve a un pod distinto (por el motivo que sea), se borran todos los registros de actividades de los webhooks de los siete días anteriores.

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. Tenga en cuenta que la invocación de un webhook se vuelve a probar tres veces automáticamente antes de registrar una falla.

1. En el Centro de administración, haga clic en Aplicaciones e integraciones en la barra lateral y luego seleccione Webhooks > Webhooks.
2. 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.
3. Haga clic en la pestaña Actividad.
4. 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 todo 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.

Nota: Si un servicio usa códigos de estado de la respuesta de HTTP personalizados, es posible que tenga que consultar ese servicio.

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.