Skip to content

WebHooks e Eventos · Desenvolvedores

Receba notificações de eventos em tempo real do Dailybot via webhooks. Inscreva-se em eventos de check-ins, formulários, kudos e organização.

WebHooks e Eventos

Os webhooks do Dailybot permitem que sua aplicação receba notificações HTTP em tempo real quando ocorrem eventos na sua organização. Em vez de fazer polling na API, você registra uma URL que o Dailybot chama sempre que ocorrem eventos assinados.

Assinatura de Eventos

Para configurar um webhook de saída, você precisa configurar três coisas:

  1. URL — O endpoint que receberá os payloads dos eventos
  2. Assinaturas de eventos — Quais tipos de eventos ouvir
  3. Assinaturas de objetos — Check-ins ou formulários específicos para filtrar (opcional)

Configure webhooks pelainterface web, pela API de Webhooks ou viaZapier.

Eventos Suportados

Eventos de Check-in

EventoDescrição
followups.response.completedDisparado quando um membro completa uma resposta de check-in
followups.response.updatedDisparado quando uma resposta de check-in é modificada
followups.response.deletedDisparado quando uma resposta de check-in é excluída

Eventos de Formulário

EventoDescrição
forms.response.createdDisparado quando uma resposta de formulário é enviada
forms.response.updatedDisparado quando uma resposta de formulário é editada
forms.response.deletedDisparado quando uma resposta de formulário é removida

Eventos de Kudos

EventoDescrição
kudos.postedDisparado quando kudos são dados a um membro da organização

Eventos de Organização

EventoDescrição
organization.user_activatedDisparado quando um admin ativa um usuário
organization.user_deactivatedDisparado quando um usuário é desativado
organization.team_user_addedDisparado quando um usuário é adicionado a uma equipe
organization.team_user_removedDisparado quando um usuário é removido de uma equipe

Privacidade

Todos os eventos respeitam as configurações de privacidade. Respostas anônimas de check-in excluem informações do usuário, e os eventos não são enviados se os inscritos não tiverem permissão de leitura.

Estrutura do Payload de Eventos

Todos os eventos de webhook seguem esta estrutura padrão:

Payload padrão de evento
{
  "event": "followups.response.completed",
  "event_timestamp": "2026-02-14T09:15:00Z",
  "hook": {
    "id": "wh-1234-abcd",
    "name": "Respostas de Check-in"
  },
  "body": {
    "...": "Dados específicos do payload do evento"
  }
}

Autenticação

O Dailybot suporta três métodos para proteger seu endpoint de webhook:

Assinatura Secreta

O Dailybot envia um header X-BEARER com um token bearer configurável. Defina-o ao criar a assinatura do webhook e valide-o no seu endpoint.

Verificação de assinatura
// Verificar a assinatura do webhook
const signature = req.headers['x-bearer'];
if (signature !== process.env.DAILYBOT_WEBHOOK_SECRET) {
  return res.status(401).json({ error: 'Assinatura inválida' });
}

Autenticação Básica HTTPS

Inclua credenciais diretamente na URL do webhook:

text
https://usuario:[email protected]/webhooks/dailybot

Autenticação OAuth 2.0

Forneça uma URL de acesso de autorização e uma chave privada opcional. O Dailybot obterá tokens do seu provedor OAuth e os incluirá nas requisições do webhook.

Gerenciamento de Webhooks

Crie e gerencie webhooks através de:

Testando Webhooks

  • Use o parâmetro immediate_sample_event ao criar um webhook para receber um evento de teste imediatamente
  • Use ferramentas como webhook.site ou ngrok para desenvolvimento local
  • Registre todos os payloads recebidos durante o desenvolvimento para depuração
  • Retorne uma resposta 200 OK rapidamente — processe eventos de forma assíncrona