SalesPlatform vtiger crm 540 Интеграция с социальными сетями

Материал из SalesPlatform Wiki
Перейти к: навигация, поиск

Главная страница руководства


Содержание

Краткий обзор

Система vtiger CRM предоставляет возможность отправки личных сообщений своим клиентам в социальных сетях. Также реализована возвоможность просмотра и импорта персональной информации из профиля клиента в социальной сети. Данные функции доступны из модулей [Обращения], [Контрагенты], [Контакты]. В качестве программной библиотеки для аутентификации в социальных сетях используется HybridAuth.

Поддерживаемые социальные сервисы:

Настройка модуля

Корректная работа модуля возможна только при наличии зарегистрированных приложений в Вконтакте, Facebook и Twitter. Если у вас уже имеются приложения в данных социальных сетях - шаг Регистрация приложений в социальных сетях можно пропустить.

Регистрация приложений в социальных сетях

Регистрация приложения в Вконтакте

1. Авторизуйтесь в Вконтакте.

2. Перейдите по ссылке http://vk.com/dev.

3. Нажмите на кнопку [Создать приложение].

Рис. 2.1: Создание приложения в Вконтакте 1


4. Введите название приложения и выберите в качестве типа приложения Standalone-приложение.

Рис. 2.2: Создание приложения в Вконтакте 2


5. Укажите поля [Адрес сайта] и [Базовый домен] значениями месторасположения установленной Vtiger crm. На рисунке указан пример если система установлена на localhost. Запомните значения ID приложения, Защищенный ключ.

Рис. 2.3: Настройка приложения в Вконтакте


Регистрация приложения в Facebook

1. Авторизуйтесь в Facebook.

2. Перейдите по ссылке https://developers.facebook.com/apps.

3. Нажмите на кнопку [Создать новое приложение].

Рис. 2.4: Создание приложения в Facebook 1


Vt note.png Примечание
Если кнопки [Создать новое приложение] нет, то сначала необходимо зарегистрироваться как разработчик (кнопка Register as developer) Facebook. Регистрация проходит на той же странице.


4. Заполните поле [App Name] и нажмите на кнопку [Продолжить].

Рис. 2.5: Создание приложения в Facebook 2


5. Параметр [Sandbox Mode] переведите в значение [Disabled]. Укажите поле [Site URL] значением месторасположения установленной Vtiger crm. На рисунке указан пример если система установлена на localhost. Запомните значения App ID, App Secret.

Рис. 2.6: Настройка приложения в Facebook


Регистрация приложения в Twitter

1. Перейдите по ссылке https://dev.twitter.com/apps.

2. Авторизуйтесь в Twitter.

3. Нажмите на кнопку [Create a new application].

Рис. 2.7: Создание приложения в Twitter 1


4. Заполните все поля. В качестве [Callback URL] укажите значение месторасположения установленной Vtiger crm. В качестве [Website] укажите произвольный URL-адрес (например адрес вашей организации). На рисунке указан пример если система установлена на localhost.

Рис. 2.8: Создание приложения в Twitter 2


5. После успешного создания приложения запомните значения полей [Consumer Key] и [Consumer Secret].

Рис. 2.9: Настройка приложения в Twitter


Редактирование конфигурационного файла

Перейдите в папку где установлена система Vtiger. Далее откройте папку modules -> SPSocialConnector -> hybridauth. Выберите файл config.php.

Укажите base_url значением пути до папки hybridauth включительно. На рисунке ниже приведен пример, если система установлена на localhost.

Рис. 2.10: Редактирование файла config.php


Найдите в массиве providers те социальные сети, в которых у вас есть зарегистрированные приложения (Facebook, Twitter, Вконтакте). В качестве id укажите id приложения, в качестве secret - секретный ключ приложения.

Рис. 2.11: Редактирование файла config.php


Сохраните файл.

Настройки для отправки сообщения в Вконтакте

1. Перейдите по ссылке представленной ниже. Вместо YOUR_APP_ID введите ID вашего приложения созданного раннее.

https://oauth.vk.com/authorize?client_id=YOUR_APP_IDD&scope=offline,messages&redirect_uri=https://oauth.vk.com/blank.html&display=wap&response_type=token

2. Появится окно получения доступа к Вконтакте. Аутентифицируйте пользователя в социальной сети от чьего имени будут посылаться личные собщения. Далее разрешите приложению доступ к аккаунту. В результате вы будете перенаправлены на страницу https://oauth.vk.com/blank.html. В адресной строке скопируйте значение параметра access_token. Пример представлен ниже:

Рис. 2.12: Получение access_token


3. Перейдите в папку где установлена система Vtiger. Далее откройте папку modules -> SPSocialConnector -> providers. Выберите файл Vkontakte.php. Найдите функцию sendPrivateMessage и укажите скопированное значение access_token в параметр $access_token.

Рис. 2.13: Редактирование файла Vkontakte.php


4. Сохраните файл.

Vt note.png Примечание
Данный access_token является бесконечным по времени использования, но если у аутентифированного аккаунта поменялись пароль или имя, то необходимо сгенерировать access_token заново начиная с шага 1.


Настройки для отправки сообщения в Facebook

1. Перейдите в папку где установлена система Vtiger. Далее откройте папку modules -> SPSocialConnector -> providers. Выберите файл Facebook.php. Найдите функцию sendPrivateMessage и укажите APP ID (id вашего приложения в Facebook).

Рис. 2.14: Редактирование файла Facebook.php


2. Сохраните файл.

Отправка сообщений

Для того чтобы отправить сообщение необходимо выбрать нужную запись в [Обращениях], [Контрагентах] или [Контактах]. В разделе [Действия] нажмите на ссылку [Сообщение].

Рис. 3.1: Отправка личного сообщения


Vt important.png Важно
Для отправки личного сообщения вы должны знать URL клиента в социальной сети. Поля [Facebook URL], [Vkontakte URL], [Twitter URL] в информации о контакте предназначены для хранения URL клиента в соответсвующих социальных сетях. Если эти поля не заполнены, то отправка личных сообщений невозможна.
Vt important.png Важно
Если при отправке сообщения в новом окне появляется ошибка: "You cannot access this page directly.", то необходимо очистить кэш и куки браузера.

В новом окне необходимо указать URL, на который будет отправлено личное сообщение и нажать кнопку [Выбрать]. Пример представлен на рисунке ниже.

Рис. 3.2: Выбор URL для отправки личного сообщения


Vt tip.png Совет
Также вы можете выбрать сразу несколько URL для отправки личных сообщений.

Далее необходимо ввести текст сообщения и нажать кнопку [Отправить].

Рис. 3.3: Текст сообщения


Vt note.png Примечание
При отправке личного сообщения в Facebook придется продублировать введенное сообщение в новое открывшееся диалоговое окно. Это связано с особенностями API Facebook.

Откроется новое окно. Если вы еще не аутентифицировались в выбранной социальной сети, то откроется окно аутентификации и далее окно статуса отправки сообщения.

Рис. 3.4: Окно аутентификации в социальной сети


Иначе сразу откроется окно статуса отправки.

Рис. 3.5: Окно статуса отправки сообщения


История отправленных сообщений

Просмотр истории отправленных сообщений доступен в модуле [Сообщения].

Рис. 4.1: История отправленных сообщений


При нажатии на ссылку текста сообщения откроется окно информации об отправленном сообщении: текст сообщения, время создания, кому назначено. Зеленый цвет в [Информация Статуса] означает, что сообщение успешно отправлено, красный - наоборот. Также при наведении на цветное поле высвечивается надпись-подсказка о статусе отправке сообщения.

Рис. 4.2: Информация об отправленном сообщении


При нажатии на [Еще Информация] можно посмотреть к какой записи привязано отправленное сообщение.

Рис. 4.3: Окно [Еще Информация]


Vt note.png Примечание
Одному клиенту можно послать личное сообщение сразу в несколько социальных сетей, но нельзя послать одно сообщение сразу нескольким клиентам.
Vt note.png Примечание
При удалении записи Обращения, Контрагента или Контакта из системы все сообщения связанные с данной записью останутся в базе данных, но не будут ни с кем связаны. Если восстановить удаленные записи из корзины - связь между сообщениями и отправителем также восстановится.

Импорт информации из профиля социальной сети

Просмотр и загрузка информации из профиля пользователя социальной сети доступна при изменении существующей записи в модулях [Обращения], [Контрагенты], [Контакты]. Для начала импорта необходимо нажать на кнопку [Импорт].

Vt important.png Важно
Нельзя импортировать данные из социальной сети при создании новой записи в модулях [Обращения], [Контрагенты], [Контакты]. Как указывалось выше загрузка информации доступна только при изменении существующей записи в модулях .
Рис. 5.1: Начало импорта


Откроется новое окно, в котором необходимо ввести URL страницы пользователя социальной сети и нажать кнопку [Далее].

Рис. 5.2: Окно ввода URL


Vt important.png Важно
Как указывалось ранее интеграция произведена с социальными сетями Вконтакте, Facebook, Twitter. Поэтому в окно ввода URL необходимо вводить URL пользователей зарегистрированных в данных социальных сетях.

Далее как и при отправке личного сообщения, если вы еще не аутентифицировались в выбранной социальной сети, то откроется окно аутентификации и далее окно просмотра профиля. Иначе - сразу окно просмотра профиля.

При нажатии на кнопку [Загрузить] откроется окно измененных данных, которое показывает какие поля будут заполнены в карточке клиента данными из социальной сети.

Vt note.png Примечание
Данные из профиля пользователя в социальной сети записываются ТОЛЬКО на место соответсвующих пустых полей в карточке клиента. Таким образом возможность обновления текущей информации в карточке клиента на новую из социальной сети невозможна.
Vt note.png Примечание
Измененные данные записываются сразу в базу данных системы поэтому кнопку [Сохранить] можно и не нажимать.

Главная страница руководства

Личные инструменты
Пространства имён
Варианты
Действия
Навигация
Инструменты