Битрикс24: Процедуры для настройки сценариев

---

• Чат с оператором

• Контакты

  • Новый контакт

  • Поиск контакта

  • Изменение контакта

  • Поля контакта

• Сделки

  • Новая сделка

  • Список сделок

  • Поиск сделки

  • Изменение сделки

• Лиды

  • Новый лид

  • Поиск лида

  • Поиск поля

• Задачи

  • Новая задача

  • Список задач

  • Поиск задачи

  • Изменение задачи

---

Чат с оператором

Начать чат с оператором через Битрикс24.

{% bitrix.enable text=<Тест сообщения> <параметры> %}

• text (string) * – Текст сообщения

Параметры процедуры:

• team (string) – Название команды операторов в Fasttrack

• operator_email (string) – Почта оператора в Fasttrack

• lead_id (integer) – Идентификатор лида

• contact_id (integer) – Идентификатор контакта

[ ⚠️ ] Ограничения:

• Нельзя одновременно указывать team и operator_email

• Нельзя одновременно указывать lead_id и contact_id

Контакты

Процедуры для работы с контактами в Битрикс24.

Новый контакт

Создать контакт в Битрикс24.

{% bitrix.create_contact phone_number=<телефон> as contact %}

• phone_number (str) * – Номер телефона

Поля для заполнения:

• email (str) – Адрес электронной почты

• first_name (str) – Имя

• last_name (str) – Фамилия

• custom_fields (dict) – Дополнительные поля

Поиск контакта

Получить информацию о контакте в AmoCRM по его id, телефону или почте.

Найти контакт по ID

{% bitrix.get_contact_by_uid uid=<id контакта> as contact %}

• uid (int) * – Идентификатор контакта

Найти контакт по номеру телефона

{% bitrix.get_contact_by_phone_number phone_number=<телефон> as contact %}

• phone_number (str) * – Номер телефона

Найти контакт по адресу эл. почты

{% bitrix.get_contact_by_email email=<почта> as contact %}

• email (str) * – Адрес электронной почты

Изменение контакта

Редактировать информацию о контакте в AmoCRM по его id, телефону или почте.

Редактировать контакт по ID

{% bitrix.edit_contact_by_uid uid=<id контакта> <поля контакта> as contact %}

• uid (int) * – Идентификатор контакта

Поля для редактирования:

• first_name (str) – Имя

• last_name (str) – Фамилия

• custom_fields (dict) – Дополнительные поля

Редактировать контакт по номеру телефона

{% bitrix.edit_contact_by_phone_number phone_number=<телефон> <поля контакта> as contact  %}

• phone_number (str) * – Номер телефона

Поля для редактирования:

• first_name (str) – Имя

• last_name (str) – Фамилия

• custom_fields (dict) – Дополнительные поля

Редактировать контакт по адресу эл. почты

{% bitrix.edit_contact_by_email email=<почта> <поля контакта> as contact %}

• email (str) * – Адрес электронной почты

Поля для редактирования:

• first_name (str) – Имя

• last_name (str) – Фамилия

• custom_fields (dict) – Дополнительные поля

Поля контакта

Получить список всех полей, связанных с контактом в Битрикс24.

Информация в этом блоке обновляется.

Сделки

Процедуры для работы со сделками в Битрикс24.

Новая сделка

Создать сделку в Битрикс24.

{% bitrix.create_deal contact_id=<id контакта> <поля сделки> as deal %}

• contact_id (int) * – Идентификатор контакта

Поля для редактирования:

• title (str) – Заголовок

• custom_fields (dict) – Дополнительные поля

Список сделок

Получить список сделок, связанных с контактом в Битрикс24.

{% bitrix.get_deals contact_uid=<id контакта> as deals %}

• contact_uid (str) * – Идентификатор контакта

• stage (str) * – Статус

Поиск сделки

Получить информацию о сделке в Битрикс24.

{% bitrix.get_deal uid=<id сделки> as deal %}

• uid (int) * – Идентификатор сделки

Изменение сделки

Редактировать информацио о сделке в Битрикс24.

{% bitrix.edit_deal uid=<id сделки> <поля сделки> as deal %}

• uid (int) * – Идентификатор сделки

Поля для редактирования:

• stage_id (str) – Идентификатор статуса

• title (str) – Заголовок

• contact_id (int) – Идентификатор контакта

• custom_fields (dict) – Дополнительные поля

Лиды

Процедуры для работы с лидами в Битрикс24.

Новый лид

Создать лид в Битрикс24.

{% bitrix.create_lead title=<заголовок> <поля лида> as lead %}

• title (str) * – Заголовок

Поля для заполнения:

• status_id (str) – Идентификатор статуса

• first_name (str) – Имя

• last_name (str) – Фамилия

• phone_number (str) – Номер телефона

• email (str) – Адрес электронной почты

• telegram_username (str) – Имя пользователя в Telegram

• facebook_username (str) – Имя пользователя в Facebook

• vk_username (str) – Имя пользователя в VK

• skype_username (str) – Имя пользователя в Skype

• viber_username (str) – Имя пользователя в Viber

• instagram_username (str) – Имя пользователя в Instagram

• utm_campaign (str) – UTM campaign

• utm_content (str) – UTM content

• utm_medium (str) – UTM medium

• utm_source (str) – UTM source

• utm_term (str) – UTM term

• custom_fields (dict) – Дополнительные поля

Поиск лида

Получить информацио о лиде в Битрикс24.

{% bitrix.get_lead_by_uid uid=<id лида> as lead %}

• uid (int) * – Идентификатор лида

Изменение лида

Редактировать информацию о лиде в Битрикс24.

{% bitrix.edit_lead_by_uid uid=<id лида> <поля лида> as lead %}

• uid (int) * – Идентификатор лида

Поля для редактирования:

• telegram_username (str) – Имя пользователя в Telegram

• facebook_username (str) – Имя пользователя в Facebook

• vk_username (str) – Имя пользователя в VK

• skype_username (str) – Имя пользователя в Skype

• viber_username (str) – Имя пользователя в Viber

• instagram_username (str) – Имя пользователя в Instagram

• utm_campaign (str) – UTM campaign

• utm_content (str) – UTM content

• utm_medium (str) – UTM medium

• utm_source (str) – UTM source

• utm_term (str) – UTM term

• email (str) – Адрес электронной почты

• phone_number (str) – Номер телефона

• custom_fields (str) – Дополнительные поля

Поиск поля

Получить информацию о поле, которое связанно с лидом.

{% bitrix.get_lead_field name=<название поля> as lead_field %}

• name (str) * – Название поля

Задачи

Процедуры для работы с задачами в Битрикс24.

Новая задача

Создать задачу в Битрикс24.

{% bitrix.create_task responsible_id=<id ответственного> title=<заголовок> as task %}

• responsible_id (int) * – Идентификатор ответственного

• title (str) * – Заголовок задачи

Поля для заполнения:

• description (str) – Описание задачи

• deadline_at (datetime) – Срок выполнения

Список задач

Получить список задач из Битрикс24.

{% bitrix.get_tasks responsible_id=<id ответственного> as tasks %}

• responsible_id (int) * – Идентификатор ответственного

Поиск задачи

Получить информацию о задаче в Битрикс24.

{% bitrix.get_task uid=<id задачи> as task %}

• responsible_id (int) * – Идентификатор ответственного

Изменение задачи

Редактировать информацию об ответственом для задачи в Битрикс24.

{% bitrix.edit_task uid=<id задачи> responsible_id=<id ответственного> as task %}

• responsible_id (int) * – Идентификатор ответственного