Notificações por Webhook
Por padrão, a plataforma envia alertas diretamente para o e-mail dos adm e super adm da empresa assim que a conta atingir 80%, 90%, 100% e 150% do limite contratado.
Se a sua equipe deseja ir além do e-mail e precisa que o próprio sistema tome ações automáticas, você pode utilizar um Webhook, ele permite conectar o consumo de recursos diretamente a painéis de controle e gráficos internos da sua empresa, ajudando a prever com antecedência quando será necessário fazer um upgrade de plano
O que é um Webhook?
Pense no Webhook como um "recado automático" enviado de um sistema para o outro. Em vez de enviar uma mensagem legível para humanos (como o e-mail), ele envia dados para um sistema à sua escolha assim que o limite é atingido.
Como Configurar o Webhook de Limite de Uso
A configuração do Webhook é feita através de um comando simples no ambiente da plataforma:
Reúna as Informações Necessárias: Pré-requisitos. Obtenha seu Personal Access Token, o ID da sua Organização e a URL de Destino (Endpoint) do sistema que receberá a notificação.
Acesse o GraphQL Playground: Ambiente de requisições. Abra a ferramenta de execução de chamadas da API e insira a autorização no cabeçalho (HTTP Headers):
"Authorization": "Bearer SEU_TOKEN_AQUI"
Cole o comando abaixo no painel de requisições, substituindo 123456 pelo ID da sua conta e inserindo a sua URL:
GraphQL
mutation {
createOrganizationWebhook(input: {
actions: ["usage.threshold_reached"],
name: "Alerta de Limite de Uso",
organization_id: 123456,
url: "https://seu-endpoint.com/notificacoes"
}) {
webhook {
id
actions
url
}
}
}
Estrutura do Dado Recebido no Webhook
JSON
{
"data": {
"action": "usage.threshold_reached",
"resource": "automation",
"threshold": 80,
"usage": {
"consumed": 1850,
"limit": 2000,
"percentage": 92.5
},
"period": {
"resets_at": "2026-10-01"
}
}
}
resource: O recurso que atingiu o limite.
threshold: A porcentagem de consumo atingida (80, 90, 100 ou 150).
consumed e limit: O volume consumido e o limite total contratado.
resets_at: Data de renovação do ciclo mensal em UTC.
Importante: Cadastro Retroativo no Mês Vigente
Se a sua empresa atingir um limite (por exemplo, 80%) e somente depois você cadastrar o Webhook no mesmo mês, não se preocupe:
Envio Retroativo: O sistema identifica automaticamente que a conta já passou daquele marco e dispara a notificação do Webhook imediatamente após o cadastro.
Apenas no primeiro ciclo: Isso acontece apenas para garantir que seu sistema não perca o status atual do mês. Nos meses seguintes, as notificações voltarão a ser enviadas no exato instante em que cada limite for atingido.
Documentação Técnica Avançada
Para mais detalhes sobre como atualizar, listar ou deletar webhooks de organização, além de outros eventos disponíveis, acesse a Documentação Técnica de Organization Webhooks.
Notificações por E-mail (Opção padrão)
O que cada aviso mostra: o recurso em questão, quanto já foi consumido, qual é o limite do ciclo e quando ele é reiniciado.
O que fazer ao receber? O e-mail serve como um aviso preventivo para que você possa gerenciar seus fluxos, pausar automações desnecessárias ou solicitar um upgrade de plano.
Como desabilitar as notificações por e-mail
Se você preferir não receber esses alertas no seu e-mail (por exemplo, se já configurou um webhook), é possível desativá-los a qualquer momento:
Acesse a Página de Notificações de Usuário.
Procure pela seção/item Usage Limits (Limites de Uso).
Desmarque a caixa (flag) referente ao add-on ou recurso do qual você não deseja mais receber notificações por e-mail.
Clique em Salvar para confirmar as alterações.
