> ## 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 da Integração com Aplicativo Telegram

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

# Configurar a integração com aplicativo Telegram na sua máquina local

Siga as etapas abaixo se você estiver tentando trabalhar com a integração do Telegram em sua máquina local.

## Pré-requisitos

* Token do Bot do Telegram do [BotFather](https://t.me/botfather)
* Ngrok ou serviço de tunelamento similar
* Ambiente de desenvolvimento do AirysChat em execução

## Passos da Configuração

### 1. Iniciar Servidor Ngrok

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

```bash theme={null}
# Instale o ngrok se você ainda não tiver instalado
# Faça o download em https://ngrok.com/download

# Inicie o túnel ngrok
ngrok http 3000
```

### 2. Atualizar Variáveis de Ambiente

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

```bash theme={null}
# No seu arquivo .env
FRONTEND_URL=https://your-ngrok-subdomain.ngrok.io
```

### 3. Iniciar Servidor AirysChat

Inicie o servidor do AirysChat e crie um novo canal do Telegram com o token obtido do BotFather do Telegram.

```bash theme={null}
# Iniciar o servidor de desenvolvimento
make run
# ou
foreman start -f Procfile.dev
```

### 4. Criar Canal no Telegram

1. **Acessar o AirysChat**: Acesse sua instância do AirysChat ([http://localhost:3000](http://localhost:3000))
2. **Navegar até Settings (Configurações)** → **Inboxes (Caixas de Entrada)** → **Add Inbox (Adicionar Caixa de Entrada)**
3. **Selecione Telegram** como o tipo de canal
4. **Inserir o Token do Bot**: Cole o token que você recebeu do BotFather
5. **Configurar o Canal**: Configure o nome do canal e outras definições

## Verificar o Registro do Webhook

Ao criar o canal, o AirysChat deve ter registrado uma URL de callback do webhook no Telegram para o seu Bot. Você pode verificar se esse registro de URL foi feito com sucesso chamando a API do Telegram:

```bash theme={null}
GET https://api.telegram.org/bot{your_bot_token}/getWebhookInfo
```

## Testando a Integração

Se o webhook estiver registrado corretamente no Telegram, o seu servidor Ngrok deverá receber eventos de novas mensagens do Telegram e novas conversas serão criadas no AirysChat.

### Passos para Teste

1. **Envie uma mensagem** para o seu bot do Telegram
2. **Verifique os logs do Ngrok** para ver se a requisição do webhook foi recebida
3. **Verifique o AirysChat** para ver se uma nova conversa foi criada
4. **Responda a partir do AirysChat** para testar a comunicação bidirecional

## Resolução de Problemas

<Accordion title="Webhook não registrado">
  **Problema**: O registro do webhook no Telegram falha

  **Solução**:

  * Certifique-se de que a sua URL do Ngrok esteja acessível publicamente
  * Verifique se `FRONTEND_URL` está configurado corretamente no seu arquivo `.env`
  * Verifique se o token do bot 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 Telegram não criam conversas no AirysChat

  **Solução**:

  * Verifique os logs do Ngrok em busca de requisições de webhook de entrada
  * Verifique a URL do webhook no Telegram usando a chamada de API acima
  * Verifique os logs do AirysChat em busca de mensagens de erro
  * Certifique-se de que o canal esteja devidamente configurado e ativado
</Accordion>

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

  **Solução**:

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

## Próximos Passos

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

1. **Teste o fluxo de mensagens** entre o Telegram e o AirysChat
2. **Configure a atribuição de agentes** para as conversas do Telegram
3. **Configure as respostas automáticas** se necessário
4. **Revise os logs do webhook** para depuração

## Obtendo Ajuda

Se você encontrar problemas:

* **Verifique os Logs**: Revise os logs tanto do AirysChat quanto do Ngrok
* **API do Bot do Telegram**: [Documentação Oficial](https://core.telegram.org/bots/api)
* **Erros Comuns**: Veja [Erros Comuns](/contributing-guide/common-errors)
* **Suporte da Comunidade**: [Discord](https://discord.com/invite/cJXdrwS)

***

Sua integração com o Telegram agora está pronta para desenvolvimento e testes! 📱