Agências e SaaS que vendem automação de WhatsApp para os próprios clientes costumam perguntar se dá para revender a ZAP-API. Dá, pela API de revenda: você cria e cancela instâncias para os seus clientes por API, sem passar pelo painel, e recebe uma fatura mensal única. Este artigo mostra o que existe hoje e o que ainda não oferecemos, para você decidir com o quadro real.
O que a revenda entrega hoje
- Uma chave de revendedor server-to-server (
ak_...), emitida pela nossa equipe na ativação. - Criar, listar e cancelar instâncias por API, em
/v1/reseller/api/instances. - Uma instância por cliente seu, com token próprio. O seu backend usa esse token na API comum para QR Code, envio e webhooks.
- Uma fatura mensal única com as instâncias ativas criadas pela API de revenda.
O que ainda não oferecemos
- Painel com a sua marca para o seu cliente: não existe. O seu cliente usa o sistema de vocês, e a ZAP-API fica nos bastidores.
- Domínio próprio para a API: não está disponível. As chamadas usam
api.zap-api.tech. - Marca totalmente invisível: o endereço da API, a documentação e o cabeçalho dos webhooks identificam a ZAP-API. Se o seu sistema fica entre a ZAP-API e o seu cliente, ele não vê nada disso.
- Período de teste na revenda: a instância criada pela API de revenda já nasce ativa e entra na fatura.
Como ativar
A ativação é feita pela nossa equipe. Abra um chamado pelo suporte do painel contando quantas instâncias você prevê e como os seus clientes vão usar o WhatsApp. Preço de atacado e condições ficam na proposta.
Provisionar a instância de um cliente
Quando você fecha com um cliente novo, o seu backend cria a instância dele. O cliente não passa pelo cadastro da ZAP-API.
curl -X POST https://api.zap-api.tech/v1/reseller/api/instances \
-H "Authorization: Bearer ak_sua_chave_reseller" \
-H "Content-Type: application/json" \
-d '{"displayName": "Restaurante Silva", "externalRef": "cliente-1042"}'A resposta traz instanceId, token, companyId, status e o seu externalRef. 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.
Listar, cancelar e conectar
# listar as instâncias que você criou
curl https://api.zap-api.tech/v1/reseller/api/instances \
-H "Authorization: Bearer ak_sua_chave_reseller"
# cancelar uma instância
curl -X DELETE https://api.zap-api.tech/v1/reseller/api/instances/inst_xxx \
-H "Authorization: Bearer ak_sua_chave_reseller"
# conectar: pela API comum, com o token da instância (a resposta traz o qrCode)
curl -X POST https://api.zap-api.tech/v1/instances/inst_xxx/connect \
-H "Authorization: Bearer tk_token_da_instancia"
# buscar o QR Code de novo depois do connect
curl https://api.zap-api.tech/v1/instances/inst_xxx/qrcode \
-H "Authorization: Bearer tk_token_da_instancia"A instância nasce desconectada: chame o connect antes de pedir o QR Code.
Como é a cobrança
Você cobra os seus clientes do jeito que quiser. A ZAP-API não cobra o seu cliente final: cobra de você uma fatura mensal com as instâncias ativas no fechamento do mês, pelo valor de atacado da proposta. A proposta pode prever um mínimo de instâncias por fatura.
FAQ
As instâncias que já tenho na conta entram na fatura de revenda?
Não. Entram só as instâncias criadas pela API de revenda. As que você já tem continuam no plano em que estão.
O meu cliente precisa de conta na ZAP-API?
Não. A instância é criada pela API, e o cliente só escaneia o QR Code na tela que o seu sistema mostrar.
Quem atende o meu cliente?
Vocês. A nossa equipe dá suporte técnico a vocês pelo painel.
Próximo passo
Crie sua conta e abra um chamado pelo suporte do painel pedindo a ativação da revenda.