Скилл RetailCRM в Aizor: как подключить и автоматизировать заказы и клиентов
Содержание
Коротко. Скилл RetailCRM позволяет ИИ-агенту Aizor работать с заказами, клиентами, каталогом, остатками, платежами и статусами вашей CRM. Для подключения нужен ключ API: его создают в RetailCRM в разделе «Интеграция» на вкладке «Ключи доступа к API». Ключу можно ограничить права. В документации RetailCRM цена за использование API не указана.
Что даёт скилл RetailCRM в Aizor
Официальное описание скилла от команды Aizor: заказы, клиенты и товары в RetailCRM, создание и обновление заказов, поиск и сегментация клиентов, работа с каталогом, остатками, платежами и статусами.
Проще говоря, вы пишете агенту в чате обычными словами, а он обращается к вашей CRM. Скилл будет полезен владельцу интернет-магазина, менеджеру по продажам и тому, кто каждый день ищет заказы по номеру, сверяет остатки или проверяет, какие оплаты ещё не пришли. О том, что такое Aizor, читайте на странице «Что такое Aizor».
Что понадобится
- Рабочая учётная запись RetailCRM. Адрес запроса к API в документации выглядит как
https://{your-subdomain}.retailcrm.ru/api/v5/, где вместо{your-subdomain}стоит имя вашей учётной записи. - Доступ к разделу «Интеграция» в настройках. Какая роль сотрудника нужна для создания ключа, документация не уточняет. Если раздела не видно, обратитесь к администратору вашей учётной записи.
- Приложение Aizor для macOS или Windows и скилл RetailCRM из каталога скиллов.
Нужен аккаунт Aizor? Скачивание бесплатное, промокод kalsin5 даёт −5% на каждое пополнение.
Открыть Aizor ↗Как получить ключ API: по шагам
- Откройте настройки RetailCRM и перейдите в раздел «Интеграция».
- Откройте вкладку «Ключи доступа к API». Здесь виден список созданных ключей.
- Нажмите «Добавить». Значение ключа сгенерируется автоматически.
- Выберите тип доступа: «Доступ ко всем магазинам» или «Доступ к отдельным магазинам» (тогда отметьте нужные магазины).
- В поле «Комментарий» напишите, для чего ключ, например «Агент Aizor». По комментарию ключи удобно искать в списке.
- В блоке «Разрешённые действия в API» оставьте только нужные группы данных и выберите для каждой «получение» и/или «изменение».
- Скопируйте ключ из формы создания. Позже он будет показан только в маскированном виде: первые 4 и последние 4 символа.
Срок действия ключа в документации не указан. В списке ключей видна дата последнего использования, эти данные хранятся 3 месяца. Затем установите скилл RetailCRM из каталога Aizor и вставьте ключ в его настройки. Обычно там же нужен адрес вашей учётной записи. Какие поля показывает карточка скилла, смотрите в самом приложении.
Проверка: первые запросы агенту
- «Покажи последние 5 заказов в моём RetailCRM» (только чтение).
- «Найди клиента по номеру телефона и покажи его заказы».
- «Какие остатки сейчас у этого товара?»
- «Создай тестовый заказ для клиента» (изменение: лучше включить подтверждение действий).
Попробовать на своём кабинете. Aizor скачивается бесплатно, есть тариф со своими API-ключами. Промокод kalsin5 даёт скидку 5% на пополнение баланса.
Сценарии автоматизации
Поиск заказа по запросу
Менеджер пишет агенту номер заказа или телефон клиента. Агент находит заказ, показывает состав, статус и оплату. Работает по запросу, ключу достаточно права на получение данных.
Утренний обзор по расписанию
Через планировщик Aizor агент может каждое утро собирать список заказов в нужных статусах и присылать его вам в чат или в Telegram-бота. Ключу нужны только права на чтение.
Сегментация клиентов
Вы просите найти клиентов по условию, например тех, кто давно не покупал. Агент подбирает список, а решение о рассылке остаётся за вами. Подробнее про такие задачи в статье «ИИ-агенты для бизнеса».
Создание и обновление заказов
Агент может завести заказ по описанию или сменить статус. Для этого ключу нужно право на изменение, а действие лучше пропускать через ручное подтверждение. В документации RetailCRM есть важное замечание: при загрузке заказов и клиентов в систему рекомендуют отключать триггеры, которые отправляют e-mail и SMS, чтобы клиенты не получили лишних сообщений.
Частые ошибки
| Что видите | Причина | Что делать |
|---|---|---|
"apiKey" is missing | Ключ не передан. | Проверьте, что ключ вставлен в настройки скилла. |
Wrong "apiKey" value | Ключ неверный или удалён. | Скопируйте ключ заново или создайте новый в разделе «Интеграция». |
Forbidden | Доступ к API ограничен по IP-адресам. | Проверьте ограничения по IP для вашей учётной записи. |
Account does not exist | Учётная запись не найдена. | Проверьте адрес (поддомен) учётной записи в настройках скилла. |
| Ответ 503 при частых запросах | Превышен лимит: 10 запросов в секунду с одного IP. | Попросите агента делать меньше запросов подряд и повторите позже. |
Безопасность
- Создайте отдельный ключ для агента с понятным комментарием. Так его легко найти и удалить, не затрагивая другие интеграции.
- Оставьте минимум прав. Для первых проверок хватит «получения» нужных групп данных. «Изменение» добавляйте, когда оно действительно нужно.
- Изменение заказов, платежей и клиентов лучше пускать через ручное подтверждение в Aizor.
- Не публикуйте ключ и не отправляйте его в чатах. Если ключ утёк, удалите его на вкладке «Ключи доступа к API» и создайте новый.
- Чаты и файлы Aizor хранятся на вашем устройстве. Подробнее о тарифах: цены Aizor.
Инструкция написана по официальной документации RetailCRM (docs.retailcrm.ru), состояние на октябрь 2026 года. Интерфейс кабинета и условия могут измениться. Автор Aizorlab участвует в партнёрской программе Aizor.
Читайте также
