O que é a Orbit Pulse Engine?
A Orbit Pulse Engine é o motor open-source de alta performance que roda na nossa VPS Contabo (169.58.26.171). Ela gerencia conexões WhatsApp via protocolo Baileys (WhatsApp Web Multi-Device), permitindo múltiplas instâncias simultâneas.
Passo a Passo de Conexão
1. Criação da Instância
Canais → Nova Instância → WhatsApp QR Code Nome: [nome-da-empresa]-[setor] ex: orbitsalon-vendas
2. Aguardar o QR Code
O QR Code é gerado em até 5 segundos. Ele expira em 60 segundos — se expirar, clique em “Gerar Novo QR”.
3. Scan no Celular
- WhatsApp → ⋮ Menu → Aparelhos Conectados → Conectar Aparelho
- Aponte a câmera para o QR Code
4. Status de Conexão
| Status | Ícone | Significado |
|---|---|---|
| connecting | 🟡 | Aguardando QR scan |
| open | 🟢 | Conectado e operando |
| close | 🔴 | Desconectado (precisa reconectar) |
Limites e Boas Práticas
⚠️ Um chip novo ou “frio” (sem histórico) pode ser banido ao enviar mensagens em massa sem aquecimento.
Consulte → Blindagem Anti-Ban para o protocolo completo de aquecimento.
Webhook de Status
A Orbit Pulse Engine envia eventos via webhook para o n8n quando o status da instância muda:
json { "event": "connection.update", "instance": "orbitsalon-vendas", "data": { "state": "open" } }
”@ | Set-Content “C:\Users\Jean\Documents\PROJETOS-IDEAR-DIGITAL\STARTUP\04-HELP-CENTER\orbit-pulse-hub\src\content\docs\02-canais\02-whatsapp-qr.md” -Encoding UTF8
@”
title: “WhatsApp Oficial (Meta Cloud API)” description: “Configure a integração via Meta Business Manager para operações em grande escala sem risco de ban.” section: “Canais & Conexões” order: 3
Diferença: QR Code vs Meta Cloud API
| Aspecto | QR Code (Orbit Pulse) | Meta Cloud API |
|---|---|---|
| Configuração | 3 minutos | 3-7 dias úteis |
| Risco de ban | Médio (depende de boas práticas) | Zero (número verificado) |
| Custo/mensagem | Sem custo de plataforma | Cobrança Meta por conversa |
| Throughput | ~100 msg/min | Ilimitado (aprovação Meta) |
| Templates | ❌ Não suporta | ✅ Obrigatório para prospecção |
Pré-requisitos
- Conta Meta Business Manager verificada com CNPJ.
- Número de telefone dedicado (VoIP ou fixo — nunca pessoal).
- Token de Acesso Permanente da Meta (via System User).
Fluxo de Configuração
Meta Business Manager └── WhatsApp Manager └── Número → Verificar → Gerar Token │ Orbit Pulse → Canais → Nova Instância → WhatsApp Meta Cloud → Colar Token
Templates de Mensagem
O Meta exige templates aprovados para mensagens fora da janela de 24h:
- Tipo: Marketing, Utility, Authentication
- Formato: variáveis {{1}}, {{2}} são substituídas dinamicamente
- Aprovação: 1-5 minutos (automática para a maioria)