Интеграция с Facebook

Внимание! Подключить страницу в Facebook к Callibri может только создатель этой страницы (ее администратор).

Часть 1. Создайте приложение

  1. В кабинете Callibri в разделе Синхронизации перейдите в Соцсети — Facebook. Переключите слайдер в поле «Синхронизация» в положение «включен».
  2. Перейдите в Facebook for Developers. Авторизуйтесь или создайте новую учетную запись на базе вашего профиля FB.
  3. Если вы уже пользовались FB for Developers, выберите «Мои приложения» в правом верхнем углу, нажмите «Создать приложение». 
  4. Выберите пункт «Управление бизнес-интеграциями».

    В поле «Отображаемое название» напишите название вашей группы, которое указано в URL страницы. Например, с URL https://www.facebook.com/Callibri мы пишем в название Callibri. Если вы создали новый аккаунт в системе, поле с «Отображаемым названием» появится на третьем шаге создания аккаунта.

    В назначении приложения выберите пункт «Вы или принадлежащая вам компания». Нажмите «Создать ID приложения».
    blog (42).png
    blog (42).png 200.23 KB

    Название вашей группы, которое вы написали в поле «Отображаемое название» также необходимо внести в поле «Название страницы ФБ» в Callibri.

    Если вы вносите изменения в уже созданное приложение и отображаемое название не совпадает с URL, перейдите в Настройки — Основное в блоке слева и введите новое отображаемое название. А затем вернитесь в раздел Панель.
  5. На открывшейся странице найдите «Messenger», нажмите на кнопку Настроить.
    blog (44).png
    blog (44).png 173.71 KB
  6. Скопируйте ID приложения (написано в левом верхнем углу) и вставьте в поле «ID приложения» в Callibri.
  7. В настройках приложения в разделе Маркеры доступа нажмите кнопку «Добавить или удалить Страницы». Затем на кнопку «Продолжить как “ваше имя в профиле FB”». Выберите подключаемую страницу из списка и отметьте ее галочкой, затем нажмите «Далее». Разрешите «Доступ к перепискам от имени Страницы в Messenger и управление ими» и нажмите «Готово». Нажмите «Сгенерировать маркер» и во всплывающем окне поставьте галочку в чекбоксе «Я понимаю».
    Снимок экрана 2020-10-06 в 17.30.36.png
    Снимок экрана 2020-10-06 в 17.30.36.png 117.61 KB
  8. Скопируйте полученный маркер, вернитесь в Callibri и вставьте его в поле «Токен доступа страницы».
  9. В Callibri нажмите «Сохранить», чтобы параметры синхронизации с Facebook были сохранены.
    blog (45).png
    blog (45).png 80.82 KB
  10. Вернитесь в FB for Developers. Перейдите в раздел Настройки — Основное.
  11. В полях «URL-адрес политики конфиденциальности» и «URL-адрес Пользовательского соглашения» укажите домен вашего сайта.
    blog (46).png
    blog (46).png 145.61 KB
  12. В разделе Значок приложения загрузите логотип необходимого формата (1024*1024). Он не будет нигде отображаться, поэтому можете использовать наш стандартный.
  13. В поле «Категория» выберите «Боты Messenger для бизнеса».
    blog (8).png
    blog (8).png 160.9 KB
  14. Нажмите Сохранить изменения.
  15. В меню слева в разделе «Товары» найдите Messenger. Кликните по нему и перейдите в настройки.
  16. Найдите раздел Webhooks, нажмите «Добавить URL обратного вызова».
    blog (47).png
    blog (47).png 138.97 KB
  17. Вставьте в поле «URL обратного вызова»: https://in.callibri.ru/webhooks/fb_messenger/{APP_ID}. Вместо {APP_ID} вставьте ID вашего приложения (оно написано в шапке FB for Developers). Укажите слово «подтверждение» в поле Маркер подтверждения. Нажмите «Подтвердить и сохранить».
    blog (48).png
    blog (48).png 86.38 KB
  18. Затем нажмите на кнопку «Добавить подписки» и отметьте галочками пункты «messages» и «messaging_referrals».
  19. На панели слева откройте раздел Настройки — Основное. В самом конце страницы будет кнопка «Добавить платформу», нажмите ее. В открывшимся окне выберите «Веб-сайт», укажите URL своего сайта и сохраните изменения.
  20. После этого на панели слева выберите Проверка приложения — Разрешения и функции. На открывшейся странице найдите пункт pages_messaging и нажмите кнопку «Запросить расширенный доступ».
    blog (49).png
    blog (49).png 192.1 KB

    После этого кнопка сменится на «Редактировать запрос на проверку приложения», нажмите ее.
  21. В открывшемся окне нужно заполнить все блоки. Первый блок — «Укажите информацию для подтверждения приложения». Здесь нужно написать пошаговую инструкцию, следуя которой специалист по проверке сможет протестировать вашу интеграцию. Можете написать ее сами или использовать наш шаблон:

    1. Перейдите на сайт _______________
    2. На сайте в правом нижнем углу есть чат, откройте его.
    3. В чате есть ссылка на Мессенджер Facebook. Перейдите в Мессенджер и напишите сообщение.
    5. Отвечать будут живые операторы (не бот и не автоответчик).
    6. Приложение нужно для получения всех сообщений в одном окне (для интеграции Facebook Мессенджер и чата).
    blog (50).png
    blog (50).png 242.18 KB

    После этого сохраните изменения.
  22. Затем заполните блок «Запрашиваемые разрешения и функции». В первые два поля снова пропишите указанную выше пошаговую инструкцию. Также во втором поле нужно выбрать страницу, для которой вы настраиваете синхронизацию.

    Остается в конце страницы загрузить видео с записью экрана, где видно, как вы заходите на сайт, переходите во вкладку Чат, кликаете на значок FB и попадаете в мессенджер FB.

    После загрузки в конце страницы поставьте галочку «Я соглашаюсь с тем, что все данные...». 
    blog (51).png
    blog (51).png 165.43 KB

    И сохраните изменения.
  23. Появится уведомление «Видео в обработке. Вы получите уведомление, когда оно будет готово к просмотру». Его можно закрыть.
  24. Если все заполнено верно, в этом разделе у вас появится кнопка Отправить на проверку. Нажмите на нее. В появившемся окне «Условия платформы...» поставьте галочку «Принимаю» — данные отправятся на проверку. Если кнопка не активна, следуйте рекомендациям Facebook.
  25. Если все в порядке, Facebook отправит вам тестовое сообщение, на которое необходимо ответить в течение 2 дней.
  26. Далее Facebook рассмотрит ваш запрос и уведомит о подключении. Уведомление вы получите в разделе Предупреждения — Входящие, он находится в левом меню Facebook for Developers.

Часть 2. Создайте и подтвердите бизнес-аккаунт

Когда вы получите разрешение на использование pages_messaging, вам поступит запрос на подтверждение бизнес-аккаунта. В этой части подробная инструкция по созданию бизнес-аккаунта. Она необходима только пользователям, бизнес-аккаунт которых еще не верифицирован в приложении FB. Если уже верифицирован — переходите к третьей части инструкции.

Чтобы верифицировать бизнес-аккаунт, заранее приготовьте скан (электронную копию) документа, на котором содержится юридическое название компании, а также одно из нижеперечисленного:
  • номер телефона,
  • адрес,
  • номер налогоплательщика.
Можно использовать следующие документы для загрузки:
  • счёт за коммунальные услуги или телефонную связь компании,
  • лицензию на ведение коммерческой деятельности,
  • налоговую документацию компании,
  • свидетельство о регистрации,
  • учредительный договор.
Возможные форматы скана: .pdf, .jpg, .jpeg, .png
  1. Перейдите в Facebook for Developers.
  2. Авторизуйтесь под учетной записью администратора вашего приложения FB (тот, кто его создавал).
  3. В правом верхнем углу нажмите «Мои приложения», выберите нужное.
  4. В меню слева выберите Предупреждения — Входящие.
  5. Перейдите в сообщение «Требуется подтверждение компании», нажмите «Start Business Verification».
  6. В появившемся окне нажмите «Создать аккаунт Business Manager».
  7. В окне «Создать аккаунт Business Manager» заполните поля в соответствии с данными организации. В поле «Имя» введите имя контактного лица, отвечающего за приложение. В поле «Эл. адрес вашей компании» — основной email организации, к которому есть доступ. Нажмите «Создать аккаунт».
  8. В окне «Подтверждение компании для приложения Название_приложения» выберите соответствующий аккаунт и нажмите «Отправить».
  9. Появится окно «Укажите информацию о компании». Заполните поля в соответствии с информацией о вашей организации. В поле «Сайт» введите основной адрес сайта, на котором используется МультиЧат. Нажмите «Далее».
  10. В окне «Загрузить документацию компании» загрузите приготовленную заранее копию документа. Нажмите «Далее».
  11. После этого будет доступно для изменений окно «Добавьте уполномоченного представителя». Здесь заполните поля в соответствии с данными сотрудника, который уполномочен подписывать соглашения и принимать обязательства от имени вашей компании. Это может быть один из руководителей вашей компании. В поле «Эл. адрес уполномоченного лица» введите адрес, к которому есть доступ в текущий момент. Нажмите Отправить.
  12. Появится сообщение об успешной отправке данных для регистрации бизнес-аккаунта. Нажмите Готово.
  13. Перейдите в электронную почту, указанную в п.11 («Эл. адрес уполномоченного лица»). На данный адрес должно прийти сообщение от legal_noreply@fb.com. Откройте письмо и нажмите на ссылку «View and Accept Supplemental Terms».
  14. Ссылка отправит вас на сайт legal.tapprd.thefacebook.com, где вы сможете прочесть условия соглашения и проверить введенную ранее информацию. Если вы прочли соглашение и принимаете условия, отметьте чекбокс I accept the Supplemental Terms above и нажмите I Agree.

    Готово! Вы успешно отправили данные для регистрации бизнес аккаунта! На email, указанный в п.11 («Эл. адрес уполномоченного лица») будет отправлено сообщение от legal_noreply@fb.com с благодарностью за регистрацию. К письму будет приложен файл «Agreement.pdf», который содержит информацию о вашем соглашении.

Часть 3. Активация приложения

Вы получили подтверждение приложения и успешно зарегистрировали бизнес-аккаунт FB for developers. Осталось только включить приложение, и у вас появится возможность отправлять и принимать сообщения FB через МультиЧат Callibri.

Перейдите в Facebook for Developers.
  1. Авторизуйтесь под учетной записью администратора вашего приложения FB (тот, кто его создавал).
  2. В правом верхнем углу нажмите Мои приложения, выберите нужное приложение.
  3. В меню слева выберите Messenger — Настройки. Пролистайте вниз, должно быть оповещение «Одобрено: pages_messaging».
  4. В верхней панели приложения (в правом углу) переместите слайдер в положение «включен».
  5. Появится предупреждение «Сделать приложение открытым?», подтвердите изменения.
  6. Найдите раздел Webhooks, в поле «Select a page to subscribe your webhook to the page events» выберите соответствующую страницу и нажмите «Подписаться».
Готово! Теперь вы можете отправлять и принимать сообщения FB через МультиЧат Callibri. Отправьте тестовые сообщения с вашей официальной страницы в FB в МультиЧат на вашем сайте.
Не нашли решение проблемы? Обратитесь в техподдержку, мы поможем
Apteka