WabaDO для S2 CRM: инструкция

Что делает приложение

Приложение переносит переписку из WhatsApp*, Telegram, MAX, ботов, сообществ ВКонтакте и чата на вашем сайте в штатный раздел S2 CRM «Диалоги».
Менеджеры отвечают клиентам прямо из S2, а сообщения уходят в мессенджер клиента.
Новые диалоги можно сразу раздавать сотрудникам: по кругу или по порядку.
Из S2 можно написать клиенту первым, запустить каскад (если сообщение не дошло в одном мессенджере, оно уходит в следующий) и сделать рассылку по списку.
Уведомления по событиям: сделка перешла в статус «Оплачено» — клиент сам получает сообщение.

Само приложение бесплатное. Номера (каналы) подключаются и оплачиваются в кабинете WabaDO.

Что нужно заранее

1. Аккаунт WabaDO. Зарегистрируйтесь на app.wabado.ru и пополните баланс.
2. Подключённый канал. В кабинете WabaDO создайте канал (номер WhatsApp, аккаунт Telegram или MAX, бот, сообщество ВКонтакте или чат на сайт) и войдите в мессенджер по QR-коду или коду.
3. Система S2 CRM в настройках канала. В кабинете WabaDO откройте настройки канала и выберите систему «S2 CRM». Каналы с другой системой приложение покажет, но подключать не будет.
4. Токен WabaDO. Это ключ, по которому приложение работает с вашим аккаунтом WabaDO. Создайте его в кабинете WabaDO (app.wabado.ru): в меню слева «Разработчикам» → «Токены API». Скопируйте его. Для каскадов и рассылок нужен токен с доступом ко всем каналам. Токен на отдельные каналы тоже подойдёт, но тогда работает только переписка.

Установка и подключение

1. В S2 CRM откройте маркетплейс приложений, найдите WabaDO и установите.
2. Откройте приложение из меню S2. Вверху четыре вкладки: «Подключение», «Рассылки и шаблоны», «Уведомления», «Журнал». Вкладку «Уведомления» видят только тот, кто установил приложение, и администраторы S2.
3. На вкладке «Подключение» есть блок «Быстрый старт» из четырёх шагов. Выполните их по порядку:
   1. Создайте канал — кнопка «Открыть кабинет WabaDO». Создайте канал и выберите в нём систему S2 CRM.
   2. Вставьте токен — вставьте токен в поле и нажмите стрелку (или Enter). Приложение проверит токен и напишет, сколько каналов нашло.
   3. Включите канал — в списке «Каналы» ниже включите переключатель «Включён» у нужного номера. Приложение само настроит приём сообщений и создаст канал в «Диалогах» S2.
   4. Проверьте — напишите на номер канала с другого телефона. Сообщение появится в S2, раздел «Диалоги».
4. Когда все шаги сделаны, вместо быстрого старта появится строка «✓ Всё работает: сообщения клиентов приходят в S2 CRM, раздел «Диалоги»».

Создали новый канал в кабинете WabaDO — нажмите «Обновить список». Иначе он появится сам в течение 10 минут. Новый канал по умолчанию выключен: включите его переключателем.

Заменить токен: внизу вкладки «Подключение» раскройте «Токен WabaDO», вставьте новый токен и нажмите «Заменить токен».

Каналы

Каналы показаны строками: значок мессенджера, название, номер, состояние и переключатель «Включён». Нажмите на строку — раскроются настройки канала из трёх частей: «Уведомления», «Распределение», «Цифры».

Включить и выключить

Переключатель «Включён» в строке канала. Выключенный канал не принимает и не отправляет сообщения через S2. Включать и выключать каналы может только тот, кто установил приложение, и администраторы S2.

Уведомления: что канал присылает в S2

Каждый переключатель сохраняется сразу, кнопку нажимать не нужно.

• Входящие от клиентов — сообщения, которые пишут вам клиенты.
• Отправленные с телефона — ваши ответы, написанные прямо в мессенджере на телефоне. Они тоже будут видны в диалоге.
• Отправленные другими программами — сообщения, которые ушли с этого номера через другие сервисы.
• Личные чаты — переписка один на один.
• Групповые чаты — переписка в группах. Каждая группа приходит отдельным диалогом с её названием, в каждом сообщении — имя автора. Ответ уходит в группу. Каскады и рассылки в группы не отправляются.

Личные и групповые чаты нельзя выключить одновременно: тогда канал ничего не пришлёт.

У чата на сайте есть только первые три переключателя.

Чат на сайте (виджет)

Окно чата на вашем сайте: посетитель пишет прямо со страницы, а сообщение приходит в «Диалоги» S2, как от любого клиента.

1. В кабинете WabaDO создайте канал «Виджет на сайт» и выберите в его настройках систему S2 CRM.
2. Там же скопируйте код для сайта и вставьте его на каждую страницу сайта перед закрывающим тегом </body>. Если сайт ведёт другой человек, передайте код ему.
3. В приложении нажмите «Обновить список» и включите канал переключателем. Входить в мессенджер не нужно: в строке канала написано «Код для сайта — в кабинете WabaDO».
4. Откройте свой сайт и напишите в окно чата. Сообщение появится в «Диалогах».

Как работает чат на сайте:

• Посетитель пишет первым. Написать ему первым, запустить каскад, рассылку или уведомление через чат на сайте нельзя.
• Ответ доходит, пока посетитель на сайте. Сообщение ждёт его до 30 минут. Если он ушёл, в диалоге будет «Посетитель ушёл с сайта, сообщение не доставлено».
• Посетитель без телефона. Телефон или имя, которые посетитель ввёл сам, приложение не проверяет и с вашими клиентами не связывает: иначе любой посетитель мог бы попасть в переписку настоящего клиента с этим номером. Каждый посетитель — отдельный диалог.
• Распределение по сотрудникам работает так же, как у других каналов.
• Уведомления. У чата на сайте нет выбора личных и групповых чатов, только первые три переключателя.
• Если в строке канала «Виджет выключен в WabaDO», включите чат в кабинете WabaDO.

Цифры

Сколько сообщений приложение обработало с момента подключения канала: входящих, отправлено из CRM, с телефона, другими программами, файлов, не доставлено, пропущено. Под каждым числом — сегодня, за 7 и за 30 дней.

Состояния канала

Токен перестал работать («Нет связи с WabaDO»)

Если токен отозвали или удалили в кабинете WabaDO, вверху вкладки «Подключение» появится красный блок: «Токен WabaDO не работает: его отозвали или удалили в кабинете. Сообщения не приходят и не отправляются. Вставьте новый токен.» У всех каналов будет «Нет связи с WabaDO».

Что делать:

1. Нажмите «Открыть кабинет WabaDO» и создайте новый токен: меню слева «Разработчикам» → «Токены API».
2. Вставьте его в поле в красном блоке и нажмите стрелку.
3. Блок исчезнет, каналы вернутся в «Работает». Ответы менеджеров, которые ждали, уйдут сами.

Пока токен не работает, каналы и настройки не удаляются.

Переписка в S2

Сообщения клиентов приходят в раздел S2 «Диалоги». Каждый канал WabaDO — отдельный канал в «Диалогах». Отвечайте там, как обычно.

• Клиент. Диалог привязывается к контакту S2 по телефону. Если такого контакта нет, приложение создаёт новый. У одного человека в одном канале — один диалог: и входящие, и сообщения из карточки, уведомлений и рассылок попадают в него же.
• Файлы. Файл от клиента приложение забирает у WabaDO один раз и сразу сохраняет в S2. Он виден в диалоге как вложение. Файлы можно отправлять и в ответ.
• Имя клиента берётся из мессенджера: имя диалога (как собеседник записан у владельца номера) или имя из профиля. Если имени нет — номер телефона или @username, а если нет и их — «Клиент из интеграции». Имя появится и у диалога, который сотрудник начал со своего телефона, как только мессенджер его пришлёт: диалог и участник переименуются сами. Контакт S2, заведённый без имени, тоже получит имя. Контакт, который вы назвали сами, приложение не трогает.
• Группы. Если включены групповые чаты, каждая группа — отдельный диалог с её названием, имя автора — в каждом сообщении. MAX пока не присылает название группы, поэтому такой диалог называется «Групповой чат …0130» — по последним цифрам номера группы.
• Несколько фото одним сообщением (альбом) приходят отдельными сообщениями, по файлу в каждом. Подпись — у первого.
• «Избранное» MAX (сообщения самому себе) в S2 не переносится: это не переписка с клиентом.
• Чат на сайте — см. «Чат на сайте (виджет)» выше.

Служебные отметки приложения начинаются со слов «WabaDO:». Их видят только сотрудники, клиенту они не уходят.

• «WabaDO: ⚠ Сообщение не загрузилось, смотрите в телефоне.» — конкретное сообщение клиента не дошло до S2. WabaDO не хранит переписку, текст есть только в мессенджере на телефоне.
• «WabaDO: ⚠ Сообщение не отправлено.» с причиной — ответ менеджера не ушёл. Причина и что делать написаны в отметке: например, нет подключения к мессенджеру, ограничение мессенджера, нет денег на балансе.
• «WabaDO: ⚠ Сообщение пока не отправлено: токен WabaDO не работает…» — ответ ждёт. Он уйдёт сам, когда в приложении вставят новый токен.
• «WabaDO: 📞 Входящий звонок в мессенджере.» — клиент звонил в мессенджер.

Отметки о файлах стоят прямо в сообщении клиента:

• «⚠ Файл не загрузился, смотрите в телефоне.» — файл не удалось сохранить в S2.
• «⚠ Файл недоступен (истёк срок хранения).» — файл уже удалён у WabaDO, откройте его в телефоне.

Канал был без связи. Короткие переподключения (до 5 минут) нигде не показываются: в это время ничего не теряется. Если канал был без связи дольше, в строке канала появится «Канал был без связи с … до …, проверьте сообщения в телефоне», и такая же запись будет на вкладке «Журнал». В диалоги эта отметка не пишется. Сверьте переписку за этот период с телефоном.

Написать первым и запустить каскад из карточки

В карточке контакта или сделки откройте приложение WabaDO.

• «Написать клиенту»: выберите канал, напишите текст, нажмите «Написать». Диалог откроется в «Диалогах».
• «Запустить каскад»: выберите шаблон, отметьте две галочки (согласие получателей и понимание риска блокировки), нажмите «Запустить каскад». Итог появится в примечании карточки.
• Ниже — «Каскады по этой карточке»: что уже запускали и чем закончилось.

Если выделить несколько контактов или сделок в списке и открыть WabaDO, появится короткая форма рассылки: шаблон, паузы, часы, согласие и «Запустить рассылку». Ход и отчёт — в приложении, вкладка «Рассылки и шаблоны».

Распределение диалогов

Раздел «Распределение» в настройках канала решает, кому из сотрудников S2 достаётся новый диалог.

1. Включите «Распределять новые диалоги».
2. В поле «Как распределять» выберите способ:
   • По кругу — каждый новый диалог получает следующий сотрудник в списке, после последнего снова первый.
   • По порядку — всегда первый в списке. Остальные — запасные: на случай, если первого уволили или выключили в S2.
3. В «Добавить оператора» выберите сотрудника и нажмите «Добавить». Порядок меняется стрелками ↑ ↓, убрать — ✕.
4. Нажмите «Сохранить распределение».

Один сотрудник несколько раз. Сотрудника можно добавить в список дважды и больше. Тогда «по кругу» он получит больше диалогов за один круг. Счётчики «сегодня» и «всего» — на сотрудника, а не на строку.

Кто получит следующий. У следующего по кругу стоит метка «следующий». Под настройками написано: «Следующий: …» и «Последнее назначение: …, время».

Повторные сообщения. Если клиент пишет снова, диалог остаётся у того же сотрудника. Ответственного получает только первое сообщение нового клиента или новой группы.

Сотрудник, которого нет в S2 или он выключен, помечается «нет в S2 или выключен — пропускается». Если распределение выключено, новые диалоги приходят без ответственного.

Рассылки и шаблоны

На вкладке «Рассылки и шаблоны» сверху шаблоны, ниже рассылки и их история.

Шаблон каскада

Шаблон — это какие каналы по очереди пробовать и какой текст отправить. Шаблоны нужны для каскадов из карточки, рассылок и уведомлений.

1. Нажмите «Создать шаблон».
2. Введите название.
3. Шаг 1: выберите канал и напишите текст. Можно вставлять подстановки: {{имя}}, {{фамилия}}, {{телефон}}, {{сделка_название}}, {{контакт_поле_123}} (123 — номер дополнительного поля S2) или название столбца файла.
4. Нажмите «Добавить шаг», чтобы добавить запасной канал. Всего до 5 шагов. Текст следующего шага можно оставить пустым — возьмётся текст первого.
5. Нажмите «Сохранить шаблон».

«Ждать подтверждение, минут» — когда переходить к следующему каналу:

• 0 — следующий канал сработает, только если отправка не удалась: номера нет в мессенджере или канал недоступен.
• Больше 0 — ещё и если за это время не пришло подтверждение доставки.

Мессенджеры подтверждают по-разному. WhatsApp подтверждает доставку. Telegram — только прочтение. MAX не подтверждает ничего. Поэтому с ожиданием больше 0 человек может получить сообщение дважды: в первом мессенджере и в следующем. У последнего шага этого поля нет — дальше идти некуда.

У каждого шаблона справа кнопки «Разослать», «Изменить», «Удалить».

Рассылка по шагам

Нажмите «Новая рассылка» или «Разослать» у шаблона.

1. Название и получатели.
   • Введите название.
   • В «Откуда получатели» выберите «Файл .xlsx или .csv» или «Выборка контактов S2».
   • Файл: до 5 МБ и 20 000 строк. Кнопка «Скачать пример» скачает образец. В одном столбце телефон, в других — то, что нужно вставить в текст.
   • Выборка: можно задать поиск, номер ответственного, сегмента или табличного фильтра S2.
   • Нажмите «Дальше».
2. Что в каком столбце (только для файла). Над каждым столбцом выберите «не загружать», «Телефон» или «В текст». В поле «Как назвать» — имя для подстановки, например «имя» превратится в {{имя}}. Если в первой строке названия столбцов, оставьте галочку «Первая строка — заголовки». Нажмите «Применить» — увидите итог: получателей, неверных номеров, повторов.
3. Текст и канал.
   • «С одного канала»: выберите канал и напишите текст. Кнопки «Вставить из файла» вставят столбцы в текст.
   • «По каскаду»: выберите шаблон.
   • «Пауза от / до, секунд» — сколько ждать между получателями (по умолчанию 30–90).
   • «Отправлять с / до, час» — по времени аккаунта S2 (по умолчанию с 10 до 20). Вне этих часов рассылка ждёт.
   • Галочка «Пустые значения подставлять пустой строкой». Без неё получатель, у которого нет значения для подстановки, пропускается и попадает в отчёт.
   • Отметьте согласие получателей.
   • Нажмите «Проверить перед запуском». «Изменить столбцы» вернёт на шаг 2.
4. Проверка и запуск. Проверьте название, число получателей, канал, паузу, часы и текст. Нажмите «Запустить рассылку».

Важно. Мессенджеры блокируют номера за массовые рассылки и жалобы. Пишите только тем, кто согласился получать от вас сообщения.

Ход и отчёт

Ниже — «История рассылок». Нажмите на рассылку, чтобы раскрыть:

• итоги: Доставлено, Отправлено, Не удалось, Неизвестно, В очереди, Ждём подтверждение;
• кнопки «Пауза», «Продолжить», «Отменить»;
• «Отчёт» — таблица: получатель, результат, шаг, причина;
• «Скачать отчёт» — тот же отчёт файлом для Excel.

«Неизвестно» значит: сообщение могло уйти, но подтверждения нет.

Если закончились деньги или мессенджер ограничил канал, рассылка сама встанет на паузу. Устраните причину и нажмите «Продолжить». «Отменить» останавливает новые отправки, а каскады, которые уже начались, дойдут до конца.

Текст и данные из столбцов удаляются после завершения рассылки.

Уведомления по событиям

Клиент сам получает сообщение, когда в S2 что-то происходит: сделка перешла в статус «Оплачено», счёт оплачен, назначена запись. Событие и условие вы задаёте в сценарии S2, а приложение пишет клиенту по вашему тексту.

Вкладка «Уведомления» видна только тому, кто установил приложение, и администраторам S2.

Создать уведомление

Нажмите «Создать уведомление» и пройдите шаги.

1. Название. Например, «Оплата получена».
2. Объект. В «Что запускает» выберите раздел S2: сделка, заявка, контакт, компания, договор, счёт, платёж, запись, недвижимость, задача, визит. У разделов со статусом можно добавить условие «статус» (необязательно). Лучше задавать условие в самом сценарии S2, а здесь — как дополнительную проверку.
3. Кому писать. Контакт, компания или «Контакт, а если его нет — компания». У контакта и компании этот шаг не нужен — сообщение получат они сами. Телефон берётся по порядку: мобильный, основной, рабочий, дополнительный.
4. Связанные объекты. Отметьте, чьи данные нужны в тексте: статус, ответственный, продукты, задачи, счета и другие. S2 отдаст только отмеченное — так быстрее. Получатель отмечен всегда. Связь с несколькими записями подставляется готовым списком, запись на строку. Например, {{продукты}} даст «Кухонный гарнитур — 1 × 45 000».
5. Через что. Канал или каскад по шаблону. Чат на сайте, боты и группы писать первыми не могут, их здесь нет.
6. Текст. Нажмите «+ Вставить поле» (или наберите {{ в тексте). Откроется список полей по группам с поиском. Нажмите на поле — оно вставится туда, где стоит курсор. Под текстом вставленные поля подсвечены. Пустое значение подставится пустым.
   • Предпросмотр. Введите ID записи S2 и нажмите стрелку. ID — в адресе карточки, например …/deals/72738. Пусто — возьмётся последняя запись раздела. Вы увидите, кому, каким каналом и с каким текстом уйдёт сообщение. Пустые подстановки подсвечены.
   • Если выбран каскад, текст берётся из шаблона.
7. Частота. «Не чаще одного сообщения по одной записи, секунд» — по умолчанию 60. Если сценарий срабатывает на каждое изменение записи, лишние вызовы в это время не отправляются. 0 — без ограничения.
8. Включение. Включите «Клиенты согласны получать от нас такие сообщения» (без этого уведомление не включится) и «Включить сразу».
9. Нажмите «Сохранить». Сразу откроется «Адрес для сценария S2» и короткая инструкция.

Настроить сценарий в S2

Сообщение отправляется, когда сценарий S2 обращается к адресу уведомления. Этот адрес — как номер телефона уведомления: S2 «звонит» по нему, и приложение отправляет сообщение.

1. В приложении у уведомления нажмите «Адрес для S2», затем «Скопировать».
2. В S2 откройте «Настройки» → «Автоматизации» → «Сценарии».
3. Создайте сценарий для нужного раздела (например, «Сделки») с нужным событием: создание, изменение, смена статуса.
4. Добавьте условие в сценарий, например «статус изменился на Оплачено». Без условия сообщение будет уходить на каждое изменение записи.
5. Добавьте действие «Вызвать вебхук» (так в S2 называется отправка данных по адресу). Метод — POST, формат — JSON. Вставьте скопированный адрес. Ключ добавлять не нужно.
6. Сохраните сценарий.
7. Измените тестовую запись так, чтобы сценарий сработал. Итог появится в журнале уведомления.

Проверить текст без сценария: в блоке адреса введите свой номер в «Пробное сообщение на свой номер» и нажмите «Отправить пробное». Текст подставится из последней записи раздела.

Журнал уведомления

Нажмите на уведомление в списке, затем «Журнал». Там видно: когда, номер записи, итог (Отправлено, Пропущено, Ошибка, Повтор, В очереди) и подробности. Показаны 20 последних сработок. Период «С … По …» и «Показать» — для поиска старых, «Ещё 20» — следующие.

Повтор того же вызова второй раз не отправляется. Вызовы чаще заданного окна по одной записи тоже пропускаются.

В строке уведомления видно, сколько отправлено и чем закончилась последняя сработка. Переключатель «Включено» включает и выключает уведомление. Выключенное уведомление на вызовы S2 не отвечает. «Удалить» — сценарий в S2 после этого перестанет работать, удалите и его.

Журнал и поддержка

Вкладка «Журнал» — почему что-то не ушло или было пропущено. Время — по часовому поясу аккаунта S2. Текстов сообщений там нет. Показаны 20 последних записей. «С … По …» и «Показать» — для поиска за период, «Ещё 20» — следующие.

Блок «Для поддержки» внизу экрана: номер аккаунта S2, версия приложения, аккаунт WabaDO. Нажмите «Скопировать» и пришлите эту строку в поддержку. Токенов и ключей в ней нет.

Полный журнал обмена (для поддержки). Внизу вкладки «Журнал» есть переключатель «Полный журнал обмена». Он на 24 часа включает запись всего, что приходит от S2 и WabaDO и уходит к ним. Тексты сообщений туда попадают, токены и ключи — нет. Записи хранятся 3 дня. Кнопка «Открыть журнал обмена» показывает журнал текстом в новой вкладке: сохраните его (Ctrl+S) и приложите к обращению в поддержку. Журнал включает и открывает только администратор приложения.

Чат поддержки. На главном экране приложения есть окно чата с поддержкой WabaDO. Вверху — ссылки «Кабинет WabaDO» и «Поддержка».

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

Клиент написал, а сообщение не появилось в «Диалогах».
Проверьте на вкладке «Подключение»: у канала «Работает», в «Уведомлениях» включены «Входящие от клиентов» и нужный тип чата (личные или групповые). Нет красного блока про токен. Если в диалоге стоит отметка «Сообщение не загрузилось, смотрите в телефоне», текст есть только в мессенджере. Причина — на вкладке «Журнал».

Менеджер ответил, а клиент не получил.
В диалоге будет отметка «⚠ Сообщение не отправлено» с причиной. Частые причины: канал вышел из мессенджера, закончились деньги, мессенджер ограничил номер. Исправьте в кабинете WabaDO.

Клиент получил сообщение дважды.
Если в каскаде «Ждать подтверждение, минут» больше 0, а мессенджер не подтвердил доставку (MAX не подтверждает, Telegram подтверждает только прочтение), сообщение уйдёт и в следующий канал. Поставьте 0 — следующий канал будет пробоваться только при ошибке отправки. Для уведомлений: проверьте, что в сценарии S2 есть условие, и не стоит ли частота 0.

Пишет «Токен WabaDO не работает».
Токен отозвали или удалили в кабинете WabaDO. Создайте новый в кабинете («Разработчикам» → «Токены API») и вставьте в красный блок на вкладке «Подключение».

Канал пишет «Другая система».
В кабинете WabaDO у канала выбрана не S2 CRM. Выберите S2 CRM в настройках канала и нажмите «Обновить список».

Пишет «У аккаунта WabaDO уже 20 адресов уведомлений».
У одного аккаунта WabaDO может быть не больше 20 адресов уведомлений. Откройте в кабинете WabaDO раздел «Уведомления», удалите адреса, которые больше не нужны, и включите канал снова.

Как удалить приложение?
Удалите его в маркетплейсе S2. Работа сразу останавливается: каналы выключаются, приём сообщений снимается. Каналы в кабинете WabaDO остаются — если они больше не нужны, удалите их там, иначе они продолжат списывать деньги.

Что будет с данными после удаления?
Всё, что хранилось в приложении, стирается сразу: токен WabaDO, настройки, шаблоны, уведомления, рассылки, журналы. Переписка остаётся в «Диалогах» S2. Если поставите приложение снова, начнёте с чистого листа: токен и настройки нужно будет ввести заново. Сами сообщения WabaDO не хранит.

* WhatsApp принадлежит Meta Platforms Inc., которая признана экстремистской организацией и запрещена в России.