После долгих поисков на просторах интернета пришел к выводу: то-ли никто не хочет делится опытом, то-ли Viber не на столько популярен как "телега" (но клиенту надо, а значит спрос есть)), то-ли Viber слишком хитрая контора с завышенными требованиями к безопасности и пр. пр. пр., в общем после изучения мат-части (API) получилась интересная вещь. Давайте разбираться:
- API Viber-а оказался довольно простым и без заморочек;
- Ну раз уж мы управляем ботом, добавим возможность "чата" с подписчиками на бота;
- И сделаем возможность добавлять несколько (да сколько угодно) ботов (учетных записей Viber);
- База желательно клиент-серверная, т.к. нужно публиковать на веб-сервере, да еще и с настоящим живым сертификатом (который придется купить).
Сразу скажу, что расширение писалось для конфигурации "УНФ для Украины" (с поддержкой укр. языка), но практически можно добавить в любую современную конфигурацию (на последних БСП), исключения составит переделка логики работы самого бота, то есть, заменить предлагаемые команды меню бота на свои (отчеты).
Основой интеграции является справочник учетных записей Viber (ботов), в каждой учетке хранится системная информация Viber (имя, токен и т.д.), а так-же настраивается доступ на уровне пользователей базы, публикация HTTP сервиса и папка (шара доступная пользователю под которым работает служба сервера 1С), где хранятся передаваемые (вами) файлы из встроенного чата (мы же хотим полновесный чат, картинки, файлы, все такое))... и собственно HTTP сервис с двумя методами POST и GET (первый это веб-хук , второй отдает наши переданные файлы (причем безопасно!)). Для ведения сообщений и их статусов (в разрезе учетных записей) есть два регистра сведений, ну и собственно общая форма "Чат", реализована на ПолеHTMLДокумента (тут пришлось повозится нарисовать красивый, более-менее похожий на оригинал, с изучением css и html, потому как все что находилось в интернете, все в топку)).
Теперь подробнее про HTTP сервис:
В API вайбера как то туманно описан заголовок приходящего запроса на веб-хук, тут без отладки не обошлось, да ко всему прочему еще и ХЕШ приходящий в заголовке (чтоб определить к какой учетной записи запрос) захеширован HMAC256, которого в 1С днем-с-огнем нет, спасибо Инфостарту, с небольшими доделками и это теперь у нас есть. Второй важный момент, Viber не умеет делать запрос с авторизацией, поэтому публикуем базу частично, т.е. нам нужно в публикации указать логи и пароль служебного пользователя и выключаем публикацию клиента, меняем vrd файл:
<point xmlns="http://v8.1c.ru/8.2/virtual-resource-system"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
base="/base_name"
ib="Srvr="server_name";Ref="base_name";usr=user_name;pwd=password;"
enable="false">
а так же нам необходимо включить публикацию HTTP-сервисов нашего расширения:
<httpServices publishExtensionsByDefault="true">
... и третье, наш GET запрос отдает файлы по тому же принципу, с использованием параметров в запросе, где указывается имя файла и хеш, в котором содержится учетная запись Vibera (мы же не хотим публиковать папку на весь мир).
Если у вас база опубликована для доступа к веб-клиенту, придется опубликовать ее же еще раз но с другим именем, без доступа к веб-клиенту, и указать путь к веб-хуку (в справочнике учетных записей).
Расскажу немного про форму "чата": т.к. в 1С нельзя оповестить клиента с сервера, сделал обновление поля HTML через фоновое задание, с предварительной проверкой о необходимости обновления. Важно! При обновлении поля нужно поместить скрол вниз документа, реализовано через событие ПолеHTMLДокумента "ДокументСформирован" с установкой "Документ.body.scrollTop = Документ.body.scrollHeight+99999", но в редакции платформы 8.3.13 это почему то не работает, а вот 8.3.15-16 все отлично.
Из того что реализовано по CRM: при первом сообщении (или событии "conversation_started") от подписчика выполняется проверка заполненности номера телефона в учетных записях подписчиков (рег. сведений) и привязки его к контрагенту или пользователю ИБ (такое тоже может быть, меню пользователя не реализовано, см. процедуру "ОбработатьЛогикуПоведения" в модуле "днк_ВайберСервер"), и на основании сего формируется клавиатура или сообщения, если привязка к контрагенту есть или подписчик поделился своим номером, доступны следующие функции через отправку меню подписчика (параметры предопределенного меню редактируются двойным щелчком на пункт меню в ТЧ, нажав на кнопку выбора, там где это доступно):
- Наши контакты (необходимо указать подразделения в уч. записи бота, если не указано берется компания из константы и ее конт. инф., если указаны подразделения, выводится подменю для выбора нужного);
- Прайс-лист (необходимо указать основной прайс-лист в уч. записи бота);
- Дополнительное подменю "Еще" (конструируется в учетной записи на закладке "Параметры", создается дерево кнопок, каждая кнопка либо команда либо подменю, кол-во уровней подменю неограниченно, действия можно задавать как на подменю так и на команду, действия - перечень сообщений отправляемых при нажатии на кнопку меню). Поддерживается постраничный вывод кнопок меню.
- Подменю "Для клиентов" (доступно, если подписчик контрагент):
- Акт сверки (вывод отчета Акт сверки с выбором формата файла);
- Сводно о заказе (вывод отчета Сводно о заказе с выбором формата файла, либо ввод номера, либо постраничный вывод подменю с номерами незакрытых заказов);
- Анализ заказов (вывод отчета Анализ заказов с выбором формата файла);
- Мои бонусы (вывод остатка начисленных бонусов, если включена соответствующая функц. опция).
- Обратная связь (отправляется сообщение боту с пометкой "важное", такое сообщение отображается в оповещениях с восклицательным знаком).
Присутствует механизм отслеживания новых сообщений (обработчиком ожидания при старте системы) и выводом их в виде оповещения через систему оповещений пользователя (колокольчик)), нажав на которое открывается форма чата с необходимым подписчиком, если такая команда уже выполнена другим пользователем, выводится соответствующее предупреждение о том, что чат уже начат...
При проведении расходных накладных и заказов покупателей, фиксируется состояние заказа и остаток отгрузки в доп. регистре сведений, при изменении остатка или состояния заказа, система отправляет контрагенту (если он подписчик бота) сообщение с соответствующими данными.
При желании можно добавить еще кучу возможностей, с отсылкой клиентам, например акций на товар и т.д...
Рекомендуемая версия платформы 8.3.16 и выше.
Обновлено 09.02.2020
1. Исправлены ошибки;
2. Добавлено в настройки отдельный каталог для отправки фото для устройств на Android (выявился недочет приложений Viber на устройствах Android, всегда считал дырявым)), так вот, не понимают они непрямые ссылки на картинки (GET)). Придется добавлять виртуальный каталог на веб-сервере, папка каталога должна быть доступна 1С (отправил запрос в поддержку вайбера, надеюсь исправят баг);
3. Добавлена форма групповой (широковещательной) рассылки;
4. Добавлена возможность отправлять стикеры, как в чате, групповой рассылке, так и в командах конструктора доп. меню
Обновлено 12.02.2020
1. Удалены настройки каталога для Андроид. Поддержка вайбера работает отменно, после переписки и предоставления им примеров JSON отправки картинок, найдены недочеты: в анроидах используется кеш и CDN ссылки, формирование имени файла для кеширования происходит по последнему ресурсу (после последнего "/" и до "?"), соответственно в ссылке на картинку последним ресурсом должно быть имя файла картинки (https://server.com/viberbot/botname/image.jpg?param=983yriiowoufh а не так https://server.com/viberbot/botname?filename=image.jpg¶m=983yriiowoufh в последнем случае файл всегда будет кешироваться с именем "botname")
2. Добавлен параметр в учетной записи "Срок действия" - срок действия ссылки на файл (картинку), по истечении которого загрузка картинки (файла) невозможно, если сообщение не было сразу доставлено и просмотрено
Обновлено 19.02.2020
Добавлена возможность добавления команд дополнительного меню - сообщение с типом "Карусель" (rich_media), а так же форма конструктора "карусели", см. скрин. Конструктор вызывается при редактировании команды доп. меню с типом "медиа контент".
Обновлено 26.03.2020
- исправлена ошибка события conversation_started - отправка сообщения (приветствия) при первом входе в чат бота;
- добавлена двухязыковая поддержка служебных сообщений от бота (укр., рус.) - указывается в настройках учетной записи;
- добавлена кнопка меню "оплата liqpay" - возможность оплачивать через плат. систему LiqPay документов заказ покупателя, счет на оплату, ресх. накладные, с выбором из списка неоплаченных документов (если у контрагента стоят соотв. галки расчетов), или указание непосредственно номера документа;
- добавлены ссылки на чат-бот для отправки, например в СМС, приглашения, ссылки двух вариантов - прямая (deeplink), web-ссылка (т.к. на телефонах андроид в СМС deeplink не воспринимается системой как ссылка). Посмотреть ссылки можно в учетной записи на закладке "публикация";
- оптимизированы некоторые функции.
Обновлено 27.04.2020
- исправлены ошибки и оптимизированы некоторые участки кода;
- в меню оплаты добавлена прямая ссылка для оплаты на р/с;
- ! добавлена возможность оповещения о новых сообщениях через систему взаимодействия (если такова подключена), что значительно ускоряет оповещение и снимает нагрузку, т.к. отсутствуют обработчики ожидания;
- перестроено меню идентифицированного подписчика (который привязан к контрагенту);
- весь код открыт;
- изменен метод отправки прайс-листа (в связи с изменениями в последнем релизе целевой конфигурации);
- изменена версия.
Минимальный релиз конфигурации "Управление небольшой фирмой для Украины" - 1.6.11.2
Минимальный релиз конфигурации "Управление нашей фирмой" - 1.6.23.69
Обновлено 27.08.2021
Добавлен новый релиз (2.0.1.46) для конфигурации "BAS Small business" (Украина) (бывшая УНФ)
- оптимизированы некоторые участки кода;
- полностью переработана форма чата, теперь полный функционал как в самом Viber;
- добавлено меню товаров (редактируемый каталог с возможностью поиска), при оплате заказа есть возможность отправлять присоединенные файлы к номенклатуре;
- добавлено меню корзины;
- добавлено меню управления счетами и заказами (инф. о заказе, отчет, печ. форма, удалить если не завершен, оплатить);
- доработан механизм оплаты, добавлены платежные системы ApplePay и GooglePay через систему платежного бота Viber (возможность не тестировалась, необходимо регистрировать MerchantId в LiqPay с заявкой подключения к вашему боту Viber).
Минимальная версия платформы 8.3.16
Минимальный релиз конфигурации "BAS Small business" - 1.6.14.1
Достоинства
- Нет необходимости менять типовую конфигурацию;
- Открытый код;
- Поддержка и консультации для разработчиков и конечного потребителя.
