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.
Criando um trigger
Vá para Triggers
Navegue até Configurações > Triggers na barra lateral esquerda.
Clique em + Novo trigger
O botão está localizado no canto superior direito.
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
Clique em Criar trigger
O trigger é ativado imediatamente se o status estiver definido como Ativo.
Eventos disponíveis
| Evento | Dispara quando… |
|---|
| Create | Um novo registro é inserido na coleção |
| Update | Um registro existente é modificado |
| Delete | Um registro é excluído |
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.
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).
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. 
