# Действия OpenCart

Перед добавлением действий подключите OpenCart и убедитесь, что магазин отображается в разделе Интеграции.

# Настройка бота

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

Например, код способа оплаты может быть cod, а код способа доставки — flat.flat. Используйте значения, настроенные именно в вашем магазине.

# Найти товары

Ищет товары по запросу клиента. Поиск выполняется по:

• названию;
• модели;
• артикулу SKU;
• значению опции.

В ответ бот получает найденные товары и их идентификаторы. Используйте product_id выбранного товара для следующего действия.

Пример: клиент спрашивает о наличии белой футболки. Бот выполняет поиск и предлагает только товары, найденные в OpenCart.

# Получить товар

Возвращает актуальные сведения о выбранном товаре:

• название и описание;
• модель и артикул;
• цену и остаток;
• варианты и опции.

Для выполнения действия нужен product_id, полученный при поиске.

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

Находит существующий заказ по номеру и возвращает доступные сведения о нём. Для выполнения действия нужен order_id.

Пример: клиент сообщает номер заказа. Бот проверяет заказ в OpenCart и отвечает только на основании полученных данных.

# Создать заказ

Создаёт новый заказ после того, как клиент подтвердил его состав и условия. Перед вызовом действия бот должен собрать:

• товары, количество и выбранные опции;
• имя и фамилию клиента;
• email и телефон;
• платёжный адрес;
• адрес доставки;
• страну и регион;
• способ оплаты;
• способ доставки;
• комментарий, если он нужен.

Перед сохранением OpenCart повторно проверяет товары, цены и остатки. Повторный технический запрос с тем же идентификатором не создаёт дубликат заказа.

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

1. Найдите товар по запросу клиента.
2. Получите его карточку и уточните вариант, цену и наличие.
3. Соберите контактные данные, адрес, способ оплаты и способ доставки.
4. Покажите клиенту состав заказа, количество и условия оформления.
5. Получите явное подтверждение.
6. Создайте заказ.
7. Сообщите об успешном оформлении только после подтверждённого ответа действия OpenCart.

Добавьте в инструкцию бота правило:

Не создавай заказ, пока клиент явно не подтвердил состав заказа, количество товаров, адрес и способ доставки. Не сообщай, что заказ создан, пока действие OpenCart не вернуло успешный результат.

# Как бот получает данные

Каталог не копируется в ChatRex. При каждом вызове действия бот получает актуальные данные непосредственно из подключённого магазина OpenCart.