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

# Visão geral dos eventos

> Todos os eventos webhook que o Fire emite, organizados por entidade.

O Fire notifica seu sistema sobre mudanças em tempo real via webhooks — requisições HTTP `POST` enviadas para seu endpoint registrado sempre que algo relevante acontece. Você assina os eventos que lhe interessam e age sobre eles como sua integração exigir.

## Eventos de canal

Os eventos de canal notificam seu sistema quando o catálogo de canais de venda muda. Use-os para manter seu mapeamento local de canais sincronizado — os IDs de canal são obrigatórios ao injetar pedidos e ao processar eventos de publicação.

<CardGroup cols={3}>
  <Card title="channel.updated" icon="plug" href="/pt/webhook-reference/channel-updated">
    Um canal foi criado ou sua configuração mudou.
  </Card>

  <Card title="channel.deleted" icon="plug-circle-xmark" href="/pt/webhook-reference/channel-deleted">
    Um canal foi removido do Fire.
  </Card>

  <Card title="channels.sync" icon="arrows-rotate" href="/pt/webhook-reference/channels-sync">
    Sincronização em massa — catálogo completo de canais em lotes de até 50.
  </Card>
</CardGroup>

## Eventos de loja

Os eventos de loja notificam seu sistema quando as configurações de loja mudam. O Fire suporta atualizações de loja individuais, exclusões explícitas e sincronizações em massa para onboarding ou mudanças massivas.

<CardGroup cols={3}>
  <Card title="store.updated" icon="store" href="/pt/webhook-reference/store-updated">
    Uma loja foi criada ou sua configuração mudou.
  </Card>

  <Card title="store.deleted" icon="trash" href="/pt/webhook-reference/store-deleted">
    Uma loja foi removida do Fire.
  </Card>

  <Card title="stores.sync" icon="arrows-rotate" href="/pt/webhook-reference/stores-sync">
    Sincronização em massa — até 50 lojas por lote.
  </Card>
</CardGroup>

## Eventos de cardápio

Os eventos de cardápio carregam a definição completa do catálogo para uma loja e canal específicos — categorias, produtos, grupos de modificadores e horários. O payload está pronto para ser encaminhado a sistemas downstream.

<CardGroup cols={2}>
  <Card title="menu.updated" icon="book-open" href="/pt/webhook-reference/menu-updated">
    Um cardápio foi criado ou atualizado. Também usado para sinalizar a exclusão do cardápio (payload vazio).
  </Card>

  <Card title="menus.sync" icon="arrows-rotate" href="/pt/webhook-reference/menus-sync">
    Sincronização em massa — cardápios para várias lojas em lotes de até 50.
  </Card>
</CardGroup>

## Eventos de produto

<CardGroup cols={2}>
  <Card title="product.updated" icon="tag" href="/pt/webhook-reference/product-updated">
    Um ou mais produtos foram atualizados em todas as lojas onde aparecem.
  </Card>

  <Card title="product.availability_changed" icon="circle-dot" href="/pt/webhook-reference/product-availability-changed">
    Um produto foi ativado ou desativado em uma ou mais lojas.
  </Card>
</CardGroup>

## Eventos de pedido

<CardGroup cols={1}>
  <Card title="order.status_changed" icon="receipt" href="/pt/webhook-reference/order-status-changed">
    O status de um pedido mudou dentro do Fire.
  </Card>
</CardGroup>

***

## Envelope do evento

Todos os eventos compartilham a mesma estrutura de nível superior:

```json theme={null}
{
  "event": "event.type",
  "id": "evt_abc123",
  "createdAt": "2025-01-15T14:30:00Z",
  "data": { }
}
```

| Campo       | Tipo   | Descrição                                  |
| ----------- | ------ | ------------------------------------------ |
| `event`     | string | Identificador do tipo de evento            |
| `id`        | string | ID único do evento — use para deduplicação |
| `createdAt` | string | Timestamp ISO 8601                         |
| `data`      | object | Payload específico do evento               |

## Headers da requisição

| Header             | Descrição                                                        |
| ------------------ | ---------------------------------------------------------------- |
| `Content-Type`     | `application/json`                                               |
| `X-Fire-Event`     | Tipo de evento (ex.: `menu.updated`)                             |
| `X-Fire-Signature` | Assinatura HMAC-SHA256 — veja [Autenticação](/pt/authentication) |
| `X-Fire-Delivery`  | ID único da tentativa de entrega                                 |

## Deduplicação

Use o campo `id` para detectar e descartar entregas duplicadas. O Fire pode entregar o mesmo evento mais de uma vez em caso de retentativas.

## Como responder

Retorne qualquer `2xx` em até 10 segundos para confirmar o recebimento. Processe de forma assíncrona para evitar timeouts.