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

---

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

• Контакты

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

  • Список контактов

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

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

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

  • Задача для контакта

• Сделки

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

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

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

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

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

  • Значение доп. поля

  • Заметка для сделки

  • Задача для сделки

---

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

Начать чат с оператором через AmoCRM.

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

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

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

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

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

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

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

Контакты

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

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

Создать контакт в AmoCRM.

{% amo.create_contact <поля контакта> need_save=True as contact %}

• need_save (bool) * – Сохранить ID контакта в атрибутах (по умолчанию False)

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

• first_name (str) – Имя

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

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

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

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

Список контактов

Получить список контактов из AmoCRM.

{% amo.get_contacts_by_phone_number phone_number=<телефон> need_save=True as contacts %}

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

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

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

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

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

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

• need_save (bool) * – Сохранить ID контакта в атрибутах (по умолчанию False)

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

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

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

• need_save (bool) * – Сохранить ID контакта в атрибутах (по умолчанию False)

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

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

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

• need_save (bool) * – Сохранить ID контакта в атрибутах (по умолчанию False)

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

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

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

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

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

• need_save (bool) * – Сохранить ID контакта в атрибутах (по умолчанию False)

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

• first_name (str) – Имя

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

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

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

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

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

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

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

• need_save (bool) * – Сохранить ID контакта в атрибутах (по умолчанию False)

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

• first_name (str) – Имя

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

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

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

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

{% amo.edit_contact_by_email email=<почта> as contact %}

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

• need_save (bool) * – Сохранить ID контакта в атрибутах (по умолчанию False)

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

• first_name (str) – Имя

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

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

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

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

Получить список дополнительных (кастомных) полей контакта в AmoCRM.

{% amo.get_contact_custom_fields limit=100 as custom_fields %}

• limit (int) * – Ограничение на кол-во полей в ответе (по умолчанию 100)

Задача для контакта

Создать задачу, связанную с контактом в AmoCRM.

{% amo.create_task contact_id=<id контакта> text=<задача> due_at=<дедлайн> as task %}

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

• text (str) * – Содержание задачи

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

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

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

Сделки

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

Новая сделка

Создать сделку в AmoCRM.

{% amo.create_deal <параметры> is_unsorted=False as deals %}

• is_unsorted (bool) * – Создать сделку в "Неразобранном" (по умолчанию False)

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

• name (str) – Название

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

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

• pipeline_id (int) – Идентификатор шага (этапа)

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

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

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

• tags (list[int]) – Список тегов

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

• Чтобы создать сделку в "Неразобранном", в процедуре не должно быть параметров status_id и responsible_id, убедитесь, что вы их не используете.

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

Получить список сделок из AmoCRM.

{% amo.get_deals query=<value> <параметры> limit=100 as deals %}

• query (str) * – Параметры запроса

• limit (int) * – Ограничение на кол-во сделок в ответе (по умолчанию 100, не больше 250)

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

• exclude_status_ids (set[int] или list[int]) – Статусы, которые нужно исключить из ответа

Поиск сделки

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

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

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

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

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

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

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

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

• name (str) – Название сделки

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

• pipeline_id (int) – Идентификатор шага (этапа)

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

• tags (list[int]) – Список тегов

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

Получить список дополнительных (кастомных) полей для сделки в AmoCRM.

{% amo.get_deal_custom_fields limit=100 as custom_fields %}

• limit (int) * – Ограничение на кол-во полей в ответе (по умолчанию 100)

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

Значение доп. поля

Фильтр, чтобы получить значение дополнительного (кастомного) поля для сделки в AmoCRM.

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

Заметка для сделки

Создать заметку, связанную со сделкой в AmoCRM.

{% amo.create_note deal_id=<id сделки> text=<текст заметки> <параметры> as note %}

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

• text (str) * – Содержание заметки

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

• owner_id (int) – Идентификатор создателя заметки

Задача для сделки

Создать задачу, связанную со сделкой в AmoCRM.

{% amo.create_task deal_id=<id сделки> text=<текст задачи> due_at=<дедлайн> as task %}

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

• text (str) * – Содержание задачи

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

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

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