Коннекторы открытых линий: обзор методов

Коннекторы открытых линий — это инструмент для интеграции внешних мессенджеров и социальных сетей с Битрикс24. Коннекторы позволяют:

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

Быстрый переход: все методы

Пользовательская документация: Подключение каналов Контакт-центра

Связь коннекторов с другими объектами

Открытые линии. Собирают сообщения с коннекторов, управляют очередями и распределяют сообщения между сотрудниками. Работать с открытыми линиями следует с помощью группы методов imopenlines.*.
CRM. На основе сообщений можно автоматически создавать лиды и сделки методами crm.lead.add и crm.deal.add.
Пользователь. Получить идентификатор пользователя позволяют методы user.get и user.search.
Чат. За переписку с пользователями отвечают методы im.chat.* и im.message.*.
Чат-боты. Настройка автоматических ответов и чат-ботов выполняется с помощью методов imbot.*

Как подключить коннектор

Зарегистрируйте коннектор с помощью метода imconnector.register.
Активируйте его методом imconnector.activate.
Установите данные коннектора методом imconnector.connector.data.set.
Проверьте статус коннектора методом imconnector.status и убедитесь, что он готов к работе.

Как работать с сообщениями

Отправить сообщение можно методом imconnector.send.messages.

Отправленные сообщения можно изменять методом imconnector.update.messages. Метод изменяет параметры пользователя, сообщения и чата.

Удалить сообщения открытых линий можно методом imconnector.delete.messages.

Как добавить виджет в Контакт-центр

Чтобы добавить виджет коннектора в Контакт-центр, используйте код встройки CONTACT_CENTER. Этот код необходимо указать в параметре PLACEMENT метода placement.bind.

Обзор методов и событий {#all-methods}

Scope: imopenlines

Кто может выполнять метод: любой пользователь

{% note info "" %}

Методы imconnector.* в текущей версии не поддерживают работу через вебхуки.

{% endnote %}