Интеграция с ВКонтакте: различия между версиями

Материал из Planfix
Перейти к: навигация, поиск
 
(не показана 71 промежуточная версия 6 участников)
Строка 1: Строка 1:
ПланФикс позволяет вести переписку с клиентами, которые пишут сообщения в ваше сообщество ВКонтакте, прямо из ПланФикса.  
{{#seo:
|title=Интеграция с Вконтакте
|titlemode=append
|keywords=планфикс, Интеграции, Вконтакте
|description=Интеграция с Вконтакте
}}
ПланФикс позволяет вести переписку с клиентами, которые пишут сообщения в ваше сообщество ВКонтакте прямо из ПланФикса.  


Интеграция использует официальные API ВКонтакте.
Интеграция использует официальные API ВКонтакте.




== Настройка интеграции ==
== Навигация ==
*[[#Настройка интеграции в ПланФиксе |Настройка интеграции в ПланФиксе]]
*[[#Настройка интеграции в ВКонтакте |Настройка интеграции в ВКонтакте]]
*[[#Работа с личными сообщениями |Работа с личными сообщениями]]
*[[#Получение в ПланФикс комментариев из ВКонтакте |Получение в ПланФикс комментариев из ВКонтакте]]
*[[#Получение заявок с лид-форм ВКонтакте |Получение заявок с лид-форм ВКонтакте]]


Настроить интеграцию может администратор аккаунта ПланФикса в разделе '''Управление аккаунтом''', вкладка '''Интеграции''':


== Настройка интеграции в ПланФиксе ==
Настроить интеграцию может администратор аккаунта ПланФикса в разделе '''Управление аккаунтом''', вкладка '''Интеграции - Социальные сети''':


https://p.pfx.so/pf/rs/BZ01rQ.jpg
https://p.pfx.so/pf/Vz/s7z8MW.png




После этого нужно нажать на '''Интеграцию с ВКонтакте''', а затем на '''Добавить группу''':
https://p.pfx.so/pf/ws/Vmb7jc.png




https://p.pfx.so/pf/12/NdOM4H.jpg
После этого нужно нажать на '''ВКонтакте''', а затем на '''Добавить группу''':
 
https://p.pfx.so/pf/jy/faxIbd.png




В появившемся окошке подтвердить согласие:
В появившемся окошке подтвердить согласие:


https://p.pfx.so/pf/O9/qQjEdQ.png


https://p.pfx.so/pf/lL/OSy5ZV.jpg


После этого на странице интеграции в ПланФиксе появится название и логотип вашей группы.  
После этого на странице интеграции в ПланФиксе появится название и логотип вашей группы.  
Для начала получения сообщения из нее нужно кликнуть на '''Активировать''':
Для начала получения сообщения из нее нужно:
*Кликнуть на '''Активировать''':
 
https://p.pfx.so/pf/o1/prVEQS.png
 


*И настроить параметры интеграции:


https://p.pfx.so/pf/Yo/xEkhbU.jpg
https://p.pfx.so/pf/qp/u3Jjti.png




и подтвердить разрешение на получение информации из группы:
и подтвердить разрешение на получение информации из группы:


https://p.pfx.so/pf/pY/NyD2Xr.png
Если все сделано верно, кнопка '''Активировать''' станет зеленой:
https://p.pfx.so/pf/mJ/gbuN2B.png


https://p.pfx.so/pf/iD/upZKcv.jpg
== Настройка интеграции в ВКонтакте ==
После окончания настройки интеграции в ПланФиксе вы увидите информационное окно:


https://p.pfx.so/pf/bd/54k1t8.png


Если все сделано верно, кнопка '''Активировать''' станет зеленой:


Для окончания настройки вам необходимо сделать следующее:
1. '''Скопируйте''' из него указанную ссылку.
2. '''Перейдите''' в управление группой ВКонтакте и '''вставьте''' в соответствующее поле эту ссылку и ключ, а также отметьте нужные типы контента, который будет попадать в ПланФикс, как это показано ниже.


https://p.pfx.so/pf/19/OZUglH.jpg
'''Важно:'''
*Указывайте последнюю версию API ВКонтакте. Обычно она первая в списке.
*Без настроек во ВКонтакте интеграция работать не будет.


https://p.pfx.so/pf/mq/bWhxn1.gif
:Посмотреть [https://p.pfx.so/pf/mq/bWhxn1.gif в новом окне] и большем размере.


== Использование интеграции ==


== Работа с личными сообщениями ==
Пользователь ВКонтакте пишет личное сообщение в сообщество, нажав эту кнопку на его странице:
Пользователь ВКонтакте пишет личное сообщение в сообщество, нажав эту кнопку на его странице:


 
https://p.pfx.so/pf/Gw/ipTaij.png
https://p.pfx.so/pf/60/oFDlnI.jpg




В ПланФиксе автоматически создается задача с текстом его сообщения.  
В ПланФиксе автоматически создается задача с текстом его сообщения.  
Все комментарии, написанные в ПланФиксе, пользователь ВКонтакте видит в чате, как при общении внутри соцсети:
Все комментарии, написанные в ПланФиксе, пользователь ВКонтакте видит в чате, как при общении внутри соцсети:
https://p.pfx.so/pf/0H/ldwXTJ.png




https://p.pfx.so/pf/d5/GB0Sp7.jpg
В то же время в ПланФиксе это выглядит как обычная задача:


https://p.pfx.so/pf/hr/ZUx5DK.png


В то же время в ПланФиксе это выглядит как обычная задача:


'''Полезно:''' Если вы отредактируете комментарий в ПланФиксе, его текст в ВК тоже изменится. Это позволяет исправлять ошибки и опечатки в отправленных клиенту сообщениях.
== Получение в ПланФикс комментариев из ВКонтакте ==
Вы можете включить получение в ПланФикс комментариев, оставляемых пользователями ВК к публикациям, обсуждениям или фотографиям в группе
https://p.pfx.so/pf/Yn/EtPBqf.gif
:Посмотреть [https://p.pfx.so/pf/Yn/EtPBqf.gif в новом окне] и большем размере.
В работе с комментариями из ВК в ПланФиксе используется следующая логика:
*Для каждого поста / фотографии / видео / обсуждения создается отдельная задача в ПланФиксе. Это происходит автоматически, в момент появления нового комментария к этой публикации.
*Постановщиком этой задачи становится сотрудник, указанный в шаблоне в настройках интеграции. Если в шаблоне выбрана опция '''Создатель задачи''', постановщиком становится сотрудник, который настраивал интеграцию.
*Исполнителями задачи становятся исполнители, указанные в шаблоне, по которому создаются задачи. В настройках интеграции можно указать сотрудников, которые [[Дополнительное подключение сотрудников |дополнительно подключаются]] к задаче в качестве исполнителей.
*Если появляется новый комментарий к публикации, которая уже присутствует в ПланФиксе в виде задачи, то он добавляется в эту задачу новым действием.
*Если задача по данной публикации завершена и в настройках интеграции активирована опция '''Создавать новую задачу, если нет активных задач общения с этим контактом''', будет создана новая задача по этой публикации и в нее добавлен этот комментарий
*Возможность отвечать на комментарий пользователя прямо из ПланФикса есть только для комментариев, оставленных к постам на стене группы. Для ответа достаточно выделить получателя в блоке '''Уведомить об этом''' при создании нового действия.
*Для ответа на комментарии, оставленные к другим типам публикаций в группе ВК, необходимо перейти в ВК и ответить там. Для удобства под каждым комментарием в ПланФиксе отображается прямая ссылка на него в ВК.
*Если в ваш ответ на комментарий под публикацией на странице сообщества вкралась ошибка, исправить ее можно только в самом ВК.
== Получение заявок с лид-форм ВКонтакте ==
Вы можете включить получение в ПланФикс данных, оставленных пользователями ВК в ваших формах сбора заявок. Для этого активируйте чекбокс в настройках API ('''ВКонтакте / Управление страницей / Работа с API / Callback API / Типы событий'''):
https://p.pfx.so/pf/Ws/pwsIcF.png


https://p.pfx.so/pf/Sy/AbySDM.jpg


Особенностью этого типа интеграции является то, что если вы добавите в шаблон задачи, по которой создается лид в ПланФиксе, пользовательские поля с названиями, аналогичными названиям полей лид-формы ВК, эти поля будут автоматически заполнены данными из формы. Подробнее: [https://planfix.com/ru/blog/sbor-zayavok-lid-forma-vkontakte/ Сбор заявок: лид-форма ВКонтакте]


== Обратите внимание: ==


== Обратите внимание ==
*Вы можете добавлять в свой аккаунт несколько групп ВКонтакте.
*Вы можете добавлять в свой аккаунт несколько групп ВКонтакте.
*Интеграция работает только с открытыми группами.
*Вы можете выбрать [[шаблоны задач | шаблон задачи]], по которому при поступлении новых сообщений будут создаваться задачи в ПланФиксе.  
*Вы можете выбрать [[шаблоны задач | шаблон задачи]], по которому при поступлении новых сообщений будут создаваться задачи в ПланФиксе.  
*Убедитесь, что в используемом шаблоне указаны исполнители.
*Убедитесь, что в используемом шаблоне указаны исполнители.
*По правилам сети ВКонтакте, вы можете написать пользователю только в течение 10 дней с момента его последнего комментария.  
*По правилам сети ВКонтакте, вы можете написать пользователю только в течение 10 дней с момента его последнего комментария.  
*Интеграция ПланФикса и ВКонтакте доступна во всех платных и премиум-аккаунтах.
*Интеграция ПланФикса и ВКонтакте доступна во всех платных и премиум-аккаунтах.
*В настройке интеграции есть возможность активировать опцию [[Создавать новую задачу если нет активных задач общения с этим контактом |Создавать новую задачу, если нет активных задач общения с этим контактом]]
*При работе с автоматическими рассылками в ВКонтакте удобно активировать опцию [[Создавать задачи по исходящим сообщениям только в случае получения ответа]]
*[[Опции интеграции: не прикреплять файлы публикации в задачу | Не прикрепляйте файлы публикации в задачу]], если они вам не нужны в ней.
*Из истории переписки с контактом в новую задачу по умолчанию добавляется 10 последних сообщений. Это количество можно изменить: 1, 5, 10, 20, 50.




При настройке интеграции есть возможность создавать новую задачу, если нет [[Тип статуса задачи |
== Важно ==
активных]] (то есть в любом активном статусе) задач по обращениям от клиента:
Для работы с массовыми рассылками из ВКонтакте, Instagram и WhatsApp в ПланФиксе действует специальный механизм. Пока он работает следующим образом: если в течение 5 минут система обнаруживает больше 3 однотипных исходящих сообщений — они считаются массовой рассылкой.


Такие сообщения сохраняются в базу ПланФикса, но в задачи не добавляются, пока на такое сообщение не будет получен ответ клиента. Когда ответ поступит, ПланФикс проверит наличие сообщения в базе и, если оно найдено, добавит сообщение в задачу вместе с ответом клиента.


https://p.pfx.so/pf/KB/wMxSW3.jpg
Обратите внимание, в базе ПланФикса сообщения с признаком массовой рассылки хранятся один месяц.


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


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


== Дополнительно ==
*В переписке с клиентами для ответа на типовые вопросы вы можете использовать механизм [[Быстрые ответы |быстрых ответов]].


https://p.pfx.so/pf/oo/VYR2Om.jpg
При неактивном чекбоксе все сообщения клиента будут попадать в одну задачу, независимо от ее текущего статуса.


== Перейти ==
== Перейти ==
 
*[[Добавление ссылки на профиль ВКонтакте в карточку контакта]]
*[[Интеграции]]
*[[Интеграции]]
*[[Как добавить id Вконтакте в карточку контакта?]]

Текущая версия от 10:56, 18 марта 2024

ПланФикс позволяет вести переписку с клиентами, которые пишут сообщения в ваше сообщество ВКонтакте прямо из ПланФикса.

Интеграция использует официальные API ВКонтакте.


Навигация


Настройка интеграции в ПланФиксе

Настроить интеграцию может администратор аккаунта ПланФикса в разделе Управление аккаунтом, вкладка Интеграции - Социальные сети:

s7z8MW.png


Vmb7jc.png


После этого нужно нажать на ВКонтакте, а затем на Добавить группу:

faxIbd.png


В появившемся окошке подтвердить согласие:

qQjEdQ.png


После этого на странице интеграции в ПланФиксе появится название и логотип вашей группы. Для начала получения сообщения из нее нужно:

  • Кликнуть на Активировать:

prVEQS.png


  • И настроить параметры интеграции:

u3Jjti.png


и подтвердить разрешение на получение информации из группы:

NyD2Xr.png


Если все сделано верно, кнопка Активировать станет зеленой:

gbuN2B.png

Настройка интеграции в ВКонтакте

После окончания настройки интеграции в ПланФиксе вы увидите информационное окно:

54k1t8.png


Для окончания настройки вам необходимо сделать следующее: 1. Скопируйте из него указанную ссылку. 2. Перейдите в управление группой ВКонтакте и вставьте в соответствующее поле эту ссылку и ключ, а также отметьте нужные типы контента, который будет попадать в ПланФикс, как это показано ниже.

Важно:

  • Указывайте последнюю версию API ВКонтакте. Обычно она первая в списке.
  • Без настроек во ВКонтакте интеграция работать не будет.

bWhxn1.gif

Посмотреть в новом окне и большем размере.


Работа с личными сообщениями

Пользователь ВКонтакте пишет личное сообщение в сообщество, нажав эту кнопку на его странице:

ipTaij.png


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

ldwXTJ.png


В то же время в ПланФиксе это выглядит как обычная задача:

ZUx5DK.png


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


Получение в ПланФикс комментариев из ВКонтакте

Вы можете включить получение в ПланФикс комментариев, оставляемых пользователями ВК к публикациям, обсуждениям или фотографиям в группе

EtPBqf.gif

Посмотреть в новом окне и большем размере.


В работе с комментариями из ВК в ПланФиксе используется следующая логика:

  • Для каждого поста / фотографии / видео / обсуждения создается отдельная задача в ПланФиксе. Это происходит автоматически, в момент появления нового комментария к этой публикации.
  • Постановщиком этой задачи становится сотрудник, указанный в шаблоне в настройках интеграции. Если в шаблоне выбрана опция Создатель задачи, постановщиком становится сотрудник, который настраивал интеграцию.
  • Исполнителями задачи становятся исполнители, указанные в шаблоне, по которому создаются задачи. В настройках интеграции можно указать сотрудников, которые дополнительно подключаются к задаче в качестве исполнителей.
  • Если появляется новый комментарий к публикации, которая уже присутствует в ПланФиксе в виде задачи, то он добавляется в эту задачу новым действием.
  • Если задача по данной публикации завершена и в настройках интеграции активирована опция Создавать новую задачу, если нет активных задач общения с этим контактом, будет создана новая задача по этой публикации и в нее добавлен этот комментарий
  • Возможность отвечать на комментарий пользователя прямо из ПланФикса есть только для комментариев, оставленных к постам на стене группы. Для ответа достаточно выделить получателя в блоке Уведомить об этом при создании нового действия.
  • Для ответа на комментарии, оставленные к другим типам публикаций в группе ВК, необходимо перейти в ВК и ответить там. Для удобства под каждым комментарием в ПланФиксе отображается прямая ссылка на него в ВК.
  • Если в ваш ответ на комментарий под публикацией на странице сообщества вкралась ошибка, исправить ее можно только в самом ВК.


Получение заявок с лид-форм ВКонтакте

Вы можете включить получение в ПланФикс данных, оставленных пользователями ВК в ваших формах сбора заявок. Для этого активируйте чекбокс в настройках API (ВКонтакте / Управление страницей / Работа с API / Callback API / Типы событий):

pwsIcF.png


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


Обратите внимание


Важно

Для работы с массовыми рассылками из ВКонтакте, Instagram и WhatsApp в ПланФиксе действует специальный механизм. Пока он работает следующим образом: если в течение 5 минут система обнаруживает больше 3 однотипных исходящих сообщений — они считаются массовой рассылкой.

Такие сообщения сохраняются в базу ПланФикса, но в задачи не добавляются, пока на такое сообщение не будет получен ответ клиента. Когда ответ поступит, ПланФикс проверит наличие сообщения в базе и, если оно найдено, добавит сообщение в задачу вместе с ответом клиента.

Обратите внимание, в базе ПланФикса сообщения с признаком массовой рассылки хранятся один месяц.

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


Дополнительно

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


Перейти