Wazzup
Wazzup подключает к SNABZHENETS+ мессенджеры поставщиков: WhatsApp, WhatsApp Business API, Telegram и другие каналы, доступные в аккаунте Wazzup. Интеграция устанавливается из маркета, после чего администратор вставляет API-ключ своего аккаунта Wazzup в настройках карточки.
Что появляется в портале
После включения Wazzup и выдачи пользователю права messengers.read в левом меню появляется раздел Мессенджеры. Внутри открывается встроенное окно чатов Wazzup. То же окно доступно из карточек заявке, RFQ поставщику и контрагентов, если переписка уже связана с этой сущностью.
Для настройки и обслуживания интеграции нужен доступ messengers.manage и право управлять интеграциями. В панели Wazzup можно проверить соединение, синхронизировать каналы, пользователей, контакты и сделки, зарегистрировать webhook, посмотреть последние статусы и отправить тестовое сообщение.
Подключение
- В Wazzup откройте настройки API и скопируйте API-ключ.
- В SNABZHENETS+ откройте Настройки → Интеграции → Wazzup.
- Установите интеграцию, вставьте API-ключ и сохраните настройки.
- Нажмите Проверить соединение. Портал запросит список каналов Wazzup.
- Включите интеграцию и откройте панель Wazzup.
- Нажмите Синхронизировать каналы и Зарегистрировать webhook.
API-ключ хранится зашифрованно и не отображается в журнале событий, переменных или пользовательском API. Роли операторов внутри Wazzup назначаются в интерфейсе Wazzup; SNABZHENETS+ синхронизирует пользователей, контакты и сделки, но не управляет ролями Wazzup.
Если для WhatsApp Business API используется WABA-канал, укажите в настройках интеграции approved template ID для RFQ поставщикам и для запроса счетов. WABA не начинает новую переписку свободным текстом: система отправляет template, а файл отправляет отдельным сообщением после него.
Синхронизация CRM
Кнопка Синхронизировать контакты отправляет в Wazzup активные контактные лица компаний из карточек контрагентов. Карточка компании сама по себе не создаёт контакт Wazzup: у контактного лица должен быть WhatsApp, телефон или Telegram в каналах связи. В Wazzup передаётся contactData[], поэтому один контакт может быть связан с несколькими мессенджерами.
Кнопка Синхронизировать сделки отправляет в Wazzup заявки и RFQ поставщикам. В сделку заявки попадают контактные лица заказчика, выбранного поставщика и поставщиков заявки. В RFQ-сделку попадают контактные лица компании-поставщика. В Wazzup передаётся не более 10 контактов на одну сделку.
RFQ через мессенджеры
В карточке заявка кнопка Запросить цены создаёт RFQ поставщику. Для каждого поставщика можно выбрать каналы доставки:
- Email;
- WhatsApp через Wazzup;
- Telegram через Wazzup;
- несколько каналов одновременно.
Если выбран WhatsApp или Telegram, в карточке поставщика должен быть телефон, WhatsApp или Telegram-канал контакта. Система отправляет поставщику сообщение с номером RFQ, сроком ответа и публичной ссылкой на страницу ответа /supplier-rfqs/:token, а затем отдельным сообщением отправляет Excel-шаблон ответа. По ссылке поставщик без логина видит позиции RFQ и отправляет цены через форму; технический JSON API поставщику не показывается. Последний успешный набор каналов запоминается отдельно по поставщику: при следующей отправке RFQ чекбоксы откроются так же, как использовались раньше.
Если выбран Email и Wazzup одновременно, успешная отправка хотя бы в один канал считается частичной доставкой. Пользователь видит результат по каждому каналу, а RFQ считается отправленным только если Wazzup или Email приняли сообщение.
Запросы счетов через Wazzup
После сравнения ответов и выбора строк поставщиков кнопка Запросить счета может отправить запрос через Email, WhatsApp или Telegram. Для Wazzup система отправляет текст с номером заявки и итогом по выбранным строкам, затем отдельный Excel-файл с позициями. Email больше не обязателен, если у поставщика есть мессенджер-контакт и выбран Wazzup-канал.
Входящие ответы Wazzup по связанному RFQ или запросу счета появляются в карточке заявки в тех же рабочих блоках, что и ответы из почты: получен, не импортирован для RFQ и получен, счёт не создан для счетов. Система не создаёт КП или входящий счёт автоматически — менеджер проверяет ответ вручную.
Webhook-события
SNABZHENETS+ принимает от Wazzup:
- входящие и исходящие сообщения;
- статусы доставки;
- новые контакты и сделки;
- обновления каналов;
- статусы WABA-шаблонов.
События сохраняются в журнале установки и обновляют локальное зеркало Wazzup. Это зеркало используется для карточных ссылок на чаты, счётчика неотвеченных сообщений, статусов отправки и безопасных переменных. Регистрация webhook использует публичный URL портала; Wazzup отправляет тестовый POST, на который портал отвечает успешно перед сохранением подписок.
Права
| Право | Что разрешает |
|---|---|
messengers.read | Видеть раздел Мессенджеры и открывать iframe-чаты Wazzup |
messengers.manage | Синхронизировать данные, регистрировать webhook и отправлять тестовые сообщения |
Администратор портала может выдать эти права в настройках ролей.