Meeting API · доступно на Профи

Запись встреч из вашей CRM
— одним запросом

Отправьте AI-бота на онлайн-встречу (Zoom, Google Meet, Teams, Telemost, Webex) прямо из CRM — он подключится, запишет и вернёт расшифровку. Тело запроса — JSON или form, авторизация по X-API-Key.

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

3 шага от ссылки до расшифровки

Запустить бота, дождаться записи, забрать текст — через webhook или поллинг.

# 1. Отправить бота на встречу (JSON-тело)
curl -X POST https://wonderscribe.pro/api/v1/meeting \
 -H "X-API-Key: ws_..." \
 -H "Content-Type: application/json" \
 -d '{"meeting_url": "https://zoom.us/j/123", "consent_acknowledged": true,
      "webhook_url": "https://ваша-crm.ru/ws-callback"}'
# → {"bot_id": "abc-123", "status": "joining", "webhook_secret": "whsec_..."}

# 2. Бот зашёл, записал, расшифровал — мы шлём webhook на webhook_url:
# POST {"event":"meeting.transcript.completed", "bot_id":"abc-123",
#       "task_id":"t-789", "status":"completed", "result_url":"/api/v1/tasks/t-789/result"}

# 3. Забрать готовую расшифровку
curl -H "X-API-Key: ws_..." \
 https://wonderscribe.pro/api/v1/tasks/t-789/result
# → {"text": "...", "segments": [...], "summary": "...", "speakers": [...]}

Без webhook_url — забирайте поллингом: GET /api/v1/meeting/{bot_id} → когда task_id заполнен → /api/v1/tasks/{task_id}/result.

Эндпоинты

3 метода для встреч

Method Endpoint Назначение
POST /api/v1/meeting Отправить бота: сейчас или по расписанию (start_at)
GET /api/v1/meeting/{bot_id} Статус бота + task_id записи когда готово
DELETE /api/v1/meeting/{bot_id} Отменить запланированную / остановить идущую запись
POST /meeting

Параметры запуска

Поле Тип Описание
meeting_url *stringСсылка на встречу (Zoom, Google Meet, Teams, Telemost, Webex)
consent_acknowledged *boolПодтверждение, что участники уведомлены о записи и согласны на обработку ПДн (152-ФЗ)
start_atISO 8601Время запуска (напр. 2026-06-15T15:00:00+03:00). В будущем → бот зайдёт по расписанию. Без поля → сразу. Макс. +30 дней
webhook_urlhttps URLКуда прислать POST, когда транскрипт готов. Тело подписано X-WS-Signature ключом webhook_secret из ответа

* — обязательное поле · ответ: {bot_id, status, scheduled_start_at?, webhook_secret?}

Webhook

Push с подписью

Укажите webhook_url — и не нужно поллить. Мы пришлём POST, когда транскрипт готов, с HMAC-подписью тела.

# Что прилетит к вам на webhook_url:
POST https://ваша-crm.ru/ws-callback
X-WS-Signature: sha256=9f86d081...
{"event":"meeting.transcript.completed","bot_id":"abc-123",
 "task_id":"t-789","status":"completed","result_url":"/api/v1/tasks/t-789/result"}

# Проверка подписи на вашей стороне (Python):
import hmac, hashlib
expected = "sha256=" + hmac.new(webhook_secret.encode(), raw_body, hashlib.sha256).hexdigest()
assert hmac.compare_digest(expected, request.headers["X-WS-Signature"])

Webhook шлётся на готовность расшифровки (completed / failed). Доставка повторяется при сбоях. result_url — относительный, добавьте https://wonderscribe.pro.

Интеграция

Подключить к любой CRM

API ничего CRM-специфичного не требует — нужен исходящий HTTP-запрос с заголовком и телом. Три рабочих пути:

Bitrix24

Робот / бизнес-процесс с действием «Исходящий вебхук» на стадии сделки «Встреча назначена».

POST на /api/v1/meeting, заголовок X-API-Key, JSON-тело. Нативно, без сторонних сервисов.

amoCRM

Через Salesbot (шаг «HTTP-запрос»), виджет или no-code коннектор на триггере воронки.

Коннектор позволяет задать заголовок X-API-Key и JSON-тело по событию amoCRM.

Любая CRM · коннектор

Make, Zapier, n8n — триггер из CRM → HTTP-запрос на наш эндпоинт.

Универсальный путь: задаёте заголовок и JSON-тело в коннекторе, минуя ограничения нативных вебхуков.

Что нужно в любом случае: заголовок X-API-Key, consent_acknowledged: true, доступная в CRM meeting_url на момент запуска. Результат — webhook или поллинг.

Ошибки

Коды ответов

400 consent_requiredНе передан consent_acknowledged: true
400 invalid_meeting_urlНеверная или недопустимая ссылка на встречу
400 invalid_webhook_urlwebhook_url должен быть https и публичным
401Неверный или отсутствующий X-API-Key
429Лимит 20 запросов/мин на ключ
503Сервис бота временно недоступен — повторите

Минуты списываются после записи с того же баланса тарифа.

Готовы подключить?

Получите API-ключ в кабинете и отправьте первого бота на встречу.