> For the complete documentation index, see [llms.txt](https://ola.meajuda.cc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ola.meajuda.cc/extras/api-de-integracoes/notificacoes-e-eventos-webhook.md).

# Notificações e Eventos (Webhook)

Os webhooks, também conhecidos como HTTP Callbacks, são uma maneira eficaz de se registrar para receber informações em tempo real em uma URL específica de sua escolha. Eles atuam como pontes entre diferentes sistemas, permitindo que um sistema notifique outro sobre eventos específicos.

Quando ocorre uma alteração no estado de um recurso dentro da plataforma, como quando um novo pedido é recebido, um evento é gerado. Esse evento é então enviado para todos os webhooks que foram previamente cadastrados para receber tais notificações.

Esta funcionalidade está disponível no menu de **Integrações**. Logo abaixo, veja como utilizá-la.

<div data-with-frame="true"><figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FtaOiorBFN3F2kgtqPADI%2Fimage.png?alt=media&amp;token=1a1aa9c5-ccf7-431d-a866-3e2f34deffda" alt="" width="243"><figcaption><p>Integração Webhook na área de Integrações</p></figcaption></figure></div>

### Para começar a utilizar as notificações de eventos por webhooks, siga os passos abaixo:

1. **Implemente o seu sistema de recebimento de notificações.** Este será o local onde os eventos serão enviados.
2. **Cadastre as URLs do seu sistema na plataforma.** Assim, a plataforma saberá para onde enviar as notificações.

## Receber movimentações de estoque

Use o evento **Movimentação de estoque** para avisar seu sistema sempre que uma movimentação for registrada na loja, inclusive nas baixas geradas por vendas.

1. Prepare uma URL pública no seu sistema para receber as notificações.
2. No painel, acesse **Histórico de atividades → Webhooks**.
3. Cadastre ou edite a URL que receberá os eventos.
4. Em **Eventos de estoque**, marque **Movimentação de estoque** e salve a configuração.

Cada movimentação gera um evento para a URL configurada. Para consultar os campos e exemplos de recebimento, abra a pasta **Estoque**, na [documentação da API Delivery](https://documenter.getpostman.com/view/569841/TzeXmntp), e consulte **Webhook de movimentação de estoque**.

{% hint style="success" %}
**Exemplo prático**

Uma venda de um produto com ficha técnica pode baixar vários insumos. Se a receita usar farinha e queijo, a integração receberá uma notificação para a movimentação da farinha e outra para a do queijo.
{% endhint %}

{% hint style="info" %}
**Observações importantes**

* O identificador do evento enviado é `movimentacao_estoque`.
* Uma venda com ficha técnica gera um evento por insumo movimentado. Os eventos da mesma venda compartilham o `random_key`.
* Não descarte eventos apenas porque compartilham o `random_key`: eles podem representar movimentações de insumos diferentes.
* O envio segue as regras de recebimento e reenvio descritas neste artigo. Prepare a integração para lidar com notificações repetidas sem aplicar a mesma movimentação novamente.
  {% endhint %}

***

### Importante

* **Integração Assíncrona:** Certifique-se de que o seu sistema de recebimento de eventos esteja construído seguindo o paradigma de integração assíncrona. Isso significa que, ao receber uma notificação, seu sistema deve armazená-la em uma fila para posterior processamento interno, em vez de processá-la imediatamente.
* **URL Pública:** A URL do seu webhook deve ser acessível publicamente na internet. Isso garante que a plataforma possa alcançá-la e enviar os eventos sem problemas.

***

### Timeouts

A plataforma espera receber uma resposta do seu webhook em até 3 segundos após o disparo de um evento. Se esse tempo for excedido, a conexão será encerrada e a plataforma tentará reenviar o evento após 5 minutos.

**Recomendações:**

* **Tratamento de Eventos Duplicados:** É possível que, em algumas situações, um evento seja disparado mais de uma vez. Por isso, é essencial que você implemente um tratamento em seu sistema para garantir que eventos duplicados sejam considerados apenas uma vez.
* **Resposta ao Recebimento:** Quando o seu endpoint receber uma notificação, é crucial retornar com a resposta `{"status": "ok"}`. Se houver um volume considerável e repetitivo de retornos inválidos, o webhook será desativado automaticamente pela plataforma.

***

Esperamos que este artigo tenha esclarecido como funcionam as notificações e eventos via webhook em nossa plataforma. Se tiver mais dúvidas, não hesite em entrar em contato com nossa equipe de suporte. Estamos aqui para ajudar!
