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

Материал из Planfix
Перейти к: навигация, поиск
Нет описания правки
 
(не показаны 32 промежуточные версии 4 участников)
Строка 5: Строка 5:
|description=интеграция с Viber
|description=интеграция с Viber
}}
}}
Вы можете подключить в ПланФикс один или несколько специальных аккаунтов [https://www.viber.com/ Viber] и обрабатывать сообщения, приходящие по этим каналам, средствами ПланФикса. В качестве такого аккаунта могут выступать:
Вы можете [[Интеграции |подключить]] к ПланФиксу чат-ботов Viber для приема и обработки сообщений клиентов.
*public-аккаунты Viber (временно не регистрируются Viber)
*бот-аккаунты Viber (можно создать по [https://partners.viber.com/login ссылке])


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


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


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


Где вместо {botname} будет имя вашего бота. Вот так например выглядит ссылка на бот нашей службы поддержки:
== Как заполнить заявку ==
Перейдите на сайт Viber и заполните форму на английском.


[viber://pa?chatURI=planfix viber://pa?chatURI=planfix]
#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://planfix.ru/support/ на нашем сайте]
По всем вопросам можно [https://help.viber.com/hc/en-us/requests/new?ticket_form_id=5377663333917 обратиться в поддержку Viber].


== Как подключить чат-бота к ПланФиксу ==
*В ПланФиксе переходим в раздел Управление аккаунтом — Интеграции — Мессенджеры:


https://p.pfx.so/pf/eG/lsiIkH.png


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


Создать бот-аккаунт можно по [[https://partners.viber.com/login ссылке]].
*Открываем Viber и добавляем публичный аккаунт. В появившемся окне вставляем ключ API, который отправила команда Viber:


После создания бот-аккаунта вы получите ключ API, который понадобятся для подключения его в ПланФикс:
https://p.pfx.so/pf/ak/0iu4g6.png


https://p.pfx.so/pf/sH/PlOZzX.jpg


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


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


== Подключение  бот- или публичного аккаунта Viber в ПланФикс==
https://p.pfx.so/pf/jM/hBKtp5.png


'''Шаг 1:''' Скопируйте ключ API вашего public- или бот-аккаунта в приложении Viber.
== Дополнительные настройки ==
Помимо основных настроек интеграции, есть следующие дополнительные опции:


'''Шаг 2:''' В ПланФиксе перейдите в раздел '''Управление аккаунтом / Интеграции с другими сервисами / Мессенджеры''' (доступен администраторам аккаунта). Нажмите на '''Viber''':
https://p.pfx.so/pf/1f/kzrTp0.png


https://p.pfx.so/pf/hE/vLAHSJ.jpg


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


https://p.pfx.so/pf/r8/Dy4thf.jpg
*'''Отправка сообщения от лица сотрудника'''. При использовании опции клиент будет получать уведомления персонально от лица сотрудника, написавшего его в ПланФиксе.


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


https://p.pfx.so/pf/X8/eoqdQy.jpg
<pre>viber://pa?chatURI={botname}</pre>




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


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


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


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


https://p.pfx.so/pf/vS/IxqlPP.jpg
https://p.pfx.so/pf/y6/n8nihx.png




Каждое последующее сообщение от пользователя будет добавлено в его задачу новым действием. Добавляется любое содержимое сообщения: текст, приложенные фотографии, геометки, отправленные контакты, дудлы (dooddles).
*Каждое последующее сообщение от пользователя будет добавляться в его задачу.  
 
*Ваши ответы в ПланФиксе будут отправлены ему в Viber вместе с текстом сообщения и приложенными файлами, если вы укажете пользователя в блоке «Уведомить об этом».
 
Ваши ответы в ПланФиксе, в которых пользователь будет выделен в блоке "Уведомить об этом", будут отправлены ему в Viber. Помимо текста сообщения, будут отправлены приложенные к сообщению файлы, в том числе изображения.
 
 
== Дополнительные настройки интеграции ==
https://p.pfx.so/pf/XC/vqEavx.jpg
 
*'''Создавать новую задачу, если нет активных задач общения с этим контактом'''
Активация этой настройки приведет к созданию новой задачи, если нет [[Тип статуса задачи |
активных]] (то есть в любом активном статусе) задач по обращениям от клиента:
 
https://p.pfx.so/pf/4Q/AHGt0P.jpg
 
По умолчанию чекбокс включен.  При активном чекбоксе новая задача будет создаваться, если предыдущая задача данного клиента удалена, завершена или находится в неактивном статусе.
При этом ссылка на предыдущую задачу-общение автоматически добавляется в описание созданной задачи:
 
https://p.pfx.so/pf/oo/VYR2Om.jpg
 
При неактивном чекбоксе все сообщения клиента будут попадать в одну задачу, независимо от ее текущего статуса.
 
 
*'''Отправлять сообщения от лица сотрудника'''
По умолчанию, клиент получает сообщения в Viber от лица вашего паблик-аккаунта. Если активировать этот признак, клиент будет получать уведомления персонально от лица сотрудника, написавшего его в ПланФиксе.
 
https://p.pfx.so/pf/sF/hRiqIB.jpg
 


== Ограничения ==
*Публичные чаты в 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 не поддерживаются.
  • Номер телефона клиента можно узнать, только если он сам его укажет в диалоге.

Перейти