> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQs sobre Webhooks

> Obtenha respostas para as perguntas mais comuns sobre webhooks, incluindo gerenciamento, suporte de rede, tentativas e solução de problemas

## Créditos e Limites de Taxa

<Accordion title="Quantos endereços posso inserir para 1 webhook?">
  Até 100.000 endereços usando a [API](/docs/pt-BR/api-reference/webhooks/create-webhook).
</Accordion>

<Accordion title="Serei cobrado em créditos se eu alterar a URL do webhook no painel da Helius após criar o webhook?">
  Sim, editar um webhook via API ou painel custa 100 créditos por requisição. Isso se aplica a qualquer modificação, incluindo mudanças de URL, adição/remoção de endereços ou atualização de tipos de transações.
</Accordion>

<Accordion title="Quantos créditos custa para receber uma notificação de webhook?">
  Cada evento de webhook custa 1 crédito quando a Helius processa e envia o evento para o seu endpoint. Você é cobrado, independentemente de o seu endpoint processar o webhook com sucesso ou retornar um erro.
</Accordion>

<Accordion title="Quanto custa criar, editar e excluir webhooks?">
  Todas as operações de gerenciamento de webhook (criar, editar, excluir) custam 100 créditos por requisição quando realizadas via API. Isso cobre o processamento necessário para atualizar suas configurações de webhook.
</Accordion>

## Redes Suportadas

<Accordion title="Os webhooks estão disponíveis no Solana Devnet?">
  Sim. Se você criar um webhook através da interface, escolha “devnet” como “Network”. Se criar através da Webhook API, defina o parâmetro “webhookType” como "rawDevnet", "enhancedDevnet" ou "discordDevnet", dependendo do tipo de webhook desejado.
</Accordion>

<Accordion title="Posso inserir 'localhost' para minha URL de webhook?">
  Não — a URL deve ser publicamente acessível via HTTPS. A Helius não pode acessar servidores de desenvolvimento local por URLs localhost.
</Accordion>

## Usando Webhooks

<Accordion title="Como posso verificar se o webhook veio da Helius?">
  Defina um cabeçalho de autorização ao criar ou atualizar o webhook. A Helius ecoa esse valor no cabeçalho `Authorization` ao enviar dados para seu endpoint de webhook, permitindo que você verifique a autenticidade da solicitação.
</Accordion>

<Accordion title="Qual é a diferença entre 'raw' e 'enhanced' webhooks?">
  **Raw webhooks** retornam dados regulares de transação Solana diretamente da blockchain. Quando ocorre uma transação para os endereços monitorados, os dados da transação bruta são enviados para a sua URL de webhook.

  **Enhanced webhooks** fornecem tipos de transações interpretados pela Helius. Nós analisamos mais de 100 tipos de transações Solana (listas de NFT, trocas DeFi, transferências, etc.) e as abstraímos em nosso próprio esquema.

  Use raw webhooks se você quiser todos os dados de transação sem abstrações, ou enhanced webhooks se quiser detecção e análise de tipo de transação integrada.
</Accordion>

<Accordion title="Quando o Webhook envia uma notificação?">
  Os webhooks enviam notificações imediatamente após uma transação correspondente ser confirmada na blockchain.
</Accordion>

## Tentativas

<Accordion title="Como meu endpoint deve reconhecer um evento de webhook?">
  Seu endpoint deve retornar um código de status `200` em **1 segundo** para reconhecer o recebimento bem-sucedido. Como melhor prática, responda com `200` imediatamente e lide com qualquer processamento de forma assíncrona — isso previne timeouts causados por lógica de negócios lenta.
</Accordion>

<Accordion title="Qual é a política de tentativas para webhooks?">
  A Helius tenta novamente a entrega quando seu endpoint retorna um erro `5xx`, um erro `4xx` (exceto `403`), tempos de espera ou falhas devido a um erro de conexão ou falha de DNS. Tentamos novamente até **3 vezes** com um **intervalo de 1 segundo** entre cada tentativa.

  Se todas as tentativas de reenvio falharem, o evento é **permanentemente perdido** — não há re-fila ou segundo ciclo de entrega.

  Monitore os seus registros de webhook no [Painel Helius](https://dashboard.helius.dev/webhooks) para identificar falhas de entrega e investigar problemas do endpoint.

  Também oferecemos políticas de tentativas personalizáveis para planos empresariais.
</Accordion>

<Accordion title="Um evento de webhook é entregue exatamente uma vez?">
  A Helius pode entregar o mesmo evento de webhook várias vezes. Isso pode acontecer devido à lógica de tentativas ou problemas de rede.

  Seu manipulador de webhooks deve estar preparado para lidar com duplicatas graciosamente — processar o mesmo evento várias vezes deve produzir o mesmo resultado que processá-lo uma vez.

  Para lidar com duplicatas, use a assinatura da transação ou um identificador único de evento para acompanhar quais eventos você já processou.
</Accordion>

<Accordion title="Os webhooks postam transações falhas?">
  Depende do tipo de webhook. Webhooks aprimorados não enviam transações falhas, mas webhooks brutos incluem tanto transações bem-sucedidas quanto falhas.
</Accordion>

## Desativação Automática

<Accordion title="Por que meu webhook foi desativado automaticamente?">
  A Helius monitora a saúde do endpoint e desativa automaticamente os webhooks com uma **taxa de falha de entrega ≥ 95%**. Planos pagos (Dev e acima) são avaliados em uma janela de 7 dias, enquanto webhooks do plano gratuito são avaliados em uma janela de 24 horas. Isso previne tentativas de entrega desperdiçadas contra endpoints inacessíveis.

  Causas comuns incluem uma URL de endpoint inacessível, seu servidor retornando respostas de erro consistentes ou problemas de rede/firewall bloqueando entregas da Helius.
</Accordion>

<Accordion title="Como faço para reativar um webhook desativado?">
  1. Corrija o problema subjacente com seu endpoint.
  2. Faça login no [Painel Helius](https://dashboard.helius.dev/webhooks).
  3. Encontre o webhook desativado e reative-o.

  Você também pode reativar webhooks programaticamente via [Ponto de extremidade da API Toggle Webhook](/docs/pt-BR/api-reference/webhooks/toggle-webhook) enviando uma requisição PATCH com `{ "active": true }`.
</Accordion>

<Accordion title="Meu webhook será desativado novamente imediatamente após eu reativá-lo?">
  Não. Após reativação, o webhook entra em um **período de carência de 24 horas** durante o qual não será desativado automaticamente. Isso lhe dá tempo para verificar se o seu endpoint está saudável antes da próxima avaliação.
</Accordion>

<Accordion title="Serei notificado quando um webhook for desativado automaticamente?">
  Sim — usuários no **plano Dev e acima** recebem uma notificação por e-mail quando um webhook é desativado automaticamente. Usuários do plano gratuito podem monitorar o status do webhook no [Painel Helius](https://dashboard.helius.dev/webhooks).
</Accordion>

<Accordion title="Posso desativar um webhook sem excluí-lo?">
  Sim. Você pode alternar webhooks entre ativado e desativado no [Painel Helius](https://dashboard.helius.dev/webhooks) ou via [Ponto de extremidade da API Toggle Webhook](/docs/pt-BR/api-reference/webhooks/toggle-webhook). Isso permite pausar temporariamente as entregas sem perder sua configuração de webhook.
</Accordion>

## Solução de Problemas com Webhooks

<Accordion title="Por que meu webhook está perdendo dados?">
  A perda de dados geralmente ocorre quando seu endpoint encontra um erro, causando tentativas de reenvio de webhook que eventualmente falham e levam à perda de dados. Verifique seus registros de webhook no [painel](https://dashboard.helius.dev/webhooks), certifique-se de que haja um registro suficiente no lado do cliente e [entre em contato com o suporte](/docs/pt-BR/support/contact-support) se o problema persistir.
</Accordion>

<Accordion title="Por que meus webhooks não estão funcionando?">
  Certifique-se de que o tipo de transação selecionado corresponda às transações que você está monitorando. Comece com o tipo de transação "ANY" para identificar se é um problema geral ou incompatibilidade de tipo. Use [webhook.site](http://webhook.site/) para testar se o problema está na configuração do seu endpoint.
</Accordion>

<Accordion title="Por que meu webhook não me envia todas as transações de um certo tipo (como TOKEN_MINT)?">
  O webhook `TOKEN_MINT` apenas aciona para programas específicos como Candy Machine V1 e Solana Program Library. Ele não cobre todos os eventos de mintagem de token em toda a blockchain. Para monitoramento mais amplo, considere usar uma assinatura de conta ou programa mais geral via webhooks com filtro de tipo de transação "ANY".
</Accordion>

***

## Precisa de Mais Ajuda?

<CardGroup cols={2}>
  <Card title="Contatar Suporte" icon="headset" href="/docs/pt-BR/support/contact-support">
    Obtenha ajuda da nossa equipe através do Discord, chat ou suporte por e-mail.
  </Card>

  <Card title="Página de Status" icon="wave-pulse" href="/docs/pt-BR/support/status-page">
    Verifique a disponibilidade e informações de desempenho do serviço em tempo real.
  </Card>
</CardGroup>