# Действия «Мой Класс»

Действия позволяют боту читать актуальные данные CRM «Мой Класс» и выполнять подтверждённые клиентом операции. Сначала подключите интеграцию.

# Как добавить действие

1. Откройте Мои боты и нажмите Изменить у нужного бота.
2. Перейдите на вкладку Интеграции и действия.
3. Включите Включить действия в боте.
4. Нажмите Добавить действие.
5. В блоке Что выполнить в результате нажмите Добавить действие.
6. В разделе Действия в интеграциях выберите источник Мой Класс.
7. Выберите нужную операцию и настройте параметры.

# Доступные действия

# Получить сотрудников

Возвращает сотрудников из «Мой Класс». Включите Фильтровать сотрудников, если бот должен работать только с выбранными сотрудниками.

# Получить программы

Возвращает учебные программы. Фильтр по программе позволяет ограничить выдачу заранее выбранными направлениями.

# Получить группы

Возвращает группы и связанные с ними сведения. Доступны фильтры:

• по группе;
• по программе;
• по филиалу.

Используйте это действие, когда клиент спрашивает о подходящих группах, стоимости, расписании, преподавателе или наличии мест.

# Получить занятия

Возвращает занятия. Список можно ограничить:

• занятием;
• группой;
• сотрудником;
• учеником;
• филиалом.

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

# Найти/Создать ученика

Ищет существующего ученика и при необходимости создаёт новую карточку.

Для поиска можно использовать ученика из списка, имя, телефон или email. Если включён поиск, выберите хотя бы один критерий. Телефон должен содержать не более 15 символов.

Чтобы создать ученика, включите При неуспешном поиске создать ученика. В блоке создания доступны:

• ФИО — обязательное поле, не более 100 символов;
• телефон — не более 15 символов;
• email — не более 100 символов;
• родитель — не более 100 символов;
• статус клиента;
• филиалы;
• ответственные сотрудники.

# Записать ученика в группу

Создаёт запись ученика в выбранную группу.

Обязательные параметры:

• Ученик;
• Группа;
• Статус записи.

Дополнительно можно указать программу, ответственного сотрудника, цену и комментарий. Цена не может быть отрицательной, комментарий — не более 1000 символов.

Перед записью подтвердите с клиентом выбранную группу и условия. ID ученика удобно получать действием Найти/Создать ученика.

# Получить записи в группы

Возвращает существующие записи учеников в группы. Доступны фильтры:

• филиал;
• группа;
• сотрудник;
• ученик;
• программа;
• статус записи.

# Получить задачи

Возвращает задачи из CRM. Их можно фильтровать по филиалу, группе, сотруднику, ученику и статусу выполнения. По умолчанию используется статус Не выполнена.

# Поставить задачу

Создаёт задачу сотруднику в «Мой Класс».

Обязательные параметры:

• Текст задачи — не более 250 символов;
• Начало задачи — дата и время;
• Окончание задачи — дата и время.

Дополнительно задачу можно связать с ответственными сотрудниками, учениками, группами и филиалами.

# Рекомендуемые последовательности

# Консультация по расписанию

1. Получить программы.
2. Получить группы по выбранной программе или филиалу.
3. Получить занятия для выбранной группы.
4. Ответить клиенту только данными, полученными из «Мой Класс» или базы знаний.

# Новая заявка

1. Получить имя и телефон клиента.
2. Найти/Создать ученика — сначала поиск по телефону.
3. Подтвердить программу и группу.
4. Записать ученика в группу.
5. Поставить задачу ответственному сотруднику.
6. Передать диалог сотруднику, если это предусмотрено сценарием бота.

# Проверка существующей записи

1. Найти ученика по телефону.
2. Вызвать Получить записи в группы с фильтром по ученику.
3. При необходимости получить связанные занятия или задачи.

# Настройка промпта

В основной цели и описании действия явно укажите:

• когда бот может создавать ученика или запись;
• какие данные нужно собрать до вызова;
• что клиент должен подтвердить;
• что делать, если поиск вернул несколько результатов или не вернул ничего;
• что внутренние ID и технические данные нельзя показывать клиенту.

Поля из разговора передавайте через переменные @. Перед публикацией проверьте сценарий в разделе Тестирование и убедитесь, что новые данные появились в «Мой Класс» без дублей.