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

# Configurar Webhooks

> Receba notificações de forma assíncrona quando eventos ocorrerem, em vez de precisar consultar atualizações constantemente

Nossa implementação de webhooks segue a especificação do [Standard Webhooks](https://www.standardwebhooks.com/) e nossos SDKs oferecem:

* Validação de assinatura de webhook integrada para segurança
* Cargas úteis de webhook totalmente tipadas

Além disso, nossos webhooks oferecem suporte nativo para formatação em Slack,
tornando muito fácil configurar notificações em chat para sua equipe.

## Primeiros Passos

<Info>
  **Use nosso ambiente sandbox durante o desenvolvimento**

  Assim você pode testar facilmente compras, assinaturas, cancelamentos e reembolsos
  para acionar eventos de webhook automaticamente — sem gastar um centavo.
</Info>

<Steps>
  <Step title="Adicionar novo endpoint">
    Vá até as configurações da sua organização e clique no botão Adicionar Endpoint para criar um novo webhook.

    <img className="block dark:hidden" src="https://mintcdn.com/norbaas/5OPQggdmVnQLu7D4/assets/integrate/webhooks/create.light.png?fit=max&auto=format&n=5OPQggdmVnQLu7D4&q=85&s=31c04fcba76a646889ba7a7df36a353a" width="1532" height="389" data-path="assets/integrate/webhooks/create.light.png" />

    <img className="hidden dark:block" src="https://mintcdn.com/norbaas/5OPQggdmVnQLu7D4/assets/integrate/webhooks/create.dark.png?fit=max&auto=format&n=5OPQggdmVnQLu7D4&q=85&s=c69638ce1f0f6ac30a5016bff53b95a1" width="1494" height="388" data-path="assets/integrate/webhooks/create.dark.png" />
  </Step>

  <Step title="Especifique a URL do seu endpoint">
    Insira a URL para a qual os eventos de webhook devem ser enviados.

    <img className="block dark:hidden" src="https://mintcdn.com/norbaas/5OPQggdmVnQLu7D4/assets/integrate/webhooks/url.light.png?fit=max&auto=format&n=5OPQggdmVnQLu7D4&q=85&s=56dd372ca03b37707db932fb10cdf6bf" width="1075" height="402" data-path="assets/integrate/webhooks/url.light.png" />

    <img className="hidden dark:block" src="https://mintcdn.com/norbaas/5OPQggdmVnQLu7D4/assets/integrate/webhooks/url.dark.png?fit=max&auto=format&n=5OPQggdmVnQLu7D4&q=85&s=0849f4d61e587bddda27170b1f836455" width="1068" height="398" data-path="assets/integrate/webhooks/url.dark.png" />

    <Tip>
      **Desenvolvendo localmente?**

      Use uma ferramenta como o [ngrok](https://ngrok.com/) para criar um túnel que encaminha eventos de webhook para o seu ambiente de desenvolvimento local. Isso permitirá que você teste seus manipuladores de webhook sem precisar implantá-los em um servidor em produção.

      Depois de instalar o `ngrok`, você pode iniciar um túnel facilmente:

      ```bash theme={null}
      ngrok http 3000
      ```

      Certifique-se apenas de fornecer a URL gerada pelo ngrok como o endpoint de webhook na Norbaas.
    </Tip>
  </Step>

  <Step title="Escolha um formato de entrega">
    Para integrações padrão ou personalizadas, mantenha este parâmetro como Bruto (Raw). Isso enviará a carga útil no formato JSON.

    Se você deseja enviar notificações para um canal do Discord ou Slack, pode selecionar o formato correspondente aqui. O Norbaas irá adaptar a carga útil para que mensagens devidamente formatadas sejam enviadas ao seu canal.

    <img className="block dark:hidden" src="https://mintcdn.com/norbaas/5OPQggdmVnQLu7D4/assets/integrate/webhooks/format.light.png?fit=max&auto=format&n=5OPQggdmVnQLu7D4&q=85&s=1e85014ee4edce50099eede82aac21c6" width="1034" height="402" data-path="assets/integrate/webhooks/format.light.png" />

    <img className="hidden dark:block" src="https://mintcdn.com/norbaas/5OPQggdmVnQLu7D4/assets/integrate/webhooks/format.dark.png?fit=max&auto=format&n=5OPQggdmVnQLu7D4&q=85&s=35a7aa0fbe9a770a1f22d632ae51960e" width="1050" height="418" data-path="assets/integrate/webhooks/format.dark.png" />

    Se você colar uma URL de Webhook do Slack, o formato será selecionado automaticamente.
  </Step>

  <Step title="Defina um segredo">
    Nós assinamos criptograficamente as requisições usando esse segredo. Assim, você pode verificá-las facilmente com nossos SDKs para garantir que são cargas úteis legítimas de webhook enviadas pelo Norbaas.

    Você pode definir o seu próprio segredo ou gerar um aleatoriamente.

    <img className="block dark:hidden" src="https://mintcdn.com/norbaas/5OPQggdmVnQLu7D4/assets/integrate/webhooks/secret.light.png?fit=max&auto=format&n=5OPQggdmVnQLu7D4&q=85&s=d7769db4af0120c60d59028c9c7a093e" width="1074" height="331" data-path="assets/integrate/webhooks/secret.light.png" />

    <img className="hidden dark:block" src="https://mintcdn.com/norbaas/5OPQggdmVnQLu7D4/assets/integrate/webhooks/secret.dark.png?fit=max&auto=format&n=5OPQggdmVnQLu7D4&q=85&s=fa4f42cd6ba3a9c159fbfcc54e58fc99" width="1072" height="332" data-path="assets/integrate/webhooks/secret.dark.png" />
  </Step>

  <Step title="Inscreva-se em eventos">
    Por fim, selecione todos os eventos sobre os quais deseja ser notificado e pronto  🎉
  </Step>
</Steps>

[Agora é hora de integrar nosso endpoint para receber eventos
→](/integrate/webhooks/delivery)