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

# configurar webhook

> criar uma subscrição de webhook passo a passo

<Steps>
  <Step title="acesse configurações > integrações > webhooks">
    na plataforma, vá em **configurações > integrações > webhooks** e clique em **adicionar webhook**.
  </Step>

  <Step title="preencha os dados">
    | campo       | descrição                                                        |
    | ----------- | ---------------------------------------------------------------- |
    | **nome**    | nome descritivo (ex: "integração de pedidos")                    |
    | **status**  | ativo ou inativo (somente webhooks ativos disparam notificações) |
    | **URL**     | endpoint HTTPS onde receber as notificações                      |
    | **eventos** | quais eventos você quer monitorar                                |

    escolha apenas os eventos que você precisa — não é necessário selecionar tudo.
  </Step>

  <Step title="configure um signing secret (recomendado)">
    defina um secret para validar que as notificações vêm realmente da gente. veja como usar em [assinando requisições](./assinando-requisicoes).
  </Step>

  <Step title="salve">
    clique em **salvar** e o webhook começa a receber eventos imediatamente.
  </Step>
</Steps>

## testar localmente

use **ngrok**, **localtunnel** ou algum serviço semelhante para expor seu `localhost` e testar antes de ir a produção:

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

configure o webhook apontando para a `URL` gerada, simule eventos na plataforma e verifique os logs do seu servidor.