Grupos & Funil meteórico

Crie grupos em escala e um único link que enche um grupo e pula pro próximo sozinho — sem você trocar o link. É o motor de lançamento.

Criar um grupo

curl -X POST https://dashboard.vistoazul.com.br/api/v1/wa/group/create \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "x-instance: vendas" \
  -H "Content-Type: application/json" \
  -d '{"name":"Lançamento 01","participants":[]}'

A resposta traz o JID do grupo (ex.: 1203...@g.us), que você usa para disparar e para montar o funil.

Listar seus grupos

Disparar no grupo mencionando @todos

Use o JID do grupo como number e mentions: "all" para marcar todos os participantes:

curl -X POST https://dashboard.vistoazul.com.br/api/v1/wa/send/text \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "x-instance: vendas" \
  -H "Content-Type: application/json" \
  -d '{"number":"1203...@g.us","text":"Começamos em 5 min! 🚀","mentions":"all"}'

O funil meteórico

Um funil é um link curto (vistoazul.com.br/g/seu-slug) ligado a vários grupos. Quando alguém abre o link, ele entra no primeiro grupo com vaga; quando esse enche, o próximo é usado — e quando todos lotam, um novo grupo é criado sozinho.

Criar o funil

curl -X POST https://dashboard.vistoazul.com.br/api/v1/funnels \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Lançamento",
    "slug": "lancamento",
    "instance": "vendas",
    "jids": ["1203...@g.us"],
    "capacity": 950,
    "welcomeMsg": "Boas-vindas! Começamos amanhã 💙",
    "fullMessage": "As vagas abrem em instantes, tente de novo já já."
  }'

Campo	Descrição
name	Nome do funil (usado ao criar grupos novos).
slug	Final do link público: /g/<slug>.
instance	Instância dona dos grupos.
jids	Lista de grupos iniciais (JIDs ...@g.us).
capacity	Vagas por grupo antes de pular (padrão 950).
welcomeMsg	Mensagem opcional enviada a quem entra.
fullMessage	Texto exibido quando, momentaneamente, não há vaga.

O link público

Divulgue esse link. Ele redireciona o visitante para o grupo certo automaticamente. Não precisa de API key — é público.

Acompanhar o funil

{ "capacity": 950, "hits": 2310,
  "activeIndex": 2, "groups": [ { "jid": "...@g.us", "count": 950 } ] }

Liste todos com GET /v1/funnels e remova com DELETE /v1/funnels/:id.