# Каналы общения

В этом разделе настраиваются прочие коммуникационные каналы, интегрируемые в сервис **Webim**: чаты в мессенджерах, переписка в группах в соц. сетях и т. п.

Работоспособность каналов зависит не только от Webim. Мессенджеры и социальные сети меняют условия доступа к своим API, операторы связи влияют на качество соединения, регуляторы могут ограничивать работу отдельных сервисов. Такие изменения находятся вне контроля Webim, и сервис не гарантирует бесперебойную работу каналов в подобных случаях.

При редактировании уже сохранённого канала часть чувствительных данных в форме отображается **частично скрытой** (маскируется): полное значение в интерфейсе недоступно. Чтобы изменить такое поле, введите новое значение целиком. Незаполненные поля не маскируются.

Замаскированное значение показывается в поле ввода как подсказка (placeholder): часть символов заменена на звёздочки (`*`). Для адреса прокси у IPv4 видны только первые два октета (например, `192.168.*.*`), у домена — первая и последняя метки (например, `proxy.***.local`). Порт, если он указан, не маскируется (например, `192.168.*.*:3128`). Для URL видны схема и замаскированный хост, путь заменяется на `***` (например, `https://api.***.local/***`); порт в URL тоже остаётся видимым. Для токенов и паролей начало скрыто звёздочками, в конце может оставаться короткий фрагмент.

Например, для **Telegram** частично скрываются URL сервера Telegram Bot API, адрес (хост) прокси, URL прокси для вебхука (`webhook_proxy_url`), токен авторизации бота и пароль прокси. Аналогично маскируются и другие секреты канала.

## MAX

Группа настроек для интеграции мессенджера **MAX** с сервисом **Webim**. Подробная инструкция по подключению канала описана в [документации](https://webim.ru/kb/channels/social-network-messengers/max.html).

| Название параметра     | Описание                                                        |
|------------------------| ----------------------------------------------------------------|
| Токен авторизации бота | Токен (`access_token`), полученный при создании бота в **MAX**. |

## Apple Messages for Business

Начиная с версии **Webim** [10.1](https://webim.ru/webim-10-1/) Вы можете настроить канал Apple Messages for Business самостоятельно, не прибегая к технической поддержке **Webim**. Через данный канал вы сможете коммуницировать с владельцами устройств **Apple**, которые нашли Вашу компанию через какой-либо сервис **Apple**: поиск, карты, Siri. Для посетителя общение в чате будет осуществляться через стандартное приложение **Сообщения (Messages)**.

Процесс создания Business ID для интеграции происходит на стороне Apple и описан в [инструкции](https://webim.ru/kb/channels/social-network-messengers/apple-messages-for-business/apple-messages-for-business-setup.html).

| Название параметра        | Описание                                                                                                                                                                                                         |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Идентификатор бизнес чата | После того, как вы зарегистрируете бизнес-аккаунт и **Apple** его одобрят, они выдадут Вам **Apple Messages for Business ID**. Скопируйте данный код и укажите в этом поле при настройке данного канала общения. |

## Telegram

Группа настроек интеграции мессенджера **Telegram** и сервиса **Webim**.

Они понадобятся, если вы собираетесь предлагать своим пользователям общение с операторами через собственный канал в **Telegram**. В этом случае вам предстоит создать собственный бот в **Telegram** и настроить интеграцию сервисов.

Подробно эта интеграция описана в [документации](https://webim.ru/kb/channels/social-network-messengers/telegram.html).

| Название параметра     | Описание                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Токен авторизации бота | Чтобы начать работу с ботом в **Telegram**, понадобится знать токен (маркер) этого бота.<br> Этот токен необходим для использования [Telegram Bot API](https://core.telegram.org/bots) от имени Вашего бота.<br><br> Данный токен вы получили, когда только создавали свой бот, обращаясь к BotFather: ![Диалог с BotFather в Telegram: сообщение с токеном бота](https://webim.ru/kb/img/channels/index/tg-bot-preview.webp)<br> Подробно процесс получения токена описан в [документации сервиса Telegram](https://core.telegram.org/bots#botfather) |

## Сообщество Вконтакте

Группа настроек интеграции социальной сети **ВКонтакте** и сервиса **Webim**

Они понадобятся, если вы собираетесь предлагать своим пользователям общение с операторами через своё сообщество в сети **ВКонтакте**. В этом случае вам предстоит создать группу (публичную страницу, событие) **ВК** и настроить интеграцию сервисов.

Подробная инструкция для этого содержится в [нашей документации](https://webim.ru/kb/channels/social-network-messengers/vk.html).

| Название параметра | Описание                                                                                                                                                                                                                                                                                                                                        |
|--------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Ключ доступа       | Введите здесь уникальный ключ доступа, предварительно сгенерированный в сети **ВКонтакте** для доступа к вашему сообществу через **API Вконтакте**.<br>Подробно процесс формирования ключа доступа описан в шагах 8-15 [инструкции по настройке интеграции](https://webim.ru/kb/channels/social-network-messengers/vk.html).                                   |
| Адрес сервера      | URL сервера **Webim**, по которому к нему должен обращаться сервер **ВКонтакте** и который вам необходимо скопировать и, не изменяя, перенести в настройки сообщества **ВКонтакте**.<br>Подробно процесс формирования ключа доступа описан в шагах 16-18 [инструкции по настройке интеграции](https://webim.ru/kb/channels/social-network-messengers/vk.html). |
| Код подтверждения  | Введите здесь условный код, который сервер **ВКонтакте** будет ожидать, обратившись к серверу **Webim**. Скопируйте его в настройках API своего сообщества **ВКонтакте**.<br>Подробно процесс формирования ключа доступа описан в шагах 19-20 [инструкции по настройке интеграции](https://webim.ru/kb/channels/social-network-messengers/vk.html).            |
| Секретный ключ     | Секретный ключ, сгенерированный сервисом **Webim**. Скопируйте его на этой странице, сохраните в надёжном месте, вставьте на странице настроек сообщества **ВКонтакте**.<br>Подробно процесс формирования ключа доступа описан в шагах 21-24 [инструкции по настройке интеграции](https://webim.ru/kb/channels/social-network-messengers/vk.html).             |

## WhatsApp 360Dialog

Группа настроек для интеграции мессенджера WhatsApp[^whatsapp_footnote] с **Webim** через **360Dialog**. Клиенты могут обращаться к Вам через данный мессенджер, если у Вас подключён официальный бизнес-аккаунт **WhatsApp**. Подробнее про интеграцию Вы можете прочитать в [инструкции](https://webim.ru/kb/channels/social-network-messengers/whatsapp/whatsapp-360dialog.html). Интеграция доступна для **Webim** 10.2 и новее.

| Название параметра                     | Описание                                                                       |
|----------------------------------------|--------------------------------------------------------------------------------|
| Номер телефона (без + или 00 в начале) | Номер, на который зарегистрирован Ваш официальный бизнес-аккаунт **WhatsApp**. |
| Адрес для отправки запросов            | Адрес, куда **Webim** будет слать сообщения.                                   |

## Viber

Группа настроек для интеграции мессенджера **Viber** с сервисом **Webim**. Раньше у **Viber** была возможность создания только паблик-аккаунтов. После этого часть паблик-аккаунтов была переведена в новый статус - "сообщества". **Webim не поддерживает** интеграцию с сообществами в **Viber**, однако поддерживает её со старыми паблик-аккаунтами, которые не были переведены в сообщества, и с новыми паблик-аккаунтами, которые регистрируются по [данной ссылке](https://partners.viber.com/login). И старая, и новая версия паблик-аккаунтов реализуется по одному API, поэтому поддерживается **Webim**, однако функционируют они по-разному. Инструкция по интеграции со старыми паблик-аккаунтами [здесь](https://webim.ru/kb/channels/social-network-messengers/viber.html), однако она может быть полезна и при интеграции нового паблик-аккаунта.

| Название параметра                    | Описание                                                                                                                                            |
| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| Токен авторизации публичного аккаунта | Уникальный ключ, полученный на странице описания публичного аккаунта на сайте **Viber** (см. п.1-2 [инструкции](https://webim.ru/kb/channels/social-network-messengers/viber.html)). |

## Одноклассники

Группа настроек для интеграции социальной сети **Одноклассники** с сервисом **Webim**. Она используется для общения с пользователями через группу в **Одноклассниках** при помощи функции **Написать сообщение** на странице группы. Если у Вас группы ещё нет, необходимо её создать и настроить интеграцию. Как это сделать, написано в [инструкции](https://webim.ru/kb/channels/social-network-messengers/ok.html).

| Название параметра       | Описание                                                                                                                                                          |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Токен авторизации группы | Уникальный ключ, необходимый для интеграции **Webim** с **Одноклассниками**. Как его получить описано в пунктах 5-10 [инструкции](https://webim.ru/kb/channels/social-network-messengers/ok.html). |

## Email

Группа настроек для интеграции почтового канала с **Webim**. Благодаря настройке данного канала Ваши операторы смогут видеть обращения, отправленные на Email, в [РМО](https://webim.ru/kb/control-panel/sections.html) вместе с остальными сообщениями. Процесс настройки канала описан в [инструкции](https://webim.ru/kb/channels/mail/email.html).

| Название параметра | Описание                                                                                                |
|--------------------|---------------------------------------------------------------------------------------------------------|
| Ваш Email-адрес    | Адрес электронной почты, на который будут писать пользователи.                                          |
| Наш Email адрес    | Сгенерированный на стороне **Webim** Email адрес, на который будут пересылаться письма с Вашего Email.   |

## LINE

Группа настроек для интеграции мессенджера [**LINE**](https://www.line.me/en/) с **Webim**. Подробнее про интеграцию Вы можете прочитать в [инструкции](https://webim.ru/kb/channels/social-network-messengers/line.html). Интеграция доступна для **Webim** 10.7 и новее.

| Название параметра                     | Описание                                                                       |
|----------------------------------------|--------------------------------------------------------------------------------|
| Channel access token                   | Уникальный ключ доступа, полученный при создании канала.                       |
| Channel secret                         | Уникальный ключ самого канала.                                                 |

[^whatsapp_footnote]: WhatsApp принадлежит корпорации Meta, деятельность которой признана экстремистской и запрещена в РФ.

---

Источник: https://webim.ru/kb/channels/index.html
