#
InSales
Перед добавлением действий подключите InSales и проверьте домен магазина.
#
Получить товары
Возвращает сокращённый список доступных товаров. Используйте действие для просмотра каталога, когда боту не требуется точный поиск по запросу клиента.
#
Найти товар
Ищет товар по запросу пользователя. Подходит для сценария, в котором клиент указывает название, вид или характеристики нужного товара.
#
Получить товар
Возвращает выбранный товар, его варианты, цены, наличие и доступные характеристики. Перед оформлением заказа используйте идентификатор нужного варианта товара, а не только название товара.
#
Найти клиента
Ищет клиента одним из способов:
- по общему запросу;
- по номеру телефона;
- по email.
Сначала попробуйте найти клиента, чтобы не создавать дубликат.
#
Создать клиента
Создаёт клиента по данным из диалога. Перед вызовом действия получите как минимум:
- имя — переменная
name; - телефон — переменная
phone; - email, если он используется в вашем сценарии.
#
Получить заказ
Возвращает данные заказа по его идентификатору: состав, клиента, доставку, оплату, статус и итоговые значения.
#
Создать заказ
Создаёт заказ с выбранными товарами и данными клиента. При настройке действия обязательно:
- Выберите способ доставки.
- Выберите способ оплаты. Список содержит только способы, совместимые с выбранной доставкой.
- Проверьте переменные имени, телефона и адреса доставки.
- Сохраните действие и изменения бота.
Для выполнения действия боту нужны:
- имя клиента —
name; - телефон —
phone; - адрес доставки —
delivery_address; - варианты товаров;
- количество каждого товара.
При добавлении действия через шаблон или AI-помощника переменные name, phone и delivery_address создаются и привязываются автоматически. Если действие добавлено вручную, проверьте их наличие и привязку.
note
Способы доставки и оплаты выбираются в настройках действия заранее. Бот не выбирает произвольный способ во время диалога.
#
Рекомендуемая последовательность
- Найдите товар по запросу клиента.
- Получите карточку товара и уточните вариант, цену и наличие.
- Найдите клиента по телефону или email.
- Если клиент не найден, создайте его.
- Соберите имя, телефон и адрес доставки.
- Покажите клиенту товары, количество, стоимость и условия оформления.
- Получите явное подтверждение.
- Создайте заказ.
- Сообщите об успешном оформлении только после подтверждённого ответа действия.
Не повторяйте создание клиента или заказа вручную, если результат первого вызова неизвестен. Сначала проверьте данные в InSales или получите заказ по идентификатору, чтобы не создать дубликат.