Line

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.

Conexão

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

• ID Comercial — criado no LINE Business Center

• Conta Oficial do LINE — criada por meio do LINE Official Account Manager.

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

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.

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

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.

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().

• 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.

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.

Anexos do LINE

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

• imagens

• vídeos

• mensagens de áudio/voz

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 .

Botões de ação

Teclado (respostas rápidas)

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

Botões no texto

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

Atenção!

Tipos de botões disponíveis

• Padrão

• Botão de callback

• Solicitar geolocalização (somente teclado)

Conectando a um grupo

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