Wafly › Parceiros › API de WhatsApp para SaaS
API de WhatsApp para SaaS: uma instância por cliente, sem VPS
WhatsApp no seu sistema, começando com um número
Seu produto pode começar com um único número. A Wafly fornece envio por API REST e recebimento por webhook; seu backend mantém os dados e as regras da aplicação. O mesmo desenho atende agendamentos, avisos de pedidos, consultas a um sistema interno e agentes de IA. Não é preciso construir um CRM nem usar n8n para começar.
Teste 3 dias sem cartão com seu próprio número. Depois, R$59,90 por número/mês. A conexão Flex não é oficial da Meta e há risco de bloqueio ou desconexão. Os custos do seu backend e de IA são separados.
Testar com meu número · Ver endpoints e webhooks"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
Preciso usar n8n para integrar WhatsApp ao meu sistema?
Não. Seu backend pode chamar a API REST e receber eventos por webhook. n8n é uma alternativa para montar o fluxo.
A Wafly entrega um agente de IA pronto?
Não. A Wafly fornece o canal de envio e recebimento. Sua aplicação mantém o modelo, as regras, o histórico e o encaminhamento para uma pessoa.
Posso integrar a partir de uma tela criada com IA?
A tela deve chamar um backend autenticado. É o backend que guarda as credenciais e chama a Wafly; não coloque tokens no navegador. A compatibilidade do seu fluxo precisa ser testada, não presumida pelo nome da ferramenta.
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.