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
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
- Na Central de administração, clique no ícone Aplicativos e integrações (
) na barra lateral e selecione Alvos > Alvos.
- Localize o alvo na lista e clique em Editar.
- Atualize o valor da URL para usar https.
- 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
- Na Central de administração, clique no ícone Aplicativos e integrações (
) na barra lateral e selecione Alvos > Alvos.
- 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
- Na Central de administração, clique no ícone Aplicativos e integrações (
) na barra lateral e selecione Webhooks > Webhooks.
- Clique em Começar agora.
Se você tiver alvos qualificados para conversão, será guiado pelo processo.
- Clique em Gerenciar alvos para garantir que seus gatilhos estejam preparados para a conversão e clique em Avançar.
- Revise o resumo dos alvos qualificados e clique em Converter alvos.
- 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.
- 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
- 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.
- 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
- Na Central de administração, clique no ícone Aplicativos e integrações (
) na barra lateral e selecione Webhooks > Webhooks.
- Clique em Ações na parte superior da página e em Visualizar registro de conversão de alvos.
- Clique na aba Falha ao converter e encontre o alvo que deseja tentar converter novamente.
- Resolva o erro descrito para o alvo.
- 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
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
Como reverter um webhook em alvo
- Na Central de administração, clique no ícone Aplicativos e integrações (
) na barra lateral e selecione Webhooks > Webhooks.
- Clique em Ações na parte superior da página e em Visualizar registro de conversão de alvos.
- Clique na aba Convertido e encontre aquele que deseja reverter para alvo.
- 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.
4 Comentários
Não há opção de Alvos em "Aplicativos e integrações".
Os alvos estão localizados em Conta > Extensões.
A função esta sendo implementada em fases. Pelo descrito, sua conta não foi atualizada ainda. Não se preocupe, pois até fevereiro a nova interface deve ser implementada em todas as contas.
Espero que isso ajude! Qualquer dúvida por favor entre em contato!
Alvos do tipo Destino de URL continuarão funcionando após a data de corte?
Como você pode ver nesse anúncio: Anúncio de remoção dos alvos HTTP e conversão para webhooks, apenas os Alvos HTTP serão afetados. Sendo assim, Alvos da URL, continuarão funcionando.
Espero ter lhe ajudado.
Afabio
Por favor, entre para comentar.