+7 (727) 355-53-65
Войти Начать бесплатно
Сменить регион сайта
Казахстан и СНГ (выбрано)
English Россия

Интеграция через iFrame

iFrame — это элемент(тэг), который позволяет отображать веб-страницу внутри другой.

Чтобы вставить Dialogs на сайт, установите этот код в любое место между <body></body>:

$query = http_build_query($fields);
Код подключения iframe:
<iframe
       id="webchat"
       src="https://dialogs.pro/?<?=$query?>"
       sandbox="allow-forms allow-modals allow-orientation-lock allow-pointer-lock allow-popups allow-popups-to-escape-sandbox allow-presentation allow-same-origin allow-scripts allow-top-navigation allow-top-navigation-by-user-activation"
       allow="camera https://dialogs.pro/; microphone https://dialogs.pro/; clipboard-read https://dialogs.pro/; clipboard-write https://dialogs.pro/"
       width="100%"
       height="99%"
       style="border: 0;" >
</iframe>

 

Параметры в iFrame#

В скрипте можно указать данные авторизации и фильтры. Это нужно для того, чтобы не вводить логин и пароль, а установленные фильтры позволят открыть Dialogs на нужных диалогах.

Параметры нужно указывать в атрибуте "src" после знака равно и "https://dialogs.pro/?". Например:

src="https://dialogs.pro/?api[access_token]=$2y$10$3QNdSGJJarGvzMX277775777777WaI4QRW5Fw.NCWkbNONufjlEI.m&api[license_id]=15006&api[messenger_type]=grWhatsApp&api[crm_domain]=chatapp-dev46.bitrix24.ru&api[employee_ext_code]=123&api[company_id]=26&crm[dialogIds]"

В итоге должно получиться так(обратить внимание на атрибут "src"):

$query = http_build_query($fields);
Код подключения iframe:
<iframe
      id="webchat"
      src="https://dialogs.pro/?api[access_token]=$2y$10$3QNdSGJJarGvzMX277775777777WaI4QRW5Fw.NCWkbNONufjlEI.m&api[license_id]=11111&api[messenger_type]=grWhatsApp&api[crm_domain]=domen.bitrix24.ru&api[employee_ext_code]=123&api[company_id]=26&crm[dialogIds]"
      sandbox="allow-forms allow-modals allow-orientation-lock allow-pointer-lock allow-popups allow-popups-to-escape-sandbox allow-presentation allow-same-origin allow-scripts allow-top-navigation allow-top-navigation-by-user-activation"
      allow="camera https://dialogs.pro/; microphone https://dialogs.pro/; clipboard-read https://dialogs.pro/; clipboard-write https://dialogs.pro/"
      width="100%"
      height="99%"
      style="border: 0;" >
</iframe>

Доступные параметры:#

api[access_token]Токен доступа, см. метод Авторизация.
api[license_id]Номер линии. Используется для фильтрации списка линий.
api[messenger_type]Мессенджер. Используется для фильтрации списка мессенджеров.
api[crm_domain]Домен внешней системы.  Необходим для авторизации под конкретным сотрудником.
api[employee_ext_code]ID сотрудника во внешней системе. Необходим для авторизации под конкретным сотрудником.
crm[phones]Массив телефонов. Используется для фильтрации диалогов.
crm[dialogIds]Массив ID чатов. Используется для фильтрации диалогов.

Все поля необязательные.

ChatApp Dialog использует токен API (access_token), переданный из сторонней системы, и получает свою новую независимую пару токенов через специальный метод. Поэтому он не сломает токен API сторонней системы. ChatApp Dialog сам обновляет свой токен при необходимости.

Важно: нужно передать в ChatApp Dialog живой access_token в момент открытия фрейма.

Пример интеграции в Tilda#

Через iFrame можно установить Dialogs на любой сайт. В данной статье приводится пример интеграции с конструктором сайтов Tilda.

1. Зайдите в свое рабочее пространство в Tilda.

2. На вкладке «Мои сайты» создайте сайт или перейдите в существующий.

3. Добавьте блок HTML, например, «Popup: HTML-код в попапе».

4. Вставьте в блок код подключения iFrame:

<iframe
      id="webchat"
      src="https://dialogs.pro/"
      sandbox="allow-forms allow-modals allow-orientation-lock allow-pointer-lock allow-popups allow-popups-to-escape-sandbox allow-presentation allow-same-origin allow-scripts allow-top-navigation allow-top-navigation-by-user-activation"
      allow="camera https://dialogs.pro/; microphone https://dialogs.pro/; clipboard-read https://dialogs.pro/; clipboard-write https://dialogs.pro/"
      width="100%"
      height="1200px"
      style="border: 0;" >
</iframe>

5. Нажмите «Сохранить» и «Закрыть».


 

6. Скопируйте ссылку на Popup.

7. Установите ссылку в любое место на странице, например в кнопку.

8. Опубликуйте сайт.

9. Теперь при нажатии на кнопку откроется всплывающее окно с Dialogs

Оставить заявку на услуги интегратора