Conexões

O módulo de Conexões é onde você gerencia os números de WhatsApp conectados à plataforma. Existem dois tipos de conexão: Web (legado) e API Oficial (Meta Cloud API).

Tipos de conexão

Tipo	Descrição
API Oficial (Meta)	Conexão via WhatsApp Business API da Meta. Mais estável e recomendada.
Web	Conexão via QR Code similar ao WhatsApp Web. Uso limitado.

A maioria das operações usa a API Oficial, que oferece mais estabilidade e recursos.

Conexões API Oficial (Meta)

Informações exibidas

Para cada número conectado via API Oficial, você vê:

Coluna	Descrição
Número	Telefone conectado
Tier	Limite de mensagens permitido
Ativo	Status do telefone (ACTIVE/DISABLED)
BM	Business Manager associado
Status Conta	Estado da conta WhatsApp
Saúde	Qualidade e violações
Fila de Transferência	Fila para mensagens recebidas
Centro de Custo	Para controle financeiro
BOT	Integração de automação

Status da conta

Status	Significado
CONNECTED	Funcionando normalmente
PENDING	Aguardando ativação
RESTRICTED	Restrições aplicadas
FLAGGED	Sinalizado por violação
RATE_LIMITED	Limite de envio atingido
BANNED	Banido pelo WhatsApp

Indicador de Saúde

A saúde do número mostra a qualidade dos envios:

Cor	Quality Score	Significado
Verde	GREEN	Tudo certo, pode enviar normalmente
Amarelo	YELLOW	Atenção, algumas reclamações
Vermelho	RED	Problema sério, envios podem ser limitados

Se a qualidade cair, reduza o volume de mensagens e revise o conteúdo.

Configurações do número

Clique em um número para editar:

Configuração	Descrição
Fila de Transferência	Para onde vão as mensagens recebidas
BOT/Integração	Automação que atende primeiro
Centro de Custo	Classificação para faturamento

Edição em lote

Selecione vários números com checkbox e edite configurações em massa.

Conexões Web (QR Code)

Como conectar

Acesse Conexões > Conexões Web
Clique em "Nova Conexão"
Digite um nome para identificar
Salve e clique em "QR Code"
Escaneie o código com seu WhatsApp
Aguarde a conexão ser estabelecida

Status da conexão Web

Status	Cor	Significado
CONNECTED	Verde	Conectado e funcionando
DISCONNECTED	Vermelho	Desconectado
qrcode	-	Aguardando escaneamento
OPENING	-	Estabelecendo conexão
TIMEOUT	Amarelo	Tempo esgotado

Ações disponíveis

Ação	Descrição
QR Code	Gerar novo código para escaneamento
Desconectar	Encerrar sessão do WhatsApp
Editar	Alterar nome e configurações
Excluir	Remover conexão

Alerta de duplicidade

Se o mesmo número estiver conectado em mais de uma conexão Web, o sistema exibe um alerta vermelho. Isso pode causar:

Problemas de sincronização
Mensagens duplicadas
Histórico inconsistente

Mantenha apenas uma conexão ativa por número.

Configurações comuns

Tanto para API Oficial quanto Web, você pode configurar:

Fila de Transferência

Define para qual fila as mensagens recebidas (receptivas) serão direcionadas:

Se definida: mensagens vão direto para a fila escolhida
Se não definida: usa a fila padrão ou roteamento automático

Integração/BOT

Vincula um bot ou integração para atendimento automático:

Dialogflow
N8N
Typebot
Webhook personalizado

O bot atende primeiro; se não resolver, transfere para humano.

Centro de Custo

Classifica o número para controle financeiro. Útil quando você tem números diferentes para departamentos ou clientes.

Business Manager (BM)

Para conexões API Oficial, o número está vinculado a um Business Manager:

O que é

O Business Manager é a conta empresarial na Meta que gerencia:

Números de WhatsApp
Templates de mensagem
Pagamentos e faturamento
Permissões e acessos

Filtrando por BM

Na lista de conexões API Oficial, use o filtro de Business Manager para ver apenas números de um BM específico.

Dicas importantes

Mantenha o perfil atualizado

Um perfil completo no WhatsApp Business passa mais confiança:

Foto de perfil profissional
Nome da empresa
Descrição do negócio
Endereço e horário de funcionamento
Site e email de contato

Monitore a qualidade

Verifique regularmente o indicador de saúde
Se a qualidade cair, reduza volume de envios
Revise o conteúdo das mensagens
Evite enviar para quem não autorizou

Evite bloqueios

Não use o mesmo número em múltiplas conexões
Respeite os limites de envio (tier)
Não envie spam ou conteúdo proibido
Responda reclamações rapidamente

Permissões

Ação	Permissão
Ver conexões	Acesso básico
Adicionar conexão Web	`connections-page:addConnection`
Editar conexão	`connections-page:editOrDeleteConnection`
Gerenciar sessão (QR)	`connections-page:actionButtons`
Editar API Oficial	`official-connections-page:editConnection`