[[:templates_ai|{{wiki:user:undo_24.png}}]]

====== Funcionalidade Laravel Telegram Bot - Passos com repositório ======

===== Passo a passo =====

  - Realizar o clone do repositório modelo
    * <code>git clone git@github.com:spsise/templates-telegram-bot.git</code>
  - Realizar a troca do nome do projeto
    * Abrir o arquivo:
      * <code>scripts/cursor/rename-project-guide.md</code>
    * Executar o comando:
      * <code>com base em @rename-project-guide.md renomeie todos os arquivos necessários do projeto para NOME_PROJETO_BOT</code>
  - Realizar a troca das portas e nomes dos containers
    * Abrir o arquivo:
      * <code>scripts/cursor/port-mapping-reference.md</code>
    * Executar o comando:
      * <code>com base em @port-mapping-reference.md verifique a possibilidade de trocar as portas e nomes dos containers</code>
  - Adicionar as variáveis de ambiente
    * Criar arquivo .env
    * Executar código:
      * <code>php artisan key:generate</code>
      * <code>php artisan config:clear</code>
      * <code>php artisan cache:clear</code>
  - Configurar Bot do Telegram

===== Detalhamento =====

==== Configurar Bot do Telegram ====

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

  * **TELEGRAM_BOT_TOKEN** - Token de autenticação do bot
    - Abra o Telegram no seu celular ou computador
    - Procure por **@BotFather** na busca
    - Inicie uma conversa com ele
      - Criar um Novo Bot
      - **/newbot**
    - Assim obterá o token, por exemplo: //1234567890:ABCdefGHIjklMNOpqrsTUVwxyz-1234567890//
  * **Configurar Webhook para o Bot**
    - Set URL:
      - <code>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</code>
    - Obter informações:
      - <code>https://api.telegram.org/bot{SEU_BOT_TOKEN}/getWebhookInfo</code>
    - Deletar:
      - <code>https://api.telegram.org/bot{SEU_BOT_TOKEN}/deleteWebhook</code>
    - Testar bot:
      - <code>https://api.telegram.org/bot{SEU_BOT_TOKEN}/getMe</code>
  * **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
        * <code>openssl rand -hex 32</code>
      * Use um gerador online: 
        * <code>https://generate-random.org/encryption-key-generator</code>
        * [[https://generate-random.org/encryption-key-generator]]
      * Exemplo de chave gerada
        * <code>a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0u1v2w3x4y5z6</code>