К основному содержимому

API и Webhooks

Как получить доступ, настроить и использовать наш API и Webhooks

Обновлено на этой неделе

Вы уже знаете, что tl;dv создан для экономии времени и повышения эффективности работы. Использование нашего Public API и Webhooks сделает всё ещё проще.

Вот как получить к ним доступ, настроить их и переложить ещё больше работы!

Public API

Наш API позволяет импортировать совещания и создавать индивидуальные рабочие процессы, адаптированные под ваши потребности. Доступ к API и webhooks доступен только на тарифе Business.

  • Тариф Business: доступ к API включен

  • Тарифы Pro или Free: доступ к API не включен и недоступен

Как использовать Public API от tl;dv

Для начала вам понадобится:

  1. Ваш API-ключ: Вы можете найти его в настройках аккаунта, если у вас тариф Business.

  2. Техническая настройка: Реализация обычно требует некоторого программирования, поэтому может потребоваться помощь разработчика из вашей команды.

В ней есть всё необходимое для начала интеграции.

Нужна помощь или хотите повысить тариф?

Если вы не уверены, должен ли у вас быть доступ или как его использовать, мы здесь, если у вас есть вопросы или вы хотите повысить тариф до Business. Просто напишите на support@tldv.io - мы будем рады помочь! 🙌


Webhooks

Как настроить Webhooks для получения данных о совещаниях

Хотите автоматизировать рабочие процессы, получая данные о совещаниях в реальном времени? Мы можем настроить webhook для вас! После настройки мы будем отправлять вам данные, как только совещание (или его расшифровка) будут готовы, без необходимости опрашивать наш API.

Как это работает

Webhooks позволяют получать уведомления, когда:

  • Совещание успешно обработано (MeetingReady)

  • Расшифровка доступна (TranscriptReady)

Каждый webhook включает богатые метаданные, идеально подходящие для создания пользовательских автоматизаций или интеграций, и каждое событие отправляет JSON-данные, соответствующие формату, используемому в нашем Public API.

Вот как это выглядит:

{  "id": "webhook-job-id",  "event": "MeetingReady",  "executedAt": "2025-06-16T09:23:00Z",  "data": {    "id": "meeting-id",    "happenedAt": "2025-06-15T14:00:00Z",    "name": "Team Sync",    "organizer": {      "email": "organizer@example.com",      "name": "Alex Taylor"    },    "invitees": [      {        "email": "teammate@example.com",        "name": "Jordan Lee"      }    ],    "url": "https://app.tldv.io/meetings/meeting-id"  }}

После активации мы будем запускать webhook каждый раз, когда вы организуете совещание и оно успешно обрабатывается. Если расшифровки позже будут сгенерированы повторно, вы также получите дополнительное событие TranscriptReady.

Что нам нужно от вас

Поскольку вы не можете настроить webhooks самостоятельно, просто отправьте нам следующую информацию, чтобы мы могли настроить их для вас:

  1. URL для webhook: Конечная точка, на которую вы хотите, чтобы мы отправляли данные.

  2. Email пользователя: Адрес электронной почты пользователя, к которому должен быть привязан webhook.

  3. Дополнительная конфигурация заголовков: Любые дополнительные конфигурации или заголовки (например, токены авторизации), которые вы хотите, чтобы мы включили в запрос.

Отправьте это нам через чат или email, и мы позаботимся обо всем остальном. 🔮

Нашли ответ на свой вопрос?