WhatsApp via Z-API

Mande mensagens de WhatsApp do app sem precisar aprovar templates na Meta.

Pré-requisito

Conta Z-API (gateway brasileiro). Em app.z-api.io:

1. Cria uma instância
2. Conecta seu chip (escaneia QR code com WhatsApp do celular)
3. Pega instanceId + token na área da instância

Configurar no BeaDev

App → Integrações → WhatsApp (Z-API):

• Instance ID
• Token
• Client-Token (opcional, pra account-level security)

Enviar mensagem de texto

await integrations.whatsapp.sendText(
  "5511987654321",  // DDI+DDD+número, sem espaço/sinal
  "Olá Maria, seu pedido #1234 foi aprovado!"
);

Enviar imagem

await integrations.whatsapp.sendImage(
  phone,
  "https://meusite.com/comprovante.png",
  "Aqui está seu comprovante"  // legenda opcional
);

Enviar PDF / documento

await integrations.whatsapp.sendDocument(
  phone,
  "https://meusite.com/boleto.pdf",
  "Boleto.pdf"  // nome do arquivo
);

Enviar link rico

await integrations.whatsapp.sendLink(phone, {
  message: "Confira sua nota fiscal:",
  linkUrl: "https://nfe.exemplo.com/123",
  title: "NF-e #001234",
  linkDescription: "Emitida em 30/04/2026",
  image: "https://meusite.com/logo.png"  // opcional
});

Status da conexão

const status = await integrations.whatsapp.status();
// retorna { connected: true/false, ... }

Útil pra mostrar na UI se a integração tá saudável.

Casos de uso comuns

• Notificar cliente quando pedido sai pra entrega
• Alertar gestor quando algo trava no fluxo
• Enviar boleto/comprovante automático
• Lembretes de vencimento

Limites Z-API

Conta seu plano Z-API. BeaDev não tem limite extra além das chamadas mensais de IA (que não conta WhatsApp).