Skip to main content

​
O que é uma Instância?

Uma instância representa uma conexão WhatsApp única no EnviaAI. Cada instância:
  • Conecta a um único número de telefone
  • Pode enviar e receber mensagens independentemente
  • Tem suas próprias configurações e webhooks
  • É vinculada a uma API Key
Pense em instâncias como “linhas telefônicas virtuais” - cada uma é independente e pode ser gerenciada separadamente.

​
Ciclo de Vida

​
Status da Instância

StatusDescrição
disconnectedInstância criada mas não conectada
connectingProcesso de conexão em andamento
qr_pendingAguardando escaneamento do QR Code
connectedConectada e pronta para uso

​
Métodos de Conexão

​
API Oficial (Meta)

Conexão via WhatsApp Business API oficial da Meta. Vantagens:
  • Alta confiabilidade
  • Sem risco de banimento
  • Selo de verificação
  • Suporte oficial
Requisitos:
  • Conta Meta Business verificada
  • Número de telefone verificado
  • Access Token da Meta

​
QR Code (Não Oficial)

Conexão via escaneamento de QR Code. Vantagens:
  • Setup instantâneo
  • Sem verificação necessária
  • Ideal para testes
Desvantagens:
  • Risco de banimento
  • Menor estabilidade
  • Não recomendado para produção
A conexão via QR Code usa uma API não oficial. Use apenas para desenvolvimento e testes.

​
Limites por Plano

PlanoInstâncias
Free1
Starter3
Pro10
EnterpriseIlimitado

​
Configurações

Cada instância pode ter configurações próprias: 
{
  "autoRead": false,      // Marcar mensagens como lidas automaticamente
  "autoTyping": true,     // Mostrar "digitando..." antes de enviar
  "webhookUrl": "https://...",  // URL do webhook
  "webhookEvents": ["message.received", "message.sent"]
}

​
Boas Práticas

Uma instância por caso de uso

Separe vendas, suporte e marketing em instâncias diferentes

Monitore o status

Configure webhooks para instance.disconnected e reconecte automaticamente

Use nomes descritivos

Nomeie instâncias de forma clara: “Vendas SP”, “Suporte 24h”

Teste antes de produção

Use QR Code para testes, API Oficial para produção

​
Próximos Passos

Criar Instância

Crie sua primeira instância

Conectar

Conecte via QR Code ou API Oficial