> For the complete documentation index, see [llms.txt](https://developers.bluefleet.com.br/home/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.bluefleet.com.br/home/webhooks/informacoes-gerais.md).

# Informações gerais

Webhooks permitem criar integrações que comunicam eventos ocorridos na plataforma da Blue Fleet. Quando um evento ocorre, a Blue Fleet notifica a sua aplicação ativamente, através de uma requisição `HTTP POST` para a URL previamente cadastrada.

Um evento pode ser o cadastro de um cliente, o lançamento de uma nota fiscal, a alteração de um fornecedor e etc.

### Cadastro de Webhooks <a href="#cadastro-de-webhooks" id="cadastro-de-webhooks"></a>

Para realizar o cadastro da URL para recebimento das notificações, envie e-mail para <suporte@bluefleet.com.br> com a URL desejada.

### Retorno esperado <a href="#retorno-esperado" id="retorno-esperado"></a>

A cada requisição, a Blue Fleet espera um retorno `HTTP 200`.

Caso o retorno não seja `HTTP 200` ou não ocorra em até 30 segundos, a conexão será terminada e a requisição considerada como erro.

<br>