Anteriormente, os alvos eram usados para passar informações para aplicativos e serviços externos baseados em nuvem para notificá-los sobre alterações no Zendesk. Este artigo descreve como converter a maioria dos alvos URL existentes que você tiver em webhook.
Sobre a conversão de alvos em webhooks
- Criar um novo webhook com base no alvo.
- Configurar um gatilho para enviar notificações para o webhook.
- Verificar se o novo webhook e gatilho estão funcionando conforme o esperado e, em seguida, desativar o alvo e quaisquer gatilhos associados a ele.
Conversão de alvos da Clickatell, Pivotal, Twilio, X Corp e Yammer
Não há uma maneira direta de mapear configurações de alvos da Clickatell, Pivotal, Twilio, X Corp (anteriormente Twitter) e Yammer para webhooks. Recomendamos procurar por aplicativos no Marketplace da Zendesk que atendam às suas necessidades.
Criação de um novo webhook com base no alvo
Para converter os alvos em webhook, é bom ter os detalhes do alvo abertos em uma janela e o webhook aberto em outra.
Como criar um novo webhook com base em um alvo URL
- Em uma janela do navegador, abra o alvo URL.
- Na Central de administração, clique em Aplicativos e integrações na barra lateral e selecione Alvos > Alvos.
- Encontre o alvo que você deseja converter em um webhook e clique em Editar.
- Em outra janela do navegador, abra a página Webhooks.
- Na Central de administração, clique em Aplicativos e integrações na barra lateral e selecione Ações e webhooks > Webhooks.
- Clique em Criar webhook.
- Selecione Gatilho ou automação como o modo de conexão e clique em Avançar.
- Mapeie os valores do alvo para os campos do webhook. Para obter instruções de mapeamento detalhadas, consulte:
- Clique em Criar webhook.
Mapeamento de configurações de alvo do Basecamp para webhooks
- Título: O Nome do webhook.
- URL: a URL do ponto de extremidade do webhook.
- Para a autenticação do webhook, escolha um dos seguintes métodos:
- Nome de usuário e Senha: defina a Autenticação do webhook como Autenticação básica e insira o nome de usuário e a senha do Basecamp. Não é possível copiar e colar a senha.
- Token da API: defina a Autenticação do webhook como Chave da API e insira o token da API do alvo do Campfire.
- ID do projeto: acrescente /projects/[ID] ao final da URL do ponto de extremidade do webhook. Por exemplo: https://corp.basecamphq.com/projects/2612430.
-
Recursos: acrescente ao final da URL do ponto de extremidade do webhook, após o ID do projeto.
-
Mensagem: acrescente /posts/[ID]/comments. Por exemplo:
https://corp.basecamphq.com/projects/2612430/posts/25611692/comments
- Pendências: acrescente /todo_lists/[ID]. Por exemplo: https://corp.basecamphq.com/projects/2612430/todo_lists/25611692.
-
Mensagem: acrescente /posts/[ID]/comments. Por exemplo:
Mapeamento de configurações de alvo do Campfire para webhooks
- Título: o Nome do webhook.
- Subdomínio: a URL do ponto de extremidade do webhook.
- Token da API: defina a Autenticação do webhook como Chave da API e insira o token da API do alvo do Campfire.
- Sala: acrescente essa informação à URL do ponto de extremidade do webhook.
- SSL: não se aplica ao criar um webhook.
- Preservar formato: não se aplica ao criar o webhook.
Mapeamento de configurações de alvo do Get Satisfaction para webhooks
- Título: o Nome do webhook.
-
Nome da empresa: incorpore à URL do ponto de extremidade do webhook. Por exemplo:
https://getsatisfaction.com/yourcompany/
- E-mail e Senha: defina a Autenticação do webhook como Autenticação básica e insira o nome de usuário e a senha do Get Satisfaction. Não é possível copiar e colar a senha.
Mapeamento de configurações de alvo do Jira para webhooks
- Título: O Nome do webhook.
- URL: a URL do ponto de extremidade do webhook.
- Nome de usuário e Senha: defina a Autenticação do webhook como Autenticação básica e insira o nome de usuário e a senha do Jira. Não é possível copiar e colar a senha.
Mapeamento de configurações de alvo da URL para webhooks
- Título: O Nome do webhook.
- URL: a URL do ponto de extremidade do webhook.
- Método: O Método de solicitação do webhook.
- Nome do atributo: Não é obrigatório ao criar o webhook, mas será usado quando estiver configurando as ações de gatilhos.
- Autenticação básica: Defina a Autenticação do webhook como Autenticação básica e insira o nome de usuário e senha do alvo URL. Não é possível copiar e colar a senha.
- Além disso, é necessário definir o Formato da solicitação no webhook como Com codificação de formulário.
Configuração de um gatilho para enviar notificações para o webhook
Você já deve ter um gatilho configurado para enviar notificações com base no alvo. É possível editar ou clonar esse gatilho, mas você também pode criar um novo.
- Na Central de administração, clique em Objetos e regras na barra lateral e selecione Regras de negócios > Gatilhos.
-
Edite ou clone um gatilho existente.
Anote o valor de Mensagem para a ação Notificar por > Alvo. Você o usará de novo com a nova ação baseada em webhook.
- Em Ações, clique em Adicionar ação e selecione Notificar por > Webhook ativo.
- Selecione o webhook criado para substituir o alvo no menu de lista suspensa.
- Configure o webhook para enviar as informações de que você precisa.
Por exemplo, se estivesse substituindo um alvo da URL, em Parâmetros da URL, você faria o seguinte:
- Defina a chave como o Nome do atributo do alvo URL.
- Defina o valor como a Mensagem da ação Notificar por > Alvo.
- Clique em Salvar.
- Retorne ao webhook e teste a funcionalidade.
Desativação do alvo e dos gatilhos associados
Depois de criar o webhook e atualizar o gatilho associado, teste o webhook por completo, iniciando as condições de gatilho apropriadas. Enquanto o gatilho estiver configurado com duas ações Notificar por, uma para o alvo e outra para o webhook, você receberá mensagens duplicadas no aplicativo ou sistema externo.
Depois de confirmar que o webhook e o gatilho estão funcionando adequadamente, edite o gatilho para remover a ação Notificar por > Alvo e desative ou apague o alvo.