> ## Documentation Index
> Fetch the complete documentation index at: https://docs.airys.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuração de Integração do Aplicativo Line

> Configure a integração do aplicativo Line na sua máquina local para desenvolvimento

# Configurar a integração do aplicativo Line na sua máquina local

Siga os passos se você estiver tentando trabalhar com a integração do Line em sua máquina local.

## Pré-requisitos

* Conta de Desenvolvedor Line
* Acesso ao [Line Developer Console](https://developers.line.biz/console)
* Ngrok ou serviço de tunelamento semelhante
* Ambiente de desenvolvimento AirysChat em execução

## Passos de Configuração

### 1. Iniciar Servidor Ngrok

Inicie um servidor Ngrok escutando na porta `3000` ou na porta em que você executará a instalação do AirysChat:

```bash theme={null}
# Install ngrok if you haven't already
# Download from https://ngrok.com/download

# Start ngrok tunnel
ngrok http 3000
```

### 2. Atualizar Variáveis de Ambiente

Atualize a variável `FRONTEND_URL` do `.env` no AirysChat com a versão `https` da URL do Ngrok:

```bash theme={null}
# In your .env file
FRONTEND_URL=https://your-ngrok-subdomain.ngrok.io
```

### 3. Configurar Line Developer Console

1. **Acessar Line Developer Console**: Vá para [Line Developer Console](https://developers.line.biz/console)
2. **Criar um Provedor (Provider)** (se você não tiver um)
3. **Criar um Novo Canal (Channel)** e selecione "Messaging API"
4. **Definir Configurações Básicas**:
   * Nome do canal
   * Descrição do canal
   * Categoria
   * Subcategoria

### 4. Obter Credenciais Necessárias

No Line Developer Console, no canal "Messaging API", colete os seguintes valores:

1. **Nome do Canal** (Channel Name)
2. **ID do Canal LINE** (LINE Channel ID)
3. **Segredo do Canal LINE** (LINE Channel Secret)
4. **Token do Canal LINE** (LINE Channel Token)

### 5. Iniciar Servidor AirysChat

Inicie o servidor do AirysChat e crie um novo canal do Line com os valores obtidos no Line Developer Console:

```bash theme={null}
# Start the development server
make run
# or
foreman start -f Procfile.dev
```

### 6. Criar Canal do Line no AirysChat

1. **Acessar o AirysChat**: Vá para a sua instância do AirysChat ([http://localhost:3000](http://localhost:3000))
2. **Navegar para Configurações** → **Caixas de Entrada** → **Adicionar Caixa de Entrada**
3. **Selecionar Line** como o tipo de canal
4. **Inserir Credenciais do Line**:
   * Nome do Canal
   * ID do Canal LINE
   * Segredo do Canal LINE
   * Token do Canal LINE
5. **Salvar Configuração**

## Configurar Webhook no Line Developer Console

Depois de criar o canal, o AirysChat fornecerá uma URL de webhook para o canal. Você precisa configurar esta URL de webhook no Line Developer Console:

### Passos para Configurar o Webhook

1. **Vá para o Line Developer Console** → Seu Canal → **Messaging API**
2. **Encontrar Configurações de Webhook**
3. **Definir URL do Webhook**: Use a URL fornecida pelo AirysChat
   ```
   https://your-ngrok-subdomain.ngrok.io/webhooks/line/your-channel-id
   ```
4. **Ativar Webhook**: Alterne o webhook para "Ativado" (Enabled)
5. **Verificar Webhook**: Use o botão "Verificar" (Verify) para testar a conexão

### Configurações Adicionais do Line

Defina estas configurações no Line Developer Console:

* **Mensagens de resposta automática (Auto-reply messages)**: Desativar (para que o AirysChat possa lidar com as respostas)
* **Mensagens de saudação (Greeting messages)**: Opcional
* **Reenvio de webhook (Webhook redelivery)**: Ativar para confiabilidade

## Testando a Integração

Se o webhook for registrado corretamente com o Line, seu servidor Ngrok deverá receber eventos para novas mensagens do Line, e novas conversas serão criadas no AirysChat.

### Passos de Teste

1. **Adicione seu bot do Line como amigo** usando o código QR ou ID do bot
2. **Envie uma mensagem** para seu bot do Line
3. **Verifique os logs do Ngrok** para ver se a solicitação de webhook foi recebida
4. **Verifique o AirysChat** para ver se uma nova conversa foi criada
5. **Responda do AirysChat** para testar a comunicação bidirecional

## Solução de Problemas

<Accordion title="A verificação do webhook falha">
  **Problema**: A verificação do webhook do Line falha no Developer Console

  **Solução**:

  * Certifique-se de que a URL do Ngrok esteja acessível publicamente
  * Verifique se a `FRONTEND_URL` está definida corretamente em seu arquivo `.env`
  * Verifique se o formato da URL do webhook está correto
  * Reinicie o AirysChat após atualizar as variáveis de ambiente
</Accordion>

<Accordion title="Mensagens não aparecem no AirysChat">
  **Problema**: As mensagens do Line não criam conversas no AirysChat

  **Solução**:

  * Verifique os logs do Ngrok para solicitações de webhook recebidas
  * Verifique se o webhook está ativado no Line Developer Console
  * Verifique os logs do AirysChat para quaisquer mensagens de erro
  * Certifique-se de que todas as credenciais do Line foram inseridas corretamente
  * Verifique se o canal está ativado no AirysChat
</Accordion>

<Accordion title="Erros de SSL/TLS">
  **Problema**: Problemas de certificado SSL com o webhook

  **Solução**:

  * Use a versão `https` de sua URL do Ngrok
  * Certifique-se de que o Ngrok esteja funcionando corretamente
  * O Line requer HTTPS para URLs de webhook
  * Tente reiniciar o Ngrok e atualizar o webhook
</Accordion>

<Accordion title="Erros de autenticação">
  **Problema**: Falhas de autenticação na API do Line

  **Solução**:

  * Verifique se o ID do Canal, Segredo do Canal e Token do Canal estão corretos
  * Verifique se o canal está publicado e não no modo de desenvolvimento
  * Certifique-se de que a Messaging API esteja ativada para seu canal
  * Gere um novo Token de Canal (Channel Token) se necessário
</Accordion>

## Recursos da API do Line

O Line oferece vários recursos que você pode integrar:

* **Rich Messages**: Cartões, carrosséis, respostas rápidas
* **Flex Messages**: Layouts personalizados
* **LIFF (Line Frontend Framework)**: Aplicativos da web dentro do Line
* **Line Login**: Autenticação de usuário

## Próximos Passos

Após a configuração bem-sucedida:

1. **Teste o fluxo de mensagens** entre o Line e o AirysChat
2. **Configure as atribuições de agentes** para conversas do Line
3. **Configure respostas automatizadas** se necessário
4. **Explore recursos de mensagens ricas (rich messages)** para aprimorar a experiência do usuário
5. **Revise os logs do webhook** para depuração

## Obtendo Ajuda

Se você encontrar problemas:

* **Verifique os Logs**: Revise os logs do AirysChat e do Ngrok
* **Documentação para Desenvolvedores do Line**: [Documentação Oficial da API do Line](https://developers.line.biz/en/docs/)
* **Erros Comuns**: Consulte [Erros Comuns](/contributing-guide/common-errors)
* **Suporte da Comunidade**: [Discord](https://discord.com/invite/cJXdrwS)

## Recursos Úteis

* **Documentação da Messaging API do Line**: [https://developers.line.biz/en/docs/messaging-api/](https://developers.line.biz/en/docs/messaging-api/)
* **Line Developer Console**: [https://developers.line.biz/console](https://developers.line.biz/console)
* **Ferramenta de Teste de Webhook**: Disponível no Line Developer Console

***

Sua integração com o Line agora está pronta para desenvolvimento e testes! 💬