Viber — различия между версиями

Материал из ПланФикс
Перейти к: навигация, поиск
 
(не показано 35 промежуточных версий 7 участников)
Строка 1: Строка 1:
Вы можете подключить в ПланФикс один или несколько [http://www.viber.com/ru/public-accounts публичных аккаунтов Viber] и обрабатывать сообщения, приходящие по этому каналу, средствами ПланФикса.
+
{{#seo:
 +
|title=Viber
 +
|titlemode=append
 +
|keywords=планфикс, Viber, интеграция
 +
|description=интеграция с Viber
 +
}}
 +
Вы можете подключить в ПланФикс один или несколько специальных аккаунтов [https://www.viber.com/ Viber] и обрабатывать сообщения, приходящие по этим каналам, средствами ПланФикса. В качестве такого аккаунта могут выступать:
 +
*public-аккаунты Viber (временно не регистрируются Viber)
 +
*бот-аккаунты Viber (можно создать по [https://partners.viber.com/login ссылке])
  
Сообщения пользователей в диалогах с вашим публичным аккаунтом, становятся задачами в ПланФиксе (1 задача на 1 уникального пользователя). Пользователь может обмениваться с вами текстами, изображениями, контактами и другой информацией - все отправленные им сообщения будут добавляться новыми действиями в его персональную задачу. Вы можете обрабатывать сообщения всеми доступными в ПланФиксе средствами, а ваши комментарии, изображения и файлы других типов, добавленные новыми действиями с уведомлением этого пользователя, будут отправлены ему в Viber от лица вашего публичного аккаунта.
+
Сообщения пользователей в диалогах с такими аккаунтами, становятся [[Задачи | задачами]] в ПланФиксе. Пользователь может обмениваться с вами текстами, изображениями, контактами и другой информацией - все отправленные им сообщения будут добавляться новыми действиями в созданную задачу-общение. Вы можете обрабатывать такие сообщения всеми доступными в ПланФиксе средствами, а ваши комментарии, изображения и файлы других типов, добавленные новыми действиями с уведомлением этого пользователя, будут отправлены ему в Viber.
  
  
== Создание публичного аккаунта Viber ==
+
== Общая информация ==
'''Если у вас уже есть публичный аккаунт Viber, можете перейти к следующему разделу.'''
 
  
'''Шаг 1:''' На текущий момент создание публичного аккаунта Viber доступно только по предварительной заявке. Для того, чтобы оставить ее, перейдите по этой ссылке: [https://support.viber.com/customer/ru/widget/emails/new?interaction_name=NEWEA Заявка на паблик аккаунт Вайбера]
+
Чтобы написать вашему бот-аккаунту Viber пользователь должен перейти по специальной ссылке:
  
Для получения публичного аккаунта, у вас должен быть обычный Viber-аккаунт. После заполнения небольшой формы по ссылке, вам на этот аккаунт придет сообщение о предоставлении доступа к созданию публичного аккаунта. Сообщение приходит быстро и имеет такой вид:
+
viber://pa?chatURI={botname}
  
https://pic.planfix.ru/pf/5n/UXbtEr.jpg
+
Где вместо {botname} будет имя вашего бота. Вот так, например, выглядит ссылка на бот нашей службы поддержки:
  
'''Шаг 2:''' Перезагрузите приложение Viber. После перезагрузки в интерфейсе появится раздел для работы с паблик-аккаунтами. Нажмите в него (1) и создайте новый аккаунт (2):
+
viber://pa?chatURI=planfix
  
https://pic.planfix.ru/pf/RM/kBMYn3.jpg
+
Вы можете разместить её у себя на сайте или в соц. сетях, пример можно посмотреть [https://planfix.ru/support/ на нашем сайте]
  
После создания публичного аккаунта, скопируйте ключ API - он понадобится для добавления интеграции с этим публичным аккаунтом в ПланФикс:
+
Если у клиента установлен десктоп-приложение Viber или клиент заходит с мобильного телефона, то при клике на такую ссылку произойдет подключение бота в контакт-лист Viber и далее можно будет общаться с ним через ПланФикс подключив бота к нему.
  
https://pic.planfix.ru/pf/27/QO9YSq.jpg
+
Если у клиента не установлено десктоп-приложение Viber (что чаще всего бывает), то при при клике на такую ссылку в браузере ничего не произойдет 🙁. В таком случае, можно только рекомендовать зайти на неё с мобильного устройства или установить десктоп-приложение Viber.
  
 +
Viber не передает номер телефона клиента при общении в чате, т.е получить номер телефона через Viber можно, только если сам клиент укажет его в диалоге.
  
== Подключение  публичного аккаунта Viber в ПланФикс==
 
  
'''Шаг 1:''' Скопируйте ключ API публичного аккаунта в приложении Viber.
+
== Создание бот-аккаунта Viber ==
  
'''Шаг 2:''' В ПланФиксе перейдите в раздел '''Управление аккаунтом / Интеграции''' (доступен администраторам аккаунта). Нажмите на '''Интеграция с Viber''':
+
Создать бот-аккаунт можно по [[https://partners.viber.com/login ссылке]].
 +
 
 +
После создания бот-аккаунта вы получите ключ API, который понадобятся для подключения его в ПланФикс:
 +
 
 +
https://pic.planfix.ru/pf/sH/PlOZzX.jpg
 +
 
 +
 
 +
 
 +
== Подключение  бот- или публичного аккаунта Viber в ПланФикс==
 +
 
 +
'''Шаг 1:''' Скопируйте ключ API вашего public- или бот-аккаунта в приложении Viber.
 +
 
 +
'''Шаг 2:''' В ПланФиксе перейдите в раздел '''Управление аккаунтом / Интеграции / Мессенджеры''' (доступен администраторам аккаунта). Нажмите на '''Viber''':
 +
 
 +
 
 +
https://pic.planfix.ru/pf/77/frv31L.png
  
https://pic.planfix.ru/pf/Yx/nLGzGA.jpg
 
  
 
В открывшейся панели нажмите на кнопку '''Добавить публичный аккаунт ''' и вставьте скопированный ключ API в появившееся поле:
 
В открывшейся панели нажмите на кнопку '''Добавить публичный аккаунт ''' и вставьте скопированный ключ API в появившееся поле:
  
https://pic.planfix.ru/pf/5E/fPjVWF.jpg
+
https://pic.planfix.ru/pf/r8/Dy4thf.jpg
  
После добавления ключа ваш публичный аккаунт будет подключен в ПланФикс.  
+
После добавления ключа ваш аккаунт будет подключен в ПланФикс.  
  
https://pic.planfix.ru/pf/X8/eoqdQy.jpg
+
https://p.pfx.so/pf/Ds/08qnLU.png
  
  
 
== Работа в ПланФиксе с обращениями пользователей Viber ==
 
== Работа в ПланФиксе с обращениями пользователей Viber ==
  
'''Первое сообщение от пользователя.''' Когда пользователь Viber впервые напишет личное сообщение в вашем публичном аккаунте, в ПланФиксе:
+
'''Первое сообщение от пользователя.''' Когда пользователь Viber впервые напишет личное сообщение в вашем аккаунте, в ПланФиксе:
 
*Будет создана карточка контакта этого пользователя с его именем и аватаром из Viber
 
*Будет создана карточка контакта этого пользователя с его именем и аватаром из Viber
*Будет создана новая задача, в которой пользователь становится постановщиком, а текст его сообщения - текстом задачи.
+
*Будет создана новая задача, в которой пользователь становится постановщиком, а текст его сообщения - текстом задачи. Исполнителем становится сотрудник, указанный в шаблоне, по которому создаются задачи по интеграции. Если исполнителем не указан никто, система назначит им владельца аккаунта или сотрудника, который настраивал интеграцию.
  
 
https://pic.planfix.ru/pf/u6/B4sgC3.jpg
 
https://pic.planfix.ru/pf/u6/B4sgC3.jpg
  
В настройках интеграции вы можете выбрать шаблоны, по которым будут создаваться контакты и задачи в этом случае:
+
В настройках интеграции вы можете выбрать шаблоны, по которым будут создаваться контакты и задачи в этом случае. А также указать, кого из сотрудников необходимо [[Дополнительное подключение сотрудников |дополнительно подключать к общению в качестве исполнителей]]:
  
https://pic.planfix.ru/pf/vS/IxqlPP.jpg
+
https://p.pfx.so/pf/dL/w11U6L.png
  
  
'''Последующие общение с пользователем:'''
+
Каждое последующее сообщение от пользователя будет добавлено в его задачу новым действием. Добавляется любое содержимое сообщения: текст, приложенные фотографии, геометки, отправленные контакты, дудлы (dooddles).
*Каждое последующее сообщение от пользователя будет добавлено в его задачу новым действием. Добавляется любое содержимое сообщения: текст, приложенные фотографии, геометки, отправленные контакты, дудлы (dooddles).
+
 
*Ваши ответы  в ПланФиксе, в которых пользователь будет выделен в блоке "Уведомить об этом", будут отправлены ему в Viber от лица публичного аккаунта. Помимо текста сообщения, будут отправлены приложенные к сообщению файлы, в том числе изображения.
+
 
 +
Ваши ответы  в ПланФиксе, в которых пользователь будет выделен в блоке "Уведомить об этом", будут отправлены ему в Viber. Помимо текста сообщения, будут отправлены приложенные к сообщению файлы, в том числе изображения.
 +
 
 +
 
 +
== Дополнительные настройки интеграции ==
 +
https://p.pfx.so/pf/hG/xgB93I.png
 +
 
 +
*'''Создавать новую задачу, если нет активных задач общения с этим контактом'''
 +
Активация этой настройки приведет к созданию новой задачи, если нет [[Тип статуса задачи |
 +
активных]] (то есть в любом активном статусе) задач по обращениям от клиента:
 +
 
 +
По умолчанию чекбокс включен.  При активном чекбоксе новая задача будет создаваться, если предыдущая задача данного клиента удалена, завершена или находится в неактивном статусе.
 +
При этом ссылка на предыдущую задачу-общение автоматически добавляется в описание созданной задачи:
 +
 
 +
https://pic.planfix.ru/pf/oo/VYR2Om.jpg
 +
 
 +
 
 +
При неактивном чекбоксе все сообщения клиента будут попадать в одну задачу, независимо от ее текущего статуса.
 +
 
 +
 
 +
*'''Отправлять сообщения от лица сотрудника'''
 +
По умолчанию, клиент получает сообщения в Viber от лица вашего паблик-аккаунта. Если активировать этот признак, клиент будет получать уведомления персонально от лица сотрудника, написавшего его в ПланФиксе.
  
'''Удаление задачи'''
 
*Если вы удалите задачу, в которой идет общение с пользователем Viber, она будет перемещена в '''Корзину''' (Задачи / Корзина). Новые сообщения пользователя будут продолжать добавляться в удаленную задачу, но вы их не увидите. Такое поведение системы задумано специально - оно является аналогом "черного списка" и позволяет не отвлекаться на сообщения от троллей и неадекватных пользователей.
 
*Если восстановить задачу из Корзины, все сообщения станут доступны и дальнейшее общение с этим пользователем будет отрабатываться обычным образом.
 
*Если удалить задачу из Корзины, следующее полученное от данного пользователя сообщение приведет к созданию новой задачи. Таким образом можно очистить историю взаимоотношений с ним, если по какой-то причине это понадобится.
 
  
  
 
== Перейти ==
 
== Перейти ==
 
+
*[[Интеграции]]
[[Интеграции]]
 

Текущая версия на 11:42, 1 сентября 2021

Вы можете подключить в ПланФикс один или несколько специальных аккаунтов Viber и обрабатывать сообщения, приходящие по этим каналам, средствами ПланФикса. В качестве такого аккаунта могут выступать:

  • public-аккаунты Viber (временно не регистрируются Viber)
  • бот-аккаунты Viber (можно создать по ссылке)

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


Общая информация

Чтобы написать вашему бот-аккаунту Viber пользователь должен перейти по специальной ссылке:

viber://pa?chatURI={botname}

Где вместо {botname} будет имя вашего бота. Вот так, например, выглядит ссылка на бот нашей службы поддержки:

viber://pa?chatURI=planfix

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

Если у клиента установлен десктоп-приложение Viber или клиент заходит с мобильного телефона, то при клике на такую ссылку произойдет подключение бота в контакт-лист Viber и далее можно будет общаться с ним через ПланФикс подключив бота к нему.

Если у клиента не установлено десктоп-приложение Viber (что чаще всего бывает), то при при клике на такую ссылку в браузере ничего не произойдет 🙁. В таком случае, можно только рекомендовать зайти на неё с мобильного устройства или установить десктоп-приложение Viber.

Viber не передает номер телефона клиента при общении в чате, т.е получить номер телефона через Viber можно, только если сам клиент укажет его в диалоге.


Создание бот-аккаунта Viber

Создать бот-аккаунт можно по [ссылке].

После создания бот-аккаунта вы получите ключ API, который понадобятся для подключения его в ПланФикс:

PlOZzX.jpg


Подключение бот- или публичного аккаунта Viber в ПланФикс

Шаг 1: Скопируйте ключ API вашего public- или бот-аккаунта в приложении Viber.

Шаг 2: В ПланФиксе перейдите в раздел Управление аккаунтом / Интеграции / Мессенджеры (доступен администраторам аккаунта). Нажмите на Viber:


frv31L.png


В открывшейся панели нажмите на кнопку Добавить публичный аккаунт и вставьте скопированный ключ API в появившееся поле:

Dy4thf.jpg

После добавления ключа ваш аккаунт будет подключен в ПланФикс.

08qnLU.png


Работа в ПланФиксе с обращениями пользователей Viber

Первое сообщение от пользователя. Когда пользователь Viber впервые напишет личное сообщение в вашем аккаунте, в ПланФиксе:

  • Будет создана карточка контакта этого пользователя с его именем и аватаром из Viber
  • Будет создана новая задача, в которой пользователь становится постановщиком, а текст его сообщения - текстом задачи. Исполнителем становится сотрудник, указанный в шаблоне, по которому создаются задачи по интеграции. Если исполнителем не указан никто, система назначит им владельца аккаунта или сотрудника, который настраивал интеграцию.

B4sgC3.jpg

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

w11U6L.png


Каждое последующее сообщение от пользователя будет добавлено в его задачу новым действием. Добавляется любое содержимое сообщения: текст, приложенные фотографии, геометки, отправленные контакты, дудлы (dooddles).


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


Дополнительные настройки интеграции

xgB93I.png

  • Создавать новую задачу, если нет активных задач общения с этим контактом

Активация этой настройки приведет к созданию новой задачи, если нет активных (то есть в любом активном статусе) задач по обращениям от клиента:

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

VYR2Om.jpg


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


  • Отправлять сообщения от лица сотрудника

По умолчанию, клиент получает сообщения в Viber от лица вашего паблик-аккаунта. Если активировать этот признак, клиент будет получать уведомления персонально от лица сотрудника, написавшего его в ПланФиксе.


Перейти