Receitas (cookbook)

Fluxos completos e prontos para copiar. Cada receita combina poucos endpoints da API para resolver um caso real de ponta a ponta.

Receita 1: chatbot de IA no WhatsApp

Responda mensagens automaticamente com um modelo de IA. O laço tem duas pontas: receber por webhook e responder pela API.

1. Aponte o webhook para o seu servidor

curl -X POST https://dashboard.vistoazul.com.br/api/v1/instances/vendas/webhook \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://seu-agente.com/webhook","enabled":true}'

2. Ao receber, gere a resposta e devolva

No seu servidor (exemplo em Node.js):

app.post("/webhook", async (req, res) => {
  const msg = req.body;                 // mensagem recebida
  const texto = msg?.message?.text;
  const numero = msg?.chatid;

  const resposta = await gerarComIA(texto);  // seu modelo de IA

  await fetch("https://dashboard.vistoazul.com.br/api/v1/messages/text", {
    method: "POST",
    headers: {
      "Authorization": "Bearer SUA_API_KEY",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({ instance: "vendas", number: numero, text: resposta })
  });
  res.sendStatus(200);
});

Receita 2: cobrança PIX automática

Dispare uma cobrança PIX na conversa assim que um pedido é criado (ex.: no checkout da sua loja ou num fluxo de vendas).

curl -X POST https://dashboard.vistoazul.com.br/api/v1/wa/send/request-payment \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "x-instance: vendas" \
  -H "Content-Type: application/json" \
  -d '{
    "number": "5511999999999",
    "amount": 97.00,
    "pixKey": "sua-chave-pix",
    "pixType": "email",
    "title": "Pedido #1234",
    "itemName": "Plano Mensal",
    "text": "Segue o PIX para concluir seu pedido."
  }'

O cliente recebe a cobrança nativa do WhatsApp e paga sem sair da conversa. Combine com o webhook para confirmar o pagamento no seu sistema.

Receita 3: captura de lead de grupo + boas-vindas

Quando alguém entra num grupo seu (ex.: pelo link de funil), receba o evento, salve o contato e mande uma mensagem de boas-vindas.

1. Receba o evento groups → Join

{
  "EventType": "groups",
  "event": { "Join": ["5511999999999@s.whatsapp.net"] },
  "instanceName": "vendas"
}

2. Salve o contato com uma tag

curl -X POST https://dashboard.vistoazul.com.br/api/v1/contacts \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"number":"5511999999999","tags":["lead","grupo-lancamento"]}'

3. Mande as boas-vindas

curl -X POST https://dashboard.vistoazul.com.br/api/v1/messages/text \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"instance":"vendas","number":"5511999999999","text":"Bem-vindo! Que bom ter você aqui."}'

Depois, use campanhas segmentadas pela tag lead para nutrir esses contatos.