Экосистема и API — виджет BazON для amoCRM (v2.0)

Руководство по настройке и работе виджета BazON для amoCRM. Раздел для администратора аккаунта. BazON работает как центральный узел для остальных виджетов 3FSOFT. Авито, ZZap и Бибинет обращаются к нему по API за артикулами, данными товара и применимостью, а каналы отправки (Авито, RadistOnline, Drom) позволяют слать клиентам сообщения и медиа прямо из amoCRM. Со стороны пользователя почти всё сводится к одному действию — выдать токен доступа.

API и токены доступа

Что делает. Раздел, где вы выдаёте токены доступа к API виджета BazON для других виджетов 3FSOFT (Авито, ZZap, Бибинет). Чтобы виджет обращался к BazON, вы выдаёте токен и вставляете его в настройки этого виджета. Токен не привязан к конкретному виджету — его использует любой, в который вы его вставили, и он общий по аккаунту. Сами методы API пока в разработке (в разделе есть пометка), токены выдаются заранее — как появятся методы, доступ уже будет настроен.

Как настроить.

1. Откройте виджет → API и токены доступа.
2. Нажмите «Выдать токен».
3. Введите название/назначение (например, «Авито») — чтобы понимать, какой токен для какого виджета.
4. Нажмите «Выдать» — появится полный токен. Нажмите «Копировать» и вставьте в настройки нужного виджета. После закрытия токен больше не покажется.

Отозвать токен: в списке найдите нужный → «Отозвать» → подтвердите. Токен перейдёт в статус «Отозван» и останется в списке; виджет, который его использовал, потеряет доступ — выдайте и пропишите новый.

В списке видно: название, опознавательный префикс токена (например, bzn_a1b2c3d4…, не весь секрет), кто и когда выдал, статус «Активен»/«Отозван».

Ограничения и частые вопросы.

• Токен показывается один раз при выдаче — скопируйте сразу. В базе хранится только его отпечаток, не сам секрет; повторно посмотреть нельзя.
• Потеряли токен — отзовите и выдайте новый.
• Отозванные токены остаются в списке для истории (видно, кто и когда выдавал/отзывал), удалить нельзя — это специально.
• Виджет не получает доступ — проверьте, что токен активен (не отозван) и вставлен без лишних пробелов.

Определение артикула (для Авито)

Что делает. Когда вы публикуете товары BazON на Авито через виджет AVITO, у каждого объявления есть привязка к товару BazON. Эта функция позволяет виджету Авито спросить у виджета BazON, какой артикул соответствует объявлению, и подставлять его в сделки amoCRM. Связку настраивает обращающийся виджет (Авито от 3FSOFT) — с вашей стороны нужно только выдать токен.

Как настроить.

1. Откройте настройки BazON → «API и токены доступа».
2. Нажмите «Выдать токен», назовите его понятно (например, «Авито»).
3. Скопируйте токен (показывается один раз) и вставьте в настройки виджета Авито, где он просит токен доступа к BazON.

Ограничения и частые вопросы.

• Аккаунт определяется автоматически по токену — виджету Авито достаточно одного токена.
• Нужен подключённый BazON: слетел вход во вкладке «Подключение» — определение артикула не работает, пока не войдёте заново.
• Токен потерян/скомпрометирован — отзовите и выдайте новый, затем обновите его в виджете Авито.
• «Токен недействителен» в Авито — токен отозван или введён с ошибкой, выдайте новый.
• Артикул приходит пустым — у объявления в экспортёре нет привязанного товара, проверьте выгрузку товара на Авито в BazON.

Данные по артикулу (для внешних виджетов)

Что делает. Другой виджет или интеграция 3FSOFT по артикулу (номеру товара BazON) запрашивает у виджета BazON полную карточку товара и список применимости — чтобы показать или использовать их у себя. Можно передать несколько артикулов через запятую. Со стороны пользователя — только выдать токен.

Как настроить.

1. Откройте настройки BazON → «API и токены доступа».
2. Нажмите «Выдать токен» (можно тот же общий по аккаунту токен).
3. Вставьте токен в настройки виджета/интеграции, обращающейся к BazON.

Ограничения и частые вопросы.

• Аккаунт определяется по токену.
• Нужен подключённый BazON — иначе метод вернёт ошибку, пока не войдёте заново.
• За один раз можно запросить до 100 артикулов.

Поиск товаров для ZZap

Что делает. Виджет ZZap по номеру запчасти запрашивает у виджета BazON список подходящих товаров (наличие, цена, склады), чтобы показать их на стороне ZZap. Со стороны пользователя — только выдать токен.

Как настроить.

1. Откройте настройки BazON → «API и токены доступа».
2. Нажмите «Выдать токен» (можно общий по аккаунту).
3. Вставьте токен в настройки виджета ZZap.

Ограничения и частые вопросы.

• Аккаунт определяется по токену.
• Нужен подключённый BazON, иначе поиск не работает.
• Поиск идёт по номеру запчасти и производителю — оба обязательны.
• «Токен недействителен» — выдайте новый. Ничего не находит — нет товара с таким номером/производителем, проверьте их в BazON.

Мессенджеры (каналы отправки клиентам)

Что делает. Раздел, где вы подключаете каналы для отправки клиентам сообщений, фото, видео и документов прямо из amoCRM: договор-счёт, карточку товара, медиа по сделке. Здесь подключаются «трубы», а что именно отправлять, менеджер выбирает в карточке сделки и каталоге (см. Каталог и товары и договор-счёт в Оплаты и эквайринг).

Какие каналы поддерживаются:

Видео отправляется только через RadistOnline; Авито и Drom его не принимают, для них видео пропускается.

Как настроить. Настройки → Настройка интеграции → Мессенджеры → «+ Подключение».

• Авито: в виджете AVITO (раздел «API») выпустите токен доступа (ak_…), вставьте в подключение, сохраните. Кнопка «Проверить» подтвердит, что ключ рабочий.
• RadistOnline: в ЛК RadistOnline возьмите API-ключ (X-Api-Key), вставьте, сохраните. «Проверить» покажет список доступных каналов кабинета (WhatsApp / Telegram / Max) — конкретный канал выбирается в момент отправки.
• Drom: возьмите X-Api-Key приложения Drom. Укажите два поля amoCRM, куда приложение Drom записывает данные диалога: «поле login продавца» и «поле ID диалога» (каждое — на контакте или сделке). Без них отправка в Drom невозможна.

Получатель определяется автоматически по контактам сделки (телефон / сохранённый диалог Telegram-Max); в момент отправки менеджер может выбрать конкретный номер или канал. Для Drom — по диалогу из настроенных полей.

Ограничения и частые вопросы.

• Ключи и токены хранятся в зашифрованном виде, в ответах и логах не показываются.
• Drom не подгружает отправленное в ленту сделки, поэтому после отправки виджет добавляет в сделку примечание о факте отправки. Авито и RadistOnline показывают сообщение в своей ленте сами.

Связанные разделы

• Каталог и товары
• Подключение и доступы