Guia de configuração de broadcast do MagicTradeBot

1. Configuração do WhatsApp

As notificações do WhatsApp utilizam a API WhatsApp Business da Meta.

Pré-requisitos

• Uma conta Meta (Facebook) Business
• Um número de telefone comercial verificado
• Acesso à plataforma Meta Developer

Configuração Passo a Passo

Passo 1: Criar um App Meta

1. Acesse Meta for Developers
2. Clique em "My Apps" → "Create App"
3. Selecione "Business" como tipo de app
4. Preencha os detalhes do app e crie o aplicativo

Passo 2: Adicionar o Produto WhatsApp

1. No painel do app, clique em "Add Product"
2. Encontre "WhatsApp" e clique em "Set Up"
3. Selecione ou crie um Portfolio Business

Passo 3: Obter Suas Credenciais

1. Navegue até WhatsApp → Configuração da API
2. Você verá dois valores importantes:

Token de Acesso Temporário (whatsapp_token):

• Copie o token de acesso temporário exibido
• Nota: Para produção, gere um token permanente:
  • Vá para Usuários do Sistema nas Configurações de Negócios
  • Crie um usuário do sistema
  • Gere um token com a permissão whatsapp_business_messaging

ID do Número de Telefone (whatsapp_phone_id):

• Listado em "Phone Number ID"
• Este NÃO é o seu número de telefone, é um identificador único

Passo 4: Configurar no MagicTradeBot

BroadCast:
  whatsapp_token: "EAAxxxxxxxxxxxxxxxxxxxxxxxx"
  whatsapp_phone_id: "123456789012345"

Passo 5: Verificar o Número do Destinatário

1. Na página de configuração da API do WhatsApp, adicione seu número pessoal do WhatsApp como destinatário
2. Verifique o número por meio do OTP enviado ao seu WhatsApp

2. Configuração do Discord

O Discord usa webhooks para notificações — o método mais simples.

Configuração Passo a Passo

Passo 1: Acessar as Configurações do Servidor

1. Abra o Discord e vá para o seu servidor
2. Clique com o botão direito no canal onde deseja as notificações
3. Selecione "Editar Canal"

Passo 2: Criar um Webhook

1. Navegue até a aba "Integrações"
2. Clique em "Webhooks" → "Criar Webhook"
3. Dê um nome ao webhook (ex.: "MagicTradeBot Signals")
4. (Opcional) Faça upload de um avatar personalizado

Passo 3: Copiar a URL do Webhook

1. Clique em "Copiar URL do Webhook"
2. Formato da URL: https://discord.com/api/webhooks/XXXXX/YYYYY

Passo 4: Configurar no MagicTradeBot

BroadCast:
  discord_webhook_url: "https://discord.com/api/webhooks/123456789/AbCdEfGhIjKlMnOpQrStUvWxYz"

3. Configuração do Instagram

As notificações do Instagram utilizam a API Instagram Graph (Meta).

Pré-requisitos

• Conta Instagram Business ou Creator
• Página do Facebook conectada à sua conta do Instagram
• Conta de desenvolvedor Meta

Configuração Passo a Passo

Passo 1: Converter para Conta Business

1. No app do Instagram: Configurações → Conta
2. Selecione "Mudar para Conta Profissional"
3. Escolha "Business" ou "Creator"

Passo 2: Conectar a uma Página do Facebook

1. Vá para Configurações → Conta → Contas Vinculadas
2. Vincule seu Instagram a uma Página do Facebook

Passo 3: Criar um App Meta

1. Acesse Meta for Developers
2. Crie um novo app (se ainda não tiver)
3. Adicione o produto "Instagram"

Passo 4: Gerar Token de Acesso

1. Vá para Instagram → Basic Display ou Instagram Graph API
2. Para Instagram Graph API:
   • Vá para Ferramentas → Graph API Explorer
   • Selecione seu app
   • Selecione sua conta do Instagram
   • Adicione permissões: instagram_basic, instagram_manage_messages
   • Clique em "Gerar Token de Acesso"

Passo 5: Obter Token de Longa Duração

Tokens de curta duração expiram em 1 hora. Converta para longa duração (60 dias):

curl -i -X GET "https://graph.facebook.com/v18.0/oauth/access_token?grant_type=fb_exchange_token&client_id=YOUR_APP_ID&client_secret=YOUR_APP_SECRET&fb_exchange_token=SHORT_LIVED_TOKEN"

Passo 6: Configurar no MagicTradeBot

BroadCast:
  instagram_token: "IGQVJxxxxxxxxxxxxxxxxxxxxxxxxxx"

4. Configuração do Telegram

O Telegram oferece a configuração de bot mais fácil entre todas as plataformas.

Configuração Passo a Passo

Passo 1: Criar um Bot

1. Abra o Telegram e procure por @BotFather
2. Inicie uma conversa e envie /newbot
3. Siga as instruções:
   • Escolha um nome para o seu bot (ex.: "My Trading Signals")
   • Escolha um nome de usuário que termine em "bot" (ex.: "mytrading_signals_bot")

Passo 2: Obter o Token do Bot

1. O BotFather fornecerá o token do bot
2. Formato: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz
3. Guarde este token com segurança

Passo 3: Obter Seu ID de Chat

Método 1: Usando IDBot

1. Pesquise por @myidbot ou @userinfobot no Telegram
2. Inicie uma conversa e envie /start
3. O bot responderá com seu ID de chat

Método 2: Método Manual

1. Envie uma mensagem para o seu bot (o que você criou)
2. Acesse: https://api.telegram.org/bot<SEU_TOKEN_DO_BOT>/getUpdates
3. Procure por "chat":{"id":123456789}
4. Esse número é o seu chat_id

Método 3: Para Grupos

1. Adicione seu bot ao grupo
2. Envie uma mensagem no grupo
3. Acesse: https://api.telegram.org/bot<SEU_TOKEN_DO_BOT>/getUpdates
4. Procure pelo ID do chat (será negativo para grupos: -123456789)

Passo 4: Iniciar o Bot

1. Pesquise pelo seu bot no Telegram
2. Clique em "Start" ou envie /start

Passo 5: Configurar no MagicTradeBot

BroadCast:
  telegram_bot_token: "123456789:ABCdefGHIjklMNOpqrsTUVwxyz"
  telegram_chat_id: "987654321"