SmartHub AppsMáquina de aquisição

P8.1 · Grupo VIP — provisionamento de instância por tenant

Depende de P0.3 e P2.1. Skill obrigatória: `/evolution-api-ecomsmart`.

Leia antes de escrever código

Grupo de WhatsApp não existe na API Oficial da Meta. Toda a funcionalidade de grupo (listar, entrar, mandar mensagem, moderar) só existe pela camada não-oficial — no nosso caso, a Evolution API self-hosted que a EcomSmart já opera para relatórios internos. Isso significa:

O prompt

Implemente o provisionamento de instância WhatsApp por loja, no app grupovip do repo radar.

1. Modelos

2. Provisionamento

Endpoint que, ao lojista assinar o plano, chama a Evolution API do servidor compartilhado:

POST {evolution}/instance/create
  { "instanceName": "tenant-<loja_id>", "qrcode": true }

3. Sincronização de grupos

Após conectar, GET {evolution}/group/fetchAllGroups/{instancia}?getParticipants=false (endpoint documentado na skill). Lojista escolhe qual grupo é o "VIP" a gerenciar — nunca gerenciar todos os grupos da conta dele automaticamente, só o(s) explicitamente selecionado(s), respeitando o limite do plano (1 no Essencial, 5 no Pro).

4. Registro de webhooks

Configure o webhook da instância para receber:

5. Limite de taxa

Nenhuma ação de escrita na Evolution (enviar mensagem, mudar assunto do grupo, atualizar participante) pode sair sem passar por um limitador central, com folga generosa e documentada em grupovip/README.md. Escreva o limitador antes de qualquer chamada de escrita — não deixe para depois.

6. Capacidade

Cada instância ativa consome memória o tempo todo no servidor Evolution compartilhado (~300 MB). Antes de provisionar um lote grande de clientes novos, verifique a capacidade disponível no servidor — não provisione sem checar.

Critérios de aceite

  1. Provisionamento real de uma instância de teste, com QR code exibido e conexão confirmada, usando um número secundário (nunca o principal de produção)
  2. Webhooks de group-participants-update e messages-upsert chegando e gravando corretamente
  3. Teste do limitador de taxa recusando uma rajada de chamadas
  4. Teste de que a instância corporativa EAPI - DURAES nunca é usada nem referenciada neste fluxo
  5. Teste de que o limite de grupos por plano é respeitado (Essencial recusa o segundo grupo)
  6. grupovip/README.md documentando o limite de taxa escolhido e por quê

Secret radar-evolution com a URL e o token admin do servidor Evolution compartilhado. Peça a mim — não invente.

© 2026 EcomSmart · Uso interno · pt-BR