Los webhooks secreany 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 unrol personalizadoque 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 elCentro de administración, haga clic enAplicaciones e integracionesen la barra lateral y luego seleccioneWebhooks > 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 enEditar.
- 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 laclave, eltokenni lacontraseñauna vez que se haya creado o actualizado el webhook. Para eliminar un encabezado personalizado, haga clic en el icono para borrar ().
- (Opcional)Pruebelos cambios que haya hecho al webhook.
- Haga clic enGuardar.
Para clonar un webhook
- En elCentro de administración, haga clic enAplicaciones e integracionesen la barra lateral y luego seleccioneWebhooks > 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 enClonar.
- Edita elNombredel webhook y modifique el webhook según se necesite.
- Haga clic enActualizar.
Para desactivar un webhook
- En elCentro de administración, haga clic enAplicaciones e integracionesen la barra lateral y luego seleccioneWebhooks > 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 enDesactivar.
- En el cuadro de diálogo de confirmación, haga clic enDesactivar.
Para borrar un webhook
- En elCentro de administración, haga clic enAplicaciones e integracionesen la barra lateral y luego seleccioneWebhooks > 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 enBorrar.
- Haga clic enBorrar.
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, consulteWebhook retry logicen 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 elinterruptor del webhook, las acciones podrían no ser entregadas. Para detectar las invocaciones duplicadas, podría utilizarfirmas 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 elCentro de administración, haga clic enAplicaciones e integracionesen la barra lateral y luego seleccioneWebhooks > 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 enVer detalles.
- Haga clic en la pestañaActividad.
- Haga clic enFiltrar帕拉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 enAplicar filtros.
Depurar un webhook
Si un webhook no funciona correctamente, se podrán ver las invocaciones fallidas en elregistro de actividades del webhook. El registro de actividades se puede filtrar por el estado que indica queFalló, 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, consulteHTTP response status codesen 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.
0 Comentarios
Inicie sesiónpara dejar un comentario.