Интеграция 1С и WhatsApp (Ватсап)

Функции мессенджера выведены в отдельную подсистему и доступны с панели разделов (Рис 1):



Рис.1

Основным окном подсистемы является окно переписки с контрагентом (Рис.2)



Из карточки контрагента или списка контрагентов переход в историю переписки осуществляется щелчком по кнопке Переписка WhatsApp.



Рис. 3

Когда пользователь WhatsApp отправляет сообщение на ваш номер, и разговор с клиентом не ведется ни одним оператором, на экране у всех операторов возникает диалог (см. рис.2). Сотрудник, вступающий в диалог с клиентом, должен нажать кнопку «Начать беседу».



Рис. 4

Вид окна переписки изменится (см. рис.5): появится окно для ввода сообщения (1) и кнопка для его отправки (2).

Отправка сообщения также возможна при использовании горячих клавиш Ctrl+Enter с клавиатуры.



Рис. 5

При этом, у всех прочих операторов, не успевших нажать кнопку «Начать Беседу» первыми, будет выдана ошибка, сообщающая, что разговор уже ведется его коллегой.

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

Чтобы вставить в текст отправляемого сообщения эмодзи, надо нажать кнопку отображения таблицы эмодзи (3). Справа появится список из более чем 1000 различных значков. Выберите необходимый, скопируйте код вместе с фигурными скобками (4) и вставьте в нужное место текста сообщения (1). Либо просто нажмите на нужный код, он добавится к сообщению.

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

Для начала надо пройти регистрацию в сервисе Green API - https://green-api.com/. После того как вы выполнили необходимые действия, вы должны попасть в личный кабинет пользователя сервиса. Для подключения важны два параметра: IdInstance и ApiTokenInstance. Позже их надо будет ввести в настройках в базе 1С.

Также необходимо кнопку Изменить сверху и включить все параметры уведомлений. Адрес отправки будет заполнен позже:



Рис. 6

Далее перейдем к установке самой подсистемы. Необходимо скачать файл конфигурации WhatsAppIntegration.cf.

Установку выполнять от лица Администратора с полным пакетом прав. В режиме конфигуратора через меню Конфигурация – Сравнить, объединить с конфигурацией из файла выбрать файл WhatsAppIntegration.cf (Рис. 7)



Рис. 7

Снять галку с корневого узла (Рис.8)



Рис.8

Зайти в меню Действия – Отметить по подсистемам файла (Рис.9)



Рис.9

Проставить галку в пункте WhatAspp, нажать кнопку Установить (Рис. 10):



На этом этапе Вы с легкостью удостоверитесь в том, что установка подсистемы не нанесет ущерб уже имеющимся объектам конфигурации.

В режиме сравнения конфигураций раскрыть пункт Свойства и в Модуле управляемого приложения проставить галку, после чего зайти в окно настройки объединения модулей (Рис. 11).



Рис.11

Произвести настройку объединения модулей. Перенести все куски кода, которые обрамлены комментариями «WhatsApp».

Войти в базу в пользовательском режиме. В меню WhatsApp – Сервис – Настройки необходимо заполнить поля.



Рис. 12

Пояснения настроек:

Расположение номера телефона контрагента. Сообщения должны отправляться на номер телефона. Но в разных конфигурациях они могут храниться в разных полях базы. Для этого и создана эта настройка. Если номер телефона хранится в реквизите справочника Контрагенты, необходимо выбрать тип расположения Реквизит и путь выбрать из списка реквизитов. Однако в большинстве типовых конфигураций телефоны хранятся в специальной таблице контактной информации, поэтому в типе расположения следует выбрать этот пункт. А в пути надо указать само название поля, обычно это ТелефонКонтрагента;
Часовой пояс сервера. Необходимо указать для правильного определения времени получения сообщений. Для Москвы, например, равен 3.
Создавать ненайденных контрагентов. Если сообщение пришло от номера телефона, которого нет ни у одного контрагента в базе, создавать ли новую карточку контрагента с заполненным наименованием и телефоном? Если галочку не поставить, то и сообщения от неопределенных номеров в базе сохраняться не будут.
В стандартной версии, если вы хотите не только отправлять, но и получать сообщения от абонентов, надо включить регламентное задание "Проверка новых сообщений WhatsApp". Обязательно в регистр «(WA) Операторы» из справочника Пользователи добавить сотрудников, на которых ляжет функционал по работе с клиентами посредством WhatsApp. Также им необходимо дать роль «Оператор WhatsApp».

Можно приступать к работе. Желаем успехов в развитии Вашего бизнеса!

Для подключения вам желательно создать отдельную публикацию только с одним http-сервисом WhatsApp. В конфигураторе перейдите "Администрирование" - "Публикация на веб-сервере...". Введите имя, относящееся к WhatsApp. Если у вас уже есть публикация, будет создана вторая. Снимите все галки, кроме галки по самому сервису WhatsApp, опубликуйте.

Рис. 17

В самом файле новой публикации default.vrd необходимо прописать логин и пароль пользователя 1С, под которым будет происходить подключение. Пользователь должен обладать достаточными правами. Тем самым вы получите доступ к вашей базе без авторизации, но только к конкретному сервису. В итоге файл публикации должен выглядеть примерно так:

<?xml version="1.0" encoding="UTF-8"?>
<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="/WhatsAppIntegrationPro"
		ib="File=&quot;F:\1C\WhatsAppIntegrationPro&quot;;usr=&quot;Admin&quot;;pwd=&quot;123&quot;;"
		enable="false">
	<ws enable="false"
			pointEnableCommon="false"/>
	<debug enable="true"
			protocol="tcp"
			url="tcp://localhost"/>
	<httpServices publishByDefault="false">
		<service name="WA_Service"
				rootUrl="whatsapp"
				enable="true"
				reuseSessions="dontuse"
				sessionMaxAge="20"
				poolSize="10"
				poolTimeout="5"/>
	</httpServices>
	<standardOdata enable="false"
			reuseSessions="autouse"
			sessionMaxAge="20"
			poolSize="10"
			poolTimeout="5"/>
</point>

После этого в настройках необходимо указать адрес вашей опубликованной базы. Он складывается из адреса веб-сервера и имени публикации. Рядом с полей есть кнопка проверки. При нажатии должна будет открыться страница в браузере. Если все сделано правильно, то вы увидите надпись "ОК". Если у вас запрашивается имя/пароль, значит вы неверно прописали их в файле публикации. Если ошибок нет, для надежности, скопируйте адрес страницы и перейдите по ней из другой, внешней сети, например с телефона через мобильный интернет. Этот адрес должен быть доступен не только в вашей сети.

Настройки же конкретного аккаунта проходят в отдельном справочнике "(WA) Аккаунты". Каждый аккаунт может бытьпривязан к своему сервсиу. В настройках аккаунта вы выбираете используемый сервис, вводите идентификатор и токен из личного кабинета. После этого необходимо нажать кнопку "Подключить Webhook". Вы получите сообщение о результатах подключения. Если подключение прошло успешно, вы должны получать сообщения от сервиса.

- Я хочу посмотреть, как это работает.

- В ближайшее время мы снимем видео с иллюстрацией работы, а пока демонстрация данного продукта осуществляется через программу TeamViewer. Дата и время удаленной презентации продукта согласуется с разработчиком продукта в форме обращений. Для наилучшего исхода демонстрации просим предоставить список имеющихся вопросов, чтобы акцентировать на них внимание. Так же уточните версию платформы и конфигурацию 1C, которую используете.

 - Код закрыт? Могу ли я внести свои доработки?

- Код полностью открыт. Вы можете дорабатывать систему под потребности своего бизнеса.

- Могут ли параллельно общаться несколько менеджеров со множеством клиентов?

- Да, у вас могут быть десятки менеджеров, которые ведут работу с сотнями клиентов. При этом с каждым конкретным клиентом будет вести диалог один менеджер.

- Можно ли «передать» клиента от одного менеджера к другому, например, на время отпуска первого.

- В этом нет необходимости. Закрепления клиента за менеджером нет. В каждый новый сеанс разговора возможно назначить нового менеджера, при этом история переписки сохраняется в базе и видна всем сотрудникам.

- Я сомневаюсь, что данная разработка будет работать в моей базе.

- При обращении напишите, пожалуйста, какая у вас версия платформы, а также режим совместимости конфигурации.

- Существует ли и как осуществляется групповая рассылка клиентам?

- Да, вы можете ежедневно производить рассылки. В подсистеме есть обработка, в которой вы можете написать текст для отправки, заполнить список клиентов и произвести рассылку. С помощью методов, которые есть в подсистеме, вы можете сделать свою рассылку по необходимым условиям. Однако использовать систему для массовых рассылок не следует. Это запрещено непосредственно платформой WhatsApp, и номер, с которого будет происходить рассылка, может быть заблокирован.

- Должен ли быть в сети телефон с WhatsApp, зарегистрированный в обработке?

- Да.

- В стандартной версии при создании и ведении диалога я вижу только исходящие сообщения в 1С, а вот входящих не вижу

- У вас не работает регламентное задание по получению сообщений.

 - В версии Pro сообщения отправляются, но не отображаются в чате, не вижу ни своих сообщений, которые успешно отправляются, не ответных, соответственно нет никакой истории

- Настройте webhook для своей версии Pro.

- Могу ли я, купив решение один раз, использовать его во всех подразделениях на разных конфигурациях? Нужна ли для этого лицензия? Или лицензия нужна только для соединения?

- Если вы будете использовать разработку только внутри своей компании, то ограничения не накладываются, можете применять ее в различных конфигурациях. Требуется только лицензия на соединения, как обычно в 1С. Использование разработки на тиражных решениях запрещено.

- Рассылка будет проходить как обычное sms или получатель должен меня авторизовать?

- Авторизация не требуется.

- Как быть с ситуацией если я 100% хочу донести до клиента информацию? Как узнать, что он не получил сообщение и приступить к отправке СМС?

- Для этого вам необходимо использовать версию Pro.

- В случае обновления WhatsApp и обновления GreenAPI будет ли это влиять на модуль интеграции с 1С? Если да, то как это отлавливать и дорабатывать?

- Может повлиять, если только изменится структура запросов к GreenAPI. Я не могу отвечать за этот сервис, но по всем "правилам хорошего тона" они не должны этого делать. Если же все же это случится, я обновлю и опубликованную разработку. Если же вдруг сам сервис перестанет работать, будет переделано на использование другого сервиса.

- Если менеджер переключается с работы из базы 1C на переписку непосредственно из мессенджера WhatApp, сохранится ли вся история переписки в 1С?

- Если у вас версия Pro, то да. Иначе сохранятся только входящие сообщения контрагента.

- Как хранится история переписки и файлы?

- В регистре сведений в 1С.

- Существует ли возможность доставки сообщения, если собеседник (клиент или сотрудник) в данный момент офлайн (отправка по факту подключения)?

- Да.

Версия Pro 1.8.01 от 04.04.2023

Появилась интеграция с сервисом GreenAPI. Теперь используемый сервис можно выбирать в каждом аккаунте отдельно. Для нового сервиса поддерживаются все функции, что были в системе раньше.

Версия Pro 1.7.05 от 22.04.2020

Небольшие исправления в логике работы единого окна переписки.

Версия Pro 1.7.04 от 20.04.2020

В новой версии появился новый вариант отображения переписок - единым окном. Теперь не надо открывать много окон чтобы вести много бесед, все переписки по аккаунту будут находиться в одном окне, по аналогии с веб-версией WhatsApp. Включить этот режим можно в настройках, установив галку "Единое окно переписки". После перезапуска в подсистеме WhatsApp появится новый пункт, а также это окно будет работать со всем функционалом из прошлых версий.

Рассмотрим, что есть в новом окне:

1. В левой части находится список последних бесед. Для каждой беседы отображаются имя контакта, последнее сообщение, время и количество непрочитанных, если есть. Зеленым цветом выделены контакты, с которыми беседу ведете вы, серым - другие операторы.
2. Область переписки по выбранному контакту из левого списка. Аналогична предыдущим версиям.
3. Следует различать две кнопки закрытия. Стандартная - это закрытие всего окна переписок, все активные беседы будут закрыты. Кнопка чуть ниже - это окончание текущей беседы, без закрытия всего окна.
4. Нажав правой кнопкой на беседе, можно сделать ее непрочитанной, если будет необходимо вернуться к ней позже. Как только оператор заходит в беседу, с нее снимается этот признак.

Внимание! В связи с применением нового функционала текущая версия подсистемы требует режим совместимости 8.3.8, а не 8.3.6

Версия Pro 1.6.01 от 18.03.2020

Многие пользователи жаловались, что если во время их работы в 1С приходит новое сообщение, открывается форма переписки, которая перекрывает текущее окно, что, конечно, может помешать работе. Для этого были сделаны варианты действий при новом сообщении:

1. Открыть переписку

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

2. Показать оповещение

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

3. Ничего не делать

"Тихий" режим. Для пользователей, которые должны обладать всеми правами оператора, открывать беседы, писать сообщения, но никакие оповещения им не нужны.

Вариант действия можно выбрать в настройках подсистемы для всех операторов сразу и переопределить для конкретного в списке операторов.

Версия Pro 1.5.07 от 05.03.2020

Появилась получать и отправлять все типы сообщений, а именно:

• Аудио, видео
• Голосовые сообщения
• Местоположение на карте
• Контактную информацию

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

Рис. 16

Версия Pro 1.4.02 от 16.12.2019

Теперь в качестве справочника контактов может быть использован не только справочник Контрагенты. Например, в большинстве современных типовых конфигурациях основным справочником является справочник Партнеры. Также теперь можно выбрать справочники "Контактные лица партнеров", "Пользователи", "Физические лица".

Рис. 15

Версия 1.2.01 от 28.09.2018

Добавлена возможность получения и отправки любых файлов через WhatsApp, не только изображений. Отправка производится также через кнопку со "скрепкой". Однако отправка файлов вынесена в отдельную настройку (см.  рис. 14). Дело в том, что файлы будут отправляться через Яндекс.Диск, поэтому в настройках вам необходимо будет указать почту Яндекса и пароль для доступа. Настоятельно рекомендуется завести для этого новый аккаунт, т.к. Диск будет использоваться сервисом. Просто создайте новый ящик на Яндексе и укажите регистрационные данные в настройках.

Рис. 14

Версия 1.1.01 от 01.08.2018

Добавлена возможность не только получения от клиента, но и отправки изображений. В форме переписки появилась кнопка со "скрепкой". После нажатия вам надо выбрать файл, и он будет отправлен собеседнику. Все отправленные и полученные изображения хранятся в истории переписки.

Рис. 13