Подключение ВКонтакте

EasyChat принимает сообщения из сообщества ВКонтакте в общий список диалогов. Оператор отвечает из EasyChat, а клиент получает ответ во ВКонтакте.

Если оператор ответил прямо во ВКонтакте, EasyChat тоже сохранит этот ответ в истории диалога.

Для надёжного приёма сообщений настройте основной cron и проверьте его запуск. На части хостингов сообщения обрабатываются сразу, но очередь и повторные попытки после ошибок требуют работающего cron.

Что Подготовить

• Доступ владельца или администратора к сообществу VK.
• Ключ доступа сообщества.
• Рабочий сайт по HTTPS.
• Доступ администратора EasyChat.

Ключ доступа храните как пароль: не отправляйте его в переписки, скриншоты и публичные инструкции.

Создать Ключ Сообщества

В VK откройте нужное сообщество:

Управление → Дополнительно → Работа с API → Ключи доступа

Создайте ключ и выдайте только нужные права:

• сообщения сообщества;
• управление сообществом;
• фотографии, если операторы будут отправлять изображения;
• документы, если операторы будут отправлять PDF, Word или OpenDocument.

Лишние права к стене, рекламе, товарам и другим разделам не нужны.

Подключить В EasyChat

Откройте EasyChat → Интеграции → ВКонтакте.

1. Вставьте ключ сообщества.
2. Дождитесь проверки.
3. Убедитесь, что карточка показывает статус Подключено.

EasyChat сам подготовит прием сообщений сообщества. Если VK временно не ответил, нажмите Проверить и подключить повторно.

Проверить Первый Диалог

1. Напишите в сообщество VK как обычный пользователь.
2. Откройте EasyChat.
3. Проверьте, что появился новый диалог с источником VK.
4. Ответьте из EasyChat.
5. Убедитесь, что ответ пришел пользователю во ВКонтакте.

Что Видит Оператор

В диалоге VK оператор видит сообщения клиента, может отвечать текстом, отправлять изображения и документы PDF/DOC/DOCX/ODT/ODS/ODP, если соответствующие права были выданы при создании ключа.

Пересланные сообщения тоже отображаются полностью: EasyChat показывает вложенные фотографии и документы, текст исходного сообщения и аккуратную отметку Переслано. Когда VK разрешает получить публичное имя автора, оно появляется рядом с отметкой автоматически — даже если VK вернул его чуть позже, уже открытый диалог обновится без перезагрузки страницы.

Ссылки в сообщениях отображаются кликабельно и открываются в новом окне.

Частые Ситуации

• EasyChat пишет, что не хватает прав. Создайте новый ключ и отметьте права для сообщений, управления сообществом, фото и документов.
• Канал подключен, но сообщений нет. Проверьте, что сообщения включены в самом сообществе VK и сайт доступен по HTTPS.
• Изображения или документы не отправляются. Проверьте, что при создании ключа были выданы права на фото или документы.
• Проверка отложена. Подождите несколько минут и нажмите Проверить и подключить еще раз.

Мини-Чеклист

• Основной cron настроен раз в минуту, проверка фоновых задач пройдена.
• Ключ сообщества создан.
• Выданы только нужные права.
• Ключ вставлен в EasyChat.
• Статус подключения зеленый.
• Тестовое сообщение появилось в EasyChat.
• Оператор отправил ответ.