Baileys vs. API Oficial — Como escolher
Essa é a dúvida mais comum de quem instala o ChatDigi. Aqui está o comparativo completo baseado no que o sistema realmente suporta.
Comparativo geral
| Característica | Baileys (QR/Pareamento) | API Oficial (WABA) |
|---|---|---|
| Precisa de celular ligado | Sim | Não |
| Precisa de número com chip | Sim | Não (número pode ser só de voz ou virtual) |
| Custo por mensagem | Nenhum extra | Sim — Meta cobra por conversa |
| Estabilidade | Depende do celular/internet | Alta (infraestrutura da Meta) |
| Limite de mensagens | Não tem limite oficial | Meta define limites por tier (250/1k/10k/ilimitado por dia) |
| Enviar fora da janela de 24h | Sim, qualquer mensagem | Apenas templates aprovados pela Meta |
| Templates de mensagem | Não usa | Obrigatório para mensagens fora da janela |
| Grupos do WhatsApp | Suportado (opcional) | Não suportado |
| Número multiagente | Sim | Sim |
| Campanhas em massa | Funciona (risco de ban pelo WhatsApp) | Suportado com templates |
| Configuração inicial | 2 minutos (QR Code) | Horas a dias (aprovação Meta) |
Quando usar Baileys
Use Baileys se:
- Você tem um celular disponível 24h por dia conectado à internet
- Está começando e quer testar o sistema rapidamente
- Seu volume de mensagens é baixo a médio
- Você não precisa enviar mensagens ativas fora da janela de 24h com frequência
- Quer evitar custo adicional por mensagem
Risco de ban
O WhatsApp pode bloquear números Baileys que enviam muitas mensagens em massa ou que recebem muitas denúncias. Se sua operação é de alto volume ou envio em massa, prefira a API Oficial.
Quando usar API Oficial
Use API Oficial se:
- Você não quer depender de um celular ligado
- Precisa de alta confiabilidade (SLA de atendimento, volume alto)
- Precisa enviar mensagens ativas para clientes que não falaram com você recentemente (exige templates)
- Sua empresa já tem ou quer obter o selo de verificação da Meta (badge azul)
- Você vai fazer campanhas de marketing via WhatsApp
Comportamentos diferentes dentro do ChatDigi
Alguns comportamentos variam conforme o tipo de conexão:
Janela de 24h:
- Baileys: o sistema não impõe restrição — você envia qualquer mensagem a qualquer hora
- Oficial: o sistema verifica se a janela está aberta; se não estiver, bloqueia o envio livre e exige um template
Iniciar conversa nova:
- Baileys: você digita e envia normalmente
- Oficial: abre o modal "Nova Conversa - API Oficial", que exige selecionar um template pré-aprovado
Reconexão:
- Baileys: reconecta automaticamente até 3 tentativas; se falhar, precisa de novo QR/código
- Oficial: não há sessão para reconectar — as credenciais ficam salvas
Chamadas de voz (API Oficial):
- Você pode configurar quem atende chamadas: Agente IA ou direto para atendentes. Esse toggle fica no cartão da conexão.
Posso usar os dois ao mesmo tempo?
Sim. Você pode ter um número Baileys e um número Oficial ativos simultaneamente. Cada fila pode ser associada a uma conexão específica.
Resumo de decisão rápida
Tem celular disponível 24/7 + volume baixo/médio + quer simplicidade?
→ Baileys (QR Code)
Não tem celular + volume alto + precisa de garantia + faz campanhas?
→ API Oficial (WABA)
Não sabe por onde começar com a Oficial?
→ Use o Embedded Signup (assistente guiado)