Вебхук-автоматизации

План Basic и выше

Вебхуки требуют платный план. Basic: 1 вебхук, Pro: 3, Ultra: 10.

Вебхуки позволяют подключить TellDone к любому внешнему сервису. Когда ты создаешь голосовую заметку, TellDone обрабатывает ее и автоматически отправляет извлеченные данные - заметки, задачи, события и отчеты - на указанный тобой URL. Каждая задача и событие отправляются отдельной доставкой, чтобы твой инструмент автоматизации мог обрабатывать их по отдельности.

Настройка вебхука

Настройки автоматизаций для Zapier, Make и n8n

Зайди в Настройки > Интеграции > Webhook Automations
Нажми Новая автоматизация

Настройка нового вебхука

Введи название (например, "Мой вебхук Zapier")
Вставь URL вебхука из твоего сервиса автоматизации
Выбери, какие данные отправлять: заметки, задачи, события, отчеты (или любую комбинацию)
При необходимости добавь auth header - токен, который отправляется в заголовке Authorization для защищенных эндпоинтов
Нажми Сохранить
Скопируй секрет подписи - он показывается только один раз. Он понадобится, если захочешь проверять подлинность вебхуков
Нажми Тестовая отправка, чтобы убедиться, что эндпоинт получает данные

подсказка

URL вебхука должен использовать HTTPS. HTTP-адреса и IP-адреса частных сетей не принимаются.

Что отправляется

Каждая доставка - это JSON-объект с тремя полями: event (тип события), timestamp и data (содержимое). Вот как выглядит каждый тип события.

Заметки (`note.created`)

Содержит AI-генерированный заголовок, полную транскрипцию, резюме, тип заметки, теги, приоритет, язык и дату создания.

{
  "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"
  }
}

На плане Ultra доставки заметок могут также включать ссылку на аудиозапись (audio_url, audio_format, duration_seconds). Ссылка действительна 24 часа. Включи это опцией "Note + Audio" при создании автоматизации.

Задачи (`task.created`)

Одна доставка на задачу. Одна заметка с 3 задачами отправляет 3 отдельных вебхука.

{
  "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"
  }
}

События (`calendar_event.created`)

Одна доставка на событие календаря.

{
  "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"
  }
}

Отчеты (`report.created`)

Отправляется при генерации ежедневного, еженедельного или ежемесячного отчета.

{
  "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"
  }
}

Безопасность

Каждая доставка подписана HMAC-SHA256 с использованием секрета подписи твоей автоматизации. С каждой доставкой отправляются следующие заголовки:

X-LP-Signature - подпись HMAC-SHA256 (sha256=...)
X-LP-Timestamp - временная метка Unix, использованная при подписи
X-LP-Event - тип события (note.created, task.created, calendar_event.created, report.created)
X-LP-Delivery-Id - уникальный ID доставки (полезен для дедупликации)
User-Agent - всегда TellDone-Webhooks/1.0

Если ты задал auth header, он отправляется в заголовке Authorization с каждой доставкой.

Секрет подписи показывается один раз при создании автоматизации. Ты можешь перегенерировать его в любой момент в настройках автоматизации - старый секрет перестает работать немедленно.

Принимаются только HTTPS URL. HTTP, IP-адреса и адреса частных сетей отклоняются.

Политика повторных попыток

Если твой эндпоинт не отвечает, TellDone повторяет с нарастающими задержками:

Попытка	Задержка
1-я повторная	30 секунд
2-я повторная	2 минуты
3-я повторная	15 минут
4-я повторная	1 час
5-я повторная	4 часа

После 5 неудачных попыток доставка помечается как мертвая. Ты все равно можешь повторить ее вручную из истории доставок.

Как TellDone обрабатывает разные ответы:

2xx - доставлено успешно
4xx (кроме 429) - сразу помечается как мертвая, без повторных попыток (эндпоинт явно отклонил данные)
429 (Too Many Requests) - повторяется с учетом заголовка Retry-After
5xx или таймаут - повторяется по расписанию выше

После 20 последовательных ошибок по всем доставкам автоматизация отключается автоматически. Исправь проблему, затем включи заново в Настройках.

Управление вебхуками

Пауза/возобновление - отключи любую автоматизацию без удаления, включи заново в любой момент
История доставок - просматривай все доставки со статусом, HTTP-кодом и временем ответа. Фильтруй по Доставленным или Ошибкам
Тестовая отправка - отправь тестовый запрос (включает "test": true в теле) для проверки эндпоинта. Не считается в лимитах
Перегенерация секрета - сгенерируй новый секрет подписи, если старый скомпрометирован
Редактирование - обнови URL, auth header или типы данных. Изменения вступают в силу немедленно
Удаление - навсегда удаляет автоматизацию и все логи доставок

Лимиты доставки

План	Вебхуки	Доставок/мес	Доставок/час
Basic	1	300	100
Pro	3	3 000	100
Ultra	10	15 000	100

На плане Ultra также поддерживаются ссылки на аудио в доставках заметок (срок действия 24 часа).

Месячные счетчики сбрасываются 1-го числа каждого месяца. Тестовые отправки не считаются.

Фильтрация тестовых событий

При использовании Тестовой отправки в тело запроса добавляется "test": true на верхнем уровне. В своем инструменте автоматизации ты можешь проверять это поле и пропускать обработку, когда оно присутствует.

Инструкции для платформ

Пошаговые инструкции по настройке для твоего инструмента автоматизации:

Zapier - подключи TellDone к тысячам приложений через Zap
Make - строй визуальные сценарии автоматизации (ранее Integromat)
n8n - используй вебхуки TellDone в воркфлоу с собственным хостингом или в облаке
Свои эндпоинты - любой сервис, принимающий HTTPS POST-запросы, работает с вебхуками TellDone

Смотри также

Zapier - пошаговая настройка Zapier
Make - пошаговая настройка Make
n8n - пошаговая настройка n8n
Todoist - выделенная двусторонняя синхронизация задач (без вебхуков)
Notion - выделенная интеграция для Notion
Пересылка по email - получай данные заметок по email

Настройка вебхука​

Что отправляется​

Заметки (note.created)​

Задачи (task.created)​

События (calendar_event.created)​

Отчеты (report.created)​

Безопасность​

Политика повторных попыток​

Управление вебхуками​

Лимиты доставки​

Фильтрация тестовых событий​

Инструкции для платформ​

Популярные сценарии​

Смотри также​