API de painel SMM: o que é, para que serve e como integrar
A API de um painel SMM é a porta de comunicação entre o seu sistema e o fornecedor. Em vez de entrar no painel e lançar pedido por pedido, o seu site, bot ou planilha envia o pedido por uma requisição e recebe a resposta automaticamente. É o que torna possível ter um child panel, um bot de WhatsApp que vende sozinho ou uma integração com a sua loja.
O que dá para fazer pela API
- Listar serviços — catálogo com ID, nome, preço por mil, mínimo, máximo e tipo.
- Criar pedido — informando o ID do serviço, o link público e a quantidade.
- Consultar status — de um pedido ou de vários de uma vez: pendente, em andamento, parcial, concluído ou cancelado.
- Consultar saldo — para o seu sistema avisar quando for hora de recarregar.
- Solicitar reposição — nos serviços com garantia, dentro do prazo.
Como funciona uma requisição
O padrão do mercado, seguido pela API do Top Fama, é simples: uma requisição POST para um único endereço, com a sua chave (key) e uma ação (action). Por exemplo, para criar um pedido você envia action=add, o service, o link e a quantity; a resposta traz o número do pedido. Para acompanhar, envia action=status com esse número.
A documentação completa, com exemplos de requisição e resposta, está na página /api. A chave fica na sua conta, depois do cadastro.
Três formas comuns de usar a API
1. Painel próprio (child panel)
Scripts de painel prontos já têm a integração embutida: basta cadastrar o Top Fama como provedor com o endereço e a chave, importar os serviços e definir a margem.
2. Bot de atendimento
Um bot no WhatsApp ou no Telegram recebe o link do cliente, confirma o pagamento e cria o pedido pela API. Útil para quem vende pacotes fixos e quer atender fora do horário.
3. Integração com loja virtual
Lojas que vendem pacotes de engajamento podem disparar o pedido pela API quando o pagamento for aprovado, sem ninguém copiar e colar link.
Boas práticas de integração
- Guarde a chave com segurança. Quem tem a chave gasta o seu saldo. Nunca a coloque em código que roda no navegador do cliente.
- Consulte status em lote e em intervalos razoáveis, em vez de perguntar sobre cada pedido a cada segundo.
- Atualize o catálogo periodicamente. Serviços entram e saem, e preços mudam — sincronize a lista para não vender um serviço desativado.
- Valide o link antes de enviar. Perfil privado ou link errado gera pedido parcial ou cancelado.
- Monitore o saldo e avise a si mesmo antes que ele zere.
Preciso saber programar?
Para usar um script de painel pronto, não: a integração é configuração, não código. Para um bot ou uma loja personalizada, sim — ou alguém que programe por você. Em ambos os casos, o formato é o mesmo usado pela maioria dos fornecedores, então qualquer exemplo de integração SMM serve de base.
Veja a documentação da API e crie sua conta para gerar a sua chave.