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

Материал из ПланФикс
Перейти к: навигация, поиск
 
(не показаны 32 промежуточные версии 5 участников)
Строка 5: Строка 5:
 
|description=Интеграция с Вконтакте
 
|description=Интеграция с Вконтакте
 
}}
 
}}
 +
ПланФикс позволяет вести переписку с клиентами, которые пишут сообщения в ваше сообщество ВКонтакте прямо из ПланФикса.
  
 +
Интеграция использует официальные API ВКонтакте.
  
ПланФикс позволяет вести переписку с клиентами, которые пишут сообщения в ваше сообщество ВКонтакте, прямо из ПланФикса.
 
  
Интеграция использует официальные API ВКонтакте.
+
== Содержание ==
 +
*[[#Настройка интеграции в ПланФиксе |Настройка интеграции в ПланФиксе]]
 +
*[[#Настройка интеграции в ВКонтакте |Настройка интеграции в ВКонтакте]]
 +
*[[#Работа с личными сообщениями |Работа с личными сообщениями]]
 +
*[[#Получение в ПланФикс комментариев из ВКонтакте |Получение в ПланФикс комментариев из ВКонтакте]]
 +
*[[#Получение заявок с лид-форм ВКонтакте |Получение заявок с лид-форм ВКонтакте]]
  
  
 
== Настройка интеграции в ПланФиксе ==
 
== Настройка интеграции в ПланФиксе ==
 
 
Настроить интеграцию может администратор аккаунта ПланФикса в разделе '''Управление аккаунтом''', вкладка '''Интеграции - Социальные сети''':
 
Настроить интеграцию может администратор аккаунта ПланФикса в разделе '''Управление аккаунтом''', вкладка '''Интеграции - Социальные сети''':
 
  
 
https://pic.planfix.ru/pf/H5/NylyPo.png
 
https://pic.planfix.ru/pf/H5/NylyPo.png
  
  
https://pic.planfix.ru/pf/up/YLqftr.jpg
+
https://pic.planfix.ru/pf/L3/wioOgW.png
  
  
После этого нужно нажать на '''Интеграцию с ВКонтакте''', а затем на '''Добавить группу''':
+
После этого нужно нажать на '''ВКонтакте''', а затем на '''Добавить группу''':
  
 
+
https://pic.planfix.ru/pf/99/ZbRlhJ.png
https://pic.planfix.ru/pf/12/NdOM4H.jpg
 
  
  
 
В появившемся окошке подтвердить согласие:
 
В появившемся окошке подтвердить согласие:
  
 +
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
Строка 42: Строка 44:
  
 
и подтвердить разрешение на получение информации из группы:
 
и подтвердить разрешение на получение информации из группы:
 
  
 
https://pic.planfix.ru/pf/iD/upZKcv.jpg
 
https://pic.planfix.ru/pf/iD/upZKcv.jpg
Строка 48: Строка 49:
  
 
Если все сделано верно, кнопка '''Активировать''' станет зеленой:
 
Если все сделано верно, кнопка '''Активировать''' станет зеленой:
 
  
 
https://pic.planfix.ru/pf/19/OZUglH.jpg
 
https://pic.planfix.ru/pf/19/OZUglH.jpg
Строка 63: Строка 63:
 
1. '''Скопируйте''' из него указанную ссылку.
 
1. '''Скопируйте''' из него указанную ссылку.
  
2. '''Перейдите''' в управление группой ВКонтакте и '''вставьте''' в соответствующее поле эту ссылку и ключ, а также отметьте нужные типы контента, который будет попадать в ПланФикс, как это показано ниже:
+
2. '''Перейдите''' в управление группой ВКонтакте и '''вставьте''' в соответствующее поле эту ссылку и ключ, а также отметьте нужные типы контента, который будет попадать в ПланФикс, как это показано ниже.
 +
 
 +
'''Важно:'''
 +
*Указывайте последнюю версию API ВКонтакте. Обычно она первая в списке.
 +
*Без настроек во ВКонтакте интеграция работать не будет.
  
 
https://pic.planfix.ru/pf/CU/JMFvzW.gif
 
https://pic.planfix.ru/pf/CU/JMFvzW.gif
 
 
'''Важно:''' без этой настройки в ВКонтакте интеграция работать не будет
 
  
  
Строка 74: Строка 75:
  
 
Пользователь ВКонтакте пишет личное сообщение в сообщество, нажав эту кнопку на его странице:
 
Пользователь ВКонтакте пишет личное сообщение в сообщество, нажав эту кнопку на его странице:
 
  
 
https://pic.planfix.ru/pf/60/oFDlnI.jpg
 
https://pic.planfix.ru/pf/60/oFDlnI.jpg
Строка 81: Строка 81:
 
В ПланФиксе автоматически создается задача с текстом его сообщения.  
 
В ПланФиксе автоматически создается задача с текстом его сообщения.  
 
Все комментарии, написанные в ПланФиксе, пользователь ВКонтакте видит в чате, как при общении внутри соцсети:
 
Все комментарии, написанные в ПланФиксе, пользователь ВКонтакте видит в чате, как при общении внутри соцсети:
 
  
 
https://pic.planfix.ru/pf/d5/GB0Sp7.jpg
 
https://pic.planfix.ru/pf/d5/GB0Sp7.jpg
Строка 87: Строка 86:
  
 
В то же время в ПланФиксе это выглядит как обычная задача:
 
В то же время в ПланФиксе это выглядит как обычная задача:
 +
 +
https://pic.planfix.ru/pf/Sy/AbySDM.jpg
  
  
https://pic.planfix.ru/pf/Sy/AbySDM.jpg
+
'''Полезно:''' Если вы отредактируете комментарий в ПланФиксе, его текст в ВК тоже изменится. Это позволяет исправлять ошибки и опечатки в отправленных клиенту сообщениях.
  
  
Строка 101: Строка 102:
 
*Для каждого поста / фотографии / видео / обсуждения создается отдельная задача в ПланФиксе. Это происходит автоматически, в момент появления нового комментария к этой публикации.
 
*Для каждого поста / фотографии / видео / обсуждения создается отдельная задача в ПланФиксе. Это происходит автоматически, в момент появления нового комментария к этой публикации.
 
*Постановщиком этой задачи становится сотрудник, указанный в шаблоне в настройках интеграции. Если в шаблоне выбрана опция '''Создатель задачи''', постановщиком становится сотрудник, который настраивал интеграцию.
 
*Постановщиком этой задачи становится сотрудник, указанный в шаблоне в настройках интеграции. Если в шаблоне выбрана опция '''Создатель задачи''', постановщиком становится сотрудник, который настраивал интеграцию.
 +
*Исполнителями задачи становятся исполнители, указанные в шаблоне, по которому создаются задачи. В настройках интеграции можно указать сотрудников, которые [[Дополнительное подключение сотрудников |дополнительно подключаются]] к задаче в качестве исполнителей.
 
*Если появляется новый комментарий к публикации, которая уже присутствует в ПланФиксе в виде задачи, то он добавляется в эту задачу новым действием.
 
*Если появляется новый комментарий к публикации, которая уже присутствует в ПланФиксе в виде задачи, то он добавляется в эту задачу новым действием.
 
*Если задача по данной публикации завершена и в настройках интеграции активирована опция '''Создавать новую задачу, если нет активных задач общения с этим контактом''', будет создана новая задача по этой публикации и в нее добавлен этот комментарий
 
*Если задача по данной публикации завершена и в настройках интеграции активирована опция '''Создавать новую задачу, если нет активных задач общения с этим контактом''', будет создана новая задача по этой публикации и в нее добавлен этот комментарий
 
*Возможность отвечать на комментарий пользователя прямо из ПланФикса есть только для комментариев, оставленных к постам на стене группы. Для ответа достаточно выделить получателя в блоке '''Уведомить об этом''' при создании нового действия.
 
*Возможность отвечать на комментарий пользователя прямо из ПланФикса есть только для комментариев, оставленных к постам на стене группы. Для ответа достаточно выделить получателя в блоке '''Уведомить об этом''' при создании нового действия.
 
*Для ответа на комментарии, оставленные к другим типам публикаций в группе ВК, необходимо перейти в ВК и ответить там. Для удобства под каждым комментарием в ПланФиксе отображается прямая ссылка на него в ВК.
 
*Для ответа на комментарии, оставленные к другим типам публикаций в группе ВК, необходимо перейти в ВК и ответить там. Для удобства под каждым комментарием в ПланФиксе отображается прямая ссылка на него в ВК.
 
+
*Если в ваш ответ на комментарий под публикацией на странице сообщества вкралась ошибка, исправить ее можно только в самом ВК.
  
  
 
== Получение заявок с лид-форм ВКонтакте ==
 
== Получение заявок с лид-форм ВКонтакте ==
Вы можете включить получение в ПланФик сданных, оставленных пользователями ВК в ваших формах сбора заявок. Для этого активируйте чекбокс в настройках API ('''ВКонтакте / Управление страницей / Работа с API / Callback API / Типы событий'''):
+
Вы можете включить получение в ПланФикс данных, оставленных пользователями ВК в ваших формах сбора заявок. Для этого активируйте чекбокс в настройках API ('''ВКонтакте / Управление страницей / Работа с API / Callback API / Типы событий'''):
  
 
https://pic.planfix.ru/pf/5H/Ka4QKI.jpg
 
https://pic.planfix.ru/pf/5H/Ka4QKI.jpg
 
  
 
https://pic.planfix.ru/pf/Tk/SkJi78.jpg
 
https://pic.planfix.ru/pf/Tk/SkJi78.jpg
  
  
Особенностью этого типа интеграции является то, что если вы добавите в шаблон задачи, по которой создается лид в ПланФиксе, кастомные поля с названиями, аналогичными названиям полей лид-формы ВК, эти поля будут автоматически заполнены данными из формы. Подробнее: [https://blog.planfix.ru/sbor-zayavok-lid-forma-vkontakte/ Сбор заявок: лид-форма ВКонтакте]
+
Особенностью этого типа интеграции является то, что если вы добавите в шаблон задачи, по которой создается лид в ПланФиксе, пользовательские поля с названиями, аналогичными названиям полей лид-формы ВК, эти поля будут автоматически заполнены данными из формы. Подробнее: [https://blog.planfix.ru/sbor-zayavok-lid-forma-vkontakte/ Сбор заявок: лид-форма ВКонтакте]
 
  
== Обратите внимание: ==
 
  
 +
== Обратите внимание ==
 
*Вы можете добавлять в свой аккаунт несколько групп ВКонтакте.
 
*Вы можете добавлять в свой аккаунт несколько групп ВКонтакте.
 +
*Интеграция работает только с открытыми группами.
 
*Вы можете выбрать [[шаблоны задач | шаблон задачи]], по которому при поступлении новых сообщений будут создаваться задачи в ПланФиксе.  
 
*Вы можете выбрать [[шаблоны задач | шаблон задачи]], по которому при поступлении новых сообщений будут создаваться задачи в ПланФиксе.  
 
*Убедитесь, что в используемом шаблоне указаны исполнители.
 
*Убедитесь, что в используемом шаблоне указаны исполнители.
 
*По правилам сети ВКонтакте, вы можете написать пользователю только в течение 10 дней с момента его последнего комментария.  
 
*По правилам сети ВКонтакте, вы можете написать пользователю только в течение 10 дней с момента его последнего комментария.  
 
*Интеграция ПланФикса и ВКонтакте доступна во всех платных и премиум-аккаунтах.
 
*Интеграция ПланФикса и ВКонтакте доступна во всех платных и премиум-аккаунтах.
*В настройке интеграции есть возможность активировать опцию [[Создавать новую задачу, если нет активных задач общения с этим контактом]]  
+
*В настройке интеграции есть возможность активировать опцию [[Создавать новую задачу если нет активных задач общения с этим контактом |Создавать новую задачу, если нет активных задач общения с этим контактом]]  
 
*При работе с автоматическими рассылками в ВКонтакте удобно активировать опцию [[Создавать задачи по исходящим сообщениям только в случае получения ответа]]
 
*При работе с автоматическими рассылками в ВКонтакте удобно активировать опцию [[Создавать задачи по исходящим сообщениям только в случае получения ответа]]
 +
*[[Опции интеграции: не прикреплять файлы публикации в задачу | Не прикрепляйте файлы публикации в задачу]], если они вам не нужны в ней.
 +
*Из истории переписки с контактом в новую задачу по умолчанию добавляется 10 последних сообщений. Это количество можно изменить: 1, 5, 10, 20, 50.
 +
 +
 +
== Важно ==
 +
Для работы с массовыми рассылками из ВКонтакте, Instagram и WhatsApp в ПланФиксе действует специальный механизм. Пока он работает следующим образом: если в течение 5 минут система обнаруживает больше 3 однотипных исходящих сообщений — они считаются массовой рассылкой.
 +
 +
Такие сообщения сохраняются в базу ПланФикса, но в задачи не добавляются, пока на такое сообщение не будет получен ответ клиента. Когда ответ поступит, ПланФикс проверит наличие сообщения в базе и, если оно найдено, добавит сообщение в задачу вместе с ответом клиента.
 +
 +
Обратите внимание, в базе ПланФикса сообщения с признаком массовой рассылки хранятся один месяц.
 +
 +
Такой механизм реализован, чтобы хроника уведомлений участников задачи меньше захламлялась ненужными сообщениями и не создавала лишнюю нагрузку на сервера ПланФикса. Такая нагрузка может сильно задерживать обработку других сообщений.
  
  
 
== Перейти ==
 
== Перейти ==
 
+
*[[Добавление ссылки на профиль ВКонтакте в карточку контакта]]
 
*[[Интеграции]]
 
*[[Интеграции]]
*[[Как добавить 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 однотипных исходящих сообщений — они считаются массовой рассылкой.

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

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

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


Перейти