# alfaCRM

Сначала подключите alfaCRM.

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

• Получить филиалы — возвращает филиалы, с которыми может работать бот; это начальное действие для остальных запросов.
• Получить предметы обучения — возвращает доступные направления и предметы.
• Получить уроки — получает обычные или регулярные занятия в зависимости от выбранного формата.
• Получить преподавателей — возвращает преподавателей выбранного филиала; список можно фильтровать по типу урока, преподавателю и предмету.
• Найти/создать клиента — ищет клиента по телефону или email, возвращает ID и выбранные поля, а при включённой настройке создаёт новую карточку.
• Записать на урок — записывает клиента в существующий урок, всегда создаёт новый либо сначала пробует существующий и при невозможности создаёт новый.

# Найти или создать клиента

1. Выберите поисковый критерий: телефон или email.
2. Передайте значение вручную или через переменную @.
3. Выберите данные карточки, которые нужно вернуть боту. ID клиента возвращается всегда.
4. Если нужно, включите При неуспешном поиске создавать клиента и заполните данные новой карточки.

Полученный ID используйте в действии Записать на урок.

# Записать на урок

В параметре Способ записи на урок доступны три режима:

• Записать в существующий урок — укажите ID урока;
• Всегда создавать новый урок — задайте тип урока, преподавателя и предмет;
• Записать в существующий, иначе создать новый — передайте ID и параметры нового урока на случай, если запись в существующий невозможна.

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

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

1. Определить филиал.
2. Получить предмет или урок.
3. Получить подходящих преподавателей.
4. Собрать данные ученика и подтвердить выбор.
5. Вызвать Записать на урок.

Не создавайте запись, пока бот не знает филиал, урок, преподавателя и необходимые контактные данные.