Os webhooks são criados e gerenciados na Central de administração do Zendesk na página Webhooks.
Você precisa ser um administrador ou um agente em uma função personalizada com permissão para gerenciar webhooks.
Edição e gerenciamento de webhooks
Na maioria dos casos, os administradores podem editar, clonar, desativar e apagar webhooks. No entanto, os webhooks que são criados por requisitos do aplicativo podem ser editados, mas não podem ser clonados nem apagados. Os webhooks criados pelos requisitos do aplicativo podem ser atualizados pelo desenvolvedor e substituir as alterações feitas pelos administradores da conta. Após a criação do webhook, você não consegue alterar seu método de conexão.
Como editar um webhook
- Na Central de administração, clique em
Aplicativos e integrações na barra lateral e selecione Webhooks > Webhooks.
- Encontre o webhook na lista, clique no ícone de menu de opções (
) na linha do webhook e clique em Editar.
- Modifique o webhook conforme necessário.
Todos os campos são editáveis. No entanto, quando se usa autenticação, a chave, o token ou a senha não podem ser visualizados após o webhook é criado ou atualizado. Para remover um cabeçalho personalizado, clique no ícone (
).
- (Opcional) Teste as alterações que você fez no webhook.
- Clique em Salvar.
Como clonar um webhook
- Na Central de administração, clique em
Aplicativos e integrações na barra lateral e selecione Webhooks > Webhooks.
- Encontre o webhook na lista, clique no ícone de menu de opções (
) na linha do webhook e clique em Clonar.
- Edite o Nome do webhook e modifique-o conforme a necessidade.
- Clique em Atualizar.
Como desativar um webhook
- Na Central de administração, clique em
Aplicativos e integrações na barra lateral e selecione Webhooks > Webhooks.
- Encontre o webhook na lista, clique no ícone de menu de opções (
) na linha do webhook e clique em Desativar.
- Na tela de confirmação, clique em Desativar.
Como apagar um webhook
- Na Central de administração, clique em
Aplicativos e integrações na barra lateral e selecione Webhooks > Webhooks.
- Encontre o webhook na lista, clique no ícone de menu de opções (
) na linha do webhook e clique em Apagar.
- Clique em Apagar.
Visualização da atividade de um webhook (beta)
A invocação do webhook é tentada novamente automaticamente três vezes após a falha se o ponto de extremidade retornar alguns códigos de resposta HTTP. Para obter mais informações e exemplos sobre cenários de novas tentativas, consulte Gerenciamento de webhooks na documentação do desenvolvedor.
- Na Central de administração, clique em
Aplicativos e integrações na barra lateral e selecione Webhooks > Webhooks.
- Encontre o webhook na lista, clique no ícone de menu de opções (
) na linha do webhook e clique em Ver detalhes.
- Clique na aba Atividade.
- Clique em Filtrar para filtrar o registro de atividades por data de início, data de término, hora de início, hora de término ou status e, em seguida, clique em Aplicar filtros.
Depuração de problemas de webhooks
Se um webhook não estiver funcionando corretamente, as invocações malsucedidas serão exibidas no registro de atividades do webhook. É possível filtrar o registro de atividades pelo status Falha ou por um tipo específico de erro. Na aba de atividades, você também pode clicar na ID de invocação para visualizar a solicitação e a resposta de uma invocação específica do webhook.
Na maioria dos casos, a resposta vem do serviço de terceiros que recebe a solicitação do webhook, não do próprio Zendesk. Normalmente, você precisa trabalhar com esse serviço para corrigir erros.
Você pode usar o código numérico no status da resposta para diagnosticar problemas. Esses códigos de status da resposta são padrão em solicitações HTTP. Para obter uma lista dos códigos de status de resposta HTTP padrão e seu significado, consulte HTTP response status codes no MDN web docs.
As solicitações de webhook tem um tempo limite de dez segundos. Um status de resposta "Failed: 504 Gateway Timeout" mostra que um serviço não respondeu à solicitação de um webhook dentro desse prazo. O período de tempo limite não pode ser alterado.
0 Comentários
Por favor, entre para comentar.