# Linha

O LINE continua sendo um dos aplicativos de mensagens mais usados na Ásia, então adicioná-lo ao MaviBot libera acesso a uma enorme base de usuários. Aqui está um guia simples, passo a passo, para levar você da configuração às suas primeiras mensagens.

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

## **Conexão**

Para configurar a integração com sucesso, você precisará concluir algumas etapas obrigatórias:

* **ID Comercial** — criado no [LINE Business Center](https://account.line.biz/login)
* **Conta Oficial do LINE** — criada por meio do LINE Official Account Manager.

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

* **API de Mensagens** — você precisará ativá-la nas configurações da sua Conta Oficial.

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

Depois disso, vá para a seção de configurações de Resposta e verifique se os Webhooks estão ativados — sem isso, o LINE não conseguirá enviar eventos ao MaviBot.

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

### ID do Canal e Segredo do Canal

Vá para a seção da Messaging API — é lá que ficam os dois parâmetros principais.

* **ID do Canal**
* **Segredo do Canal**

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

**Eles são necessários para conectar seu bot ao MaviBot.**

### Conectando o LINE ao MaviBot

**Agora vamos seguir para a conexão do LINE ao MaviBot:**

* Abra a **Canais** seção no MaviBot.
* Selecione **LINE**.
* Cole seu **ID do Canal** e **Segredo do Canal**.
* Clique em **Concluído**.

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

Se os dados estiverem corretos, o bot será conectado instantaneamente.

### Variáveis

**Quando um usuário envia mensagem para o seu bot, o MaviBot armazena automaticamente dados-chave em variáveis:**

* **line\_source\_type** — pode ser um de três tipos: *user* (chat direto), *group* (chat em grupo), *room* (tipo legada de chat em grupo).
* **line\_quote\_token** — um token para responder a uma mensagem específica. O MaviBot sempre armazena o token da mensagem recebida mais recente. Pode ser usado em [`line_send_message()`](/doc/pt/chatbot/mensageiros/line_chatbot/api.md).
* **line\_request** — o payload completo do webhook, salvo quando a variável `save_webhook` está ativada.
* **latitude**, **longitude** — coordenadas, salvas quando o usuário envia uma localização.
* **line\_address** — um endereço legível, salvo quando o usuário compartilha uma localização.

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

Essas variáveis permitem criar fluxos flexíveis e entregar respostas altamente personalizadas.

## Quais eventos o LINE envia ao MaviBot

Callbacks possíveis:

* **line\_follow** — o usuário adicionou o bot como amigo / o desbloqueou
* **line\_sticker** — um sticker foi enviado
* **client\_unsubscribed** — o usuário bloqueou o bot
* **line\_join** — o bot foi adicionado a um chat em grupo
* **line\_leave** — o bot saiu de um chat em grupo
* **line\_memberJoined** — um novo membro entrou no chat em grupo
* **line\_memberLeft** — um membro saiu do chat em grupo

Cada evento pode ser usado para automação — saudações, gatilhos e registros.

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

## **Anexos do LINE**&#x20;

O LINE suporta três tipos de mídia:

* **imagens**
* **vídeos**
* **mensagens de áudio/voz**

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

{% hint style="warning" %}

#### Atenção!

O LINE tem um limite rígido: você pode enviar **no máximo 5 objetos por vez**.

* **Cada anexo** conta como **um objeto**.
* **O texto da mensagem** também é um objeto separado.
* **Um conjunto de botões** é outro objeto separado.

Então, se você enviar **mídia + texto + botões**, tenha em mente o **limite de 5 objetos** .
{% endhint %}

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

## Botões de ação

#### **Teclado (respostas rápidas)**&#x20;

Aparecem acima do campo de entrada. Até **13 botões**.

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

#### **Botões no texto**

Exibidos abaixo da mensagem. Até **4 botões**, e o texto da mensagem pode conter até **160 caracteres**.

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

{% hint style="success" %}

#### Atenção!

**Tipos de botões disponíveis**

* **Padrão**
* **Botão de callback**
* **Solicitar geolocalização** *(somente teclado)*
  {% endhint %}

## **Conectando a um grupo**&#x20;

Para permitir que seu bot seja adicionado a chats em grupo, você precisa ativar esse recurso no **LINE Official Account Manager**

<div data-with-frame="true"><figure><img src="/files/48d24b6c0f4e029513932ffe1b99baf5d07f62df" 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/pt/chatbot/mensageiros/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.