Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.
Подсказка
titleДля кого нужна эта статья

Эта статья поможет вам интегрировать чат-бота TWIN в стороннее приложение. Как мобильное, так и десктопное. 

Предупреждение
titleАктуальность информации
Мы стараемся поддерживать информацию в данной статье в актуальном состоянии. Все последние обновления для работы с сервисами TWIN в первую очередь публикуются на ресурсе https://developers.twin24.ai
note
Предупреждение
titleУчтите при интеграции
Команда TWIN постоянно совершенствуем свои сервисы. В связи с этим возможно внесение изменений в наше API. Просим вас учитывать этот факт при реализации интеграции чат-платформы TWIN с вашими приложениями. Важно обратить на это внимание при согласовании гарантийных обязательств.

Оглавление

...

titleSDK как основной инструмент интеграции

...

В дальнейшем интеграцию чат-платформу TWIN планируется осуществлять с помощью SDK (находиться в разработке). Это позволит производить процесс интеграции быстрее и обеспечит более высокую стабильность работы. 

Оглавление


...

Вступление

В данной статье рассмотрены 2 варианта интеграции чат-бота TWIN с собственным приложением. 

  1. Интеграция через websockets
    • Более продвинутая технически
    • Позволяет вести общение через сервис чатов TWIN
      • Имеет большое количество дополнительных настроек
      • Ознакомиться с возможностями чатов можно по ссылке 
  2. Интеграция через HTTP REST API
    • Упрощенный способ интеграции
    • Интеграция производится напрямую с сервисом бота TWIN
      • Дополнительные настройки отсутствуют
      • Простое взаимодействие с ботом в формате "вопрос-ответ"

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

Основные шаги интеграции

  • Создание сессии бота
    • Происходит путем запроса к API
    • В ответ будет получено сообщение бота (если есть) и id созданной сессии
  • Подключение к соккет-серверу
    • В соккеты будут приходить события от бота и оператора
  • Обмен сообщениями бот-клиент
    • Отправка сообщений клиента производится через API
    • Получение сообщений и событий бота и оператора происходит через соккеты

Основные методы API

Создание сессии бота

(Детальное описание с комментариями будет позже)

https://developers.twin24.ai/reference/startchatsessions

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

(Детальное описание с комментариями будет позже)

https://developers.twin24.ai/reference/continuelastorstartnewchatsessions

Прочие доступные методы

Со всеми доступными методами можно ознакомиться в документации разработчика:

https://developers.twin24.ai/reference/operatorchatsessionlist

Live события

Подключение к соккет-серверу

Для работы с соккет-сервером используется инструмент Centrifuge. 

Подробности о доступных SDK для работы с Centrifuge можно получить в официальной документации Centrifuge

Эндпоинт для подключения: wss://twin24.ai/centrifugo/connection/websocket 

  • При подключении нужно отправить data и name
Блок кода
languagejson
titledata
linenumberstrue
{
    "application": "widget", // REQUIERD. Всегда widget
    "settings": {
        "userId": "bce7d22e-dde6-4427-b391-ebbdfda44de6", // OPTIONAL. Уникальный идентификатор пользователя
        "sessions": [
            "bce7d22e-dde6-4427-b391-ebbdfda44de6" // REQUIRED. Идентификатор сессии бота (можно передать несколько для прослушивания сразу нескольких сессий)
        ]
    }
}
Блок кода
languagejson
titlename
linenumberstrue
Всегда равно "js"
  • В ответ на подключение будет получено следующее сообщение:
Блок кода
languagejson
linenumberstrue
{
    "id": 1, // Порядковый номер сообщения
    "connect": { // Подробная информация о подключении
        "client

Оглавление

Оглавление

Информация об интеграции

Интеграция чат-платформы TWIN в приложение (кодовую базу) клиента идёт на стороне клиента. Так как интеграция осуществляется силами клиента, счёт за такую интеграцию не выставляется.

Возможность интеграции и её срок определяется специалистами на стороне клиента. Со своей стороны TWIN предоставляет необходимую документацию по методам подключения и взаимодействия платформы с приложением заказчика.

Для обеспечения двухсторонней связи используется библиотека Socket.IO, построенная на основе протокола WebSocket.

Интеграция осуществляется в несколько простых шагов:

  1. Старт чат-сессии. Происходит при помощи API.
  2. Отправка сообщения в чат сессию. Происходит при помощи API.
  3. Получение сообщений, подтверждение получения сообщений - происходит с помощью socket.io.

Ниже детально описаны все перечисленные этапы с примерами кода на языке python 3.11.

Старт новой чат-сессии

Метод: POST

Authorization: No Auth 

URL: https://tcl.twin24.ai/api/chats/v1/chats/{chat_id}/sessions?x_widget=1

Ссылка на документацию

Пример функции на языке python:

Блок кода
languagepy
themeConfluence
firstline1
titleФункция старта чат-сессии
linenumberstrue
def start_chat_session(chat_id: str, name: str = "integration_example"):
    url = f"https://tcl.twin24.ai/api/chats/v1/chats/{chat_id}/sessions?x_widget=1"
    headers = {"Content-Type": "application/json"}
    payload = json.dumps({"name": name})
    response = requests.request("POST", url, headers=headers, data=payload)
    
    return response

Описание параметров пути:

...

Поле

...

Тип

...

Обязательно

...

Описание

...

chatId

...

string

...

Да

...

Идентификатор чата. Он определяет настройки чата и схему работы бота.

Тело запроса

Блок кода
languagepy
firstline1
titleТело запроса в формате Json:
linenumberstrue
{
  "name": "string",
  "botId": "bce7d22e-dde6-4427-b391-ebbdfda44de6",
  "sessionId": "bce7d22e-dde6-4427-b391-ebbdfda44de6",
  "sessionTtl": 3600,// Идентификатор клиента
  "messengerType": "WHATSAPP",
  "messengerUserId": "string",
  "messageBodyversion": "string6.2.1 OSS",
  "messageAttachments": [
 // Системная информация. Не имеет роли для интеграции
        "subs": { // Список доступных подписок
            "widget:bce7d22e-dde6-4427-b391-ebbdfda44de6"
  ],: { // Имя канала подписки
  "clientNameForOperator": "string",
  "clientId": "bce7d22e-dde6-4427-b391-ebbdfda44de6",
  "clientExternalId": "string",
  "clientPhone": 75555673245,
  "clientEmail": "string",
  "clientDeviceIdrecoverable": "string"true,
  "clientTimezone": 300,
  "clientMetadata": {
// Системная информация. Не имеет роли для интеграции
           "var1": "val1",
    "var2epoch": "val21769579399",
 // Системная  "var3": "val3"
  },
  "returnAnswerAsync": true
}

...

Поле

...

Тип

...

Обязательно

...

Описание

...

name

...

string

...

Да

...

Имя сессии

...

botId

...

string

...

Нет

...

sessionId

...

Нет

...

Идентификатор существующего сеанса чата.

...

sessionTtl

...

Нет

...

Время жизни чат-сессии. Указывается в секундах и не может быть больше 12 часов. По умолчанию равен 3 600 секундам.

...

messengerType

...

Нет

...

messengerUserId

...

Нет

...

messageBody

...

Нет

...

messageAttachments

...

Нет

...

clientNameForOperator

...

Нет

...

Имя клиента, которое будет видно оператору.

...

clientId

...

Нет

...

clientExternalId

...

string

...

Нет

...

Определяемый пользователем идентификатор клиента, инициировавшего сеанс чата.

...

clientPhone

...

string

...

Нет

...

clientEmail

...

string

...

Нет

...

Электронная почта клиента

...

clientDeviceId

...

string

...

Нет

...

Идентификатор клиентского устройства для отправки PUSH-уведомлений.

...

clientTimezone

...

integer

...

Нет

...

Смещение часового пояса клиента в минутах.

...

clientMetadata

...

object

...

Нет

...

Любые определенные пользователем пары ключ/значение в качестве переменных бота.

информация. Не имеет роли для интеграции
                "positioned": true // Системная информация. Не имеет роли для интеграции
            }
        },
        "ping": 25, // Частота пинга
        "pong": true // Флаг наличия понга
    }
}
  • Далее необходимо подписаться на доступные каналы подписки, чтобы получать в них события. Название канала – ключи из объектов subs ("widget:bce7d22e-dde6-4427-b391-ebbdfda44de6")
  • Далее нужно присоединиться к сессии 
    • Нужно передать rpc
    • Метод: joinSession
    • data: {"id": "bce7d22e-dde6-4427-b391-ebbdfda44de6"} // Идентификатор сессии
    • При успешно подключении в ответ будет получено сообщение: {"success": true}
  • Теперь в соккеты будут приходить события от бота и оператора, а также системные события

Список событий

  • showTypingIndicator – уведомление о наборе сообщения ботом или оператором
    Блок кода
    languagejson
    titlePayload события
    linenumberstrue
    {
        "authorType": "BOT" // Автор события: BOT | OPERATOR
    }
  • chatMessageCreated – сообщение от бота или оператора
    Блок кода
    languagejson
    titlePayload события
    linenumberstrue
    {
        "id": "bce7d22e-dde6-4427-b391-ebbdfda44de6", // REQUIRED. Уникальный идентификатор сообщения
        "authorType": "BOT", // REQUIRED. ENUM: 'BOT' | 'OPERATOR'. Тип автора сообщения
        "body": "Тестовое сообщение", // REQUIRED. Текст сообщения (может быть пустым)
        "answers": [ // REQUIRED. Массив предустановленных вариантов ответов для пользователя
            "Вариант ответа 1

...

returnAnswerAsync

...

boolean

...

Нет

Ответы

Код 201

Description: Successful session creation

...

languagepy
firstline1
titleОтвет в формате JSON
linenumberstrue

...

  • ",
          

...

  •   "Вариант ответа 2",
            "

...

  • Вариант ответа 3"
    

...

  •     ],
    

...

  •     "

...

  • keyboard": 

...

  • { // OPTIONAL. Объект клавиатуры с кнопками быстрых 

...

  • ответов
            

...

  • "

...

  • buttonsInRow": 

...

  • 2,

...

  •  // Количество кнопок в 

...

  • одном ряду
            "

...

  • buttons": 

...

  • [ // Массив кнопок для отображения
          

...

  •       

...

  • {
          

...

  •           "

...

  • type": 

...

  • "text", // Тип кнопки. Всегда text. 
         

...

  •  

...

  •           "

...

  • text": "

...

  • Кнопка 1" // Текст на кнопке
              

...

  •   },
               

...

  •  {
                    "

...

  • type": "

...

  • text",
              

...

  •       "text": "

...

  • Кнопка 2"

...

  • 
               

...

  •  }
            ]
       

...

  •  

...

  • },
        

...

  • "createdAt": "2026-01-28T12:00:00+00:00", // REQUIRED. Дата и время создания сообщения в формате ISO 8601
        "

...

  • sessionId": "

...

  • bce7d22e-dde6-4427-b391-ebbdfda44de6", // REQUIRED. Идентификатор сессии чата 
        "attachments": [ // REQUIRED. Массив прикрепленных файлов (может быть пустым)
          

...

  •   {
              

...

  •   

...

 

Описание полей ответа

...

Поле

...

Тип

...

Обязательно

...

Описание

...

id

...

clientId

...

startedAt

...

ttl

...

messages

...

| body

...

| answers

...

| actions

...

| attachments

...

| | id

...

| | isPrivate

...

| | createdAt

...

| | name

...

| | baseName

...

| | extension

...

| | sugestedExtension

...

| | path

...

| | size

...

| | url

...

| | downloadLink

В успешном ответе содержится идентификатор чат-сессии. Именно этот параметр будет в дальнейшем использоваться для отправки сообщения в чат-сессию и подключения socket.io для "прослушивания" событий в данной чат-сессии.

Отправка сообщения в чат сессию

Метод: POST

Authorization: No Auth 

URL: https://chats-api.twin24.ai/api/v1/sessions/{session_id}/messages

Пример функции на языке python:

Блок кода
languagepy
themeConfluence
firstline1
titleФункция отправки сообщения в чат-сессию
linenumberstrue
def send_msg_to_chat_session(session_id: str, msg: str):
    url = f"https://chats-api.twin24.ai/api/v1/sessions/{session_id}/messages"
    headers = {'Content-Type': 'application/json'}
    payload = json.dumps({
        "body": msg,
        "attachments": []
    })
    response = requests.request("POST", url, headers=headers, data=payload)

    return response

Описание параметров пути:

...

Поле

...

Тип

...

Обязательно

...

Описание

...

sessionId

...

string

...

Да

...

Идентификатор чат-сессии.

Тело запроса

Блок кода
languagepy
firstline1
titleТело запроса в формате Json:
linenumberstrue
{
  "body": "string",
  "attachments": [
    "bce7d22e-dde6-4427-b391-ebbdfda44de6"
  ],
  "replyToMessageId": "string"
}

...

Поле

...

Тип

...

Обязательно

...

Описание

...

body

...

string

...

attachments

...

array of strings

...

replyToMessageId

...

string

...

Ответы

Код 201

Description: Successful message creation

Блок кода
languagepy
firstline1
titleОтвет в формате JSON
linenumberstrue
{
  "id": "bce7d22e-dde6-4427-b391-ebbdfda44de6",
  "createdAt": "2018-10-31T11:56:07+00:00"
}

Описание полей ответа

...

Поле

...

Тип

...

Обязательно

...

Описание

...

id

...

createdAt

...

  • "id": "bce7d22e-dde6-4427-b391-ebbdfda44de6", // REQUIRED. Идентификатор вложения
                "contentType": "image/png", // REQUIRED. MIME-тип файла (например: 'image/png', 'application/pdf')
                "size": 1024000, // REQUIRED. Размер файла в байтах
                "downloadLink": "https://example.com/file.png", // REQUIRED. Ссылка для скачивания файла
                "name": "test-file.png", // REQUIRED. Имя файла
                "url": "https://example.com/file.png" // OPTIONAL. Альтернативная ссылка на файл
            }
        ],
        "actions": [ // REQUIRED. Массив действий/кнопок для интерактивности (может быть пустым)
            {
                "type": "button", // REQUIRED. Тип действия
                "event": "click_action", // OPTIONAL. Событие, которое триггерится при клике
                "label": "Нажми меня", // OPTIONAL. Текст на кнопке действия
                "data": "{\"key\": \"value\"}" // OPTIONAL. Дополнительные данные в формате строки
            }
        ],
        "avatar": "https://example.com/avatar.png", // OPTIONAL. URL аватара автора
        "authorId": "bce7d22e-dde6-4427-b391-ebbdfda44de6", // OPTIONAL. Идентификатор автора
        "authorName": "Тестовый Автор", // OPTIONAL. Имя автора сообщения
        "type": "REGULAR", // OPTIONAL. ENUM: 'REGULAR' | 'TERMINAL'. Тип сообщения
        "replyId": "bce7d22e-dde6-4427-b391-ebbdfda44de6", // OPTIONAL. Идентификатор сообщения, на которое это сообщение является ответом
        "replyToMessage": { // OPTIONAL. Объект с информацией о сообщении, на которое отвечают
            "id": "bce7d22e-dde6-4427-b391-ebbdfda44de6", // REQUIRED. Идентификатор исходного сообщения
            "authorType": "CLIENT", // REQUIRED. ENUM: 'BOT' | 'OPERATOR' | 'CLIENT'. Тип автора исходного сообщения
            "body": "Исходное сообщение", // OPTIONAL. Текст исходного сообщения
            "authorName": "Имя клиента" // OPTIONAL. Имя автора исходного сообщения
        }
    }
  • operatorChanged – событие переключение диалога с бота или оператора на другого оператора или бота
    Блок кода
    languagejson
    titlePayload события
    linenumberstrue
    {
        "operatorId": "bce7d22e-dde6-4427-b391-ebbdfda44de6", // REQUIRED. Идентификатор нового оператора 
        "operatorName": "Тестовый Оператор", // REQUIRED. Имя нового оператора
        "avatar": "https://example.com/avatar.png", // REQUIRED. URL аватара нового оператора
        "previousOperatorId": "bce7d22e-dde6-4427-b391-ebbdfda44de6", // REQUIRED. Идентификатор предыдущего оператора
        "previousOperatorName": "Предыдущий Оператор", // REQUIRED. Имя предыдущего оператора
        "previousOperatorAvatar": null // REQUIRED. URL аватара предыдущего оператора
    }
  • chatMessageRead – уведомление о прочтении сообщения оператором
    Блок кода
    languagejson
    titlePayload события
    linenumberstrue
    {
        "messageId": "bce7d22e-dde6-4427-b391-ebbdfda44de6" // REQUIRED. Идентификатор сообщения
    }
  • sessionClosed – уведомление о закрытии сессии оператором
    Блок кода
    languagejson
    titlePayload события
    linenumberstrue
    {
        "sessionId": "bce7d22e-dde6-4427-b391-ebbdfda44de6", // REQUIRED. Идентификатор закрываемой сессии 
        "chatId": "bce7d22e-dde6-4427-b391-ebbdfda44de6", // REQUIRED. Идентификатор чата
        "sessionRatingRequired": true // REQUIRED. Флаг, требуется ли оценка сессии от пользователя 
    }

Интеграция через HTTP REST API

Подробный рецепт данной интеграции описан в отдельной статье: Рецепт интеграции с ботом по API

Подключение к сокетам

Информация
titleО библиотеки socket.io

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

Информация
titleО библиотеки socket.io

Для взаимодействия с socket.io взята библиотека python-socketio версии 4.6.1

Справочная информация о событиях socket.io для виджета чат-платформы TWIN

Процесс набора текста

Блок кода
languagejs
[
    "showTypingIndicatorEmit",
    {
        "authorType": "BOT"
    }
]

Создание сообщения

Блок кода
languagejs
[
    "chatMessageCreatedEmit",
    {
        "id": "d0f10a74-53fe-4a83-ac1f-ce55c0939df2",
        "authorId": "4f8151ed-8e7a-4a12-a6a5-c94f99c58019",
        "authorType": "BOT",
        "authorName": "МетроБот",
        "type": "REGULAR",
        "body": "Переключаю на оператора",
        "answers": [],
        "createdAt": "2021-03-10T08:37:53+00:00",
        "sessionId": "4d32dc5a-73d3-457e-9b30-5f7ff4c5fa24",
        "attachments": [],
        "actions": [],
        "avatar": null
    }
]
Блок кода
languagejs
[
    "chatMessageCreatedEmit",
    {
        "id": "25d27d8f-f633-42ef-b359-aeff3ce05001",
        "authorId": "389",
        "authorType": "OPERATOR",
        "authorName": "Первый Оператор V",
        "type": "REGULAR",
        "body": "\nHi",
        "answers": [],
        "createdAt": "2021-03-10T08:49:41+00:00",
        "sessionId": "b1a69f04-a759-4376-b8e5-ee82a7e0d247",
        "attachments": [],
        "actions": [],
        "avatar": {
            "id": "ed661c07-2d50-4b1f-b2c8-32f09a83065e",
            "isPrivate": false,
            "createdAt": "2021-02-05T12:58:33+00:00",
            "contentType": "image/jpeg",
            "name": "мяч.jpg",
            "baseName": "мяч",
            "extension": "jpg",
            "suggestedExtension": "jpg",
            "path": "",
            "size": 310723,
            "url": "https://minio.twin24.ai/twin-iam-dev/public/2021-02-05/ed661c07-2d50-4b1f-b2c8-32f09a83065e?response-content-type=image%2Fjpeg&response-content-disposition=inline%3B%20filename%3Dmyac.jpg%3B%20filename%2A%3Dutf-8%27%27%25D0%25BC%25D1%258F%25D1%2587.jpg",
            "downloadLink": "https://minio.twin24.ai/twin-iam-dev/public/2021-02-05/ed661c07-2d50-4b1f-b2c8-32f09a83065e?response-content-type=image%2Fjpeg&response-content-disposition=attachment%3B%20filename%3Dmyac.jpg%3B%20filename%2A%3Dutf-8%27%27%25D0%25BC%25D1%258F%25D1%2587.jpg&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=minio%2F20210310%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Date=20210310T084942Z&X-Amz-SignedHeaders=host&X-Amz-Expires=604799&X-Amz-Signature=8810cdb3f30b4ccff3c521e7db6ece5d4dfe5814fbecd36b9eed4ae65e99c6fb",
            "ownerId": null
        }
    }
]

Подтверждение о прочтении сообщения

Блок кода
languagejs
themeConfluence
titleНазвание события: chatMessageReadEmit
[
    "chatMessageReadEmit",
    {
        "messageId": "23280e7d-8d2f-409b-9480-82c805fcbb95"
    }
]

Описание параметров события chatMessageReadEmit

...

Поле

...

Тип

...

Обязательно

...

Описание

...

messageId

...

ОПЕРАТОРЫ

Назначение оператора после бота (первичное назначение)

Блок кода
languagejs
[
    "operatorChangedEmit",
    {
        "operatorId": "494",
        "operatorName": "III Operator",
        "avatar": null,
        "previousOperatorId": "4f8151ed-8e7a-4a12-a6a5-c94f99c58019",
        "previousOperatorName": "МетроБот",
        "previousOperatorAvatar": null
    }
]

Назначение другого оператора (смена операторов)

Блок кода
languagejs
[
    "operatorChangedEmit",
    {
        "operatorId": "472",
        "operatorName": "II Dev",
        "avatar": null,
        "previousOperatorId": "389",
        "previousOperatorName": "Первый Оператор V",
        "previousOperatorAvatar": {
            "id": "ed661c07-2d50-4b1f-b2c8-32f09a83065e",
            "isPrivate": false,
            "createdAt": "2021-02-05T12:58:33+00:00",
            "contentType": "image/jpeg",
            "name": "мяч.jpg",
            "baseName": "мяч",
            "extension": "jpg",
            "suggestedExtension": "jpg",
            "path": "",
            "size": 310723,
            "url": "https://minio.twin24.ai/twin-iam-dev/public/2021-02-05/ed661c07-2d50-4b1f-b2c8-32f09a83065e?response-content-type=image%2Fjpeg&response-content-disposition=inline%3B%20filename%3Dmyac.jpg%3B%20filename%2A%3Dutf-8%27%27%25D0%25BC%25D1%258F%25D1%2587.jpg",
            "downloadLink": "https://minio.twin24.ai/twin-iam-dev/public/2021-02-05/ed661c07-2d50-4b1f-b2c8-32f09a83065e?response-content-type=image%2Fjpeg&response-content-disposition=attachment%3B%20filename%3Dmyac.jpg%3B%20filename%2A%3Dutf-8%27%27%25D0%25BC%25D1%258F%25D1%2587.jpg&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=minio%2F20210310%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Date=20210310T090557Z&X-Amz-SignedHeaders=host&X-Amz-Expires=604799&X-Amz-Signature=6156df5e15d5ab535fdcf80204de440a3cfb8b8fa4d8e3a92b93cc6796f539a3",
            "ownerId": null
        }
    }
]

Описание параметров события

...

Поле

...

Тип

...

Обязательно

...

Описание

...

messageId

...

Статус оператора

Блок кода
languagejs
[
    "operatorStatusChangedEmit",
    {
        "operatorId": "389",
        "previousStatus": "ACTIVE",
        "currentStatus": "PAUSED"
    }
]

Описание параметров события operatorStatusChangedEmit

...

Поле

...

Тип

...

Обязательно

...

Описание

...

messageId

...

Выход оператора из системы

Блок кода
languagejs
[
    "operatorLoggedOutEmit",
    {
        "operatorId": "389"
    }
]

Описание параметров события operatorStatusChangedEmit

...

Поле

...

Тип

...

Обязательно

...

Описание

...

operatorId

...

Создание клиентского экземпляра

Блок кода
languagepy
themeConfluence
firstline1
titleФункция отправки сообщения в чат-сессию
linenumberstrue
import socketio

# Создаем экземпляр клиента
socket_session = socketio.Client()

Определение обработчиков событий

Протокол Socket.IO основан на событиях. Когда сервер хочет установить связь с клиентом, он создает событие. Каждое событие имеет имя и список аргументов. Клиент регистрирует функции обработчика событий с помощью декоратора socketio.Client.on() указывая имя события:

...

languagepy
themeConfluence
firstline1
titleФункция отправки сообщения в чат-сессию
linenumberstrue

...