Перейти к основному содержимому

Подключение RetailCRM

RetailCRM — это специализированная облачная CRM-система для интернет-магазинов. Интеграция с Botobot позволяет автоматически синхронизировать заказы и их статусы между двумя системами.

🎯 Что даёт интеграция​

  • Автоматическая передача заказов — все новые заказы из Telegram-бота сразу появляются в RetailCRM
  • Синхронизация статусов — изменения статусов заказов синхронизируются каждые 5 минут
  • Единая база клиентов — вся информация о покупателях в одном месте
  • Удобство для менеджеров — работа с заказами в привычном интерфейсе CRM

📋 Требования​

Для подключения интеграции вам понадобится:

  • Действующий аккаунт в RetailCRM
  • Доступ к настройкам интеграции в RetailCRM
  • Активная подписка Botobot

⚙️ Настройка интеграции​

Шаг 1: Регистрация в RetailCRM​

Если у вас ещё нет аккаунта в RetailCRM:

  1. Перейдите на retailcrm.ru
  2. Зарегистрируйте аккаунт
  3. Пройдите базовую настройку системы

Шаг 2: Создание API-ключа в RetailCRM​

Для подключения Botobot к RetailCRM нужен API-ключ:

  1. Войдите в свой аккаунт RetailCRM
  2. Перейдите в раздел Администрирование → Интеграция → Ключи доступа к API
  1. Нажмите кнопку "Добавить"
  2. В открывшейся форме:
    • Укажите название ключа (например, "Botobot")
    • Выберите доступ к нужному магазину
    • Отметьте необходимые права доступа
  1. Нажмите "Сохранить"
  2. Скопируйте созданный API-ключ — он понадобится на следующем шаге

Шаг 3: Подключение в Botobot​

Теперь подключите RetailCRM в личном кабинете Botobot:

  1. Войдите в личный кабинет Botobot
  2. Перейдите в раздел "Интеграции"
  3. Найдите RetailCRM и нажмите "Подключить"
  4. Заполните форму подключения:
    • URL RetailCRM — адрес вашего аккаунта (например, https://your-shop.retailcrm.ru)
    • API-ключ — ключ, полученный на предыдущем шаге
  1. Нажмите "Сохранить"
Проверьте URL

Убедитесь, что указали правильный URL вашего аккаунта RetailCRM. Он должен начинаться с https:// и заканчиваться на .retailcrm.ru

Шаг 4: Проверка интеграции​

После сохранения настроек интеграция активируется автоматически:

  1. Создайте тестовый заказ в вашем Telegram-боте
  2. Проверьте, что заказ появился в RetailCRM
  3. Измените статус заказа в RetailCRM
  4. Через 5 минут проверьте, что статус обновился в Botobot
Тестовый заказ

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

🔄 Синхронизация данных​

Что синхронизируется​

Заказы (Botobot → RetailCRM)​

При создании нового заказа в Telegram-боте в RetailCRM автоматически передаются:

  • Данные клиента (имя, телефон, адрес доставки)
  • Список товаров в заказе
  • Сумма заказа
  • Способ оплаты
  • Способ доставки
  • Комментарии к заказу

Статусы заказов (RetailCRM → Botobot)​

Изменения статусов заказов в RetailCRM синхронизируются с Botobot каждые 5 минут.

Частота синхронизации​

  • Новые заказы: передаются мгновенно
  • Статусы заказов: обновляются каждые 5 минут

📊 Поддерживаемые статусы​

Интеграция поддерживает следующие стандартные статусы RetailCRM:

Статус в RetailCRMОписание
newНовый заказ
availability-confirmedНаличие подтверждено
send-to-assemblingОтправлен на сборку
assemblingСобирается
assembling-completeСборка завершена
send-to-deliveryОтправлен на доставку
deliveringДоставляется
client-confirmedПодтверждён клиентом
completeВыполнен
no-callНедозвон
no-productНет товара
offer-analogПредложен аналог
already-boughtУже купил
redirectПереадресация
Кастомные статусы

Если в вашем RetailCRM настроены кастомные статусы, свяжитесь с поддержкой Botobot для их настройки.

❓ Частые вопросы​

Можно ли синхронизировать товары?​

В текущей версии интеграции синхронизируются только заказы и их статусы. Товары пока не синхронизируются автоматически.

Что делать, если заказы не передаются в RetailCRM?​

Проверьте следующее:

  1. API-ключ введён правильно — проверьте, нет ли лишних пробелов
  2. URL RetailCRM корректный — убедитесь, что указан правильный адрес
  3. У API-ключа есть права — проверьте права доступа в настройках RetailCRM
  4. Интеграция активна — убедитесь, что в Botobot интеграция включена

Если проблема сохраняется, обратитесь в поддержку.

Как отключить интеграцию?​

  1. Перейдите в раздел "Интеграции" в личном кабинете Botobot
  2. Найдите RetailCRM
  3. Нажмите "Отключить"

После отключения заказы перестанут передаваться в RetailCRM.

Передаются ли старые заказы?​

Нет, в RetailCRM передаются только новые заказы, созданные после подключения интеграции. Старые заказы нужно импортировать вручную, если это необходимо.

Можно ли подключить несколько магазинов?​

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

🔧 Устранение проблем​

Заказы не появляются в RetailCRM​

Возможные причины:

  • Неверный API-ключ или URL
  • API-ключ не имеет необходимых прав доступа
  • Интеграция не активирована в Botobot

Решение:

  1. Проверьте правильность введённых данных
  2. Пересоздайте API-ключ в RetailCRM с полными правами
  3. Убедитесь, что интеграция активна в Botobot

Статусы не синхронизируются​

Возможные причины:

  • Используются кастомные статусы, не поддерживаемые интеграцией
  • Нарушена связь между системами

Решение:

  1. Проверьте, что используете стандартные статусы RetailCRM
  2. Убедитесь, что интеграция активна
  3. Подождите 5 минут для синхронизации

💡 Советы по работе​

Оптимальный workflow​

  1. Заказы принимаются через Telegram-бота
  2. Обработка заказов ведётся в RetailCRM менеджерами
  3. Статусы обновляются в RetailCRM, клиенты получают уведомления в боте
  4. Аналитика и отчёты формируются в RetailCRM

Настройка уведомлений​

В RetailCRM можно настроить автоматические уведомления клиентам при изменении статусов. Это дополняет уведомления, которые отправляет Telegram-бот.

🆘 Нужна помощь?​

Если у вас возникли сложности с настройкой интеграции RetailCRM:

Готовы к следующему шагу? Вернитесь к списку интеграций или изучите другие возможности Botobot →