Como editar ou excluir um webhook

Um webhook envia eventos do meuats a uma URL de outra ferramenta. Sua edição permite mudar o destino ou os acontecimentos recebidos; a exclusão interrompe os novos envios para aquele cadastro e descarta entregas pendentes.

A interface atual oferece edição, renovação de chave e exclusão. Ela não apresenta uma ação individual de pausa ou desativação do webhook. Não trate renovar a chave como forma de desligar os envios.

Identifique o destino antes de editar

Abra Integrações > Webhooks e entre na configuração. Localize o cadastro pelo nome e use Editar para conferir a URL e os eventos selecionados.

Confirme com o responsável técnico que a URL pertence ao sistema que deve receber os dados. Trocar o destino pode direcionar informações comerciais para outro serviço, por isso não use um endereço de teste desconhecido.

Um nome claro ajuda a distinguir destinos, mas a URL é a informação efetiva de envio.

Editor de webhook existente
Revise destino e eventos antes de salvar alterações.

Revise os eventos selecionados

O formulário permite escolher eventos de negócio criado, atualizado, movido de etapa, ganho e perdido.

Selecione somente os acontecimentos necessários ao sistema de destino. Negócio atualizado cobre alterações de informações como nome, responsável, valor, interesse e campos; mudança de etapa tem uma opção própria.

É necessário informar uma URL e selecionar ao menos um evento para salvar. Não desmarque todos esperando transformar isso em uma pausa, pois essa não é a função do formulário.

Teste sem confundir com salvamento

A opção de teste envia uma solicitação para a URL informada sem salvar o webhook. A confirmação informa que o teste foi colocado na fila e orienta conferir a ferramenta de destino.

Isso não comprova que o sistema externo já recebeu ou processou o evento. O responsável pelo destino precisa verificar o resultado.

O teste também não confirma que as alterações do cadastro foram persistidas. Depois da revisão, use Salvar webhook e aguarde Webhook atualizado.

Renove a chave somente quando necessário

Renovar chave altera a chave de assinatura utilizada na integração. Essa ação deve ser coordenada com quem valida os recebimentos no sistema externo.

Quando a ferramenta apresenta a chave, guarde-a de forma segura. Não a publique em artigos, mensagens abertas ou capturas compartilhadas.

Renovar não é uma pausa. Se o destino continuar validando com uma chave antiga, pode rejeitar entregas, mesmo que o webhook permaneça cadastrado.

Exclua com atenção às entregas pendentes

Use Excluir no cadastro correto. A confirmação Excluir webhook informa que a URL deixará de receber novos eventos e que entregas já pendentes serão descartadas.

Confira o destino e confirme somente quando esse for o resultado desejado. Aguarde Webhook excluído e verifique a lista.

A exclusão não apaga informações já recebidas pela ferramenta externa. Também não deve ser usada como uma pausa reversível com promessa de retomar depois todas as entregas descartadas.

Quando a intenção for uma interrupção temporária

Como não há controle individual de desativação na interface atual, alinhe a necessidade com o responsável pela integração antes de excluir.

Não provoque falhas deliberadas trocando a URL ou a chave para simular uma pausa. Isso cria problemas de entrega e não oferece o mesmo comportamento de um recurso de suspensão.

Veja também

Para planejar a manutenção dos destinos, consulte: