Conversão de alvos HTTP em webhooks

Dica: os alvos HTTP serão removidos em fevereiro de 2022. Se precisar de ajuda na conversão de seus alvos HTTP existentes, entre em contato com o Suporte ao cliente Zendesk.

Caminho rápido: Central de administração > Aplicativos e integrações > Webhooks > Webhooks

Os alvos HTTP no Zendesk Support estão sendo substituídos por webhooks, que são criados e gerenciados na Central de administração do Zendesk. Há um processo de conversão simples na Central de administração que você pode usar para converter os alvos HTTP em webhooks.

Este artigo abrange as seções a seguir:

• Sobre a conversão de alvos em webhooks
• Preparação de alvos HTTP para conversão
• Conversão de alvos HTTP em webhooks na Central de administração
• Visualização do registro de conversão
• Nova tentativa de conversão
• Reversão de um webhook convertido para um alvo

Sobre a conversão de alvos em webhooks

É importante fazer as considerações a seguir sobre a conversão de seus alvos.

• A ferramenta de conversão converte apenas alvos HTTP.
• Os alvos precisam estar ativos para poderem ser convertidos. Os alvos desativados não podem ser convertidos.
• Os webhooks não oferecem suporte para autenticação HTTP. Todos os alvos que usam autenticação precisam ser atualizados para usar HTTPS antes de você poder convertê-los.
• Todos os alvos qualificados serão convertidos. Você não pode converter um alvo por vez.
• Os alvos permanecerão ativos até que todos sejam convertidos com sucesso ou sejam descontinuados.
• Se uma parte da conversão falhar, tudo que estiver relacionado aos alvos que falharam será revertido. É importante ressaltar que as conversões malsucedidas não afetam as configurações existentes de gatilhos e regras de negócios.
• A conversão é totalmente reversível até os alvos HTTP serem descontinuados. Se desejar, você pode reverter um alvo convertido.

Preparação de alvos HTTP para conversão

Há duas situações nas quais os alvos não podem ser convertidos:

• Os alvos usam HTTP em vez de HTTPS e têm a autenticação básica ativada 
• Os alvos estão inativos

Na maioria dos casos, há maneiras simples de modificar os alvos para que eles sejam incluídos na conversão.

Alteração de HTTP para HTTPS

Observação: verifique se o servidor que o webhook contatou tem suporte para HTTPS antes de você alterar os alvos para HTTPS ou convertê-los para webhooks. Se você converter seus alvos para HTTPS ou webhooks e o servidor não tiver suporte para HTTPS, as solicitações futuras falharão.

Durante o processo de conversão, você pode optar por converter alvos não seguros em webhooks seguros (HTTPS) ou ignorá-los. Se você escolher converter os alvos não seguros, nenhuma ação é necessária para resolver isso com antecedência.

Se você deseja converter apenas alguns de seus alvos HTTP que usam HTTP, pode atualizar manualmente as URLs apenas para esses alvos e selecionar Não converter alvos não seguros durante o processo de conversão.

Como alterar uma URL alvo de HTTP para HTTPS

1. Na Central de administração, clique no ícone Aplicativos e integrações () na barra lateral e selecione Alvos > Alvos.
2. Localize o alvo na lista e clique em Editar.
3. Atualize o valor da URL para usar https.
4. Na lista suspensa, selecione Atualizar alvo e clique em Enviar.

Verificação se os alvos estão ativos

Apenas os alvos HTTP ativos estão qualificados para conversão.

Como ativar um alvo

1. Na Central de administração, clique no ícone Aplicativos e integrações () na barra lateral e selecione Alvos > Alvos.
2. Encontre o alvo que você deseja reativar na lista Alvos inativos e clique em ativar.

Conversão de alvos HTTP em webhooks na Central de administração

O processo de conversão começa clonando todos os alvos existentes. As regras de negócios são então modificadas para usar webhooks em vez de alvos. A etapa final é desativar os alvos e ativar os webhooks.

Se a conversão for bem-sucedida, os alvos HTTP serão desativados, os webhooks serão ativados e as regras de negócios serão atualizadas quase simultaneamente.

Se a conversão de um alvo falhar, esse alvo e os gatilhos correspondentes permanecerão ativos e inalterados.

Como converter alvos HTTP em webhooks

1. Na Central de administração, clique no ícone Aplicativos e integrações () na barra lateral e selecione Webhooks > Webhooks.
2. Clique em Começar agora.

   Se você tiver alvos qualificados para conversão, será guiado pelo processo.

3. Clique em Gerenciar alvos para garantir que seus gatilhos estejam preparados para a conversão e clique em Avançar.
4. Revise o resumo dos alvos qualificados e clique em Converter alvos.
5. Se alvos (HTTP) não seguros forem detectados, você pode optar por Converter alvos não seguros em webhooks seguros (HTTPS) ou Não converter alvos não seguros.
   Observação: a conversão de alvos não seguros para proteger webhooks pode quebrar seus fluxos de trabalho se o seu servidor não oferecer suporte para HTTPS.
6. Clique em Visualizar registro de conversão de alvos para ver quais alvos foram convertidos com êxito ou não.

Alvos ignorados durante a conversão

Antes da conversão de alvos, você verá aqueles que serão ignorados. Isso significa que nada precisa ser feito quanto a eles como parte do processo de conversão. Os motivos que fazem com que um alvo seja ignorado durante a conversão incluem:

• Os alvos criados a partir de integrações, como o Salesforce.

Visualização do registro de conversão

No final do processo de conversão, é exibida uma janela perguntando se você deseja visualizar o registro de conversão. Você também pode acessar a página de Webhooks quando desejar. Para visualizar o registro de conversão, clique em Ações no topo da página e em Visualizar registro de conversão de alvos.

O registro de conversão tem três abas: falha ao converter, convertido e em conversão. Cada aba inclui o número de webhooks em cada status e um menu de ações disponíveis para cada alvo nesse status.

• A aba Em conversão fica preenchida apenas durante o processo de conversão. Na maior parte do tempo ela fica vazia.
• A aba Convertido mostra um registro de todos os webhooks que foram convertidos com êxito. Nessa aba é possível visualizar um webhook detalhadamente, reverter o webhook para alvo e encontrar a ID de conversão de um webhook específico.
• A aba Falha ao converter mostra um registro de todo alvo qualificado que não foi convertido com sucesso. Use essa aba para obter detalhes sobre o motivo da falha na conversão e tentar converter cada alvo novamente.

Nova tentativa de conversão

No registro de conversão, é possível ver quais alvos falharam na conversão e tentar converter novamente.

Como tentar converter um alvo novamente

1. Na Central de administração, clique no ícone Aplicativos e integrações () na barra lateral e selecione Webhooks > Webhooks.
2. Clique em Ações na parte superior da página e em Visualizar registro de conversão de alvos.
3. Clique na aba Falha ao converter e encontre o alvo que deseja tentar converter novamente.
4. Resolva o erro descrito para o alvo.
5. Clique no ícone de opções () na linha do alvo e clique em Tentar conversão novamente.

   Enquanto a nova tentativa de conversão é executada, o alvo será exibido na aba Em conversão. Quando a tentativa de conversão for concluída, o alvo passará para a aba Convertido ou as informações sobre a falha na conversão do alvo serão exibidas na aba Falha ao converter e o alvo será movido para o topo da tabela.

Resolução de erros na conversão

Apresentamos a seguir os motivos mais comuns de erros nas conversões de alvos.

Falha	Motivo	Correção
Erro ao atualizar o gatilho	A atualização do gatilho que está chamando o webhook falhou. Isso normalmente acontece por causa de uma configuração de gatilho inválida, que não está relacionada à conversão.	Revise seus gatilhos para garantir que eles podem ser modificados e salvos e, em seguida, tente fazer a conversão novamente.
Erro ao atualizar o alvo	A atualização para desativar o alvo HTTP falhou. Isso normalmente acontece por causa de uma configuração de alvo inválida, como uma URL alvo inválida.	Revise seus alvos HTTP para garantir que eles podem ser modificados e salvos e, em seguida, tente fazer a conversão novamente.
Erro ao atualizar o webhook	O webhook não foi criado devido a problemas de validação.	Revise seus alvos HTTP para garantir que eles estão devidamente prontos para serem convertidos e tente fazer a conversão novamente.

Reversão de um webhook convertido para um alvo

Até que todos os alvos HTTP sejam descontinuados, eles ainda poderão ser convertidos de webhooks para alvos em caso de problemas.

Observação: os novos webhooks criados na Central de administração não poderão ser convertidos em alvos HTTP. Isso se aplica apenas a alvos que foram convertidos em webhooks.

Como reverter um webhook em alvo

1. Na Central de administração, clique no ícone Aplicativos e integrações () na barra lateral e selecione Webhooks > Webhooks.
2. Clique em Ações na parte superior da página e em Visualizar registro de conversão de alvos.
3. Clique na aba Convertido e encontre aquele que deseja reverter para alvo.
4. Clique no ícone do menu de ação () e clique em Reverter para alvo.

   Após o webhook ser revertido para alvo com sucesso, ele será removido da lista na aba Convertido.