Tutoriais

Como tudo funciona (por trás dos panos)

Explicação simples de como o bot se comunica com o sistema e o que acontece quando alguém compra.

Explicação simplificada

O bot de vendas não trabalha sozinho. Ele se conecta a um sistema da StorM que cuida dos pagamentos, da confirmação e da entrega. Quando o cliente clica em "Comprar", o bot pede ao sistema: "Crie um pagamento PIX para esse valor". O sistema cria o pagamento e devolve o QR Code. O bot mostra o QR Code para o cliente.

Quando o cliente paga, o sistema de pagamento (PIX) avisa a StorM. A StorM atualiza o pedido e avisa o bot: "Pagamento confirmado, entregue o produto". O bot então entrega o produto (cargo, DM, key, etc.) para o cliente.

O que acontece quando você gera um PIX

  1. Você usa /gerarpix 50 ou o cliente clica em comprar
  2. O bot envia uma solicitação ao servidor da StorM: "Quero um PIX de R$ 50"
  3. O servidor cria o pagamento no provedor (Mercado Pago, StorM Wallet, etc.) e recebe o QR Code
  4. O servidor devolve o QR Code para o bot
  5. O bot mostra a mensagem com o QR Code e o valor para o cliente

O que acontece quando o cliente paga

  1. O cliente paga o PIX no app do banco
  2. O provedor de pagamento recebe a confirmação e avisa a StorM
  3. A StorM marca o pedido como "pago" e dispara a entrega
  4. Se a entrega for automática, o bot entrega na hora (cargo, DM, etc.)
  5. Se for manual, o vendedor recebe uma notificação e pode aprovar/entregar

Como o bot se comunica com o sistema

O bot envia mensagens pela internet (chamadas de API) para os servidores da StorM. Essas mensagens seguem um padrão: "Eu sou o bot X, quero fazer Y". O servidor verifica se o bot está autorizado e responde com os dados pedidos. Tudo isso acontece em segundos, de forma invisível para você.

Por que entender isso ajuda?
Quando algo não funciona — por exemplo, o PIX não gera — pode ser que o bot não esteja conseguindo falar com o servidor (problema de internet) ou que as configurações (chave PIX, etc.) não estejam corretas. Saber que existe essa "conversa" entre bot e servidor ajuda a localizar onde está o problema.