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

---

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

• Контакты

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

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

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

• Сделки

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

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

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

---

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

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

{% retail.enable text=<Тест сообщения> %}

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

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

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

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

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

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

[ ✏️ ] Заметки:

• Если указать только text, то чат-сессия будет открыта с командой по умолчанию

Контакты

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

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

Процедура для создания нового контакта в RetailCRM:

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

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

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

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

• first_name (string) – Имя

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

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

Методы для процедуры:

• contact.id_done – метод для проверки результата создания контакта. Возвращает true, если контакт успешно создан, и false, если произошла ошибка.

Примеры:

Пример 1: Создать контакт в RetailCRM (только телефон)

{# Создать контакт в RetailCRM #}
{% retail.create_contact phone_number="[phone]" as contact %}

Пример 2: Создать контакт в RetailCRM (имя, телефон, почта)

{# Создать контакт в RetailCRM #}
{% retail.create_contact name="Олег" phone_number="[phone]" email="[e-mail]" as contact %}

Пример 3: Создать контакт в RetailCRM (имя, телефон, доп. поля)

{# Создать список доп. полей #}
{% createobj custom_fields %}
  {
    "field_1": "Значение 1",
    "field_1": "Значение 2"
  }
{% endcreateobj %}

{# Создать контакт в RetailCRM #}
{% retail.create_contact name="Олег" phone_number="[phone]" custom_fields=custom_fields as contact %}

Пример 4: Проверка результата с помощью метода is_done

{# Создать контакт в RetailCRM #}
{% retail.create_contact name="Олег" phone_number="[phone]" as contact %}

{# Проверка результата #}
{% if contact.is_done %}
  {% send_text "Контакт создан." %}
{% else %}
  {% send_text "Что-то пошло не так..." %}
{% endif %}

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

Ниже приведен список процедур для поиска информации о контакте в RetailCRM по одному из параметров: Идентификатор, Телефон или Почта.

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

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

• uid (integer) * – ID контакта в RetailCRM

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

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

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

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

{% retail.get_contact_by_email email=<Почта> as contact %}

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

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

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

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

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

• uid (integer) * – ID сделки в RetailCRM

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

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

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

• first_name (string) – Имя

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

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

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

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

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

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

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

• first_name (string) – Имя

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

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

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

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

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

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

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

• first_name (string) – Имя

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

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

Сделки

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

Новая сделка

Процедура создания сделки для контакта в RetailCRM.

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

• contact_id (integer) * – ID контакта в RetailCRM

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

• number (string) – Номер сделки

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

Поиск сделки

Процедура получения информации о сделке в RetailCRM по ее идентификатору:

{% retail.get_deal uid=<ID сделки> as contact %}

uid (integer) * – ID сделки в RetailCRM

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

Процедура изменения информации о сделке в RetailCRM по ее идентификатору:

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

• uid (integer) * – ID сделки в RetailCRM

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

• contact_id (integer) – ID контакта в RetailCRM

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