Подключение tl;dv¶
Результат¶
Threadory будет получать выбранные встречи, расшифровки, summaries и action items из рабочего пространства tl;dv.
Что потребуется¶
- роль администратора или владельца проекта Threadory;
- workspace API key tl;dv; ключ доступен администратору workspace и требует подходящего плана tl;dv;
- заранее выбранное безопасное правило фильтрации встреч.
API key общий для workspace, поэтому фильтр особенно важен: не подключайте все встречи по умолчанию, если проекту нужна только их часть.
Профиль подключения¶
| Параметр | Минимум или ожидаемое поведение |
|---|---|
| Credential | Используйте отдельный tl;dv workspace API key, созданный workspace administrator. Ключ не является per-user. |
| Минимальный доступ | У tl;dv API key нет granular scopes: он может читать workspace. Поэтому meeting filters — обязательная граница данных, а не необязательное удобство. |
| Identity | Sync использует общий workspace credential и не атрибутируется каждому участнику встречи. |
| Направление и entities | Только inbound: user, meeting, transcript_segment и meeting_summary. Проверенный write-back в tl;dv не заявлен. |
| Delivery mode | Incremental polling выполняется каждые 60 минут и является проверенным baseline. Не полагайтесь на optional webhook meeting.processed, пока platform operator не проверил provider signing в этом deployment. |
Шаги¶
- В tl;dv откройте Settings → API & Integrations и создайте API key.
- В Threadory откройте Connectors → Add connector → tl;dv.
- Введите tl;dv API Key.
- Выберите режим хранения transcript. Начните с Truncate, если полный текст не нужен для сценария.
- Настройте Which meetings to ingest: по участникам, домену, названию, календарю или их комбинации.
- Используйте Preview filter и убедитесь, что выборка не захватывает лишние встречи. Preview ничего не сохраняет.
- Завершите установку и выполните Sync now.
Как проверить результат¶
- preview показывает только ожидаемые встречи;
- sync успешно завершился в Activity;
- встреча появилась в Knowledge с summary или transcript preview;
- action items доступны в Reports.
Частые проблемы¶
| Симптом | Причина | Что сделать |
|---|---|---|
| API key отклонён | Ключ неактивен или создан не для workspace | Создать новый workspace key и отозвать ошибочный |
| Preview пуст | Нет свежих встреч или фильтр слишком узкий | Ослабить один фильтр и повторить preview |
| Появились лишние встречи | Выбран режим All или слишком широкий фильтр | Остановить sync, сузить фильтр и обратиться по процедуре удаления данных |
| Нет полного transcript | Выбран Truncate или Omit | Изменить настройку только после оценки доступа и стоимости |
Безопасное отключение¶
Отключение останавливает будущий импорт встреч, но не удаляет автоматически meetings, transcript segments, summaries и производные action items, уже сохранённые в Threadory.
- Остановите workflows, зависящие от новых встреч.
- Экспортируйте нужные данные проекта.
- Отключите tl;dv connector в Threadory.
- Отзовите workspace API key в tl;dv, если он был выделен этому connector.
- Примените описанный retention process к импортированным данным встреч, которые требуется удалить.
Убедитесь, что карточка connector исчезла, а после предыдущего polling window в Activity не появляется новый tl;dv sync. Для восстановления создайте новый workspace key, подключите его с теми же проверенными filters, выполните Preview filter и только затем Sync now. Удалённые retention данные можно восстановить только из утверждённого export или backup через operator process.