Uau!Sandbox completo para desenvolvedores — grátis para sempre!Registre-se agora
Guia de Integração com a API do WhatsApp

Crie um Grupo de WhatsApp Pago com Stripe e Whapi.Cloud: Guia Completo 2026

Updated on May 14, 2026

Para desenvolvedores Node.js: como criar um grupo de WhatsApp pago que se gerencia sozinho. O Stripe Checkout captura o telefone do assinante, um webhook o adiciona via API de Grupos da Whapi.Cloud em segundos, e customer.subscription.deleted o remove silenciosamente ao cancelar. Cobre configuração de webhook com raw-body, conversão de telefone para JID, limites de taxa, fallback 403 com rotação de links de convite, dois níveis de banco de dados (Google Sheets e SQLite) e um caminho sem código com n8n. Suporta até 1.024 membros.

Paid WhatsApp group Stripe Whapi.Cloud integration system architecture showing webhook flow from payment to group membership
Sobre o autor
Jason Mitchell
Jason Mitchell
Product Owner na Whapi.Cloud
Construindo integrações de WhatsApp desde 2019. Sempre aberto a conexões — seja para discutir um caso de uso da API, compartilhar feedback ou simplesmente trocar ideias. Me encontre no LinkedIn.
Dúvidas Frequentes

FAQ: Integração de Grupo de WhatsApp Pago

Você pode usar qualquer número de WhatsApp, pessoal ou comercial. Conecte-o à Whapi.Cloud escaneando um QR code no painel; o processo leva cerca de dois minutos e não exige verificação da Meta nem conta comercial. Se o número já tiver o WhatsApp instalado em um celular, o celular e a API podem funcionar simultaneamente (a Whapi.Cloud suporta isso). Dedique um número exclusivo à integração se pretende gerenciar vários grupos pagos ou quer separar o tráfego da API das mensagens pessoais.
Exporte sua lista atual de assinantes (telefone, ID de assinatura do Stripe) e execute um script de migração que chame <code>addGroupMember()</code> para cada um. Use lotes de 10 membros com uma pausa de 3 segundos entre os lotes, e aumente o intervalo entre adições individuais para 500ms para ficar abaixo do limite IQErrorRateOverlimit. Execute o script em horários de baixo tráfego. Após a migração, insira cada assinante na tabela <code>members</code> para que o webhook de remoção por expiração consiga encontrá-los pelo ID de assinatura.
Use o Stripe CLI para encaminhar eventos de webhook para seu servidor local: <code>stripe listen --forward-to localhost:3000/webhook</code>. Ele exibe um segredo temporário de assinatura de webhook para usar como <code>STRIPE_WEBHOOK_SECRET</code> no arquivo <code>.env</code> durante os testes locais. O comando de replay do CLI permite reenviar qualquer evento passado: <code>stripe events resend evt_XXXX</code>. Teste primeiro o <code>checkout.session.completed</code> para verificar a adição do membro, depois <code>customer.subscription.deleted</code> para verificar a remoção. Confirme que a chamada à API da Whapi.Cloud foi bem-sucedida e que o registro no banco de dados foi criado ou removido corretamente.
Sem idempotência, um <code>checkout.session.completed</code> duplicado adiciona o membro duas vezes (enviando duas mensagens de boas-vindas e criando dois registros no banco de dados para a mesma assinatura). Um <code>customer.subscription.deleted</code> duplicado remove um membro ativo antes do fim do período de cobrança. A tabela <code>processed_events</code> no esquema do SQLite resolve isso: antes de processar qualquer evento, verifique se o <code>event.id</code> já está registrado. O Stripe garante que o mesmo ID de evento é usado em cada tentativa, então essa verificação é determinística.
Grupos de WhatsApp têm um limite de 1.024 membros por grupo. Quando um grupo se aproxima desse teto, a abordagem padrão é criar grupos de estouro (Grupo 2, Grupo 3) e direcionar novos assinantes ao grupo com capacidade disponível. Adicione uma verificação de <code>group_capacity</code> à sua função <code>handleCheckoutCompleted</code>: chame <code>GET /groups/{id}</code> para obter a contagem atual de participantes e, se ultrapassar seu limite (ex.: 900), redirecione o próximo assinante para um ID de grupo de estouro designado. Todos os grupos entregam o mesmo conteúdo; a diferença é administrativa. A API de Grupos da Whapi.Cloud suporta esse padrão de roteamento sem configuração adicional.
Uma resposta 403 de <code>POST /groups/{id}/participants</code> significa que o assinante configurou a privacidade do WhatsApp para restringir adições a grupos apenas para contatos ou para ninguém. O número é válido e está ativo no WhatsApp — a configuração de privacidade está bloqueando a adição pelo servidor. O único fallback confiável é o fluxo de rotação de link de convite: revogue o código de convite atual do grupo, gere um novo e envie ao assinante via mensagem direta no WhatsApp usando <code>POST /messages/text</code>. O assinante entra voluntariamente ao clicar no link. Rode o código novamente depois que ele entrar (ou após 24 horas) para fechar a janela de vazamento.

Veja o que Nossos Clientes Construíram
com Whapi.Cloud

"Cart reminders with a 5% follow-up coupon lifted our recovery rate from 4% to 11%. Customers reply directly in WhatsApp — our team closes the sale right there."

Abandoned Cart Recovery

Hans M., Germany
"Managing 40+ segment groups became trivial — auto welcome messages, pinned updates, inactive member cleanup. Lead gen from WhatsApp groups grew 3x in two months."

Automated Group Management at Scale

Carlos S., Brazil
"Guests receive door codes, WiFi credentials, and a local guide automatically on arrival. Checkout is confirmed via a photo on WhatsApp. Front desk load dropped 40% in the first month."

Contactless Hotel Operations

Ana M., Romania
"Our deals channel has 12,000 subscribers. Whapi.Cloud scrapes competitors, filters duplicates, and auto-posts the top 5 daily. Channel growth tripled after switching to automated posting."

Automated Deal Channel Publishing

Katrin S., Germany
"We verified 93,000 active WhatsApp numbers from 180,000 contacts in 48 hours. Campaign open rates improved significantly by stopping spend on inactive numbers."

Large-Scale Audience Filtering

Sergio N., Spain
"Patients book appointments and check lab results on WhatsApp. The bot handles 200+ daily queries without staff. Appointment no-shows dropped 30% after automated 24h reminders."

Healthcare Bot — Scheduling & Results

Dr. Fernanda O., Brazil
"Post-purchase WhatsApp messages with a tailored discount at day 14. Birthday coupons see 45% redemption — far above our email rate. Repeat purchases via WhatsApp: 18% of total revenue."

WhatsApp Retention Campaigns

Lukas W., Germany
"Customers get a WhatsApp tracking link the moment their parcel ships. Support tickets dropped 35% in 3 months — mostly 'where is my order?' queries simply disappeared."

Automated Shipping Notifications

Matei P., Romania
Desenvolvimento e gestão próprios

O que é Whapi.Cloud?

Whapi.Cloud é uma API intuitiva que conecta seu negócio ao WhatsApp de forma direta e sem complicações. Crie bots de suporte, agende compromissos, envie notificações, gerencie grupos e canais, automatize confirmações de pedidos e acompanhe tudo com webhooks. Foque no crescimento do seu negócio enquanto a API cuida da camada de mensagens.

Nosso serviço oferece controle total e gerenciamento de grupos, comunidades e canais do WhatsApp.

Adicione dinâmica e novos recursos: mídia, botões, reações, stories, pedidos e produtos. Tudo disponível para interação com seus clientes.

Nossa equipe responderá rapidamente e ajudará você com qualquer dúvida!
Account screenshot
Account screenshot