Criação de webhooks usando o destino HTTP

É possível criar um webhook ao combinar um gatilho ou uma automação com um destino HTTP no Zendesk Support. Quando se trata de desenvolvimento web, um webhook envia uma solicitação HTTP para uma URL específica em resposta a um evento que, nesse caso, é quando um gatilho ou automação é disparado no Zendesk Support. Os desenvolvedores da web normalmente usam webhooks para invocar um comportamento em outro sistema.

Você pode usar webhooks para criar integrações com os serviços ou com seu sistema back-end. Exemplos:

• Alertar sua equipe no Slack quando um ticket urgente for criado
• Encaminhar detalhes do ticket para sua equipe de documentação no Asana depois que um ticket for resolvido
• Notificar seu próprio serviço back-end com relação a um evento de ticket importante

O destino HTTP permite que você passe informações para serviços de terceiros e REST APIs que aceitem conteúdo JSON, XML ou formulário codificado nas solicitações HTTP. Os destinos HTTP são usados por automações e gatilhos no Zendesk Support quando um ticket atende a certas condições. Para saber mais sobre destinos, consulte Notificação de alvos externos.

Observação: os gatilhos e as ações de automação podem enviar solicitações para serviços de terceiros, mas não podem executar uma ação com base nas respostas HTTP.

Os destinos HTTP são diferentes dos alvos da URL. Os alvos da URL oferecem suporte somente ao envio de informações em parâmetros de URL, como www.example.com?order=345. Os destinos HTTP oferecem suporte ao envio de informações no corpo de solicitações POST ou PUT, um requisito para muitos serviços de terceiros e APIs abertas. Este é um exemplo de JSON:

Você pode usar qualquer um dos placeholders disponíveis do conteúdo para inserir dados de ticket no conteúdo.

Para obter mais informações, consulte a Referência de placeholders do Zendesk Support.

Criação de webhooks

1. No Zendesk Support, clique no ícone Admin. () na barra lateral esquerda e selecione Configurações > Extensões.
2. Clique na aba Alvos e clique em Adicionar alvo.
3. Selecione Destino HTTP.
4. Configure o alvo para integração com o serviço de terceiros.

   

5. Salve o alvo.
6. Use o alvo em um gatilho ou automação. Consulte Uso de alvos em automações e gatilhos.

Depuração de problemas de webhooks

Se o webhook não está funcionado adequadamente, use a aba Falhas de alvo no painel da API para verificar os problemas com a solicitação.

1. No Zendesk Support, clique no ícone Admin. () na barra lateral esquerda e selecione Canais > API.
2. Selecione a aba Falhas de alvo.

Para obter mais informações, consulte Uso do painel da API.

Exemplos

Os artigos a seguir dão exemplos da criação de integrações usando webhooks.

• Integrating with Slack, de Steven Yan
• Hipchat Integration with Hipchat v2 API, de Skip Moore
• Integrating the HTTP Target with Trello, de Steven Yan