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

Материал из Planfix
Перейти к: навигация, поиск
 
(не показана 51 промежуточная версия 8 участников)
Строка 1: Строка 1:
Вы можете подключить в ПланФикс один или несколько [http://www.viber.com/ru/public-accounts публичных аккаунтов Viber] и обрабатывать сообщения, приходящие по этому каналу, средствами ПланФикса.
{{#seo:
|title=Viber
|titlemode=append
|keywords=планфикс, Viber, интеграция
|description=интеграция с Viber
}}
Вы можете [[Интеграции |подключить]] к ПланФиксу чат-ботов Viber для приема и обработки сообщений клиентов.


Сообщения пользователей в диалогах с вашим публичным аккаунтом, становятся задачами в ПланФиксе (1 задача на 1 уникального пользователя). Пользователь может обмениваться с вами текстами, изображениями, контактами и другой информацией - все отправленные им сообщения будут добавляться новыми действиями в его персональную задачу. Вы можете обрабатывать сообщения всеми доступными в ПланФиксе средствами, а ваши комментарии, изображения и файлы других типов, добавленные новыми действиями с уведомлением этого пользователя, будут отправлены ему в Viber от лица вашего публичного аккаунта.
Обратите внимание, с 5 февраля 2024 Viber обновил [https://help.viber.com/hc/en-us/articles/15247629658525-Bot-Commercial-Model условия создания чат-ботов] — теперь это платная функция. Если ваш чат-бот создан ранее этой даты, то он будет работать на старых условиях.


== Возможности ==
*Удобная обработка обращений клиентов из Viber в едином интерфейсе ПланФикса.
*Автоматическое сохранение контактов клиентов.
*Доступны [[Быстрые ответы |быстрые ответы]], для ответа на часто задаваемые вопросы клиентов.


== Создание публичного аккаунта Viber ==
== Как создать чат-бота в Viber ==
'''Если у вас уже есть публичный аккаунт Viber, можете перейти к следующему разделу.'''
#Заполните [https://share.hsforms.com/12pxGHMtAS3yq_3KcxQ6g1A4fpwx заявку на создание бота] в Viber.
#Команда Viber свяжется с вами для обсуждения дальнейших шагов.
#Когда заявку одобрят, вы получите ключ API, необходимый для подключения интеграции в ПланФиксе.  


'''Шаг 1:''' На текущий момент создание публичного аккаунта Viber доступно только по предварительной заявке. Для того, чтобы оставить ее, перейдите по этой ссылке: [https://support.viber.com/customer/ru/widget/emails/new?interaction_name=NEWEA Заявка на паблик аккаунт Вайбера]
== Как заполнить заявку ==
Перейдите на сайт Viber и заполните форму на английском.


Для получения публичного аккаунта, у вас должен быть обычный Viber-аккаунт. После заполнения небольшой формы по ссылке, вам на этот аккаунт придет сообщение о предоставлении доступа к созданию публичного аккаунта. Сообщение приходит быстро и имеет такой вид:
#Are you familiar with new Chatbot Commercial Terms? — Вы ознакомились с коммерческими условиями подключения чат-бота? Выберите: Да/Нет
#First name — Имя
#Last name — Фамилия
#Work email — Рабочая электронная почта
#Country — Страна
#Company name — Название компании
#Company website — Сайт компании
#Do you have a Viber Business Account? — У вас есть бизнес аккаунт Viber? Выберите: Да/Нет
#Company type — тип компании:
##Владелец чат-бота
##Разработчик чат-бота
##Занимаетесь перепродажей чат-ботов
##Другое
#Your inquiry — ваш запрос. Напишите, что вы хотите подключить чат-бота.


https://p.pfx.so/pf/5n/UXbtEr.jpg
По всем вопросам можно [https://help.viber.com/hc/en-us/requests/new?ticket_form_id=5377663333917 обратиться в поддержку Viber].


'''Шаг 2:''' Перезагрузите приложение Viber. После перезагрузки в интерфейсе появится раздел для работы с паблик-аккаунтами. Нажмите в него (1) и создайте новый аккаунт (2):
== Как подключить чат-бота к ПланФиксу ==
*В ПланФиксе переходим в раздел Управление аккаунтом — Интеграции — Мессенджеры:


https://p.pfx.so/pf/RM/kBMYn3.jpg
https://p.pfx.so/pf/eG/lsiIkH.png


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


https://p.pfx.so/pf/27/QO9YSq.jpg
*Открываем Viber и добавляем публичный аккаунт. В появившемся окне вставляем ключ API, который отправила команда Viber:


https://p.pfx.so/pf/ak/0iu4g6.png


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


'''Шаг 1:''' Скопируйте ключ API публичного аккаунта в приложении Viber.
В этом же окне:
*Выберите шаблоны, по которым будут создаваться контакты или задачи.
*Укажите, кого [[Дополнительное подключение сотрудников |дополнительно подключать к общению в качестве исполнителей]].


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


https://p.pfx.so/pf/Yx/nLGzGA.jpg
https://p.pfx.so/pf/jM/hBKtp5.png


В открывшейся панели нажмите на кнопку '''Добавить публичный аккаунт ''' и вставьте скопированный ключ API в появившееся поле:
== Дополнительные настройки ==
Помимо основных настроек интеграции, есть следующие дополнительные опции:


https://p.pfx.so/pf/5E/fPjVWF.jpg
https://p.pfx.so/pf/1f/kzrTp0.png


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


https://p.pfx.so/pf/X8/eoqdQy.jpg
*'''Создание новой задачи, если нет активных задач общения с этим клиентом'''. При активации этой опции новая задача будет создаваться, если предыдущая задача клиента удалена, завершена или находится в неактивном статусе. При этом ссылка на предыдущую задачу автоматически добавляется в описание новой.


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


== Работа в ПланФиксе с обращениями пользователей Viber ==
== Работа интеграции ==
Для того, чтобы написать вашему бот-аккаунту Viber пользователь должен перейти по специальной ссылке, где вместо {botname} будет имя вашего бота:


'''Первое сообщение от пользователя.''' Когда пользователь Viber впервые напишет личное сообщение в вашем публичном аккаунте, в ПланФиксе:
<pre>viber://pa?chatURI={botname}</pre>
*Будет создана карточка контакта этого пользователя с его именем и аватаром из Viber
*Будет создана новая задача, в которой пользователь становится постановщиком, а текст его сообщения - текстом задачи.


https://p.pfx.so/pf/u6/B4sgC3.jpg


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


https://p.pfx.so/pf/vS/IxqlPP.jpg
<pre>viber://pa?chatURI=planfix</pre>




'''Последующие общение с пользователем:'''
*Когда пользователь Viber впервые напишет личное сообщение, в ПланФиксе будет создана новая задача, в которой клиент станет постановщиком.  
*Каждое последующее сообщение от пользователя будет добавлено в его задачу новым действием. Добавляется любое содержимое сообщения: текст, приложенные фотографии, геометки, отправленные контакты, дудлы (dooddles).
*Исполнителем становится сотрудник, указанный в шаблоне задач интеграции.  
*При настройке интеграции есть возможность создавать новую задачу, если нет [[Тип статуса задачи |
*Если исполнителем не указан никто, система назначит им владельца аккаунта или сотрудника, который настраивал интеграцию:
активных]] (то есть в любом активном статусе) задач по обращениям от клиента:


https://p.pfx.so/pf/y6/n8nihx.png


https://p.pfx.so/pf/KB/wMxSW3.jpg


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


По умолчанию чекбокс включен.  При активном чекбоксе новая задача будет создаваться, если предыдущая задача данного клиента удалена, завершена или находится в неактивном статусе.
== Ограничения ==
При этом история переписки автоматически добавляется в описание созданной задачи:
*Публичные чаты в Viber не поддерживаются.  
 
*Номер телефона клиента можно узнать, только если он сам его укажет в диалоге.
 
https://p.pfx.so/pf/oo/VYR2Om.jpg
 
 
При неактивном чекбоксе все сообщения клиента будут попадать в одну задачу, независимо от ее текущего статуса.
 
*Ваши ответы  в ПланФиксе, в которых пользователь будет выделен в блоке "Уведомить об этом", будут отправлены ему в Viber от лица публичного аккаунта. Помимо текста сообщения, будут отправлены приложенные к сообщению файлы, в том числе изображения.
 
'''Удаление задачи'''
*Если вы удалите задачу, в которой идет общение с пользователем Viber, она будет перемещена в '''Корзину''' (Задачи / Корзина). Новые сообщения пользователя будут продолжать добавляться в удаленную задачу, но вы их не увидите. Такое поведение системы задумано специально - оно является аналогом "черного списка" и позволяет не отвлекаться на сообщения от троллей и неадекватных пользователей.
*Если восстановить задачу из Корзины, все сообщения станут доступны и дальнейшее общение с этим пользователем будет отрабатываться обычным образом.
*Если удалить задачу из Корзины, следующее полученное от данного пользователя сообщение приведет к созданию новой задачи. Таким образом можно очистить историю взаимоотношений с ним, если по какой-то причине это понадобится.


== Перейти ==
== Перейти ==
 
*[[Интеграции]]
[[Интеграции]]

Текущая версия от 06:24, 15 июля 2024

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

Обратите внимание, с 5 февраля 2024 Viber обновил условия создания чат-ботов — теперь это платная функция. Если ваш чат-бот создан ранее этой даты, то он будет работать на старых условиях.

Возможности

  • Удобная обработка обращений клиентов из Viber в едином интерфейсе ПланФикса.
  • Автоматическое сохранение контактов клиентов.
  • Доступны быстрые ответы, для ответа на часто задаваемые вопросы клиентов.

Как создать чат-бота в Viber

  1. Заполните заявку на создание бота в Viber.
  2. Команда Viber свяжется с вами для обсуждения дальнейших шагов.
  3. Когда заявку одобрят, вы получите ключ API, необходимый для подключения интеграции в ПланФиксе.

Как заполнить заявку

Перейдите на сайт Viber и заполните форму на английском.

  1. Are you familiar with new Chatbot Commercial Terms? — Вы ознакомились с коммерческими условиями подключения чат-бота? Выберите: Да/Нет
  2. First name — Имя
  3. Last name — Фамилия
  4. Work email — Рабочая электронная почта
  5. Country — Страна
  6. Company name — Название компании
  7. Company website — Сайт компании
  8. Do you have a Viber Business Account? — У вас есть бизнес аккаунт Viber? Выберите: Да/Нет
  9. Company type — тип компании:
    1. Владелец чат-бота
    2. Разработчик чат-бота
    3. Занимаетесь перепродажей чат-ботов
    4. Другое
  10. Your inquiry — ваш запрос. Напишите, что вы хотите подключить чат-бота.

По всем вопросам можно обратиться в поддержку Viber.

Как подключить чат-бота к ПланФиксу

  • В ПланФиксе переходим в раздел Управление аккаунтом — Интеграции — Мессенджеры:

lsiIkH.png


  • Открываем Viber и добавляем публичный аккаунт. В появившемся окне вставляем ключ API, который отправила команда Viber:

0iu4g6.png


В этом же окне:

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

hBKtp5.png

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

Помимо основных настроек интеграции, есть следующие дополнительные опции:

kzrTp0.png


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

Работа интеграции

Для того, чтобы написать вашему бот-аккаунту Viber пользователь должен перейти по специальной ссылке, где вместо {botname} будет имя вашего бота:

viber://pa?chatURI={botname}


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

viber://pa?chatURI=planfix


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

n8nihx.png


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

Ограничения

  • Публичные чаты в Viber не поддерживаются.
  • Номер телефона клиента можно узнать, только если он сам его укажет в диалоге.

Перейти