Как подключить сообщения сообщества ВКонтакте

Что настроим

Покупатели пишут вашему сообществу во ВКонтакте, а сообщения приходят в раздел «Чат» Рефсейлс вместе с Telegram, MAX и WhatsApp. Отвечаете вы из «Чата», покупатель получает ответ от имени сообщества.

Что нужно заранее

• Доступ владельца магазина в Рефсейлс. Сотрудники эту страницу не открывают.

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

• Сообщество, которое ещё не подключено к другому магазину Рефсейлс. Одно сообщество работает только с одним магазином.

Как подключить

1. Во ВКонтакте откройте сообщество и перейдите в «Управление → Сообщения». Включите сообщения сообщества.

2. Перейдите в «Управление → Дополнительно → Работа с API → Ключи доступа» и создайте ключ.

3. Отметьте все права: сообщения, фотографии, документы, управление. Без фотографий и документов не уйдут вложения, без управления Рефсейлс не сможет настроить приём сообщений.

4. Скопируйте ключ. Он начинается с vk1.a.

5. В Рефсейлс откройте «Настройки» → «Интеграции». В разделе «Каналы общения» выберите «ВКонтакте».

6. Вставьте ключ в поле «Ключ доступа сообщества» и нажмите «Подключить».

Сообщество Рефсейлс определит по ключу сам, а ключ сохранит в зашифрованном виде. Адрес для приёма сообщений (сервер Callback API) Рефсейлс тоже добавит в сообщество сам. Кнопку «Подтвердить» во вкладке Callback API во ВКонтакте нажимать не нужно.

Как проверить, что работает

1. После подключения на странице появится название сообщества и строка «Сообщения покупателей приходят в «Чат».».

2. Напишите сообществу с личной страницы ВКонтакте.

3. Откройте «Чат». Диалог появится с меткой «ВКонтакте» и именем отправителя из его профиля.

4. Ответьте в этом диалоге. Ответ придёт во ВКонтакте от имени сообщества.

Что умеет канал

Сообщения и файлы

• Текст сообщения до 4096 символов.

• Фото в JPEG, PNG или GIF до 20 МБ уходит покупателю фотографией. Фото в другом формате или больше 20 МБ уходит документом.

• Голосовое сообщение, записанное в «Чате», уходит голосовым. Остальные файлы уходят документом.

• От покупателя в «Чат» приходят текст, фото, документы, голосовые и стикеры.

• Если менеджер ответил покупателю прямо во ВКонтакте, ответ тоже появится в «Чате». Исключение: покупатель ещё ни разу не писал, тогда диалога в «Чате» нет и ответ туда не попадает.

Правка и удаление

• Своё сообщение можно изменить или удалить из «Чата», и оно изменится или исчезнет у покупателя во ВКонтакте.

• ВКонтакте разрешает это только в первые сутки после отправки.

• Сообщение с вложением изменить нельзя. Удалите его и отправьте заново.

• Если покупатель изменит своё сообщение во ВКонтакте, в «Чате» оно тоже обновится.

Старая переписка

При первом подключении Рефсейлс сам выгрузит переписку сообщества: до 1500 последних диалогов и до 200 последних сообщений в каждом. Выгрузка идёт в фоне, диалоги появляются в «Чате» постепенно. Уведомлений о старых сообщениях не будет. Вложения в старых сообщениях показываются подписью, например «[Фото]».

Если отключить и снова подключить то же сообщество, переписка повторно не выгружается.

ИИ-консультант

ИИ может отвечать покупателям во ВКонтакте, пока вы не ответите сами.

1. Откройте «Настройки» → «ИИ-ассистент».

2. В разделе «Авто-консультант в чате (ИИ)» включите «Включить авто-ответы клиентам».

3. В блоке «Где отвечает ИИ» отметьте «ВКонтакте».

Как отключить

1. Откройте «Настройки» → «Интеграции» → «ВКонтакте».

2. Нажмите «Отключить» и подтвердите.

Сообщения из ВКонтакте перестанут приходить в «Чат». Переписка, которая уже есть, останется.

Если не работает

• «Ключ доступа недействителен». Ключ удалён, отозван или скопирован не полностью. Создайте новый ключ в «Работа с API → Ключи доступа» и вставьте его целиком.

• «У ключа не хватает прав». При создании ключа отмечены не все права. Создайте новый ключ и отметьте сообщения, фотографии, документы и управление.

• «Это сообщество уже подключено к другому магазину». Сообщество работает с другим магазином Рефсейлс. Отключите его там в «Настройки» → «Интеграции» → «ВКонтакте» и подключите здесь.

• «В сообществе уже 10 серверов Callback API». ВКонтакте разрешает не больше десяти. Удалите лишний сервер в «Работа с API → Callback API» и нажмите «Подключить» ещё раз.

• «ВКонтакте не смог проверить адрес сервера». Нажмите «Подключить» ещё раз. Если ошибка повторяется, напишите в поддержку.

• «ВКонтакте не ответил». Временный сбой на стороне ВКонтакте. Подождите минуту и повторите.

• В «Чате» красная плашка «Соединение разорвано». ВКонтакте отклонил ключ, например его удалили в настройках сообщества. Нажмите «Переподключить», создайте новый ключ и нажмите «Подключить заново».

• Сообщение не ушло: «Покупатель запретил сообщения от сообщества». ВКонтакте не пропускает сообщения от сообщества этому покупателю. Отправить ему сообщение не получится, пока он сам не разрешит их во ВКонтакте.

• «Прошло больше суток, ВКонтакте не даёт изменить сообщение». Срок правки и удаления у ВКонтакте сутки. Отправьте исправление новым сообщением.

Частые вопросы

Нужно ли нажимать «Подтвердить» в настройках Callback API ВКонтакте?

Нет. Рефсейлс сам добавляет сервер Callback API в сообщество, когда вы вставляете ключ доступа в «Настройки» → «Интеграции» → «ВКонтакте» и нажимаете «Подключить». Кнопку «Подтвердить» во вкладке Callback API нажимать не нужно.

Появится ли в Рефсейлс старая переписка сообщества ВКонтакте?

Да. При первом подключении сообщества Рефсейлс выгружает в «Чат» до 1500 последних диалогов и до 200 последних сообщений в каждом. Уведомлений о старых сообщениях не приходит. При повторном подключении того же сообщества переписка заново не выгружается.

Может ли ИИ отвечать покупателям во ВКонтакте?

Да. В «Настройки» → «ИИ-ассистент», раздел «Авто-консультант в чате (ИИ)», включите «Включить авто-ответы клиентам» и отметьте «ВКонтакте» в блоке «Где отвечает ИИ». Когда вы сами пишете в диалог, ИИ встаёт на паузу.

Что будет с перепиской, если отключить сообщество ВКонтакте?

Переписка, которая уже есть в «Чате», останется. Новые сообщения из ВКонтакте перестанут приходить, пока вы снова не подключите сообщество в «Настройки» → «Интеграции» → «ВКонтакте».