# Лінія

LINE і далі залишається одним із найпопулярніших месенджерів в Азії, тож додавання його до MaviBot відкриває доступ до величезної бази користувачів. Ось простий покроковий посібник, який проведе вас від налаштування до перших повідомлень.

<div data-with-frame="true"><figure><img src="/files/7c725e254269e14b78c4ae2ddc4bb77190239b53" 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/83e0c4936cb4e087c83245061cf3c008aef9f66f" alt="" width="563"><figcaption></figcaption></figure></div>

* **Messenger API** — вам потрібно увімкнути її в налаштуваннях вашого Official Account.

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

Після цього перейдіть до розділу налаштувань відповіді та переконайтеся, що Webhooks увімкнено — без цього LINE не зможе надсилати події до MaviBot.

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

### Channel ID і Channel Secret

Перейдіть до розділу Messaging API — саме там розташовані два ключові параметри.

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

<div data-with-frame="true"><figure><img src="/files/c5c99fea90be7efc440dc673757b9b60b34eff9d" 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/fc211bba6608ed6d4259a48ac95695968621cabc" alt=""><figcaption></figcaption></figure></div>

Якщо дані правильні, бот підключиться миттєво.

### Змінні

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

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

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

Ці змінні дають змогу будувати гнучкі сценарії та надсилати максимально персоналізовані відповіді.

## Які події LINE надсилає до MaviBot

Можливі callback-и:

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

Кожну подію можна використовувати для автоматизації — привітань, тригерів і логування.

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

## **Вкладення LINE**&#x20;

LINE підтримує три типи медіа:

* **зображення**
* **відео**
* **аудіо/голосові повідомлення**

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

{% hint style="warning" %}

#### Зверніть увагу!

У LINE діє суворе обмеження: ви можете надсилати **не більше 5 об’єктів одночасно**.

* **Кожне вкладення** рахується як **один об’єкт**.
* **Текст повідомлення** також є окремим об’єктом.
* **Набір кнопок** — це ще один окремий об’єкт.

Тож якщо ви надсилаєте **медіа + текст + кнопки**, пам’ятайте про **обмеження у 5 об’єктів** .
{% endhint %}

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

## Кнопки дій

#### **Клавіатура (швидкі відповіді)**&#x20;

Відображаються над полем введення. До **13 кнопок**.

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

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

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

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

{% hint style="success" %}

#### Зверніть увагу!

**Доступні типи кнопок**

* **За замовчуванням**
* **Кнопка callback**
* **Запит геолокації** *(лише клавіатура)*
  {% endhint %}

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

Щоб дозволити додавати вашого бота до групових чатів, потрібно увімкнути цю функцію в **LINE Official Account Manager**

<div data-with-frame="true"><figure><img src="/files/5a0524c9ccb60d5d3da249ef729e8d3ee4c5c912" 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/uk/chatbot/mesendzheri/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.