# Линия

LINE по-прежнему остаётся одним из самых популярных мессенджеров в Азии, поэтому добавление его в MaviBot открывает доступ к огромной базе пользователей. Ниже — простое пошаговое руководство, которое проведёт вас от настройки до первых сообщений.

<div data-with-frame="true"><figure><img src="/files/15271ddaa7e8c47ec69ac873bc8318d086cbb00f" alt="" width="188"><figcaption></figcaption></figure></div>

## **Подключение**

Чтобы успешно настроить интеграцию, вам нужно выполнить несколько обязательных шагов:

* **Business ID** — создан в [LINE Business Center](https://account.line.biz/login)
* **LINE Official Account** — создан через LINE Official Account Manager.

<div data-with-frame="true"><figure><img src="/files/0844beb55f6a476ccdb7ac92ec1ddc413dd31c70" alt="" width="563"><figcaption></figcaption></figure></div>

* **Messenger API** — его нужно включить в настройках вашего Official Account.

<div data-with-frame="true"><figure><img src="/files/42976e092c1d9ee67ed0438e3839a7f5e3ca85b0" alt=""><figcaption></figcaption></figure></div>

После этого перейдите в раздел настроек ответов и убедитесь, что Webhooks включены — без этого LINE не сможет отправлять события в MaviBot.

<div data-with-frame="true"><figure><img src="/files/4bfd1357cf7f0178b384ec8a1b50e2af69a5e82a" alt=""><figcaption></figcaption></figure></div>

### Channel ID и Channel Secret

Перейдите в раздел Messaging API — именно там находятся два ключевых параметра.

* **Channel ID**
* **Channel Secret**

<div data-with-frame="true"><figure><img src="/files/42976e092c1d9ee67ed0438e3839a7f5e3ca85b0" alt=""><figcaption></figcaption></figure></div>

**Они необходимы для подключения вашего бота к MaviBot.**

### Подключение LINE к MaviBot

**Теперь перейдём к подключению LINE к MaviBot:**

* Откройте **Channels** раздел в MaviBot.
* Выберите **LINE**.
* Вставьте ваш **Channel ID** и **Channel Secret**.
* Нажмите **Готово**.

<div data-with-frame="true"><figure><img src="/files/d039aad93cf719b48a56a7471acd013412c81580" alt=""><figcaption></figcaption></figure></div>

Если данные указаны верно, бот подключится мгновенно.

### Переменные

**Когда пользователь пишет вашему боту, MaviBot автоматически сохраняет ключевые данные в переменные:**

* **line\_source\_type** — может быть одним из трёх типов: *user* (личный чат), *group* (групповой чат), *room* (устаревший тип группового чата).
* **line\_quote\_token** — токен для ответа на конкретное сообщение. MaviBot всегда сохраняет токен из последнего входящего сообщения. Может использоваться в [`line_send_message()`](/doc/ru/chatbot/messendzhery/line_chatbot/api.md).
* **line\_request** — полный webhook payload, сохраняется, когда переменная `save_webhook` включена.
* **latitude**, **longitude** — координаты, сохраняются, когда пользователь отправляет местоположение.
* **line\_address** — читаемый адрес, сохраняется, когда пользователь делится местоположением.

<div data-with-frame="true"><figure><img src="/files/49eeb0225eec27c11c0275188386463b4f26650a" alt=""><figcaption></figcaption></figure></div>

Эти переменные позволяют строить гибкие сценарии и отправлять максимально персонализированные ответы.

## Какие события LINE отправляет в MaviBot

Возможные колбэки:

* **line\_follow** — пользователь добавил бота в друзья / разблокировал его
* **line\_sticker** — был отправлен стикер
* **client\_unsubscribed** — пользователь заблокировал бота
* **line\_join** — бот был добавлен в групповой чат
* **line\_leave** — бот покинул групповой чат
* **line\_memberJoined** — в групповой чат добавился новый участник
* **line\_memberLeft** — участник покинул групповой чат

Каждое событие можно использовать для автоматизации — приветствий, триггеров и логирования.

<div data-with-frame="true"><figure><img src="/files/11b32862365318d337b8ace3a5995eb1cbd03ec5" alt="" width="563"><figcaption></figcaption></figure></div>

## **Вложения LINE**&#x20;

LINE поддерживает три типа медиа:

* **изображения**
* **видео**
* **аудио/голосовые сообщения**

<div data-with-frame="true"><figure><img src="/files/45510b6e58c91b13272a678ec6be069730114000" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="warning" %}

#### Обратите внимание!

В LINE действует строгое ограничение: вы можете отправить **не более 5 объектов за раз**.

* **Каждое вложение** считается **одним объектом**.
* **Текст сообщения** тоже является отдельным объектом.
* **Набор кнопок** — это ещё один отдельный объект.

Так что если вы отправляете **медиа + текст + кнопки**, учитывайте **ограничение в 5 объектов** .
{% endhint %}

<div data-with-frame="true"><figure><img src="/files/c61141c45f17681fbd940b8c3eafcbe055479f70" alt="" width="563"><figcaption></figcaption></figure></div>

## Кнопки действий

#### **Клавиатура (быстрые ответы)**&#x20;

Появляются над полем ввода. До **13 кнопок**.

<div data-with-frame="true"><figure><img src="/files/613161b902bfdbb0187ea6d23a9d0782fd412fd8" alt="" width="375"><figcaption></figcaption></figure></div>

#### **Кнопки в тексте**

Отображаются под сообщением. До **4 кнопок**, а текст сообщения может содержать до **160 символов**.

<div data-with-frame="true"><figure><img src="/files/d614b7ddf179e5e3b51902d363a546fe03f06098" alt="" width="346"><figcaption></figcaption></figure></div>

{% hint style="success" %}

#### Обратите внимание!

**Доступные типы кнопок**

* **По умолчанию**
* **Кнопка-колбэк**
* **Запрос геолокации** *(только клавиатура)*
  {% endhint %}

## **Подключение к группе**&#x20;

Чтобы ваш бот можно было добавлять в групповые чаты, нужно включить эту функцию в **LINE Official Account Manager**

<div data-with-frame="true"><figure><img src="/files/1cbcd5c1240b1c83d78577947e734fe3014e369a" alt=""><figcaption></figcaption></figure></div>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/ru/chatbot/messendzhery/line_chatbot.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
