Запланировать звонок

Активити (робот) "Запланировать звонок" предназначено для использования в роботах и может быть полезно в следующих сценариях:

Автоматическое планирование звонков клиентам;
Создание запланированных звонков при изменении статуса сделки или лида;
Планирование звонков на основе данных из внешних систем;
Автоматическое создание звонков при поступлении заявок;
Планирование звонков с автоматическим определением номера телефона;
Создание звонков, привязанных к сделке с автоматическим определением контакта или компании;
Автоматизация планирования звонков для менеджеров;
Создание звонков с указанием даты и времени;
Планирование звонков с приоритетом;
Автоматическое создание звонков при выполнении определённых условий.

Как работает активити (робот):
- Активити (робот) создаёт новое дело типа "Звонок" с указанными параметрами;
- Поддерживается автоматическое определение номера телефона из сущности (лид, контакт, компания), если номер не указан;
- Можно указать номер телефона напрямую или использовать номер из сущности;
- Поддерживается привязка звонка к сделке с автоматическим определением контакта или компании сделки;
- Можно указать тему, описание, ответственного, приоритет, даты начала и завершения;
- Активити (робот) работает через REST API Битрикс24 (crm.activity.add);
- Поддерживается работа с лидами, контактами, компаниями и сделками.

Сценарий работы активити (робота) бизнес-процесса

Описание параметров активити (робота)

Название поля	Описание и примеры использования
Тип сущности	В данном поле указывается тип сущности, к которой будет привязан создаваемый звонок. Это обязательный параметр. Выбирается из выпадающего списка. Варианты выбора: - Лид (1) - для привязки звонка к лиду; - Контакт (3) - для привязки звонка к контакту; - Компания (4) - для привязки звонка к компании. Примеры использования: - Лид (1) - для создания звонка, привязанного к лиду; - Контакт (3) - для создания звонка, привязанного к контакту; - Компания (4) - для создания звонка, привязанного к компании. Важно: Если указан параметр "ID сделки", то параметр "Тип сущности" используется только для определения типа сущности, из которой будет взят номер телефона (контакт или компания сделки).
ID Сущности	В данном поле указывается числовой идентификатор (ID) сущности, к которой будет привязан создаваемый звонок. Это обязательный параметр, используется только если не указан параметр "ID сделки". Примеры: - {=Document:ID} - привязать звонок к текущей сущности из документа (лид, контакт, компания); - 123 - привязать звонок к сущности с ID 123; - {=Variable:LEAD_ID} - использовать ID из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_results} - использовать ID из результата поиска (первый элемент массива); - {=Iterator:Value} - использовать ID для каждого элемента в итераторе. Важно: Убедитесь, что указанный ID соответствует выбранному типу сущности. Если ID не существует или не соответствует типу, активити (робот) завершится с ошибкой.
ID сделки	В данном поле можно указать идентификатор сделки, к которой будет привязан создаваемый звонок. Это необязательный параметр. Если указан, то звонок будет привязан к сделке, а номер телефона будет взят из контакта или компании, привязанных к сделке. Примеры: - {=Document:ID} - привязать звонок к текущей сделке из документа; - 123 - привязать звонок к сделке с ID 123; - {=Variable:DEAL_ID} - использовать ID из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_results} - использовать ID из результата поиска. Особенности работы: - Если указан ID сделки, звонок будет привязан к сделке, а не к указанной сущности; - Номер телефона будет автоматически взят из контакта или компании, привязанных к сделке (в зависимости от типа сущности); - Если у сделки нет привязанного контакта или компании, активити (робот) завершится с ошибкой. Важно: Если указан ID сделки, то параметр "ID Сущности" игнорируется. Номер телефона будет взят из контакта или компании сделки в зависимости от типа сущности. Если у сделки нет привязанного контакта (для типа "Контакт") или компании (для типа "Компания"), активити (робот) завершится с ошибкой.
Телефон	В данном поле можно указать номер телефона для звонка. Это необязательный параметр. Если не указан, номер телефона будет автоматически взят из сущности (лид, контакт, компания) или из контакта/компании сделки. Примеры: - +79161234567 - указать номер телефона напрямую; - 89161234567 - указать номер без префикса; - {=Document:PHONE} - использовать номер телефона из текущей сущности; - {=Variable:PHONE_NUMBER} - использовать номер из переменной предыдущего активити (робота). Особенности работы: - Если номер телефона указан, он будет использован напрямую; - Если номер телефона не указан, активити (робот) автоматически возьмёт номер из сущности: * Для лида - из поля PHONE лида; * Для контакта - из поля PHONE контакта; * Для компании - из поля PHONE компании; * Для сделки - из поля PHONE контакта или компании сделки (в зависимости от типа сущности). Важно: Если номер телефона не указан и не найден в сущности, активити (робот) завершится с ошибкой "Отсутствует номер телефона".
Тема	В данном поле указывается тема (заголовок) звонка. Это обязательный параметр. Примеры: - Звонок клиенту по сделке #{=Document:ID}; - Консультация по продукту; - Напоминание о встрече; - ={{={=Variable:SUBJECT} & " - Дополнительная информация"}} - добавить информацию к теме из переменной. Рекомендации: - Используйте информативные темы, которые помогут быстро понять суть звонка; - Можно включать переменные и поля из текущей сущности для персонализации.
Описание	В данном поле указывается описание и содержание звонка. Это обязательный параметр. Примеры: - Необходимо обсудить условия сделки и ответить на вопросы клиента.; - Провести консультацию по продукту. Клиент заинтересован в функциях X и Y.; - Напомнить о предстоящей встрече и уточнить детали.; - ={{={=Variable:DESCRIPTION} & "[br]Дополнительная информация: " & {=Variable:ADDITIONAL_INFO}}}} - объединить несколько переменных с форматированием. Рекомендации: - Используйте подробные описания для лучшего понимания цели звонка; - Можно включать переменные и поля из текущей сущности для персонализации.
Ответственный	В данном поле указывается сотрудник, ответственный за выполнение звонка. Это обязательный параметр. Примеры: - {=Document:ASSIGNED_BY_ID} - назначить ответственным ответственного из текущей сущности; - {=User:ID} - назначить ответственным текущего пользователя; - [U1] - назначить ответственным пользователя с ID 1; - user_25 - назначить ответственным пользователя с ID 25; - {=Variable:RESPONSIBLE_ID} - использовать ID из переменной предыдущего активити (робота). Рекомендации: - Используйте ответственного из текущей сущности для автоматического назначения; - Можно назначать конкретного сотрудника для специализированных звонков.
Приоритет	В данном поле можно указать приоритет звонка. Это необязательный параметр (варианты: да/нет). Варианты выбора: - Нет (N) - обычный приоритет; - Да (Y) - высокий приоритет (важный звонок). Примеры использования: - Нет (N) - для обычных звонков; - Да (Y) - для важных звонков, требующих срочного выполнения. Рекомендации: - Используйте высокий приоритет только для действительно важных звонков; - Высокоприоритетные звонки выделяются в интерфейсе CRM.
Дата начала	В данном поле можно указать дату и время начала звонка. Это необязательный параметр. Если не указано, дата начала не будет установлена. Примеры: - {=System:NowLocal} - установить текущую дату и время; - ={{=dateadd({=System:Now}, "1d")}} - установить дату начала через 1 день от текущего момента; - ={{=workdateadd({=System:Now}, "2d", {=Document:ASSIGNED_BY_ID})}} - установить дату начала через 2 рабочих дня с учётом рабочего времени ответственного; - ={{=dateadd({=Document:BEGINDATE}, "1h")}} - установить дату начала через 1 час от даты начала сделки; - 15.01.2025 10:00:00 - указать конкретную дату и время. Рекомендации: - Используйте функции работы с датами для автоматического расчёта времени начала; - Учитывайте рабочие дни и часы при планировании звонков.
Дата завершения	В данном поле можно указать дату и время завершения звонка. Это необязательный параметр. Если не указано, дата завершения не будет установлена. Примеры: - ={{=dateadd({=System:Now}, "30m")}} - установить дату завершения через 30 минут от текущего момента (типичная длительность звонка); - ={{=workdateadd({=System:Now}, "1d", {=Document:ASSIGNED_BY_ID})}} - установить дату завершения через 1 рабочий день с учётом рабочего времени ответственного; - ={{=dateadd({=Variable:DATE_START}, "1h")}} - установить дату завершения через 1 час от даты начала (из переменной); - ={{=dateadd({=Document:CLOSEDATE}, "-1d")}} - установить дату завершения на 1 день раньше даты закрытия сделки; - 15.01.2025 10:30:00 - указать конкретную дату и время завершения. Рекомендации: - Дата завершения должна быть позже даты начала; - Используйте функции работы с датами для автоматического расчёта времени завершения; - Типичная длительность звонка составляет 15-30 минут.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Примеры использования активити (робота)

Описание примера	Решение
Планирование звонка лиду	Параметры: Тип сущности - Лид (1), ID Сущности - {=Document:ID}, ID сделки - не указывается, Телефон - не указывается (будет взят из лида), Тема - "Звонок по заявке #{=Document:ID}", Описание - "Необходимо связаться с клиентом для уточнения деталей заявки", Ответственный - {=Document:ASSIGNED_BY_ID}, Приоритет - Нет (N), Дата начала - ={{=dateadd({=System:Now}, "1d")}}, Дата завершения - ={{=dateadd({=System:Now}, "1d 30m")}}.
Планирование звонка контакту с указанием номера	Параметры: Тип сущности - Контакт (3), ID Сущности - {=Document:ID}, ID сделки - не указывается, Телефон - +79161234567, Тема - "Консультация по продукту", Описание - "Провести консультацию по продукту и ответить на вопросы клиента", Ответственный - {=User:ID}, Приоритет - Да (Y), Дата начала - {=System:NowLocal}, Дата завершения - ={{=dateadd({=System:Now}, "30m")}}.
Планирование звонка по сделке с автоматическим определением контакта	Параметры: Тип сущности - Контакт (3), ID Сущности - {=Document:CONTACT_ID}, ID сделки - {=Document:ID}, Телефон - не указывается (будет взят из контакта сделки), Тема - "Звонок по сделке #{=Document:ID}", Описание - "Обсудить условия сделки и ответить на вопросы клиента", Ответственный - {=Document:ASSIGNED_BY_ID}, Приоритет - Нет (N), Дата начала - ={{=workdateadd({=System:Now}, "1d", {=Document:ASSIGNED_BY_ID})}}, Дата завершения - ={{=workdateadd({=System:Now}, "1d 30m", {=Document:ASSIGNED_BY_ID})}}.
Планирование звонка компании	Параметры: Тип сущности - Компания (4), ID Сущности - {=Document:ID}, ID сделки - не указывается, Телефон - не указывается (будет взят из компании), Тема - "Звонок в компанию {=Document:TITLE}", Описание - "Связаться с компанией для обсуждения сотрудничества", Ответственный - {=Document:ASSIGNED_BY_ID}, Приоритет - Да (Y), Дата начала - ={{=dateadd({=System:Now}, "2d")}}, Дата завершения - ={{=dateadd({=System:Now}, "2d 30m")}}.
Планирование звонка по сделке с автоматическим определением компании	Параметры: Тип сущности - Компания (4), ID Сущности - {=Document:COMPANY_ID}, ID сделки - {=Document:ID}, Телефон - не указывается (будет взят из компании сделки), Тема - "Звонок по сделке #{=Document:ID}", Описание - "Обсудить условия сделки с представителем компании", Ответственный - {=Document:ASSIGNED_BY_ID}, Приоритет - Нет (N), Дата начала - ={{=workdateadd({=System:Now}, "1d", {=Document:ASSIGNED_BY_ID})}}, Дата завершения - ={{=workdateadd({=System:Now}, "1d 30m", {=Document:ASSIGNED_BY_ID})}}.
Планирование срочного звонка	Параметры: Тип сущности - Контакт (3), ID Сущности - {=Document:ID}, ID сделки - не указывается, Телефон - не указывается, Тема - "Срочный звонок клиенту", Описание - "Необходимо срочно связаться с клиентом", Ответственный - {=User:ID}, Приоритет - Да (Y), Дата начала - {=System:NowLocal}, Дата завершения - ={{=dateadd({=System:Now}, "30m")}}.
Планирование звонка через итератор	Параметры: Тип сущности - Контакт (3), ID Сущности - {=Iterator:Value}, ID сделки - не указывается, Телефон - не указывается, Тема - "Звонок контакту #{=Iterator:Value}", Описание - "Связаться с контактом для обсуждения", Ответственный - {=User:ID}, Приоритет - Нет (N), Дата начала - ={{=dateadd({=System:Now}, "1d")}}, Дата завершения - ={{=dateadd({=System:Now}, "1d 30m")}}. Для каждого контакта из итератора будет создан запланированный звонок.
Планирование звонка с указанием конкретного времени	Параметры: Тип сущности - Контакт (3), ID Сущности - {=Document:ID}, ID сделки - не указывается, Телефон - не указывается, Тема - "Запланированный звонок", Описание - "Звонок запланирован на конкретное время", Ответственный - {=Document:ASSIGNED_BY_ID}, Приоритет - Нет (N), Дата начала - 15.01.2025 10:00:00, Дата завершения - 15.01.2025 10:30:00.
Планирование звонка при изменении статуса сделки	Параметры: Тип сущности - Контакт (3), ID Сущности - {=Document:CONTACT_ID}, ID сделки - {=Document:ID}, Телефон - не указывается, Тема - "Звонок по сделке в статусе '{=Document:STAGE_ID}'", Описание - "Сделка переведена в новый статус. Необходимо связаться с клиентом", Ответственный - {=Document:ASSIGNED_BY_ID}, Приоритет - Да (Y), Дата начала - ={{=workdateadd({=System:Now}, "1d", {=Document:ASSIGNED_BY_ID})}}, Дата завершения - ={{=workdateadd({=System:Now}, "1d 30m", {=Document:ASSIGNED_BY_ID})}}.
Планирование звонка с номером из переменной	Параметры: Тип сущности - Контакт (3), ID Сущности - {=Document:ID}, ID сделки - не указывается, Телефон - {=Variable:PHONE_NUMBER}, Тема - "Звонок на указанный номер", Описание - "Связаться с клиентом по указанному номеру телефона", Ответственный - {=User:ID}, Приоритет - Нет (N), Дата начала - {=System:NowLocal}, Дата завершения - ={{=dateadd({=System:Now}, "30m")}}.

Сценарий работы робота

Важно! Ограничения и рекомендации:

Обязательные параметры:
Для успешного создания запланированного звонка обязательно должны быть заполнены следующие параметры:
- Тип сущности;
- ID Сущности (если не указан ID сделки);
- Тема;
- Описание;
- Ответственный.

Работа с номером телефона:
Если номер телефона не указан, активити (робот) автоматически возьмёт номер из сущности (лид, контакт, компания) или из контакта/компании сделки. Если номер телефона не найден, активити (робот) завершится с ошибкой "Отсутствует номер телефона". Рекомендуется всегда указывать номер телефона или убедиться, что он есть в сущности.

Привязка к сделке:
Если указан параметр "ID сделки", звонок будет привязан к сделке, а не к указанной сущности. Номер телефона будет автоматически взят из контакта или компании сделки в зависимости от типа сущности. Если у сделки нет привязанного контакта (для типа "Контакт") или компании (для типа "Компания"), активити (робот) завершится с ошибкой.

Ограничения по типам сущностей:
Активити (робот) поддерживает работу только с лидами (1), контактами (3) и компаниями (4). Для других типов сущностей (сделки, предложения, заказы и т.д.) используйте параметр "ID сделки" для привязки звонка к сделке с автоматическим определением контакта или компании.

Ограничение одновременной привязки:
Не допускается одновременная привязка звонка к лиду и сделке. Если указан тип сущности "Лид" и параметр "ID сделки", активити (робот) завершится с ошибкой "В данном активити не допускается одновременная привязка звонка к Лиду и Сделке".

Права доступа:
Убедитесь, что пользователь, указанный в поле "Запускать от имени", имеет права на создание дел в CRM. Рекомендуется использовать пользователя с правами администратора системы.

Обработка ошибок:
Если сущность с указанным ID не существует, номер телефона не найден, или произошла другая ошибка, активити (робот) завершится с соответствующей ошибкой. Всегда проверяйте существование сущности и наличие номера телефона перед созданием звонка.

Использование в итераторе:
Для массового планирования звонков рекомендуется использовать итератор. Это позволит создать звонки для всех элементов последовательно. Учитывайте ограничения API Битрикс24 по количеству запросов при работе с большим количеством элементов.

Производительность:
Создание запланированного звонка требует выполнения запросов к REST API Битрикс24. При работе с большим количеством звонков через итератор учитывайте ограничения по количеству запросов к API. Используйте параметр "Делать отладочные сообщения в журнал БП" только при необходимости для уменьшения нагрузки на систему.

Ваша корзина пуста

Запланировать звонок