Funcionalidade Laravel Telegram Bot - Passos com repositório

1. Realizar o clone do repositório modelo

   • git clone git@github.com:spsise/templates-telegram-bot.git

2. Realizar a troca do nome do projeto
   • Abrir o arquivo:

     • scripts/cursor/rename-project-guide.md

   • Executar o comando:

     • com base em @rename-project-guide.md renomeie todos os arquivos necessários do projeto para NOME_PROJETO_BOT

3. Realizar a troca das portas e nomes dos containers
   • Abrir o arquivo:

     • scripts/cursor/port-mapping-reference.md

   • Executar o comando:

     • com base em @port-mapping-reference.md verifique a possibilidade de trocar as portas e nomes dos containers

4. Adicionar as variáveis de ambiente
   • Criar arquivo .env
   • Executar código:

     • php artisan key:generate

     • php artisan config:clear

     • php artisan cache:clear

5. Configurar Bot do Telegram

Para configurar o bot do Telegram, você precisa obter:

• TELEGRAM_BOT_TOKEN - Token de autenticação do bot
  1. Abra o Telegram no seu celular ou computador
  2. Procure por @BotFather na busca
  3. Inicie uma conversa com ele
     1. Criar um Novo Bot
     2. /newbot
  4. Assim obterá o token, por exemplo: 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz-1234567890
• Configurar Webhook para o Bot
  1. Set URL:

     1. https://api.telegram.org/bot{SEU_BOT_TOKEN}/setWebhook?url=https://api-hom.virtualt.com.br/api/telegram/webhook&allowed_updates=["message","callback_query","channel_post","edited_message","edited_channel_post","inline_query","chosen_inline_result","shipping_query","pre_checkout_query","poll","poll_answer","my_chat_member","chat_member","chat_join_request"]&drop_pending_updates=true&max_connections=40

  2. Obter informações:

     1. https://api.telegram.org/bot{SEU_BOT_TOKEN}/getWebhookInfo

  3. Deletar:

     1. https://api.telegram.org/bot{SEU_BOT_TOKEN}/deleteWebhook

  4. Testar bot:

     1. https://api.telegram.org/bot{SEU_BOT_TOKEN}/getMe

• TELEGRAM_RECIPIENTS - IDs dos usuários que podem usar o bot
  • Realizar o cadastro de uma conta no Telegram
  • Procure por @userinfobot no Telegram
    • /start
• TELEGRAM_WEBHOOK_SECRET - Chave secreta para webhook (opcional)
  • Gerar uma chave secreta
    • No terminal

      • openssl rand -hex 32

    • Use um gerador online:

      • https://generate-random.org/encryption-key-generator

      • https://generate-random.org/encryption-key-generator
    • Exemplo de chave gerada

      • a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0u1v2w3x4y5z6