Onboarding de cliente na revenda de WhatsApp: do cadastro à primeira mensagem

O primeiro mês decide se o cliente fica. Em WhatsApp API o risco é maior, porque o cliente final quase nunca é desenvolvedor: ele não sabe o que é uma instância e trava no QR Code. Este artigo mostra um roteiro de onboarding para quem revende instâncias da ZAP-API dentro do próprio sistema.

As etapas

1. Cadastro no seu sistema. O cliente nunca passa pelo cadastro da ZAP-API.
2. Criação da instância. O seu backend chama a API de revenda e guarda o token.
3. QR Code. O seu sistema chama o connect da instância na API comum e mostra o QR Code na sua tela.
4. Primeira mensagem. Um envio de teste confirma que está tudo funcionando.
5. Webhook. O seu servidor passa a receber os eventos da instância.

Cada etapa precisa de um sinal claro de sucesso e de falha na sua tela. Cliente em estado ambíguo é cliente que desiste.

Criar a instância sem o cliente perceber

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": "Pizzaria Centro", "externalRef": "cliente-2001"}'

Guarde o token da resposta no ato: ele só aparece uma vez. Use o seu id interno como externalRef: repetir a chamada devolve a instância existente em vez de criar outra. A instância da revenda já nasce ativa e entra na sua fatura mensal, sem período de teste.

Mostrar o QR Code

A instância nasce desconectada. O connect inicia a conexão e já devolve o qrCode; o GET /qrcode busca o código de novo depois disso.

curl -X POST https://api.zap-api.tech/v1/instances/inst_xxx/connect \
  -H "Authorization: Bearer tk_token_da_instancia"

Mostre o QR Code com instruções curtas: abrir o WhatsApp no celular, ir em Aparelhos conectados e escanear. O QR Code expira; ofereça um botão para gerar outro.

Erros que mais derrubam o onboarding

• Tela vazia sem próximo passo: mostre sempre o que falta fazer.
• QR Code sem instrução: o cliente não sabe onde escanear.
• Conexão sem confirmação: avise quando o número conectar e quando cair.

Próximo passo

Veja como funciona a revenda hoje e, para ativar, crie sua conta e abra um chamado pelo suporte do painel.