Pular para o conteúdo
apiwpp
Caso de uso

API de WhatsApp para agências: vários clientes, uma conta só

Números de vários clientes separados por projeto, com chaves e webhooks próprios, proxy brasileiro por número e uma fatura só, cobrada por número.

Atualizado em

Uma agência que coloca o WhatsApp nos processos dos clientes cedo ou tarde enfrenta o mesmo cenário: cada cliente tem o próprio número, o próprio sistema e a própria forma de trabalhar, e a equipe precisa operar tudo isso sem misturar mensagens, chaves e cobranças. A apiwpp foi organizada para esse caso: uma conta da agência, um projeto por cliente e cada número dentro do projeto certo.

O problema de gerenciar números de vários clientes

Quando cada cliente contrata uma API por conta própria, a agência herda uma planilha de acessos: logins diferentes, faturas em datas diferentes, webhooks apontando para lugares que ninguém lembra. Quando todos os números ficam na mesma conta sem separação, o problema muda de lado: uma chave vazada dá acesso a todos os clientes, e um evento de um número chega no sistema de outro.

O modelo da apiwpp separa as duas coisas que precisam ficar separadas (acesso e eventos) e junta a que precisa ficar junta (a cobrança):

Projetos não têm custo. Uma organização pode ter até 20 projetos no padrão, e você paga pelos números conectados, não pelos projetos.

Um projeto por cliente, com chaves e webhook próprios

Ao criar o projeto de um cliente, você gera chaves de API só para ele. As chaves têm escopos: uma chave com messages:send envia mensagens, mas não cria nem apaga conexões; uma chave com connections:read só consulta o status. Assim, o sistema do cliente recebe exatamente o acesso de que precisa, e uma chave comprometida não alcança os outros projetos.

As chaves podem ser rotacionadas com uma janela de sobreposição: a chave nova passa a valer antes de a antiga expirar, e a troca acontece sem derrubar a integração.

Cada projeto também tem o próprio endereço de webhook. Mensagens recebidas, confirmações de entrega e mudanças de conexão dos números daquele cliente chegam só no servidor dele, assinadas com HMAC-SHA256. O campo externalId de cada conexão guarda o identificador do seu sistema (o código do cliente no seu CRM, por exemplo) e volta em todos os eventos, o que simplifica o roteamento quando um mesmo servidor atende vários clientes. Os detalhes da entrega estão na página de webhooks assinados.

Cada cliente em um projeto, com números, chaves e webhook separados.

Uma fatura só, cobrada por número

A cobrança é por número conectado, por mês, com mensagens ilimitadas dentro dos limites de envio que protegem o número. Não existe tarifa por mensagem nem cota de mensagens nos planos LITE e PRO, então o custo de cada cliente é previsível: é o número de conexões dele.

Toda a organização paga uma assinatura só, por PIX, boleto ou cartão, escolhido na página de cada fatura. Quando um cliente novo chega no meio do mês, o número adicional fica disponível na hora e o restante do mês é cobrado de forma proporcional, numa cobrança avulsa. Quando um cliente sai, a redução vale a partir da fatura seguinte. Os valores de cada plano estão em preços.

A apiwpp cobra a agência; a forma de repassar o custo aos seus clientes continua com você. Não há, hoje, faturamento separado por cliente final.

Proxy brasileiro e IP dedicado para isolar clientes

Cada número conectado sai por um proxy brasileiro do pool da apiwpp, com um cliente por IP e verificações de saúde que tiram o número de um proxy com problema. Se um cliente exige um endereço fixo, há duas opções:

Para clientes com operações mais sensíveis, o IP dedicado evita que a reputação de um endereço compartilhado afete o número.

Operação do dia a dia

Com dezenas de números, a rotina da equipe é acompanhar o que acontece em cada um. O painel mostra os projetos, as conexões com o status em tempo real e os registros de mensagens e de entregas de webhook, guardados por 7 dias no padrão. O evento connection.status avisa o sistema do cliente quando um número desconecta, com o motivo e se a API vai reconectar sozinha.

Cada número tem a própria fila de envio, com limites por minuto, por hora e por dia, intervalo aleatório entre mensagens e um teto de destinatários novos por dia. Um cliente que tenta enviar demais não afeta o número de outro. Números recém-conectados passam por um aquecimento de 14 dias com limites que crescem por etapa, explicado em fila anti-bloqueio.

Para acompanhar a plataforma como um todo, a página de status pública mostra a saúde de cada componente, com um teste que envia mensagens reais entre dois números a cada 10 minutos.

Se a sua agência também desenvolve produtos próprios, veja o caso de SaaS e CRMs e o guia do blog sobre como agências gerenciam dezenas de números.

Perguntas frequentes

Cada cliente precisa de uma conta na apiwpp?

Não. A agência tem uma organização com uma assinatura só, e cada cliente vira um projeto dentro dela, com chaves de API, webhook e números próprios. Projetos não têm custo; você paga pelos números conectados.

Consigo cobrar os meus clientes separadamente pela apiwpp?

Não hoje. A apiwpp emite uma fatura para a organização, calculada pelos números conectados. A cobrança dos seus clientes, com a margem que você definir, continua no seu processo.

O que acontece quando eu adiciono o número de um cliente novo no meio do mês?

O número fica disponível na hora e o restante do mês é cobrado de forma proporcional, numa cobrança avulsa. A partir da fatura seguinte, ele entra no valor normal da assinatura.

Um cliente pode acessar os números de outro?

Não pelas chaves de API: cada chave pertence a um projeto e só alcança as conexões dele. Os eventos de cada número também só são entregues no webhook do projeto a que ele pertence.

Todos: Casos de uso →

Coloque o WhatsApp dentro do seu produto: cada cliente pareia o próprio número pela sua tela, as conversas chegam por webhook com o id do cliente e você paga por número conectado.

Cada mensagem que chega no número da empresa vira um evento no seu sistema: abra o ticket, distribua para a equipe e responda pela API, com texto, mídia, reações e o indicador de digitando.

Envie confirmação de pedido, boleto ou nota em PDF e código de rastreio no canal que o cliente lê, com templates, clientRef por pedido e status de entrega e leitura no webhook.

Conecte seu primeiro número hoje.

7 dias grátis, sem cartão de crédito.