Conexões WhatsApp

Conecte um ou mais números de WhatsApp à plataforma e gerencie-os em um único painel.

Conexões são os números de WhatsApp vinculados à sua empresa no WhatsBlast. Cada conexão é um canal independente com suas próprias filas, mensagens automáticas, chatbots, flows e integrações. Você pode ter múltiplas conexões (dependendo do seu plano) para separar, por exemplo, um número de Suporte de um de Vendas.

Acesso Administradores têm acesso total. Atendentes comuns veem a tela somente se o administrador ativar a permissão "Permitir acesso a conexões" no cadastro do usuário — e mesmo assim só podem reconectar (escanear QR), não criam nem editam conexões.

Facebook e Instagram Esta página cobre as conexões de WhatsApp. Para conectar o Facebook Messenger e o Instagram Direct (canais Meta), consulte Facebook e Instagram (Meta).

Tipos de conexão WhatsApp

O WhatsBlast suporta três formas de conectar um número. A disponibilidade de cada tipo depende do seu plano.

WhatsApp (Baileys)

Método padrão. Funciona como o WhatsApp Web: você escaneia um QR Code e o sistema se conecta ao WhatsApp do seu celular. Não exige aprovação do Meta nem conta business.

Vantagem	Limitação
Qualquer número funciona (pessoal ou empresarial)	O celular precisa ficar ligado e com internet
Configuração imediata — só escanear o QR	Se o celular desligar, a sessão cai e precisa reconectar
Sem custo extra por mensagem	Não é homologado pelo Meta (uso não oficial)
Suporte a todas as funcionalidades da plataforma	Risco maior em disparos em massa sem controle de intervalos

WhatsApp (wuzAPI)

Alternativa ao Baileys, também baseada em QR Code, mas usa uma camada de API intermediária que oferece mais estabilidade em alguns ambientes. O processo é idêntico para o usuário: escaneia o QR e conecta.

Vantagem	Limitação
Maior estabilidade em determinados cenários de rede	Requer instância wuzAPI configurada no servidor
Boa alternativa se o Baileys apresentar quedas frequentes	Configuração mais técnica — feita pelo time de setup

WhatsApp (API Oficial)

A API Oficial do WhatsApp Business (WABA), homologada pelo Meta. Em vez de QR Code, você preenche as credenciais obtidas no painel do Meta (Phone Number ID, WABA ID, Send Token, Business ID, Phone Number). O número não precisa de celular ligado — roda em servidor 24/7.

Vantagem	Limitação
Homologado pelo Meta — menor risco de banimento	Requer aprovação e cadastro no Meta Business
Não depende de celular — funciona 24/7	Envio de mensagens ativas exige templates aprovados pelo Meta
Suporte a alto volume de mensagens	Mensagens ativas têm custo por conversa (cobrado pelo Meta)
Grupos e Fluxo padrão não disponíveis neste tipo	Processo de aprovação pode levar dias

Qual escolher? Para a maioria dos negócios, o Baileys resolve bem — é imediato e sem burocracia. Use a API Oficial quando precisar de estabilidade máxima, selo do WhatsApp Business ou quando o volume de mensagens for muito alto.

	Baileys	wuzAPI	API Oficial
Conexão via QR Code	✅	✅	❌ (credenciais Meta)
Precisa de celular ligado	✅	✅	❌
Homologado pelo Meta	❌	❌	✅
Grupos / Importação de histórico	✅	✅	❌
Templates de mensagem ativa	❌	❌	✅

A tela de Conexões

Painel de resumo

No topo da tela há 4 cards de resumo em tempo real: Total de conexões, Conectadas, Desconectadas e Aguard. QR.

Tabela de conexões

Coluna	O que mostra
Conexão	Ícone do tipo + nome dado à conexão + tipo (ex: WhatsApp (Baileys)).
Número	Número de telefone formatado.
Status	Badge colorido com o estado atual da sessão.
Sessão	Botão de ação de sessão (varia por status).
Atualização	Data/hora da última mudança na conexão.
Padrão	Badge "Padrão" se esta for a conexão padrão da empresa.
Ações	Editar, sincronizar templates (API Oficial), migrar, excluir.

Botões do cabeçalho

Reiniciar Conexões — reinicia todas as sessões ativas simultaneamente. Útil quando várias conexões estão com instabilidade.
Chamar Suporte — abre o WhatsApp do suporte (aparece quando configurado).
Nova Conexão (somente admin) — abre um menu dropdown com os tipos disponíveis no seu plano.

Status da conexão

Status	Cor	Significado	Ação disponível
Conectado	Verde	Tudo funcionando normalmente.	Desconectar
Aguard. QR	Amarelo	QR gerado, aguardando leitura.	QR Code (abre modal)
Desconectado	Vermelho	Sessão encerrada.	Tentar novamente / Novo QR
Conectando	Azul	Inicializando — aguarde.	— (botão desabilitado)
Timeout	Laranja	Sessão expirou sem resposta.	Desconectar e reconectar
Pareando	Laranja	Emparelhamento em andamento.	Desconectar

Criar uma nova conexão

Baileys e wuzAPI (QR Code)

Clique em "Nova Conexão" e escolha o tipo Selecione WhatsApp (Baileys) ou WhatsApp (wuzAPI) conforme seu plano.

Preencha o nome e salve Dê um nome identificável (ex: WhatsApp Suporte). Configure as demais abas conforme necessário e clique em "Salvar".

Escaneie o QR Code Clique em "QR Code" na linha da conexão (status Aguard. QR). No WhatsApp do celular: Configurações → Aparelhos conectados → Conectar aparelho. Aponte para o QR exibido na tela.

Aguarde "Conectado" O badge fica verde e o número é confirmado na tabela.

Celular sempre ligado O Baileys e o wuzAPI dependem da sessão do WhatsApp Web. Se o celular perder internet ou bateria, a sessão cai e você precisará reconectar com um novo QR Code.

WhatsApp (API Oficial)

Clique em "Nova Conexão" → "WhatsApp (API Oficial)"

Preencha as credenciais da Meta (aba Geral)

Phone Number ID — ID do número no painel Meta
WABA ID — ID da conta WhatsApp Business
Send Token — token de envio (Bearer token da API)
Business ID — ID do negócio no Meta
Phone Number — número de telefone completo com DDI

Salve para gerar o Callback URL Após salvar, o campo Callback URL é preenchido automaticamente. Copie e configure como Webhook no painel de desenvolvedor da Meta, junto com o Verify Token gerado.

Confirme o status "Conectado" Quando as credenciais estiverem corretas e o webhook configurado, a conexão fica ativa.

Configurações da conexão (modal de edição)

Clique no ícone de editar (lápis) em qualquer conexão para abrir o modal de configuração. Ele possui até 7 abas, dependendo do tipo de conexão e do plano:

Geral — nome, grupos, importação, redirecionamento
Integrações — filas, integrações externas, prompt de IA
Mensagens — mensagens automáticas e férias coletivas
Chatbot — comportamento automático e inatividade
Avaliações — NPS / pesquisa de satisfação (se ativado)
Fluxo Padrão — flows automáticos por contexto (se plano incluir integrações)
Templates (Meta) — somente para API Oficial

Aba: Geral

Campo	Descrição
Nome	Identificação da conexão. Ex: WhatsApp Vendas. Obrigatório.
Conexão padrão	Toggle. Marca esta conexão como padrão — usada em envios que não especificam a conexão (ex: agendamentos sem conexão definida).
Cor	Cor personalizada para identificar visualmente esta conexão no painel. Clique no quadradinho de cor para escolher no seletor. Ajuda a diferenciar rapidamente cada número quando você tem várias conexões.
Permitir grupos (não disponível na API Oficial)	Toggle. Quando ativado, mensagens recebidas em grupos do WhatsApp também criam tickets.
Grupos como ticket (não disponível na API Oficial)	Select: Desabilitado ou Habilitado. Quando habilitado, cada mensagem de grupo cria ou reabre um ticket nessa conexão.
Token da conexão	Token único gerado automaticamente para esta conexão. Usado em integrações externas que precisam identificar esta conexão via API. Clique em ↻ para gerar um novo token e em ⎘ para copiar.

Redirecionamento automático de fila

Permite redirecionar automaticamente o cliente para uma fila específica após um tempo sem selecionar uma opção no menu do chatbot.

Campo	Descrição
Fila de redirecionamento	Fila de destino quando o tempo esgotar sem interação.
Tempo de redirecionamento (minutos)	Quanto tempo aguardar antes de redirecionar. Coloque 0 para desativar.

Importar histórico de mensagens (não disponível na API Oficial)

Ao ativar o toggle "Importar histórico de mensagens", você pode trazer para o sistema conversas antigas desse número que ocorreram antes de conectar ao WhatsBlast.

Campo	Descrição
Incluir grupos	Toggle. Importa também mensagens de grupos.
Fechar tickets importados	Toggle. Fecha automaticamente todos os tickets criados pela importação.
Data inicial	A partir de quando importar as mensagens.
Data final	Até quando importar as mensagens.
Fila para tickets importados	Fila que receberá os tickets criados pela importação.

Atenção na importação Ao salvar com a importação ativada, o sistema desconecta e reconecta a sessão para processar o histórico. O progresso aparece como uma barra de progresso na tela de Conexões. Use datas próximas — importar anos de histórico pode demorar muito.

Aba: Integrações

Esta aba define o que acontece quando uma mensagem chega nesta conexão. As três opções são mutuamente exclusivas: ao selecionar uma, as outras são limpas automaticamente.

Campo	Disponível	Como funciona
Filas	Sempre	Selecione uma ou mais filas para distribuir os tickets. Quando o cliente envia uma mensagem, um ticket é criado e distribuído entre as filas selecionadas. Se a fila tiver chatbot (Bot) configurado, o menu de opções é enviado automaticamente. Se a fila tiver Integração vinculada, a integração externa é acionada.
Integração	Somente se plano incluir Integrações	Aciona uma integração externa (n8n, Typebot, Dialogflow, Webhook ou Flow Builder) diretamente na chegada da mensagem, sem passar por filas. Configure as integrações em Integrações de Fila.
Prompt de IA	Somente se plano incluir IA (OpenAI/Gemini)	A IA responde automaticamente ao cliente com base no prompt configurado, sem passar por filas. Quando o cliente pede atendimento humano, o ticket é transferido para a fila definida no prompt. Configure os prompts em Prompts de IA.

Regra de exclusividade Você escolhe UM dos três: Filas, Integração OU Prompt de IA. Se você selecionar uma Fila, os campos Integração e Prompt são esvaziados — e vice-versa. Pense assim: Filas = atendimento humano com chatbot básico; Integração = automação externa (Typebot, n8n...); Prompt de IA = atendimento autônomo com IA.

Aba: Mensagens

Campo	Quando é enviada
Mensagem de boas-vindas	Enviada ao cliente quando o ticket é criado nessa conexão (primeira mensagem recebida ou novo ticket aberto). Você pode anexar uma imagem ou vídeo junto com essa mensagem (clique em "Adicionar imagem").
Mensagem de conclusão	Enviada automaticamente quando o ticket é encerrado (despedida).
Mensagem de férias coletivas	Enviada no período de férias coletivas configurado. Defina também a Data de início e a Data de fim das férias. Durante esse período, qualquer mensagem recebida dispara automaticamente esta resposta.

Aba: Chatbot

Controla o comportamento automático do chatbot e o encerramento por inatividade para esta conexão.

Comportamento do chatbot

Campo	Descrição
Tempo para criar novo ticket (minutos)	Se o mesmo contato mandar mensagem após esse tempo com o ticket fechado, um novo ticket é criado. Coloque 0 para criar novo ticket sempre que o ticket anterior estiver fechado.
Limite de uso do chatbot	Quantas vezes o menu do chatbot (bot da fila) pode ser exibido ao mesmo cliente em sequência. Evita loops infinitos. Ex: 3 = o menu aparece no máximo 3 vezes consecutivas.
Tempo de uso do chatbot (minutos)	Intervalo em minutos dentro do qual o limite acima é contado. Ex: limite 3, tempo 60 = o chatbot aparece no máximo 3 vezes em 60 minutos para o mesmo contato.

Encerramento por inatividade

Campo	Descrição
Encerrar ticket após (horas)	Fecha automaticamente o ticket se não houver nenhuma interação após esse número de horas. Coloque 0 para desativar o encerramento automático.
Encerrar a partir de	Define de qual mensagem a contagem começa: Última mensagem enviada — conta a partir da última mensagem enviada pelo atendente. Última mensagem recebida — conta a partir da última mensagem recebida do cliente.
Mensagem de aviso de inatividade	Texto enviado ao cliente antes de encerrar o ticket por inatividade (aviso prévio).
Tempo para aviso de inatividade (minutos)	Quantos minutos antes do encerramento o sistema envia a mensagem de aviso acima. Deixe em branco para não enviar aviso.
Mensagem de encerramento por inatividade	Texto enviado ao cliente no momento em que o ticket é encerrado por inatividade.

Aba: Avaliações (NPS)

Disponível somente quando a pesquisa de satisfação está ativada nas Configurações da empresa. Permite enviar uma pesquisa de avaliação automaticamente ao encerrar cada ticket.

Campo	Descrição
Mensagem de avaliação	Texto enviado ao cliente ao encerrar o ticket pedindo uma nota. Ex: "Como você avalia nosso atendimento? 1 – Ruim \| 2 – Regular \| 3 – Bom \| 4 – Ótimo \| 5 – Excelente"
Mensagem de agradecimento	Resposta automática enviada após o cliente dar a nota.
Máximo de envios da pesquisa	Quantas vezes a pesquisa pode ser enviada ao mesmo cliente no intervalo configurado.
Encerrar pesquisa após (minutos)	Fecha o ticket de pesquisa se o cliente não responder dentro desse tempo.

Aba: Fluxo Padrão

Disponível somente em planos com Integrações. Configura flows automáticos do Flow Builder para dois contextos específicos desta conexão:

Campo	Quando dispara
Fluxo de boas-vindas	Disparado apenas para novos contatos — pessoas que ainda não estão na lista de contatos da empresa e que mandam a primeira mensagem. O flow é executado antes de qualquer fila ou menu. Ideal para apresentação, coleta de dados ou segmentação inicial.
Fluxo de resposta padrão	Disparado quando o ticket está fechado e o cliente envia qualquer mensagem que não seja uma palavra-chave cadastrada em "Fluxo por palavra chave". Funciona como uma resposta automática fora do horário ou pós-atendimento.

Selecione "Desabilitado" em qualquer um deles para não usar o flow naquele contexto.

Aba: Templates (Meta) — somente API Oficial

Templates são mensagens pré-aprovadas pelo Meta para envio ativo ao cliente (quando a janela de 24h de atendimento está fechada).

Clique em "Sincronizar agora" para importar do painel Meta os templates aprovados para este número.
A lista exibe cada template com: nome, idioma, ID na Meta, status e categoria.
O botão "Enviar teste" envia o template para um ticket específico (informar o ID do ticket).

Templates precisam de aprovação prévia Crie e submeta os templates no Meta Business Suite. Somente templates com status "APPROVED" funcionam para envio ativo. Sincronize sempre que adicionar novos templates na Meta.

Como os recursos se encadeiam

Entender a ordem em que os recursos são acionados é fundamental para configurar bem a conexão:

Cliente envia mensagem A mensagem chega na conexão.

Fluxo de boas-vindas (se configurado e contato for novo) O flow de boas-vindas é executado antes de qualquer outra automação. Após o flow terminar, segue para o próximo passo.

O que está na aba Integrações define o caminho:

Filas configuradas → ticket é criado e distribuído. Se a fila tiver Bot (chatbot) → o menu de opções é enviado ao cliente. Se a fila tiver Integração vinculada → a integração (n8n, Typebot, etc.) é acionada para essa fila.
Integração direta → a integração externa é acionada sem criar ticket em fila.
Prompt de IA → a IA responde automaticamente. Se o cliente pedir atendimento humano, o ticket vai para a fila definida no prompt.

Mensagem de boas-vindas da conexão Se configurada na aba Mensagens, é enviada ao cliente na criação do ticket.

Atendimento em andamento O atendente assume o ticket. As regras de inatividade e encerramento automático (aba Chatbot) ficam monitorando.

Encerramento do ticket Ao encerrar: mensagem de conclusão é enviada (aba Mensagens). Se NPS ativado: pesquisa de satisfação é enviada (aba Avaliações). Ticket fica como fechado. Se o cliente mandar nova mensagem fora do horário: Fluxo de resposta padrão dispara (aba Fluxo Padrão).

Ações avançadas na tabela

Migrar mensagens (apenas Baileys/wuzAPI, somente admin)

O botão de migração (↔) aparece em conexões Baileys e wuzAPI. Permite mover todos os tickets e contatos de uma conexão para outra do mesmo número de telefone — útil quando você troca o tipo (ex: de Baileys para wuzAPI) e quer preservar o histórico.

Use com cuidado A migração é irreversível. Os dados são transferidos da conexão de origem para a de destino. A conexão de origem fica vazia após a migração.

Sincronizar templates (somente API Oficial)

O botão ↻ na linha da conexão sincroniza os templates aprovados diretamente da lista de conexões, sem precisar abrir o modal de edição.

Reconectar após desconexão

Verifique qual conexão está "Desconectado"

Clique em "Tentar novamente" O sistema tenta reiniciar a sessão. Se a sessão ainda existir no celular, reconecta automaticamente.

Se não conectar, clique em "Novo QR" Um novo QR Code é gerado. Escaneie com o celular normalmente.

Múltiplas conexões

O número de conexões disponíveis depende do seu plano. Cada conexão é completamente independente: filas, mensagens, chatbots, flows e integrações são configurados separadamente.

Exemplos de uso:

WhatsApp Suporte — fila Suporte com chatbot de triagem
WhatsApp Vendas — prompt de IA para qualificação inicial
WhatsApp Financeiro — conexão restrita a poucos atendentes

Conexão padrão Marque a conexão principal como "Padrão". Ela será usada automaticamente em funcionalidades que não pedem conexão específica (como alguns agendamentos e campanhas sem conexão definida).

Excluir uma conexão

Clique no ícone de lixeira. A sessão é encerrada e a configuração é removida. Os tickets e o histórico de mensagens são preservados, mas perdem a referência à conexão.