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

Материал из ПланФикс
Перейти к: навигация, поиск
 
(не показано 47 промежуточных версий 6 участников)
Строка 1: Строка 1:
ПланФикс позволяет вести переписку с клиентами, которые пишут сообщения в ваше сообщество ВКонтакте, прямо из ПланФикса.  
+
{{#seo:
 +
|title=Интеграция с Вконтакте
 +
|titlemode=append
 +
|keywords=планфикс, Интеграции, Вконтакте
 +
|description=Интеграция с Вконтакте
 +
}}
 +
ПланФикс позволяет вести переписку с клиентами, которые пишут сообщения в ваше сообщество ВКонтакте прямо из ПланФикса.  
  
 
Интеграция использует официальные API ВКонтакте.
 
Интеграция использует официальные API ВКонтакте.
 +
 +
 +
== Содержание ==
 +
*[[#Настройка интеграции в ПланФиксе |Настройка интеграции в ПланФиксе]]
 +
*[[#Настройка интеграции в ВКонтакте |Настройка интеграции в ВКонтакте]]
 +
*[[#Работа с личными сообщениями |Работа с личными сообщениями]]
 +
*[[#Получение в ПланФикс комментариев из ВКонтакте |Получение в ПланФикс комментариев из ВКонтакте]]
 +
*[[#Получение заявок с лид-форм ВКонтакте |Получение заявок с лид-форм ВКонтакте]]
  
  
 
== Настройка интеграции в ПланФиксе ==
 
== Настройка интеграции в ПланФиксе ==
 +
Настроить интеграцию может администратор аккаунта ПланФикса в разделе '''Управление аккаунтом''', вкладка '''Интеграции - Социальные сети''':
  
Настроить интеграцию может администратор аккаунта ПланФикса в разделе '''Управление аккаунтом''', вкладка '''Интеграции''':
+
https://pic.planfix.ru/pf/H5/NylyPo.png
 
 
  
https://pic.planfix.ru/pf/rs/BZ01rQ.jpg
 
  
 +
https://pic.planfix.ru/pf/L3/wioOgW.png
  
После этого нужно нажать на '''Интеграцию с ВКонтакте''', а затем на '''Добавить группу''':
 
  
 +
После этого нужно нажать на '''ВКонтакте''', а затем на '''Добавить группу''':
  
https://pic.planfix.ru/pf/12/NdOM4H.jpg
+
https://pic.planfix.ru/pf/99/ZbRlhJ.png
  
  
 
В появившемся окошке подтвердить согласие:
 
В появившемся окошке подтвердить согласие:
  
 +
https://pic.planfix.ru/pf/lL/OSy5ZV.jpg
  
https://pic.planfix.ru/pf/lL/OSy5ZV.jpg
 
  
 
После этого на странице интеграции в ПланФиксе появится название и логотип вашей группы.  
 
После этого на странице интеграции в ПланФиксе появится название и логотип вашей группы.  
 
Для начала получения сообщения из нее нужно кликнуть на '''Активировать''':
 
Для начала получения сообщения из нее нужно кликнуть на '''Активировать''':
 
  
 
https://pic.planfix.ru/pf/Yo/xEkhbU.jpg
 
https://pic.planfix.ru/pf/Yo/xEkhbU.jpg
Строка 31: Строка 44:
  
 
и подтвердить разрешение на получение информации из группы:
 
и подтвердить разрешение на получение информации из группы:
 
  
 
https://pic.planfix.ru/pf/iD/upZKcv.jpg
 
https://pic.planfix.ru/pf/iD/upZKcv.jpg
Строка 37: Строка 49:
  
 
Если все сделано верно, кнопка '''Активировать''' станет зеленой:
 
Если все сделано верно, кнопка '''Активировать''' станет зеленой:
 
  
 
https://pic.planfix.ru/pf/19/OZUglH.jpg
 
https://pic.planfix.ru/pf/19/OZUglH.jpg
Строка 50: Строка 61:
 
Для окончания настройки вам необходимо сделать следующее:
 
Для окончания настройки вам необходимо сделать следующее:
  
1. Скопируйте из него указанную ссылку.
+
1. '''Скопируйте''' из него указанную ссылку.
 +
 
 +
2. '''Перейдите''' в управление группой ВКонтакте и '''вставьте''' в соответствующее поле эту ссылку и ключ, а также отметьте нужные типы контента, который будет попадать в ПланФикс, как это показано ниже.
 +
 
 +
'''Важно:'''
 +
*Указывайте последнюю версию API ВКонтакте. Обычно она первая в списке.
 +
*Без настроек во ВКонтакте интеграция работать не будет.
  
2. Перейдите в управление группой ВКонтакте и вставьте в соответствующее поле эту ссылку и ключ, как это показано ниже:
+
https://pic.planfix.ru/pf/CU/JMFvzW.gif
  
https://pic.planfix.ru/pf/Hw/wHbH4R.gif
 
  
'''Важно:''' без этой настройки в ВКонтакте интеграция работать не будет
+
== Работа с личными сообщениями ==
  
Для получения файлов в ВКонтакте проверьте, чтоб был включен раздел Документы:
+
Пользователь ВКонтакте пишет личное сообщение в сообщество, нажав эту кнопку на его странице:
  
https://pic.planfix.ru/pf/mI/0ENUrN.jpg
+
https://pic.planfix.ru/pf/60/oFDlnI.jpg
  
  
== Получение в ПланФикс комментариев из ВКонтакте ==
+
В ПланФиксе автоматически создается задача с текстом его сообщения.
В настройках интеграции вы можете включить в ПланФикс получение комментариев, оставляемых пользователями ВК к публикациям, обсуждениям или фотографиям в группе:
+
Все комментарии, написанные в ПланФиксе, пользователь ВКонтакте видит в чате, как при общении внутри соцсети:
  
https://pic.planfix.ru/pf/y4/tGrE82.jpg
+
https://pic.planfix.ru/pf/d5/GB0Sp7.jpg
  
Для того, чтобы эта информация попадала в ПланФикс, обязательно включите ее отправку в настройках группы ВКонтакте:
 
  
https://pic.planfix.ru/pf/b5/W7pQh7.gif
+
В то же время в ПланФиксе это выглядит как обычная задача:
  
 +
https://pic.planfix.ru/pf/Sy/AbySDM.jpg
  
== Использование интеграции ==
 
  
Пользователь ВКонтакте пишет личное сообщение в сообщество, нажав эту кнопку на его странице:
+
'''Полезно:''' Если вы отредактируете комментарий в ПланФиксе, его текст в ВК тоже изменится. Это позволяет исправлять ошибки и опечатки в отправленных клиенту сообщениях.
  
  
https://pic.planfix.ru/pf/60/oFDlnI.jpg
+
== Получение в ПланФикс комментариев из ВКонтакте ==
 +
Вы можете включить получение в ПланФикс комментариев, оставляемых пользователями ВК к публикациям, обсуждениям или фотографиям в группе
  
 +
https://pic.planfix.ru/pf/b5/W7pQh7.gif
  
В ПланФиксе автоматически создается задача с текстом его сообщения.
 
Все комментарии, написанные в ПланФиксе, пользователь ВКонтакте видит в чате, как при общении внутри соцсети:
 
  
 +
В работе с комментариями из ВК в ПланФиксе используется следующая логика:
 +
*Для каждого поста / фотографии / видео / обсуждения создается отдельная задача в ПланФиксе. Это происходит автоматически, в момент появления нового комментария к этой публикации.
 +
*Постановщиком этой задачи становится сотрудник, указанный в шаблоне в настройках интеграции. Если в шаблоне выбрана опция '''Создатель задачи''', постановщиком становится сотрудник, который настраивал интеграцию.
 +
*Исполнителями задачи становятся исполнители, указанные в шаблоне, по которому создаются задачи. В настройках интеграции можно указать сотрудников, которые [[Дополнительное подключение сотрудников |дополнительно подключаются]] к задаче в качестве исполнителей.
 +
*Если появляется новый комментарий к публикации, которая уже присутствует в ПланФиксе в виде задачи, то он добавляется в эту задачу новым действием.
 +
*Если задача по данной публикации завершена и в настройках интеграции активирована опция '''Создавать новую задачу, если нет активных задач общения с этим контактом''', будет создана новая задача по этой публикации и в нее добавлен этот комментарий
 +
*Возможность отвечать на комментарий пользователя прямо из ПланФикса есть только для комментариев, оставленных к постам на стене группы. Для ответа достаточно выделить получателя в блоке '''Уведомить об этом''' при создании нового действия.
 +
*Для ответа на комментарии, оставленные к другим типам публикаций в группе ВК, необходимо перейти в ВК и ответить там. Для удобства под каждым комментарием в ПланФиксе отображается прямая ссылка на него в ВК.
 +
*Если в ваш ответ на комментарий под публикацией на странице сообщества вкралась ошибка, исправить ее можно только в самом ВК.
  
https://pic.planfix.ru/pf/d5/GB0Sp7.jpg
 
  
 +
== Получение заявок с лид-форм ВКонтакте ==
 +
Вы можете включить получение в ПланФикс данных, оставленных пользователями ВК в ваших формах сбора заявок. Для этого активируйте чекбокс в настройках API ('''ВКонтакте / Управление страницей / Работа с API / Callback API / Типы событий'''):
  
В то же время в ПланФиксе это выглядит как обычная задача:
+
https://pic.planfix.ru/pf/5H/Ka4QKI.jpg
  
 +
https://pic.planfix.ru/pf/Tk/SkJi78.jpg
  
https://pic.planfix.ru/pf/Sy/AbySDM.jpg
 
  
 +
Особенностью этого типа интеграции является то, что если вы добавите в шаблон задачи, по которой создается лид в ПланФиксе, пользовательские поля с названиями, аналогичными названиям полей лид-формы ВК, эти поля будут автоматически заполнены данными из формы. Подробнее: [https://blog.planfix.ru/sbor-zayavok-lid-forma-vkontakte/ Сбор заявок: лид-форма ВКонтакте]
  
== Обратите внимание: ==
 
  
 +
== Обратите внимание ==
 
*Вы можете добавлять в свой аккаунт несколько групп ВКонтакте.
 
*Вы можете добавлять в свой аккаунт несколько групп ВКонтакте.
 +
*Интеграция работает только с открытыми группами.
 
*Вы можете выбрать [[шаблоны задач | шаблон задачи]], по которому при поступлении новых сообщений будут создаваться задачи в ПланФиксе.  
 
*Вы можете выбрать [[шаблоны задач | шаблон задачи]], по которому при поступлении новых сообщений будут создаваться задачи в ПланФиксе.  
 
*Убедитесь, что в используемом шаблоне указаны исполнители.
 
*Убедитесь, что в используемом шаблоне указаны исполнители.
 
*По правилам сети ВКонтакте, вы можете написать пользователю только в течение 10 дней с момента его последнего комментария.  
 
*По правилам сети ВКонтакте, вы можете написать пользователю только в течение 10 дней с момента его последнего комментария.  
 
*Интеграция ПланФикса и ВКонтакте доступна во всех платных и премиум-аккаунтах.
 
*Интеграция ПланФикса и ВКонтакте доступна во всех платных и премиум-аккаунтах.
*При настройке интеграции есть возможность создавать новую задачу, если нет [[Тип статуса задачи |
+
*В настройке интеграции есть возможность активировать опцию [[Создавать новую задачу если нет активных задач общения с этим контактом |Создавать новую задачу, если нет активных задач общения с этим контактом]]
активных]] (то есть в любом активном статусе) задач по обращениям от клиента:
+
*При работе с автоматическими рассылками в ВКонтакте удобно активировать опцию [[Создавать задачи по исходящим сообщениям только в случае получения ответа]]
 +
*[[Опции интеграции: не прикреплять файлы публикации в задачу | Не прикрепляйте файлы публикации в задачу]], если они вам не нужны в ней.
 +
*Из истории переписки с контактом в новую задачу по умолчанию добавляется 10 последних сообщений. Это количество можно изменить: 1, 5, 10, 20, 50.
  
  
https://pic.planfix.ru/pf/KB/wMxSW3.jpg
+
== Важно ==
 +
Для работы с массовыми рассылками из ВКонтакте, Instagram и WhatsApp в ПланФиксе действует специальный механизм. Пока он работает следующим образом: если в течение 5 минут система обнаруживает больше 3 однотипных исходящих сообщений — они считаются массовой рассылкой.  
  
 +
Такие сообщения сохраняются в базу ПланФикса, но в задачи не добавляются, пока на такое сообщение не будет получен ответ клиента. Когда ответ поступит, ПланФикс проверит наличие сообщения в базе и, если оно найдено, добавит сообщение в задачу вместе с ответом клиента.
  
По умолчанию чекбокс включен.  При активном чекбоксе новая задача будет создаваться, если предыдущая задача данного клиента удалена, завершена или находится в неактивном статусе.
+
Обратите внимание, в базе ПланФикса сообщения с признаком массовой рассылки хранятся один месяц.
При этом история переписки автоматически добавляется в описание созданной задачи:
 
  
 +
Такой механизм реализован, чтобы хроника уведомлений участников задачи меньше захламлялась ненужными сообщениями и не создавала лишнюю нагрузку на сервера ПланФикса. Такая нагрузка может сильно задерживать обработку других сообщений.
  
https://pic.planfix.ru/pf/oo/VYR2Om.jpg
 
 
 
При неактивном чекбоксе все сообщения клиента будут попадать в одну задачу, независимо от ее текущего статуса.
 
  
 
== Перейти ==
 
== Перейти ==
 
+
*[[Добавление ссылки на профиль ВКонтакте в карточку контакта]]
 
*[[Интеграции]]
 
*[[Интеграции]]
*[[Как добавить id Вконтакте в карточку контакта?]]
 

Текущая версия на 13:47, 18 февраля 2022

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

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


Содержание


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

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

NylyPo.png


wioOgW.png


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

ZbRlhJ.png


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

OSy5ZV.jpg


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

xEkhbU.jpg


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

upZKcv.jpg


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

OZUglH.jpg


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

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

6r4l6x.jpg


Для окончания настройки вам необходимо сделать следующее:

1. Скопируйте из него указанную ссылку.

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

Важно:

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

JMFvzW.gif


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

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

oFDlnI.jpg


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

GB0Sp7.jpg


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

AbySDM.jpg


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


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

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

W7pQh7.gif


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

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


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

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

Ka4QKI.jpg

SkJi78.jpg


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


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


Важно

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

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

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

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


Перейти