﻿---
title: "Битрикс24 и Яндекс Телемост: встречи из сделки и задачи"
description: Как ссылка на видеовстречу Телемоста создаётся из сделки, задачи или автоматизации Битрикс24 и чем этот сценарий отличается от Telemost API.
---

**Кратко:** из карточки сделки, задачи или автоматизации Битрикс24 создаётся ссылка на видеовстречу
Яндекс Телемоста; ссылка и история встреч остаются в таймлайне. Собственная интеграция на Telemost API
— отдельный путь с приложением, токеном и правами. Уровень проверки `documented`.

## Кратко

- **Задача:** назначать видеовстречи с клиентом из CRM, не переключаясь в другой сервис и не теряя
  ссылку.
- **Что проверено:** создание встречи из сделки, задачи и автоматизации, хранение истории в таймлайне,
  запись встречи, ограничение в 40 участников, права и endpoints Telemost API.
- **Уровень:** documented — справка Битрикс24 и документация Telemost API.
- **Что не проверено:** поведение конкретного тарифа Яндекс 360 и условия подписки на приложение.

## Когда нужна интеграция

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

Обратные случаи:

- **Встречи редкие и разовые** — проще вставить ссылку вручную: автоматизация не окупится.
- **Нужна только переписка** — это каналы MAX, Telegram или ВКонтакте:
  [Битрикс24 и MAX](https://wpcraft.ru/integrations/bitrix24/max.md), [Битрикс24 и Telegram](https://wpcraft.ru/integrations/bitrix24/telegram.md).
- **Нужны вебинары и трансляции на внешнюю аудиторию** — это отдельный сценарий Телемоста, а не
  интеграция с CRM.

## Сценарии

### Встреча из сделки → ссылка в таймлайне

- **Событие:** менеджер нажимает «Процессы» в карточке сделки и назначает встречу.
- **Направление:** Битрикс24 → Телемост → Битрикс24.
- **Сущности:** сделка, встреча, ссылка, участники.
- **Результат:** ссылка сформирована и сохранена в таймлайне сделки; клиент и коллеги переходят по ней.

### Встреча из задачи → ссылка в описании

- **Событие:** руководитель добавляет видеовстречу в задачу или отдельное поле.
- **Направление:** Битрикс24 → Телемост → Битрикс24.
- **Сущности:** задача, встреча, ссылка, исполнитель.
- **Результат:** команда присоединяется по ссылке из задачи, а встреча остаётся связанной с работой.

### Автоматизация → ссылка на встречу по стадии

- **Событие:** сделка переходит на стадию, где нужна презентация или демонстрация.
- **Направление:** Битрикс24 → Телемост.
- **Сущности:** стадия, робот или бизнес-процесс, встреча, ссылка.
- **Результат:** ссылка создаётся автоматически и сохраняется в сделке; менеджеру остаётся отправить её
  клиенту.

### Своя интеграция → создание и обновление через API

- **Событие:** CRM или внешний сервис вызывает Telemost API при переносе или отмене встречи.
- **Направление:** ваша система → Telemost API → Битрикс24.
- **Сущности:** встреча, права приложения, ссылка, статус.
- **Результат:** встреча создаётся, читается или изменяется по API, а ссылка и статус записываются в
  карточку; для этого нужны права `conferences.create`, `conferences.read`, `conferences.update`.

## Триггеры и действия

| Событие в Битрикс24 | Действие в Телемосте | Примечание |
| --- | --- | --- |
| Назначение встречи в сделке | Создание комнаты и ссылки | Штатное приложение |
| Встреча в задаче | Создание комнаты и ссылки | Ссылка остаётся в задаче |
| Смена стадии | Создание ссылки роботом | Настройка автоматизации |
| Отмена или перенос | Изменение встречи | Через приложение или API |

| Событие в Телемосте | Действие в Битрикс24 | Примечание |
| --- | --- | --- |
| Встреча проведена | Запись в истории таймлайна | Ссылка и факт встречи сохраняются |
| Запись сохранена | Файл остаётся у Телемоста | Автоматической загрузки в CRM нет |
| Изменение параметров через API | Обновление поля или комментария | Только в собственной интеграции |

## Варианты реализации

- **Приложение «Интеграция: Яндекс.Телемост»** — готовый сценарий: ссылка из сделки, задачи и
  автоматизации, история в таймлайне. Требует подписки и аккаунта Яндекс 360 для бизнеса.
- **Собственная интеграция на Telemost API** — приложение с правами на создание, чтение и изменение
  встреч. Подходит, когда CRM не Битрикс24 или правила нестандартные.
- **Ручная ссылка** — минимальный старт без интеграции; история и автоматизация при этом теряются.
- **iPaaS** — может связать событие CRM с вызовом API, но добавляет внешнюю логику и секреты вне
  вашего контура.

## Данные и соответствие полей

| Данные в Битрикс24 | Куда попадают в Телемост | Ключ соответствия | Примечание |
| --- | --- | --- | --- |
| Сделка или задача | Название встречи | Идентификатор элемента | Нужен для истории |
| Участники | Приглашённые | — | Приложение заявляет до 40 участников |
| Дата и время | Параметры встречи | — | Проверяются в календаре |
| Ссылка | Таймлайн и поле карточки | — | Основной результат связки |
| Запись | Файл у Телемоста | — | В CRM автоматически не попадает |

**Владелец данных:** Битрикс24 владеет сделкой, задачей и историей коммуникаций; Телемост — самой
встречей, ссылкой и записью. Копировать запись в CRM без отдельного решения не нужно.

## Перед запуском

- [ ] Проверить аккаунт «Яндекс 360 для бизнеса» и доступность Телемоста сотрудникам.
- [ ] Оформить подписку на приложение, если используется готовый сценарий.
- [ ] Для своей интеграции создать приложение и получить права `conferences.create`,
      `conferences.read`, `conferences.update`.
- [ ] Определить, на каких стадиях ссылка создаётся автоматически.
- [ ] Проверить, куда сохраняется ссылка: таймлайн, поле сделки или описание задачи.
- [ ] Прогнать на staging: создание, перенос, отмена встречи и повторное открытие ссылки.

## Ограничения и надёжность

- **Два продукта.** Приложение и API не взаимозаменяемы: у них разные условия, права и точки отказа.
- **Один аккаунт.** Приложение работает через один аккаунт Яндекс 360 для бизнеса; несколько аккаунтов
  требуют отдельной схемы.
- **Запись.** Видеофайл остаётся у Телемоста: в CRM автоматически попадает ссылка и история, а не сам
  файл.
- **Права API.** Без нужного права endpoint вернёт ошибку; права выдаются приложению при регистрации.
- **Тариф и подписка.** Условия и лимиты меняются у вендора: перед запуском они фиксируются по
  актуальной странице продукта.
- **Ссылка живёт отдельно.** Если встречу отменили в Телемосте, карточка CRM не узнает об этом сама,
  пока интеграция не обновит статус.

## Вопросы и ответы

**Нужен ли код?**
Для ссылки из сделки или задачи — нет, достаточно приложения. Код нужен для своей интеграции на
Telemost API.

**Где хранится запись встречи?**
У Телемоста. В Битрикс24 остаются ссылка и история; для хранения файла в CRM нужно отдельное решение.

**Можно ли использовать другой аккаунт Яндекс 360?**
Приложение подключается к одному аккаунту; несколько аккаунтов проектируются отдельно.

**Как проверить, что связка работает?**
Создать встречу из сделки, открыть ссылку в другом браузере, проверить запись в таймлайне и отмену
встречи.

## Источники

- [Битрикс24: интеграции с Яндекс](https://helpdesk.bitrix24.ru/open/26367508/)
- [Яндекс Телемост API: видеовстречи и трансляции](https://yandex.ru/dev/telemost/doc/ru/conferences/)