Встречи

Чтение встреч вместе с их сводками и расшифровками, плюс два события вебхука —

чтобы итог разговора сам улетал туда, где вы его читаете: в CRM, в таск-трекер, в рассылку.

Нужна область доступа conferences:read.

Жизнь встречи

Два события

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

Тело события — тот же объект, который отдаёт GET /v1/meetings/{id}. Это не обещание, а устройство: одна выборка и один преобразователь на оба случая.

Что внутри

curl -H "Authorization: Bearer $TYGY_API_KEY" \
  https://api.tygy.ru/v1/meetings/mt_123

• summary — о чём говорили, в Markdown;
• decisions — о чём договорились;
• transcript — расшифровка целиком и по отрезкам с временем начала и конца;
• participants — кто был, когда зашёл и когда вышел;
• contact и organization — к кому встреча привязана;
• conversation_id — из какого диалога она выросла, если выросла.

До статуса ready сводка и расшифровка равны null. Это не пустота — это «ещё не готово», и для встречи со статусом ended так останется навсегда.

Список

curl -H "Authorization: Bearer $TYGY_API_KEY" \
  "https://api.tygy.ru/v1/meetings?limit=20"

Свежие сверху, выдача курсорная — как у диалогов и контактов.

Права

Ключ читает встречи всего проекта, поэтому создать его может только сотрудник, который сам видит все встречи. У встреч своя настройка видимости, отдельная от диалогов, и проверяется она отдельно.

Расшифровка — самое чувствительное, что остаётся от разговора, поэтому область доступа требует и права на встречи, и права на расшифровки. Сотрудник, у которого есть только первое, такой ключ не создаст.