Central de Ajuda do Connect Bot

O Connect Bot conecta o WhatsApp de duas formas. Recomendamos a API Oficial para operações com clientes e volume relevante.

Cuidados com o QR Code

• Evite disparos em massa: a chance de banimento permanente do número é alta.
• Mantenha o celular ligado, com internet e com o WhatsApp ativo. Sem isso aparece o aviso Aguardando mensagem.
• Atualizações do WhatsApp podem desconectar a sessão. Nesse caso, leia o QR Code de novo.

No modo coexistência o número continua funcionando no app WhatsApp Business do celular e, ao mesmo tempo, no Connect Bot.

Antes de começar

• Número com o app WhatsApp Business instalado e o celular em mãos.
• Uma conta do Facebook para entrar na Meta.
• Usuário Administrador no Connect Bot. Se a opção de login com a Meta não aparecer, peça a liberação ao suporte da Connect Web.

Passo a passo

1. Acesse Administração › Canais e clique em Adicionar Canal.
2. Em Tipo de Canal, escolha WhatsApp OAuth e selecione o aplicativo Meta disponível na lista.
3. Clique em Conectar via WhatsApp OAuth. Uma janela da Meta abre; não feche até terminar.
4. Clique em Continuar, entre com o Facebook e escolha (ou crie) a conta do WhatsApp Business e o Gerenciador de Negócios.
5. Digite o número exatamente como está cadastrado no WhatsApp Business.
6. No celular, aceite a notificação da Meta e leia o QR Code ou aprove o compartilhamento de conversas.
7. Quando a janela fechar, o canal aparece como Conectado. Envie uma mensagem de teste e confira a aba Pendentes.

Para enviar campanhas e templates

Sem forma de pagamento você recebe e responde dentro da janela de 24 horas. Para mensagens ativas (templates, campanhas), cadastre um cartão no Gerenciador de Negócios da Meta, na área de cobrança da conta do WhatsApp Business.

Atenção: no modo coexistência não é possível fazer ligações. Denúncias e bloqueios por spam podem rebaixar a qualidade do número na Meta e levar à desconexão.

• A Meta cobra por mensagem entregue, e só pelas mensagens que você envia. Mensagens recebidas são gratuitas.
• O preço depende do país do destinatário e da categoria da mensagem.
• A cobrança é feita pela Meta, no cartão cadastrado no Gerenciador de Negócios. Não entra na fatura da Connect Web.

Janela de 24 horas

• Abre quando o cliente manda mensagem e reinicia a cada nova mensagem dele.
• Dentro da janela você responde com texto livre. Fora dela, só com template aprovado.

A Meta revisa os preços e as regras de gratuidade periodicamente. Confira os valores atuais na tabela oficial de preços do WhatsApp Business. No Connect Bot, o custo estimado aparece em Configurações › Integrações Meta › WhatsApp › Custos.

1. Acesse Administração › Canais e clique em Adicionar Canal.
2. Escolha o tipo Baileys (QR Code ou código de pareamento) ou WebJS (código de pareamento).
3. Dê um Nome ao canal e defina se ele será o Canal padrão para envios automáticos.
4. Configure os recursos que quiser (veja Recursos do canal) e salve.
5. Clique em Conectar no card do canal e leia o QR Code com o WhatsApp do celular, em Aparelhos conectados. Se não conseguir ler, use o código de pareamento.
6. Volte à edição do canal para definir as atribuições: ChatFlow (bot padrão), Fila e Usuário padrão.

Atenção: no Baileys você pode ativar Importar mensagem do aparelho para trazer o histórico do celular.

Ao criar ou editar um canal em Administração › Canais, você encontra estas opções:

Antes de começar

• Usuário Administrador no Connect Bot.
• Instagram: a conta precisa ser do tipo Business.
• Messenger: seu perfil pessoal do Facebook precisa ser administrador direto da Página. Acesso só pelo Gerenciador de Negócios não basta.

Messenger: dê acesso total à Página

1. No Facebook, troque para o perfil da Página e abra Configurações › Acesso à Página.
2. Em Pessoas com acesso do Facebook, clique em Adicionar novo, escolha seu perfil pessoal e conceda Controle total.
3. No seu perfil pessoal, aceite o convite nas notificações.

Criar o canal no Connect Bot

1. Acesse Administração › Canais › Adicionar Canal.
2. Escolha o tipo Instagram ou Facebook e selecione o aplicativo Meta (OAuth).
3. Clique em Conectar via Instagram OAuth ou Conectar via Facebook OAuth.
4. Na janela da Meta, entre com seu perfil pessoal, selecione a conta ou Página e conceda as permissões.
5. Quando a janela fechar, o canal aparece como Conectado.

Atenção: deixe a conta do Instagram Business logada em outra aba do mesmo navegador; assim a janela da Meta reconhece a conta automaticamente.

1. No Telegram, abra uma conversa com o @BotFather, envie /newbot e siga as instruções para dar nome e usuário ao bot.
2. Copie o token que o BotFather entrega no final.
3. No Connect Bot, acesse Administração › Canais › Adicionar Canal e escolha Telegram.
4. Cole o token, dê um nome ao canal e salve.
5. Envie uma mensagem para o bot no Telegram e confira se ela chega em Pendentes.

Você vai precisar

• Servidor e porta de envio (SMTP) e de recebimento (IMAP) do seu provedor.
• Usuário e senha da conta, ou senha de aplicativo se o provedor exigir (comum no Outlook/Office 365 com verificação em duas etapas).

Passo a passo

1. Em Administração › Canais › Adicionar Canal, escolha Email (IMAP/SMTP) e dê um nome (ex.: E-mail Comercial).
2. SMTP (envio): servidor (ex.: smtp.seudominio.com.br), porta 587 (TLS) ou 465 (SSL), usuário, senha, e-mail remetente e e-mail de resposta.
3. IMAP (recebimento): use o botão Detectar ou informe o host, porta 993 com TLS/SSL, usuário (botão Igual ao SMTP) e a caixa monitorada (padrão INBOX).
4. Defina o intervalo de verificação (recomendado: 30 segundos) e, se quiser, uma assinatura em HTML.
5. Salve e envie um e-mail de teste para a conta.

Atenção: se o seu e-mail estiver hospedado na Connect Web, use os dados de servidor do seu painel de hospedagem ou do Titan. Na dúvida, chame o suporte.

1. Em Administração › Canais › Adicionar Canal, escolha Webchat, dê um nome e confirme.
2. No card do canal, clique em Conectar e aguarde.
3. Clique nos três pontinhos do card e escolha Gerar Widget. Decida se as opções do chatbot aparecem como botões.
4. Copie o código JavaScript gerado. Use o botão Testar para conferir se a mensagem chega em Pendentes.
5. Envolva o código com <script> e </script> e cole no site.

Onde colar

• Uma página só (ex.: Elementor): adicione um bloco HTML na página e cole o código.
• Site inteiro (WordPress): use um plugin de snippets, como o WPCode, crie um snippet do tipo JavaScript com inserção automática no rodapé e ative.

Atenção: evite colar o código no campo genérico de rodapé de alguns temas; ele pode não salvar o script.

Esses canais também são adicionados em Administração › Canais › Adicionar Canal. Antes, o aplicativo de cada plataforma precisa estar configurado em Configurações › Apps. Com o canal conectado, perguntas, mensagens e comentários chegam à tela de atendimento como qualquer outra conversa.

Se precisar de ajuda para habilitar um desses canais na sua conta, fale com o suporte da Connect Web.

Acesse Atendimento › Atendimentos. A tela tem quatro áreas:

• Lista de conversas (esquerda): abas Abertos, Pendentes e Fechados, busca e filtros.
• Conversa (centro): histórico e barra de mensagem.
• Ações rápidas (topo direito): devolver à fila, resolver, transferir, galeria, busca.
• Detalhes do contato (ícone "i"): ficha do cliente, etiquetas, carteira, histórico e avaliações.

As abas

• Filtros: por status, período, fila, conexão, usuário, etiqueta e Kanban. Ficam salvos até você limpar.
• Ações › Selecionar múltiplos: fecha ou transfere várias conversas de uma vez.
• Ações › Iniciar conversa avulsa: manda mensagem para um número sem atendimento aberto.
• Ações › Organizar por não respondido: coloca no topo quem está esperando resposta.
• Privados / Grupos: alterna entre conversas individuais e grupos.
• Busca: por nome, telefone ou número do atendimento (#).
• Ao passar o mouse sobre uma conversa: fixar, marcar como não lida ou resolver.

Para exigir um motivo ao encerrar, o administrador ativa Forçar definição de demanda no fechamento em Configurações › Gerais.

• Clipe: envia imagem, vídeo, documento, vários arquivos, localização, contato e figurinha.
• Balão ou / + atalho: insere uma mensagem rápida.
• Assinatura: coloca o nome do atendente antes da mensagem.
• Microfone: grava mensagem de voz.

No menu de três pontinhos

• Reescrever com IA: deixa o texto Profissional, Simpático, de Marketing ou corrige a ortografia.
• Resumir conversa com IA: gera um resumo dos pontos principais.
• Copiloto: sugere respostas e analisa o sentimento do cliente.
• Criar nota: anotação interna, que o cliente não vê.
• Agendar mensagem: define data e hora para enviar depois.
• Multi-encaminhar: envia mensagens selecionadas a outros contatos.

Atenção: na API Oficial, uma faixa verde mostra quanto tempo resta da janela de 24 horas; a faixa azul avisa que é preciso usar template.

Na API Oficial você só envia texto livre até 24 horas depois da última mensagem do cliente. Depois disso, é preciso um template aprovado pela Meta.

Enviar um template na conversa

1. Na conversa, clique em ⋯ e escolha Templates.
2. Busque pelo nome ou filtre pela categoria e selecione o template.
3. Preencha as variáveis, se houver, e clique em Enviar Template.

Só templates com status APPROVED podem ser enviados. Quando o cliente responder, uma nova janela de 24 horas se abre.

Os limites de tamanho seguem as regras de cada canal (WhatsApp, Instagram, e-mail).

Acesse Atendimento › Contatos.

Cadastrar

1. Clique em + Adicionar Contato.
2. Informe Nome e Número com DDI e DDD, sem espaços (ex.: 5511999999999).
3. Opcional: e-mail, carteira, etiquetas e campos extras (botão Adicionar campo).
4. Salve.

Importar e exportar

• Importação Inteligente: arraste um arquivo CSV, XLS, XLSX ou TXT (até 30 MB) e confirme quais colunas são nome e telefone.
• Modelo CSV: baixe o modelo antes de montar a planilha.
• Exportar Contatos: baixa só os contatos visíveis na tela; aplique os filtros antes.

Utilitários

• Sincronizar contatos/grupos a partir do celular conectado.
• Remover duplicados.
• Verificar 9º dígito em números brasileiros.

A carteira liga o contato a um atendente fixo, que passa a receber as conversas dele. Combine carteira e etiquetas para montar listas, como “clientes inativos do vendedor João”.

1. Acesse Comunicação e Marketing › Mensagens Rápidas e clique em + Nova Mensagem.
2. Defina o Atalho, começando com / (ex.: /horario).
3. Escreva a mensagem. Use o menu Variáveis para inserir dados como {{name}}, {{greeting}} ou {{protocol}}.
4. Se quiser, anexe até 5 arquivos ou grave um áudio (ative Mensagem de Voz para enviar como voz).
5. Ative Mensagem pública para toda a equipe usar. Desligada, só você vê.
6. Escolha o tipo: Texto, Botões, Lista ou Template da API Oficial. Salve.

No atendimento, digite / e o atalho no campo de texto para inserir a mensagem.

Em Atendimento › Chat Privado a equipe conversa entre si sem sair do Connect Bot. O cliente não vê essas mensagens.

• Aba Usuários para falar com um colega; aba Equipes para falar com um setor. A bolinha verde indica quem está online.
• Envie texto, emojis, arquivos e áudio, ou gere um link de videoconferência.
• Use os ícones de telefone e câmera para chamadas de áudio e vídeo.

1. O administrador edita cada canal em Administração › Canais e ativa Habilitar Web Push.
2. Cada usuário aceita as notificações quando o navegador perguntar.
3. No celular, abra o painel no navegador e use Adicionar à tela inicial para ter um atalho com notificações.

Se a notificação não chegar

• Confira se a permissão de notificação está liberada no navegador ou no celular.
• Confirme que o canal está com Web Push ligado.
• Permaneça logado: ao sair, o aparelho para de receber avisos.
• No iPhone, desligue Foco e Não perturbe. No Android, deixe o navegador sem restrição de bateria.
• Para som, use o botão de som ao lado do sino no painel.

1. Acesse Comunicação e Marketing › Campanhas e clique em + Nova Campanha.
2. Informe nome, canal de envio, data e hora de início e o intervalo entre mensagens (padrão 20 segundos).
3. Se quiser, limite a janela de envio (horário) e o limite diário. O que não for enviado no dia continua no dia seguinte.
4. Escolha o público: contatos individuais, por etiqueta ou por estado (pelo DDD).
5. Escreva até 3 versões da mensagem (o sistema alterna entre elas). Use o botão IA para gerar o texto e Variáveis para personalizar.
6. Anexe imagem, vídeo ou PDF, se quiser, confira o Preview e crie a campanha.

No menu da campanha: ver contatos e status de cada envio, duplicar, baixar relatório em PDF ou CSV e excluir. Só campanhas pendentes podem ser editadas.

Atenção: intervalos abaixo de 15 segundos aumentam o risco de bloqueio do número. Envie só para quem espera receber.

Acesse Comunicação e Marketing › Envio em Massa e escolha a aba:

Planilha CSV

• Uma linha por contato: número e depois as variáveis. Ex.: 5511999999999,Ricardo,vence amanhã.
• Números com código do país, sem espaços, parênteses ou traços.

Intervalo

Informe um mínimo e um máximo em segundos; o sistema sorteia um tempo entre eles para cada mensagem. Em grupos, use mais de 3 segundos.

Opções extras: Fechar ticket logo após o envio e Atribuir fila/usuário para quem responder.

1. Acesse Configurações › Integrações Meta › Templates, selecione a conexão e clique em Carregar WABAs.
2. Clique em Criar Template.
3. Nome em letras minúsculas, números e sublinhado (ex.: lembrete_pagamento), idioma e categoria (Marketing, Utility ou Authentication).
4. Monte o Corpo (obrigatório) e, se quiser, cabeçalho (texto, imagem, vídeo ou documento), rodapé e botões (resposta rápida, link ou ligação).
5. Use {{1}}, {{2}}… para variáveis, em ordem, sem pular números.
6. Confira a prévia e clique em Criar Template para enviar à Meta.

O status começa como Pending. Utility costuma ser aprovado em minutos; Marketing pode levar algumas horas. Templates Rejected precisam ser ajustados ou recriados.

Atenção: o nome do template não pode ser alterado depois de criado. Escolher a categoria errada pode atrasar ou impedir a aprovação.

Mesmo aprovado, a Meta pode reter ou atrasar templates em tempo real. As causas mais comuns:

• Muitas mensagens com pouca resposta dos destinatários.
• Disparos repetidos em pouco tempo, ou o mesmo template enviado várias vezes ao mesmo número (comum em testes).
• Muitos bloqueios ou denúncias de spam.
• Qualidade baixa do número no Gerenciador do WhatsApp.

O que fazer

• Em testes, responda à última mensagem recebida no número de teste; isso normaliza a entrega.
• Evite reenviar o mesmo template para quem não respondeu.
• Confira a qualidade do número no Gerenciador do WhatsApp e reduza a frequência se houver alerta.
• Se continuar, abra um chamado na Connect Web informando o template, o número e o horário do envio.

Em Comunicação e Marketing › Grupos você administra grupos em massa (conexão por QR Code):

• Criar grupos em massa: nome base, primeiro participante e quantidade.
• Listar IDs e participantes: necessários para disparos em grupos. Exporte para planilha.
• Modificar em massa: título, descrição, imagem e “somente admins”.
• Gerenciar participantes: adicionar, remover, promover ou rebaixar admin.
• Ban list e palavras proibidas: remove membros ou mensagens automaticamente.
• Saudação e despedida: mensagens automáticas com {nome} e {numero}.

Atenção: teste as alterações em um grupo antes de aplicar em todos.

Em Principal › Dashboard você acompanha:

• Total de atendimentos, demanda ativa (iniciada pela empresa) e receptiva (iniciada pelo cliente) e novos contatos.
• TMA (tempo médio de atendimento) e TME (tempo médio de espera).
• Gráficos por fila, por status, por canal e por período.
• Desempenho de cada atendente: pendentes, em atendimento, resolvidos, avaliação, TME e TMA.

Filtre por Hoje, 7, 30 ou 90 dias ou por um intervalo personalizado. O botão Personalizar reorganiza os gráficos.

Em Gestão Comercial › Relatórios (Administrador e Supervisor):

• Contatos criados por período, por etiqueta, por estado (DDD), por etapa do Kanban e por carteira.
• Atendimentos por parâmetros: status, conexão, fila, usuário, canal, tipo de demanda e valor.
• Produtividade diária de cada atendente.
• Resumo por usuário: pendentes, em atendimento e resolvidos.

Aplique os filtros, clique em Gerar Relatório e exporte em Excel ou CSV.

1. Acesse Gestão Comercial › Avaliações e abra a aba Configurações.
2. Para cada nota, defina o nome (ex.: 0 = Péssimo, 5 = Incrível) e a resposta que o cliente recebe.
3. Preencha as mensagens de agradecimento, de opção inválida e de reenvio, o tempo de espera pela resposta e a escala (0 a 3, 0 a 5 ou 0 a 10).
4. Ative Habilitar avaliações para enviar a pesquisa ao fechar cada atendimento.

Na aba Avaliações, filtre por data ou nota e abra a conversa de cada avaliação. Para enviar manualmente, abra Detalhes do contato › aba Atend. › Avaliação › Enviar.