O LINE continua sendo uma das plataformas de mensagens mais populares da Ásia. Integrá-lo ao MaviBot dá acesso a milhões de usuários e permite a comunicação automatizada com o cliente através de um dos principais mensageiros da região.
Este guia orienta você por todo o processo de configuração — desde a criação da sua conta LINE até a conexão com o MaviBot e o envio das suas primeiras mensagens.
Conexão
Antes de conectar o LINE ao MaviBot, conclua as seguintes etapas de configuração:
- Crie um LINE Business ID no LINE Business Center.
- Crie uma LINE Official Account usando o LINE Official Account Manager.
- Ative a Messaging API nas configurações da sua Official Account.
Após ativar a Messaging API, abra Response settings e certifique-se de que Webhooks estejam ativados.
Importante
Os Webhooks devem estar ativados. Caso contrário, o LINE não enviará eventos para o MaviBot.
Channel ID e Channel Secret
Abra a seção Messaging API na sua LINE Official Account.
Lá você encontrará os dois valores necessários para conectar seu bot:
- Channel ID
- Channel Secret
Essas credenciais são necessárias ao conectar o LINE ao MaviBot.
Conecte o LINE ao MaviBot
- Abra a seção Messengers no MaviBot.
- Selecione LINE.
- Cole seu Channel ID e Channel Secret.
- Clique em Done.
Se as credenciais forem válidas, a integração será ativada imediatamente.
Variáveis do cliente
Quando um usuário envia uma mensagem, o MaviBot armazena automaticamente as seguintes variáveis do cliente.
| Variável | Descrição |
|---|---|
line_source_type |
Tipo de conversa. Valores possíveis: user (chat privado), group (chat em grupo), room (chat em grupo legado). |
line_quote_token |
Token usado para responder a uma mensagem específica. O MaviBot sempre armazena o token da última mensagem recebida. Pode ser usado com line_send_message(). |
line_request |
Payload completo do webhook. Disponível apenas quando a variável save_webhook está ativada. |
latitude |
Latitude recebida quando o usuário compartilha uma localização. |
longitude |
Longitude recebida quando o usuário compartilha uma localização. |
line_address |
Endereço legível recebido junto com a localização compartilhada. |
Essas variáveis permitem criar fluxos de chatbot flexíveis e personalizar respostas.
Callbacks do LINE
O MaviBot recebe os seguintes callbacks do LINE.
| Callback | Descrição |
|---|---|
line_follow |
Usuário adicionou o bot como amigo ou o desbloqueou. |
line_sticker |
Usuário enviou um sticker. |
client_unsubscribed |
Usuário bloqueou o bot. |
line_join |
Bot foi adicionado a um chat em grupo. |
line_leave |
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. |
Esses callbacks podem ser usados para automação, gatilhos, mensagens de boas-vindas, notificações e registro.
Anexos
O LINE suporta os seguintes tipos de anexos:
- Imagens
- Vídeos
- Mensagens de áudio e voz
Por favor, observe
O LINE permite no máximo 5 objetos em uma única mensagem.
Cada um dos seguintes conta como um objeto:
- um anexo de mídia;
- o texto da mensagem;
- um conjunto de botões.
Se sua mensagem contiver texto, mídia e botões, certifique-se de que o número total de objetos não exceda cinco.
Botões
Teclado (respostas rápidas)
Exibido acima do campo de entrada de mensagem.
- Máximo: 13 botões
Botões no texto
Exibidos abaixo do texto da mensagem.
- Máximo: 4 botões
- Comprimento máximo da mensagem: 160 caracteres
Tipos de botões disponíveis
- Padrão
- Callback
- Solicitar geolocalização (apenas botões de Resposta Rápida)
Conectando o bot a um grupo
Para permitir que seu bot seja adicionado a chats em grupo, ative esta opção no LINE Official Account Manager.
