Toda semana algum cliente pergunta a mesma coisa: "como vocês fazem para não eu não aparecer como cliente da ZAP-API quando eu vendo automação WhatsApp para meus clientes?". A resposta é o painel white-label — você opera com sua marca, seu domínio e seu billing, enquanto a infraestrutura roda nos nossos servidores.
Este artigo é o passo a passo completo para sair do zero (uma planilha de Excel rastreando clientes manualmente) até ter uma agência com painel próprio, isolamento de cobrança e margem recorrente real.
O problema das agências sem painel
Hoje uma agência de marketing digital típica que vende automação WhatsApp opera assim:
- Compra 10 instâncias na sua conta principal.
- Distribui credenciais entre clientes via WhatsApp ou Notion.
- Quando um cliente para de pagar, descobre tarde demais (a fatura veio toda no nome da agência).
- Quando outro cliente pergunta "como acesso o painel?", a resposta é "não tem, eu rodo as automações para você".
- Não consegue subir preço porque o cliente percebe que é só revenda.
Resultado: a agência vira refém da própria operação, não escala, e perde clientes para concorrentes que entregam um painel decente.
O que muda com white-label
No modelo reseller, cada cliente seu vê:
- Seu logo no canto superior do painel
- Seu domínio na URL (api.suaempresa.com.br)
- Sua paleta de cores na interface
- Seu email no rodapé e nos templates de notificação
- Sua fatura emitida em nome da sua empresa
E nada disso menciona ZAP-API. Para o cliente final, ele está usando seu produto.
Pré-requisitos
- Conta criada em zap-api.tech/register (trial 7 dias, sem cartão)
- Email de suporte que sua marca já usa (ex.: [email protected])
- Logo em PNG transparente (recomendado 256x256px)
- Opcional mas recomendado: domínio próprio para usar como base da API
Passo 1: Ativar conta reseller
Fale com o suporte pelo painel para habilitar o modo revendedor na sua conta — a ativação é feita do nosso lado e sai junto uma chave de API server-to-server (ak_...) para provisionar seus clientes. Não tem custo extra de ativação: você só passa a pagar pelas instâncias dos seus clientes pelo modelo de pricing reseller (R$29 por instância adicional acima da segunda, conforme tabela vigente).
Com o painel habilitado, você configura o branding você mesmo:
Endpoint usado
PUT /v1/reseller/me
Authorization: Bearer <seu JWT de login>
{
"brandName": "Agência X Automação",
"supportEmail": "[email protected]",
"primaryColor": "#1e40af",
"logoUrl": "https://cdn.agenciax.com.br/logo.png"
}O primaryColor precisa ser hex de 6 dígitos (#1e40af). O GET /v1/reseller/me devolve o estado atual do painel — marca, cores, domínio e preço por instância.
Passo 2: Provisionar conta para um cliente final
Quando você fecha venda com um cliente novo, cria a instância dele via API — ele nunca passa pelo cadastro público da ZAP-API. Uma única chamada já cria a subconta e a instância, e devolve o token que o cliente (ou o seu backend) vai usar.
Código Node.js completo
import axios from "axios";
const ZAP_API = axios.create({
baseURL: "https://api.zap-api.tech/v1",
// chave server-to-server do reseller (ak_...), não o JWT do painel
headers: { Authorization: `Bearer ${process.env.ZAP_RESELLER_API_KEY}` },
});
async function provisionarCliente({ nome, refInterno }) {
// Cria subconta + instância numa chamada só.
// externalRef torna a operação idempotente: repetir o POST com o mesmo
// valor devolve a instância existente em vez de criar outra.
const { data: instancia } = await ZAP_API.post("/reseller/api/instances", {
displayName: nome,
externalRef: refInterno,
});
return {
instanceId: instancia.instanceId, // inst_...
apiToken: instancia.token, // tk_... — plaintext, exibido UMA vez
companyId: instancia.companyId,
status: instancia.status, // "active" (sem trial, entra na fatura de atacado)
};
}
// Uso
const credenciais = await provisionarCliente({
nome: "Restaurante Silva",
refInterno: "cliente-1042",
});
console.log("Guarde no seu banco:", credenciais);Guarde o token no ato: ele só aparece nessa resposta. Repetir a chamada com o mesmo externalRef devolve a instância existente sem token novo. E note que a instância nasce active, sem trial — ela entra direto na sua fatura mensal de atacado.
Passo 3: Listar e gerenciar seus clientes
O endpoint GET /v1/reseller/api/instances devolve todas as instâncias que você provisionou, com status, número conectado e o seu externalRef — o suficiente para cruzar com o seu banco e montar um dashboard interno.
curl -X GET https://api.zap-api.tech/v1/reseller/api/instances \
-H "Authorization: Bearer ak_sua_chave_reseller"Para a visão de receita (MRR bruto, custo de atacado e margem) e para a lista agrupada por empresa cliente, use os endpoints do painel, autenticados pelo JWT de login: GET /v1/reseller/me/stats e GET /v1/reseller/me/clients.
Passo 4: Modelo de negócio (números reais)
Aqui é onde reseller deixa de ser hobby e vira negócio:
Custo (o que você paga)
- 1ª e 2ª instância de cada conta reseller: R$49/mês cada
- 3ª instância em diante: R$29/mês cada
- Sem fee de setup, sem mínimo, cobrança por uso real
Receita (o que você cobra do cliente final)
Pricing comum entre agências white-label de WhatsApp:
- Plano básico: R$99/mês — 1 instância, suporte por email
- Plano profissional: R$199/mês — 1 instância + integrações + suporte prioritário
- Plano agência: R$299–R$499/mês — múltiplas instâncias + setup assistido + treinamento
Margem por cliente
Cliente médio em plano R$199 com 1 instância: margem bruta ~75%. Com 30 clientes, MRR de R$5.970 e custo de ~R$1.470 com a infra, sobram R$4.500 mês.
Passo 5: Domínio customizado (opcional, recomendado)
Para o cliente nunca ver "zap-api.tech" na barra de endereços, configure CNAME apontando seu subdomínio para a infra da ZAP-API. Detalhamos isso em outro post (Domínio customizado na API WhatsApp).
Casos práticos
Caso 1: Agência de marketing local
Atende salões de beleza, restaurantes e clínicas em uma cidade do interior. Vende plano de R$249/mês incluindo automação WhatsApp + Google Meu Negócio. Hoje 47 clientes, MRR R$11.703, custo infra R$2.343 (47 × R$49 média porque maioria tem só 1 instância). Sobra R$9.360 mensais.
Caso 2: SaaS vertical (clínicas)
Sistema de gestão para clínicas odontológicas que vendia "agendamento online" passou a vender "agendamento + WhatsApp" como upsell. Nicho muito específico, ticket maior (R$399/mês), 80 clínicas no plano premium. Conseguiu cobrar mais porque o produto integra direto com a agenda.
Caso 3: Consultor solo
Um consultor de processos comerciais que ajuda PMEs a estruturar o pós-venda começou a vender "implementação + manutenção mensal" do WhatsApp como serviço. Não tem nem 10 clientes, mas cada um paga R$899/mês. Margem bem alta porque o serviço de consultoria é o que vale, a infra é coadjuvante.
FAQ
Preciso de CNPJ para virar reseller?
Tecnicamente não — você pode operar como pessoa física e emitir nota como MEI ou autônomo. Na prática, ter CNPJ ajuda na hora de fechar com clientes maiores que precisam emitir nota fiscal recebida e querem contrato social. Para agência séria, abra MEI no mínimo.
Posso usar meu próprio domínio na URL da API?
Sim. Configure um CNAME no seu DNS apontando api.suaempresa.com.br para o endpoint de revendedor da ZAP-API. Após a verificação automática, seus clientes acessam o painel naquele endereço com SSL automático. Detalhes técnicos no post sobre domínio customizado.
Quantos clientes posso ter como reseller?
Não há limite técnico. Conhecemos resellers com 200+ clientes ativos. O que limita é a sua capacidade de suporte — recomendamos contratar uma pessoa dedicada a partir de 50 clientes.
Como funciona o billing? Eu cobro do cliente ou a ZAP-API cobra direto?
Você cobra do cliente final. A ZAP-API cobra de você uma única fatura mensal consolidada com todas as suas instâncias ativas. O cliente final nunca recebe cobrança nossa, nem vê nosso CNPJ na nota.
O cliente vê em algum lugar a marca ZAP-API?
Quando você configura branding completo (logo + domínio + email de suporte), não. O painel inteiro fica com sua identidade visual. Detalhes muito profundos da documentação da API ainda referenciam "zap-api.tech" mas você pode hospedar a documentação do seu jeito também.
Próximo passo
Crie sua conta reseller agora — trial de 7 dias com tudo liberado, inclusive recursos white-label. Criar conta grátis.