Skip to content

WebHooks y Eventos - Dailybot Desarrolladores

Recibe notificaciones de eventos en tiempo real de Dailybot vía webhooks. Suscríbete a eventos de check-ins, formularios, kudos y organización.

WebHooks y Eventos

Los webhooks de Dailybot permiten que tu aplicación reciba notificaciones HTTP en tiempo real cuando ocurren eventos en tu organización. En lugar de hacer polling a la API, registras una URL a la que Dailybot llamará cuando ocurran los eventos suscritos.

Suscripción a Eventos

Para configurar un webhook saliente, necesitas configurar tres cosas:

  1. URL — El endpoint que recibirá los payloads de eventos
  2. Suscripciones de eventos — Qué tipos de eventos escuchar
  3. Suscripciones de objetos — Check-ins o formularios específicos para filtrar (opcional)

Configura webhooks a través de la interfaz web, la API de Webhooks o mediante Zapier.

Eventos Soportados

Eventos de Check-in

Evento Descripción
followups.response.completedSe activa cuando un miembro completa una respuesta de check-in
followups.response.updatedSe activa cuando se modifica una respuesta de check-in
followups.response.deletedSe activa cuando se elimina una respuesta de check-in

Eventos de Formularios

Evento Descripción
forms.response.createdSe activa cuando se envía una respuesta de formulario
forms.response.updatedSe activa cuando se edita una respuesta de formulario
forms.response.deletedSe activa cuando se elimina una respuesta de formulario

Eventos de Kudos

Evento Descripción
kudos.postedSe activa cuando se otorgan kudos a un miembro de la organización

Eventos de Organización

Evento Descripción
organization.user_activatedSe activa cuando un admin activa un usuario
organization.user_deactivatedSe activa cuando se desactiva un usuario
organization.team_user_addedSe activa cuando se agrega un usuario a un equipo
organization.team_user_removedSe activa cuando se remueve un usuario de un equipo

Privacidad

Todos los eventos respetan la configuración de privacidad. Las respuestas anónimas de check-ins excluyen información del usuario, y los eventos no se envían si los suscriptores no tienen permisos de lectura.

Estructura del Payload de Eventos

Todos los eventos de webhook siguen esta estructura estándar:

Payload estándar de evento 
{
  "event": "followups.response.completed",
  "event_timestamp": "2026-02-14T09:15:00Z",
  "hook": {
    "id": "wh-1234-abcd",
    "name": "Respuestas de Check-in"
  },
  "body": {
    "...": "Datos específicos del payload del evento"
  }
}

Autenticación

Dailybot soporta tres métodos para asegurar tu endpoint de webhook:

Firma Secreta

Dailybot envía un header X-BEARER con un token bearer configurable. Establécelo al crear la suscripción de webhook y valídalo en tu endpoint.

Verificación de firma 
// Verificar la firma del webhook
const signature = req.headers['x-bearer'];
if (signature !== process.env.DAILYBOT_WEBHOOK_SECRET) {
  return res.status(401).json({ error: 'Firma inválida' });
}

Autenticación Básica HTTPS

Incluye credenciales directamente en la URL del webhook:

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

Autenticación OAuth 2.0

Proporciona una URL de acceso de autorización y clave de auth privada opcional. Dailybot obtendrá tokens de tu proveedor OAuth y los incluirá en las peticiones del webhook.

Gestión de Webhooks

Crea y gestiona webhooks a través de:

Probar Webhooks

  • Usa el parámetro immediate_sample_event al crear un webhook para recibir un evento de prueba inmediatamente
  • Usa herramientas como webhook.site o ngrok para desarrollo local
  • Registra todos los payloads entrantes durante el desarrollo para depuración
  • Devuelve una respuesta 200 OK rápidamente — procesa eventos de forma asíncrona