Skip to main content
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 executar fluxos de trabalho.
Página de Triggers com estado vazio e botão New trigger

Seção de Triggers nas configurações do Databases

Criando um trigger

Formulário New trigger com campos Name, Collection, Event (Create, Update, Delete), Webhook Request, Headers e Status

Formulário para criar um novo trigger com eventos e configuração de webhook

1

Acesse Triggers

Vá para Configurações > Triggers na barra lateral esquerda.
2

Clique em + New trigger

O botão está localizado no canto superior direito.
3

Configure o trigger

Preencha os seguintes campos:
  • Name — Um nome descritivo (ex.: “Sync CRM”, “Notificar novo pedido”)
  • Collection — A coleção que você deseja monitorar
  • Event — O tipo de evento que dispara o webhook
  • Update scope — Somente para o evento Update: dispara em qualquer coluna ou somente em colunas específicas
  • Webhook Request — O método HTTP e a URL de destino
  • Headers — Headers personalizados para a requisição
  • Status — Ativa ou desativa o trigger
4

Clique em Create trigger

O trigger é ativado imediatamente se o status estiver definido como Active.

Eventos disponíveis

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.

Alcance de atualização

Quando o evento é Update, aparece um controle adicional de Update scope (alcance de atualização) com duas opções: Ao escolher Colunas específicas você deve selecionar pelo menos uma coluna. Os eventos Create e Delete sempre usam “qualquer coluna” e não mostram este controle.

Configuração do webhook

Método HTTP

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

URL do webhook

Insira a URL completa do endpoint que receberá a notificação (ex.: https://sua-api.com/webhooks/databases).
A URL deve ser pública e usar HTTPS.

Headers

Adicione headers personalizados para autenticação ou outros fins. Por padrão, é incluído um header de exemplo para Authorization com formato de Bearer token. Clique em + Add header para adicionar headers adicionais. Cada header tem um campo de nome (key) e valor (value).

Novas tentativas automáticas

Se a entrega de um webhook falhar, o Databases tenta novamente de forma automática.

Status do trigger

O botão Status permite ativar ou desativar um trigger sem excluí-lo. Um trigger desativado não envia webhooks mesmo que ocorram eventos na coleção.