Wafly › Parceiros › API de WhatsApp para SaaS
API de WhatsApp para SaaS: uma instância por cliente, sem VPS
"Quero colocar WhatsApp no meu sistema" costuma começar com um número só, compartilhado entre todos os clientes. Funciona na demo e quebra no terceiro cliente: uma restrição derruba todo mundo, os webhooks chegam misturados e ninguém sabe de quem é cada conversa. Esta página é para quem está desenhando isso direito desde o começo, ou consertando depois do terceiro cliente.
Por que uma instância por cliente
- Isolamento de risco. Se o WhatsApp restringir o número de um cliente, só aquele cliente para. Com número compartilhado, param todos.
- Isolamento de dados. O token de cada instância só acessa aquela instância. Não existe como um cliente ler a conversa de outro, porque a credencial não alcança.
- Webhooks já roteados. Cada instância aponta para a URL que você quiser. Basta colocar o identificador do cliente na URL para o seu sistema receber cada evento já sabendo de quem é.
- Cobrança espelhada. O preço é por instância, então a sua conta com o fornecedor cresce exatamente com o número de clientes que pagam a você.
Na base da Wafly, mais de um terço das assinaturas ativas tem mais de um número. É o padrão de quem revende ou embute WhatsApp em produto próprio.
Como fica a arquitetura
| O que você precisa | Como fica com uma instância por cliente |
|---|---|
| Sessão do WhatsApp | Uma por cliente, hospedada na Wafly. Você não roda VPS nem mantém engine. |
| Credencial | Token por instância. Guarde no registro do cliente no seu banco. |
| Eventos | 4 webhooks por instância: mensagem recebida, entrega, conectada, desconectada. |
| Conexão do número | QR Code em imagem ou código de pareamento, para você exibir na sua própria tela. |
| Estado da conexão | Endpoint de dispositivo mais o webhook de desconexão. Dá para mostrar "conectado" no seu painel sem perguntar ao cliente. |
| Validar número antes de enviar | Verificação em lote de números com WhatsApp, para não gastar envio com número inexistente. |
| Cliente que manda 3 mensagens picotadas | Buffer de entrada por instância, para o seu bot responder uma vez só. |
| Áudio | Transcrição opcional por instância, com a sua própria chave de IA. |
Todos os endpoints estão na documentação da API, com o mesmo padrão de URL por instância e token. O payload dos webhooks, campo a campo, está em webhook de WhatsApp.
O fluxo em 5 passos
- Seu cliente contrata o módulo de WhatsApp no seu SaaS. Nada da Wafly aparece para ele nesse momento.
- Você cria a instância dele. Pelo painel, ou por API em conta parceira (endpoint de criação de instância para parceiros), gravando o identificador da instância e o token no registro do cliente.
- Você entrega o QR na sua tela. Busque a imagem do QR pela API e mostre no seu painel; no celular, ofereça o código de pareamento em vez do QR. Renove o QR enquanto o cliente não conecta.
- Você configura os webhooks da instância para a URL do seu sistema, com o identificador do cliente. A partir daí, cada mensagem recebida chega já roteada.
- Você monitora. O webhook de desconexão avisa quando a sessão cai; o seu painel mostra "reconecte" e oferece o QR de novo. Um fluxo pronto para isso está em monitorar a conexão do WhatsApp.
Se você não quer escrever a integração do zero, o community node de n8n faz cada um desses passos como nó. O tutorial está em como integrar WhatsApp no n8n.
Como cobrar do seu cliente
O preço da Wafly é por instância: R$ 59,90 por número por mês. Em conta parceira, a partir da 11ª instância todas passam a R$ 39,90. Uma instância adicional é cobrada na hora, sem esperar o próximo ciclo, então o seu custo acompanha o cliente novo no mesmo dia em que ele entra. As regras estão em parceiros.
Duas práticas que funcionam para quem embute:
- Cobre por número, não por mensagem. Mensagens são ilimitadas na Wafly; cobrar do seu cliente por mensagem cria uma conta que você não precisa fazer.
- Crie a instância só depois que o cliente pagar. A instância nasce com custo; a criação por API deixa isso automático no seu fluxo de cobrança.
Para comparar com o restante do mercado, incluindo a oficial da Meta, a tabela está em quanto custa uma API de WhatsApp.
O que a API não oficial não resolve
Uma API não oficial conecta o número do seu cliente como se fosse um WhatsApp Web. Isso traz três limites que você precisa contar para ele antes de vender:
- Número frio. Mensagem para quem nunca conversou com o número pode ser recusada com o erro 463. Fluxos de "primeira mensagem" precisam fazer o contato iniciar a conversa. Detalhes em erro 463 no WhatsApp.
- Risco de restrição. Disparo em massa e lista fria são o que derruba número. Se o seu SaaS permite campanhas, coloque limites de ritmo no produto, não só no contrato.
- Sem selo oficial. Não há botão verificado nem templates aprovados pela Meta. Para a maioria dos casos de atendimento e automação isso não muda nada; para marketing em escala, muda.
Quando o seu cliente precisa da oficial
Se o número de um cliente sustenta o faturamento dele e uma restrição derruba a operação, a escolha certa para esse cliente é a API oficial da Meta, mesmo que custe mais. Um SaaS bem desenhado oferece as duas portas e deixa o cliente escolher por risco, não por preço. A comparação honesta está em API oficial vs não oficial.
Crie a primeira instância grátis
3 dias, sem cartão, com o seu próprio número. Adicione a segunda quando o seu cliente pagar.
Testar a Wafly grátisPerguntas frequentes
Posso usar uma API de WhatsApp não oficial dentro do meu SaaS?
Pode, desde que cada cliente conecte o próprio número e você deixe claro para ele o que é uma conexão não oficial. Se o número do cliente sustenta o faturamento dele e uma restrição derruba a operação, a escolha certa para esse cliente é a API oficial da Meta.
Quantos números uma conta suporta?
Não há limite fixo. Cada número é uma instância, com token e webhooks próprios. Contas parceiras com mais de 10 instâncias pagam R$ 39,90 por instância em vez de R$ 59,90.
Como isolar os dados de cada cliente?
Uma instância por cliente. O token de cada instância só acessa aquela instância, e os webhooks são configurados por instância, então o seu sistema recebe cada evento já sabendo de qual cliente ele é.
Preciso de VPS ou de servidor para as sessões?
Não. A sessão do WhatsApp roda na infraestrutura da Wafly. O que você hospeda é o seu SaaS e a URL que recebe os webhooks.
Continue
WhatsApp e Meta são marcas de seus respectivos donos, sem relação com a Wafly. A Wafly é uma API não oficial conectada por QR Code; nenhuma API, oficial ou não, garante que um número não será restringido. Preços conferidos no nosso próprio banco de assinaturas em 5 de setembro de 2026.