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

# Triggers

> Configure webhooks que disparam automaticamente quando registros são criados, atualizados ou excluídos

Os **Triggers** permitem executar webhooks automaticamente quando ocorrem alterações nas suas coleções. São ideais para sincronizar dados com sistemas externos, enviar notificações ou acionar fluxos de trabalho.

<Frame caption="Seção de Triggers nas configurações do Databases">
  <img src="https://mintcdn.com/jelouai/daUUvITM1J6ByU2U/assets/images/datum/triggers.png?fit=max&auto=format&n=daUUvITM1J6ByU2U&q=85&s=a3578f00045680b196daf8ae5f18fc6a" alt="Página de Triggers com estado vazio e botão Novo trigger" width="3024" height="1730" data-path="assets/images/datum/triggers.png" />
</Frame>

## Criando um trigger

<Frame caption="Formulário para criar um novo trigger com eventos e configuração de webhook">
  <img src="https://mintcdn.com/jelouai/daUUvITM1J6ByU2U/assets/images/datum/new-trigger.png?fit=max&auto=format&n=daUUvITM1J6ByU2U&q=85&s=9bf746da6d3e92bdb733dc2063e6c5cc" alt="Formulário de novo trigger com campos Nome, Coleção, Evento (Create, Update, Delete), Webhook Request, Headers e Status" width="3024" height="1730" data-path="assets/images/datum/new-trigger.png" />
</Frame>

<Steps>
  <Step title="Vá para Triggers">
    Navegue até **Configurações > Triggers** na barra lateral esquerda.
  </Step>

  <Step title="Clique em + Novo trigger">
    O botão está localizado no canto superior direito.
  </Step>

  <Step title="Configure o trigger">
    Preencha os seguintes campos:

    * **Nome** — Um nome descritivo (ex.: "Sincronizar CRM", "Notificar novo pedido")
    * **Coleção** — A coleção que você deseja monitorar
    * **Evento** — O tipo de evento que dispara o webhook
    * **Webhook Request** — O método HTTP e a URL de destino
    * **Headers** — Cabeçalhos personalizados para a requisição
    * **Status** — Habilitar ou desabilitar o trigger
  </Step>

  <Step title="Clique em Criar trigger">
    O trigger é ativado imediatamente se o status estiver definido como **Ativo**.
  </Step>
</Steps>

## Eventos disponíveis

| Evento     | Dispara quando...                      |
| ---------- | -------------------------------------- |
| **Create** | Um novo registro é inserido na coleção |
| **Update** | Um registro existente é modificado     |
| **Delete** | Um registro é excluído                 |

<Tip>
  Você pode criar múltiplos triggers para a mesma coleção com eventos diferentes. Por exemplo, um trigger para sincronizar dados a cada **Create** e outro para enviar um alerta a cada **Delete**.
</Tip>

## Configuração do webhook

### Método HTTP

Selecione o método HTTP apropriado para o seu endpoint:

| Método     | Uso típico                                        |
| ---------- | ------------------------------------------------- |
| **POST**   | Enviar dados do registro ao servidor (mais comum) |
| **GET**    | Notificar sem enviar dados no corpo               |
| **PUT**    | Substituir um recurso completo                    |
| **PATCH**  | Atualizar parcialmente um recurso                 |
| **DELETE** | Solicitar a exclusão de um recurso                |

### URL do webhook

Insira a URL completa do endpoint que receberá a notificação (ex.: `https://your-api.com/webhooks/datum`).

### Headers

Adicione cabeçalhos personalizados para autenticação ou outros fins. Por padrão, um exemplo de cabeçalho **Authorization** com formato de Bearer token é incluído.

Clique em **+ Adicionar header** para adicionar cabeçalhos adicionais. Cada header tem um campo de nome (chave) e valor.

## Status do trigger

O botão **Status** permite habilitar ou desabilitar um trigger sem excluí-lo. Um trigger desabilitado não envia webhooks mesmo que ocorram eventos na coleção.