Интеграция с ВКонтакте — различия между версиями
DM (обсуждение | вклад) |
Artem (обсуждение | вклад) |
||
(не показаны 33 промежуточные версии 5 участников) | |||
Строка 5: | Строка 5: | ||
|description=Интеграция с Вконтакте | |description=Интеграция с Вконтакте | ||
}} | }} | ||
+ | ПланФикс позволяет вести переписку с клиентами, которые пишут сообщения в ваше сообщество ВКонтакте прямо из ПланФикса. | ||
+ | Интеграция использует официальные API ВКонтакте. | ||
− | |||
− | + | == Содержание == | |
+ | *[[#Настройка интеграции в ПланФиксе |Настройка интеграции в ПланФиксе]] | ||
+ | *[[#Настройка интеграции в ВКонтакте |Настройка интеграции в ВКонтакте]] | ||
+ | *[[#Работа с личными сообщениями |Работа с личными сообщениями]] | ||
+ | *[[#Получение в ПланФикс комментариев из ВКонтакте |Получение в ПланФикс комментариев из ВКонтакте]] | ||
+ | *[[#Получение заявок с лид-форм ВКонтакте |Получение заявок с лид-форм ВКонтакте]] | ||
== Настройка интеграции в ПланФиксе == | == Настройка интеграции в ПланФиксе == | ||
− | |||
Настроить интеграцию может администратор аккаунта ПланФикса в разделе '''Управление аккаунтом''', вкладка '''Интеграции - Социальные сети''': | Настроить интеграцию может администратор аккаунта ПланФикса в разделе '''Управление аккаунтом''', вкладка '''Интеграции - Социальные сети''': | ||
+ | https://pic.planfix.ru/pf/H5/NylyPo.png | ||
− | |||
− | https://pic.planfix.ru/pf/ | + | https://pic.planfix.ru/pf/L3/wioOgW.png |
− | |||
+ | После этого нужно нажать на '''ВКонтакте''', а затем на '''Добавить группу''': | ||
− | https://pic.planfix.ru/pf/ | + | https://pic.planfix.ru/pf/99/ZbRlhJ.png |
В появившемся окошке подтвердить согласие: | В появившемся окошке подтвердить согласие: | ||
+ | https://pic.planfix.ru/pf/lL/OSy5ZV.jpg | ||
− | |||
После этого на странице интеграции в ПланФиксе появится название и логотип вашей группы. | После этого на странице интеграции в ПланФиксе появится название и логотип вашей группы. | ||
Для начала получения сообщения из нее нужно кликнуть на '''Активировать''': | Для начала получения сообщения из нее нужно кликнуть на '''Активировать''': | ||
− | |||
https://pic.planfix.ru/pf/Yo/xEkhbU.jpg | https://pic.planfix.ru/pf/Yo/xEkhbU.jpg | ||
Строка 40: | Строка 44: | ||
и подтвердить разрешение на получение информации из группы: | и подтвердить разрешение на получение информации из группы: | ||
− | |||
https://pic.planfix.ru/pf/iD/upZKcv.jpg | https://pic.planfix.ru/pf/iD/upZKcv.jpg | ||
Строка 46: | Строка 49: | ||
Если все сделано верно, кнопка '''Активировать''' станет зеленой: | Если все сделано верно, кнопка '''Активировать''' станет зеленой: | ||
− | |||
https://pic.planfix.ru/pf/19/OZUglH.jpg | https://pic.planfix.ru/pf/19/OZUglH.jpg | ||
Строка 61: | Строка 63: | ||
1. '''Скопируйте''' из него указанную ссылку. | 1. '''Скопируйте''' из него указанную ссылку. | ||
− | 2. '''Перейдите''' в управление группой ВКонтакте и '''вставьте''' в соответствующее поле эту ссылку и ключ, а также отметьте нужные типы контента, который будет попадать в ПланФикс, как это показано ниже: | + | 2. '''Перейдите''' в управление группой ВКонтакте и '''вставьте''' в соответствующее поле эту ссылку и ключ, а также отметьте нужные типы контента, который будет попадать в ПланФикс, как это показано ниже. |
+ | |||
+ | '''Важно:''' | ||
+ | *Указывайте последнюю версию API ВКонтакте. Обычно она первая в списке. | ||
+ | *Без настроек во ВКонтакте интеграция работать не будет. | ||
https://pic.planfix.ru/pf/CU/JMFvzW.gif | https://pic.planfix.ru/pf/CU/JMFvzW.gif | ||
− | |||
− | |||
− | |||
Строка 72: | Строка 75: | ||
Пользователь ВКонтакте пишет личное сообщение в сообщество, нажав эту кнопку на его странице: | Пользователь ВКонтакте пишет личное сообщение в сообщество, нажав эту кнопку на его странице: | ||
− | |||
https://pic.planfix.ru/pf/60/oFDlnI.jpg | https://pic.planfix.ru/pf/60/oFDlnI.jpg | ||
Строка 79: | Строка 81: | ||
В ПланФиксе автоматически создается задача с текстом его сообщения. | В ПланФиксе автоматически создается задача с текстом его сообщения. | ||
Все комментарии, написанные в ПланФиксе, пользователь ВКонтакте видит в чате, как при общении внутри соцсети: | Все комментарии, написанные в ПланФиксе, пользователь ВКонтакте видит в чате, как при общении внутри соцсети: | ||
− | |||
https://pic.planfix.ru/pf/d5/GB0Sp7.jpg | https://pic.planfix.ru/pf/d5/GB0Sp7.jpg | ||
Строка 85: | Строка 86: | ||
В то же время в ПланФиксе это выглядит как обычная задача: | В то же время в ПланФиксе это выглядит как обычная задача: | ||
+ | |||
+ | https://pic.planfix.ru/pf/Sy/AbySDM.jpg | ||
− | + | '''Полезно:''' Если вы отредактируете комментарий в ПланФиксе, его текст в ВК тоже изменится. Это позволяет исправлять ошибки и опечатки в отправленных клиенту сообщениях. | |
Строка 99: | Строка 102: | ||
*Для каждого поста / фотографии / видео / обсуждения создается отдельная задача в ПланФиксе. Это происходит автоматически, в момент появления нового комментария к этой публикации. | *Для каждого поста / фотографии / видео / обсуждения создается отдельная задача в ПланФиксе. Это происходит автоматически, в момент появления нового комментария к этой публикации. | ||
*Постановщиком этой задачи становится сотрудник, указанный в шаблоне в настройках интеграции. Если в шаблоне выбрана опция '''Создатель задачи''', постановщиком становится сотрудник, который настраивал интеграцию. | *Постановщиком этой задачи становится сотрудник, указанный в шаблоне в настройках интеграции. Если в шаблоне выбрана опция '''Создатель задачи''', постановщиком становится сотрудник, который настраивал интеграцию. | ||
+ | *Исполнителями задачи становятся исполнители, указанные в шаблоне, по которому создаются задачи. В настройках интеграции можно указать сотрудников, которые [[Дополнительное подключение сотрудников |дополнительно подключаются]] к задаче в качестве исполнителей. | ||
*Если появляется новый комментарий к публикации, которая уже присутствует в ПланФиксе в виде задачи, то он добавляется в эту задачу новым действием. | *Если появляется новый комментарий к публикации, которая уже присутствует в ПланФиксе в виде задачи, то он добавляется в эту задачу новым действием. | ||
*Если задача по данной публикации завершена и в настройках интеграции активирована опция '''Создавать новую задачу, если нет активных задач общения с этим контактом''', будет создана новая задача по этой публикации и в нее добавлен этот комментарий | *Если задача по данной публикации завершена и в настройках интеграции активирована опция '''Создавать новую задачу, если нет активных задач общения с этим контактом''', будет создана новая задача по этой публикации и в нее добавлен этот комментарий | ||
*Возможность отвечать на комментарий пользователя прямо из ПланФикса есть только для комментариев, оставленных к постам на стене группы. Для ответа достаточно выделить получателя в блоке '''Уведомить об этом''' при создании нового действия. | *Возможность отвечать на комментарий пользователя прямо из ПланФикса есть только для комментариев, оставленных к постам на стене группы. Для ответа достаточно выделить получателя в блоке '''Уведомить об этом''' при создании нового действия. | ||
*Для ответа на комментарии, оставленные к другим типам публикаций в группе ВК, необходимо перейти в ВК и ответить там. Для удобства под каждым комментарием в ПланФиксе отображается прямая ссылка на него в ВК. | *Для ответа на комментарии, оставленные к другим типам публикаций в группе ВК, необходимо перейти в ВК и ответить там. Для удобства под каждым комментарием в ПланФиксе отображается прямая ссылка на него в ВК. | ||
− | + | *Если в ваш ответ на комментарий под публикацией на странице сообщества вкралась ошибка, исправить ее можно только в самом ВК. | |
== Получение заявок с лид-форм ВКонтакте == | == Получение заявок с лид-форм ВКонтакте == | ||
− | Вы можете включить получение в | + | Вы можете включить получение в ПланФикс данных, оставленных пользователями ВК в ваших формах сбора заявок. Для этого активируйте чекбокс в настройках 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/ Сбор заявок: лид-форма ВКонтакте] |
− | |||
− | |||
+ | == Обратите внимание == | ||
*Вы можете добавлять в свой аккаунт несколько групп ВКонтакте. | *Вы можете добавлять в свой аккаунт несколько групп ВКонтакте. | ||
+ | *Интеграция работает только с открытыми группами. | ||
*Вы можете выбрать [[шаблоны задач | шаблон задачи]], по которому при поступлении новых сообщений будут создаваться задачи в ПланФиксе. | *Вы можете выбрать [[шаблоны задач | шаблон задачи]], по которому при поступлении новых сообщений будут создаваться задачи в ПланФиксе. | ||
*Убедитесь, что в используемом шаблоне указаны исполнители. | *Убедитесь, что в используемом шаблоне указаны исполнители. | ||
*По правилам сети ВКонтакте, вы можете написать пользователю только в течение 10 дней с момента его последнего комментария. | *По правилам сети ВКонтакте, вы можете написать пользователю только в течение 10 дней с момента его последнего комментария. | ||
*Интеграция ПланФикса и ВКонтакте доступна во всех платных и премиум-аккаунтах. | *Интеграция ПланФикса и ВКонтакте доступна во всех платных и премиум-аккаунтах. | ||
− | *В настройке интеграции есть возможность активировать опцию [[Создавать новую задачу, если нет активных задач общения с этим контактом]] | + | *В настройке интеграции есть возможность активировать опцию [[Создавать новую задачу если нет активных задач общения с этим контактом |Создавать новую задачу, если нет активных задач общения с этим контактом]] |
*При работе с автоматическими рассылками в ВКонтакте удобно активировать опцию [[Создавать задачи по исходящим сообщениям только в случае получения ответа]] | *При работе с автоматическими рассылками в ВКонтакте удобно активировать опцию [[Создавать задачи по исходящим сообщениям только в случае получения ответа]] | ||
+ | *[[Опции интеграции: не прикреплять файлы публикации в задачу | Не прикрепляйте файлы публикации в задачу]], если они вам не нужны в ней. | ||
+ | *Из истории переписки с контактом в новую задачу по умолчанию добавляется 10 последних сообщений. Это количество можно изменить: 1, 5, 10, 20, 50. | ||
+ | |||
+ | |||
+ | == Важно == | ||
+ | Для работы с массовыми рассылками из ВКонтакте, Instagram и WhatsApp в ПланФиксе действует специальный механизм. Пока он работает следующим образом: если в течение 5 минут система обнаруживает больше 3 однотипных исходящих сообщений — они считаются массовой рассылкой. | ||
+ | |||
+ | Такие сообщения сохраняются в базу ПланФикса, но в задачи не добавляются, пока на такое сообщение не будет получен ответ клиента. Когда ответ поступит, ПланФикс проверит наличие сообщения в базе и, если оно найдено, добавит сообщение в задачу вместе с ответом клиента. | ||
+ | |||
+ | Обратите внимание, в базе ПланФикса сообщения с признаком массовой рассылки хранятся один месяц. | ||
+ | |||
+ | Такой механизм реализован, чтобы хроника уведомлений участников задачи меньше захламлялась ненужными сообщениями и не создавала лишнюю нагрузку на сервера ПланФикса. Такая нагрузка может сильно задерживать обработку других сообщений. | ||
== Перейти == | == Перейти == | ||
− | + | *[[Добавление ссылки на профиль ВКонтакте в карточку контакта]] | |
*[[Интеграции]] | *[[Интеграции]] | ||
− |
Текущая версия на 13:47, 18 февраля 2022
ПланФикс позволяет вести переписку с клиентами, которые пишут сообщения в ваше сообщество ВКонтакте прямо из ПланФикса.
Интеграция использует официальные API ВКонтакте.
Содержание
Содержание
- Настройка интеграции в ПланФиксе
- Настройка интеграции в ВКонтакте
- Работа с личными сообщениями
- Получение в ПланФикс комментариев из ВКонтакте
- Получение заявок с лид-форм ВКонтакте
Настройка интеграции в ПланФиксе
Настроить интеграцию может администратор аккаунта ПланФикса в разделе Управление аккаунтом, вкладка Интеграции - Социальные сети:
После этого нужно нажать на ВКонтакте, а затем на Добавить группу:
В появившемся окошке подтвердить согласие:
После этого на странице интеграции в ПланФиксе появится название и логотип вашей группы.
Для начала получения сообщения из нее нужно кликнуть на Активировать:
и подтвердить разрешение на получение информации из группы:
Если все сделано верно, кнопка Активировать станет зеленой:
Настройка интеграции в ВКонтакте
После окончания настройки интеграции в ПланФиксе вы увидите информационное окно:
Для окончания настройки вам необходимо сделать следующее:
1. Скопируйте из него указанную ссылку.
2. Перейдите в управление группой ВКонтакте и вставьте в соответствующее поле эту ссылку и ключ, а также отметьте нужные типы контента, который будет попадать в ПланФикс, как это показано ниже.
Важно:
- Указывайте последнюю версию API ВКонтакте. Обычно она первая в списке.
- Без настроек во ВКонтакте интеграция работать не будет.
Работа с личными сообщениями
Пользователь ВКонтакте пишет личное сообщение в сообщество, нажав эту кнопку на его странице:
В ПланФиксе автоматически создается задача с текстом его сообщения.
Все комментарии, написанные в ПланФиксе, пользователь ВКонтакте видит в чате, как при общении внутри соцсети:
В то же время в ПланФиксе это выглядит как обычная задача:
Полезно: Если вы отредактируете комментарий в ПланФиксе, его текст в ВК тоже изменится. Это позволяет исправлять ошибки и опечатки в отправленных клиенту сообщениях.
Получение в ПланФикс комментариев из ВКонтакте
Вы можете включить получение в ПланФикс комментариев, оставляемых пользователями ВК к публикациям, обсуждениям или фотографиям в группе
В работе с комментариями из ВК в ПланФиксе используется следующая логика:
- Для каждого поста / фотографии / видео / обсуждения создается отдельная задача в ПланФиксе. Это происходит автоматически, в момент появления нового комментария к этой публикации.
- Постановщиком этой задачи становится сотрудник, указанный в шаблоне в настройках интеграции. Если в шаблоне выбрана опция Создатель задачи, постановщиком становится сотрудник, который настраивал интеграцию.
- Исполнителями задачи становятся исполнители, указанные в шаблоне, по которому создаются задачи. В настройках интеграции можно указать сотрудников, которые дополнительно подключаются к задаче в качестве исполнителей.
- Если появляется новый комментарий к публикации, которая уже присутствует в ПланФиксе в виде задачи, то он добавляется в эту задачу новым действием.
- Если задача по данной публикации завершена и в настройках интеграции активирована опция Создавать новую задачу, если нет активных задач общения с этим контактом, будет создана новая задача по этой публикации и в нее добавлен этот комментарий
- Возможность отвечать на комментарий пользователя прямо из ПланФикса есть только для комментариев, оставленных к постам на стене группы. Для ответа достаточно выделить получателя в блоке Уведомить об этом при создании нового действия.
- Для ответа на комментарии, оставленные к другим типам публикаций в группе ВК, необходимо перейти в ВК и ответить там. Для удобства под каждым комментарием в ПланФиксе отображается прямая ссылка на него в ВК.
- Если в ваш ответ на комментарий под публикацией на странице сообщества вкралась ошибка, исправить ее можно только в самом ВК.
Получение заявок с лид-форм ВКонтакте
Вы можете включить получение в ПланФикс данных, оставленных пользователями ВК в ваших формах сбора заявок. Для этого активируйте чекбокс в настройках API (ВКонтакте / Управление страницей / Работа с API / Callback API / Типы событий):
Особенностью этого типа интеграции является то, что если вы добавите в шаблон задачи, по которой создается лид в ПланФиксе, пользовательские поля с названиями, аналогичными названиям полей лид-формы ВК, эти поля будут автоматически заполнены данными из формы. Подробнее: Сбор заявок: лид-форма ВКонтакте
Обратите внимание
- Вы можете добавлять в свой аккаунт несколько групп ВКонтакте.
- Интеграция работает только с открытыми группами.
- Вы можете выбрать шаблон задачи, по которому при поступлении новых сообщений будут создаваться задачи в ПланФиксе.
- Убедитесь, что в используемом шаблоне указаны исполнители.
- По правилам сети ВКонтакте, вы можете написать пользователю только в течение 10 дней с момента его последнего комментария.
- Интеграция ПланФикса и ВКонтакте доступна во всех платных и премиум-аккаунтах.
- В настройке интеграции есть возможность активировать опцию Создавать новую задачу, если нет активных задач общения с этим контактом
- При работе с автоматическими рассылками в ВКонтакте удобно активировать опцию Создавать задачи по исходящим сообщениям только в случае получения ответа
- Не прикрепляйте файлы публикации в задачу, если они вам не нужны в ней.
- Из истории переписки с контактом в новую задачу по умолчанию добавляется 10 последних сообщений. Это количество можно изменить: 1, 5, 10, 20, 50.
Важно
Для работы с массовыми рассылками из ВКонтакте, Instagram и WhatsApp в ПланФиксе действует специальный механизм. Пока он работает следующим образом: если в течение 5 минут система обнаруживает больше 3 однотипных исходящих сообщений — они считаются массовой рассылкой.
Такие сообщения сохраняются в базу ПланФикса, но в задачи не добавляются, пока на такое сообщение не будет получен ответ клиента. Когда ответ поступит, ПланФикс проверит наличие сообщения в базе и, если оно найдено, добавит сообщение в задачу вместе с ответом клиента.
Обратите внимание, в базе ПланФикса сообщения с признаком массовой рассылки хранятся один месяц.
Такой механизм реализован, чтобы хроника уведомлений участников задачи меньше захламлялась ненужными сообщениями и не создавала лишнюю нагрузку на сервера ПланФикса. Такая нагрузка может сильно задерживать обработку других сообщений.