Como entender o limite de webhooks por empresa

O meuats permite cadastrar até cinco webhooks por empresa. Esse limite considera os cadastros de destino, não a quantidade de tipos de evento selecionados em cada um.

Um webhook pode receber mais de um tipo de evento. Portanto, você não precisa criar um cadastro separado para cada acontecimento quando todos devem chegar à mesma URL.

Confira a empresa e a lista completa

Abra Integrações > Webhooks na empresa que deseja configurar. Confira os destinos cadastrados antes de tentar adicionar outro.

O resumo de webhooks ativos não deve ser confundido com a contagem usada para adicionar novos cadastros. A capacidade é verificada sobre a lista de webhooks existentes.

Se você participa de várias empresas, cada uma tem seu contexto. Trocar a empresa ativa muda a configuração consultada; não é uma forma de ampliar os destinos da empresa original.

Organize eventos por destino

Cada cadastro permite selecionar negócio criado, atualizado, movido de etapa, ganho e perdido. Escolha os eventos que a URL realmente deve receber.

Quando um sistema externo precisa de vários desses acontecimentos, avalie configurar todos no mesmo webhook. Criar vários cadastros para a mesma URL pode consumir capacidade desnecessariamente e exige conferir possíveis recebimentos sobrepostos.

Não reúna destinos distintos em um único campo. O cadastro representa uma URL, e a organização precisa acompanhar a integração real.

Ao atingir cinco cadastros

A interface informa que o limite foi atingido e impede adicionar outro. Os webhooks existentes continuam disponíveis para consulta e manutenção conforme o acesso.

Antes de excluir, revise se algum cadastro pode ser atualizado para atender à necessidade atual. Se um sistema mudou de endereço, editar o webhook correspondente pode ser mais adequado que manter o endereço antigo e criar outro.

Essa decisão deve ser alinhada com quem administra o destino. Alterar URL ou eventos muda a comunicação da integração existente.

Entenda por que excluir exige cuidado

Excluir libera a retirada daquele cadastro, mas também interrompe novos envios e descarta entregas pendentes. Não apague um destino em uso apenas para abrir espaço sem avaliar a continuidade.

A interface atual não oferece uma ação individual de desativação. Portanto, não conte com uma pausa que retire o cadastro da contagem e permita recuperá-lo depois sem consequências.

Renovar a chave também não remove um cadastro nem altera o limite. Essa ação trata da assinatura dos envios, não da capacidade de destinos.

Não presuma uma ampliação automática por plano

O limite apresentado para essa configuração é de cinco webhooks. Não há, nesse procedimento, uma opção documentada para contratar mais destinos diretamente pela lista.

Se a operação precisa de uma arquitetura diferente, discuta com o responsável técnico e o suporte quais alternativas são adequadas. Não invente cadastros em outras empresas ou URLs intermediárias sem avaliar o tratamento dos dados.

Confira o resultado da reorganização

Depois de editar ou excluir um cadastro autorizado, confira a lista e os eventos selecionados. Caso faça um teste, lembre que ele é enfileirado sem salvar a configuração e precisa ser conferido no destino.

Registre nomes e finalidades dos webhooks mantidos para evitar que outra pessoa os remova por não reconhecer seu uso.

Veja também

Para executar a manutenção com o alcance correto, consulte: