Automatizaciones con webhooks
Los webhooks requieren un plan de pago. Basic: 1 webhook, Pro: 3, Ultra: 10.
Los webhooks te permiten conectar TellDone a cualquier servicio externo. Cuando creas una nota de voz, TellDone la procesa y envía automáticamente los datos extraídos - notas, tareas, eventos e informes - a una URL que especifiques. Cada tarea y evento se envía como una entrega separada, para que tu herramienta de automatización pueda procesarlos individualmente.
Configurar un webhook
- Ve a Ajustes > Integraciones > Webhook Automations
- Toca Nueva automatización
- Ingresa un nombre (ej., "Mi webhook de Zapier")
- Pega la URL del webhook de tu servicio de automatización
- Elige qué datos enviar: notas, tareas, eventos, informes (o cualquier combinación)
- Opcionalmente, agrega un auth header - un token que se envía como encabezado
Authorizationpara endpoints seguros - Toca Guardar
- Copia el secreto de firma - se muestra solo una vez. Lo necesitarás si quieres verificar la autenticidad del webhook
- Toca Envío de prueba para confirmar que tu endpoint recibe datos
La URL del webhook debe usar HTTPS. Las direcciones HTTP y las IPs de redes privadas no son aceptadas.
Qué se envía
Cada entrega es un objeto JSON con tres campos: event (el tipo de evento), timestamp y data (el contenido real). Aquí tienes cómo se ve cada tipo de evento.
Notas (note.created)
Contiene el título generado por IA, la transcripción completa, resumen, tipo de nota, etiquetas, prioridad, idioma y fecha de creación.
{
"event": "note.created",
"timestamp": "2026-02-27T14:38:00Z",
"data": {
"note_id": "550e8400-e29b-41d4-a716-446655440000",
"title": "Meeting notes - Project Alpha",
"transcript": "Full transcript text...",
"summary": "Brief AI-generated summary...",
"type": "meeting",
"tags": ["work", "project-alpha"],
"priority": "high",
"language": "en",
"created_at": "2026-02-27T10:00:00Z"
}
}
En el plan Ultra, las entregas de notas también pueden incluir un enlace a la grabación de audio (audio_url, audio_format, duration_seconds). El enlace expira después de 24 horas. Activa esto con la opción "Note + Audio" al crear la automatización.
Tareas (task.created)
Una entrega por tarea. Una nota con 3 tareas envía 3 webhooks separados.
{
"event": "task.created",
"timestamp": "2026-02-27T14:38:01Z",
"data": {
"note_id": "550e8400-...",
"note_title": "Meeting notes - Project Alpha",
"task_id": "660f9511-...",
"title": "Send proposal to client",
"description": "Include pricing for Q2",
"priority": "high",
"due_date": "2026-03-01",
"reminder_at": "2026-02-28T09:00:00Z",
"tags": ["work"],
"status": "todo",
"created_at": "2026-02-27T10:00:00Z"
}
}
Eventos (calendar_event.created)
Una entrega por evento de calendario.
{
"event": "calendar_event.created",
"timestamp": "2026-02-27T14:38:02Z",
"data": {
"note_id": "550e8400-...",
"note_title": "Meeting notes",
"event_id": "770a0622-...",
"title": "Team standup",
"description": "Weekly sync",
"start": "2026-03-03T10:00:00+03:00",
"end": "2026-03-03T10:30:00+03:00",
"location": "Zoom",
"is_all_day": false,
"attendees": ["alice@example.com"],
"tags": ["work"],
"created_at": "2026-02-27T10:00:00Z"
}
}
Informes (report.created)
Se envía cuando se genera un informe diario, semanal o mensual.
{
"event": "report.created",
"timestamp": "2026-02-28T00:05:00Z",
"data": {
"report_id": "880b1733-...",
"report_type": "daily",
"period_start": "2026-02-27",
"period_end": "2026-02-27",
"content_md": "# Daily Report\n\n...",
"content_json": {
"productivity_score": 72,
"day_type": "productive",
"tasks_created": 5,
"tasks_completed": 3
},
"created_at": "2026-02-28T00:05:00Z"
}
}
Seguridad
Cada entrega está firmada con HMAC-SHA256 usando el secreto de firma de tu automatización. Los siguientes encabezados se incluyen con cada entrega:
X-LP-Signature- la firma HMAC-SHA256 (sha256=...)X-LP-Timestamp- marca de tiempo Unix usada para la firmaX-LP-Event- el tipo de evento (note.created,task.created,calendar_event.created,report.created)X-LP-Delivery-Id- ID único de entrega (útil para deduplicación)User-Agent- siempreTellDone-Webhooks/1.0
Si configuraste un auth header, se envía como encabezado Authorization con cada entrega.
El secreto de firma se muestra una sola vez al crear la automatización. Puedes rotarlo en cualquier momento desde los ajustes de la automatización - el secreto anterior deja de funcionar inmediatamente.
Solo se aceptan URLs HTTPS. Las direcciones HTTP, direcciones IP y direcciones de redes privadas son rechazadas.
Política de reintentos
Si tu endpoint falla, TellDone reintenta con retrasos crecientes:
| Intento | Retraso |
|---|---|
| 1er reintento | 30 segundos |
| 2do reintento | 2 minutos |
| 3er reintento | 15 minutos |
| 4to reintento | 1 hora |
| 5to reintento | 4 horas |
Después de 5 intentos fallidos, la entrega se marca como muerta. Aún puedes reintentarla manualmente desde el historial de entregas.
Cómo TellDone maneja diferentes respuestas:
- 2xx - entregado exitosamente
- 4xx (excepto 429) - marcado como muerto inmediatamente, sin reintento (tu endpoint rechazó los datos explícitamente)
- 429 (Too Many Requests) - reintenta, respeta el encabezado
Retry-After - 5xx o timeout - reintenta con el calendario de arriba
Después de 20 errores consecutivos en todas las entregas, la automatización se desactiva automáticamente. Corrige el problema y luego reactiva en Ajustes.
Gestión de webhooks
- Pausar/reanudar - desactiva cualquier automatización sin eliminarla, reactiva en cualquier momento
- Historial de entregas - consulta todas las entregas con estado, código HTTP y tiempo de respuesta. Filtra por Entregados o Errores
- Envío de prueba - envía un payload de prueba (incluye
"test": trueen el cuerpo) para verificar tu endpoint. No se cuenta en los límites - Rotar secreto - genera un nuevo secreto de firma si el anterior se vio comprometido
- Editar - actualiza la URL, auth header o tipos de datos. Los cambios surten efecto inmediatamente
- Eliminar - elimina permanentemente la automatización y todos sus registros de entrega
Límites de entrega
| Plan | Webhooks | Entregas/mes | Entregas/hora |
|---|---|---|---|
| Basic | 1 | 300 | 100 |
| Pro | 3 | 3,000 | 100 |
| Ultra | 10 | 15,000 | 100 |
El plan Ultra también soporta enlaces de audio en los payloads de notas (expiran en 24 horas).
Los contadores mensuales se reinician el 1 de cada mes. Los envíos de prueba no se cuentan.
Filtrar eventos de prueba
Cuando usas Envío de prueba, el payload incluye "test": true en el nivel superior. En tu herramienta de automatización, puedes verificar este campo y omitir el procesamiento cuando esté presente.
Guías por plataforma
Para instrucciones paso a paso con tu herramienta de automatización:
- Zapier - conecta TellDone a miles de apps con Zaps
- Make - construye escenarios de automatización visuales (antes Integromat)
- n8n - usa webhooks de TellDone en flujos de trabajo autoalojados o en la nube
- Endpoints personalizados - cualquier servicio que acepte solicitudes HTTPS POST funciona con webhooks de TellDone
Casos de uso populares
- Enviar tareas a Google Sheets vía Zapier
- Crear mensajes de Slack desde notas vía Make
- Registrar eventos en un CRM personalizado vía n8n
- Respaldar todas las notas en almacenamiento en la nube
- Reenviar informes a un panel de equipo