Manual do painel · Conta

Conexões: como conectar o WhatsApp oficial, Instagram, SMS, e-mail e o web chat

Conexões é a tela onde a conta liga os canais em que a IA atende: WhatsApp oficial da Meta (até vários números), Instagram, SMS, e-mail e o web chat do site, todos caindo no mesmo Inbox.

Quando aparece: Aparece para dono e administrador em toda conta. O cartão do Instagram só aparece com o canal Instagram habilitado na conta. A escolha entre número novo e o número que você já usa no celular aparece quando a conta tem os dois caminhos da Meta disponíveis; sem o cadastro pelo Facebook disponível, a tela mostra direto o formulário de credenciais.

Quem pode usar

PapelO que vê e faz
DonoConecta, renomeia, define a conta padrão, escolhe a persona de cada conta, troca provedor e desconecta.
AdminMesmo acesso do dono em todos os canais.
AtendenteNão vê o item no menu; abrir Conexões pelo endereço leva de volta ao Painel. O guia do WhatsApp abre para qualquer papel, e a tela de personalizar o web chat também abre, mas salvar a personalização é recusado para o atendente.

Telas

Conexões

A tela Conexões serve para conectar e administrar cada canal de atendimento da conta: ver as contas ligadas e o estado de cada uma, conectar o WhatsApp oficial, o Instagram, o web chat, SMS e e-mail, e desconectar quando for trocar.

Endereço no painel: /app/conexoes

A tela Conexões na conta de demonstração, com dados fictícios e os valores desfocados.

Onde a sua IA atende

O resumo dos canais WhatsApp, SMS, E-mail e Web chat, cada um com as contas conectadas. As conversas de todos caem no mesmo Inbox.

Botões e ações

Ações da conta ‹nome›
O botão de três pontos de cada conta: abre o menu com Definir como padrão, Renomear, Escolher persona e Desconectar.
Definir como padrão
Faz desta conta a que responde quando ninguém escolheu outra (conversas antigas, campanhas e cadências sem número definido). Não aparece na conta que já é a padrão.
Renomear
Abre o diálogo Renomear conta para dar um apelido (até 60 caracteres).
Escolher persona
Abre o diálogo para escolher qual persona atende por esta conta.
Desconectar
Abre a confirmação para derrubar esta conta e apagar as credenciais salvas.
Conectar ‹canal›
Aparece no canal sem nenhuma conta e rola até o formulário de conectar daquele canal.
Conectar outro número
No WhatsApp, rola até o formulário para conectar mais um número. Fica apagado quando não há vaga, com a frase Você já usa ‹n› de ‹n› contas. Desconecte uma para conectar outra.
Trocar ‹canal›
Nos canais de conta única (SMS, e-mail, web chat) já conectados, rola até o formulário que substitui a conexão.
Reconectar
Aparece quando a sincronização com o celular não terminou (número no celular): leva ao cartão Conectar WhatsApp para conectar de novo.
  • Placar ‹usadas› de ‹total› contas nos canais que aceitam mais de uma conta.
  • Canal vazio: Nenhuma conta conectada.
  • Cada conta mostra o apelido (ou o número), o selo Padrão, o selo no celular quando o número também segue no aplicativo, o número ou o provedor (via ‹provedor›) e Atende como ‹persona› (a persona da empresa quando ninguém escolheu outra).
  • Estado da conta: Conectada, Precisa de atenção, Aguardando a primeira mensagem ou Desconectada.
  • Avisos em laranja embaixo do apelido quando algo pede ação, por exemplo mensagens recusadas por assinatura inválida; eles somem sozinhos quando a situação volta ao normal.
  • Número no celular: A sincronização com o seu celular não terminou (com Reconectar) ou Trouxemos as mensagens mais recentes; o histórico mais antigo ficou de fora.

Cartão Instagram

Direct e comentários da conta profissional. O selo do canto diz o estado: Desconectado, Autorizando…, Aguardando o teste, ‹n› contas ativas, Reconectar, Permissão faltando, Conta em outra empresa, Limite do plano ou Não conectou.

Botões e ações

Conectar Instagram
Abre a autorização no site do Instagram, numa janela própria; a senha nunca passa pelo painel.
Conectar de novo
Reabre a janela de autorização se ela foi fechada sem querer.
Autorizar de novo
Quando faltou liberar uma permissão: refaz a autorização (deixe todas as permissões marcadas).
Tentar de novo
Refaz a autorização depois de um erro genérico.
Falar com o suporte
Quando a conta do Instagram já está conectada em outra empresa: abre um e-mail para o suporte.
A mensagem não chegou?
Abre as três causas mais comuns de o teste de conexão falhar.
Testar de novo
Reinicia a espera de 3 minutos pelo oi do teste de conexão.
Conectar outra conta
Autoriza mais uma conta de Instagram, quando há vaga.
Tornar padrão
Faz desta conta de Instagram a padrão do canal.
Escolher persona
Escolhe a persona que atende por esta conta de Instagram.
Reconectar
Aparece na linha amarela quando o Instagram recusou a renovação da autorização; refaz a autorização.
Desconectar
Abre a confirmação para desconectar a conta de Instagram.
Gatilhos e boas-vindas
Abre as telas do Instagram (gatilhos, boas-vindas, perguntas de abertura, stories, lives e moderação).
  • Convite: Conecte a conta profissional da sua empresa. Precisa ser conta Profissional (Business ou Criador de conteúdo).
  • Teste de conexão obrigatório: Falta um passo: prove que as mensagens chegam. Mande um oi no Direct de outro perfil; a tela mostra Escutando… ‹m:ss› restantes e confirma sozinha. Sem resposta em 3 minutos: Não recebemos sua mensagem.
  • Confirmado: Tudo certo. Seu Instagram está atendendo.
  • Cada conta mostra a foto do perfil (ou as iniciais), o nome, Conectada · autorização renova sozinha, Atende como ‹persona› e o selo Padrão.
  • Autorização vencida: linha amarela com A autorização venceu em ‹data›. Enquanto isso, nenhuma mensagem entra nem sai.
  • Sem vaga: Sua conta já usa as ‹n› conexões de Instagram do plano.

Conectar WhatsApp

O cadastro incorporado da Meta: você entra com a conta do Facebook da sua empresa, escolhe ou cria o número e pronto, sem copiar token. Com os dois caminhos disponíveis, a tela pergunta Como você quer conectar o WhatsApp? e compara lado a lado.

Campos e filtros

Phone Number IDobrigatório
O identificador que a Meta dá ao número.
Número exibido (opcional)
Só para reconhecer a linha na lista.
WABA ID (opcional)
Identifica a conta da Meta em que o número mora e, portanto, quem paga o modelo entregue. Em branco, o modelo não é debitado do saldo.
Access Tokenobrigatório
O token permanente gerado na Meta. Guardado e nunca reexibido.
App Secretobrigatório
A Chave Secreta do Aplicativo; valida cada mensagem que a Meta envia.
Verify Tokenobrigatório
Uma senha que você inventa e repete no webhook da Meta.

Botões e ações

Conectar um número novo
Caminho do número exclusivo da IA: abre o popup do Facebook. O número deixa de funcionar no aplicativo do celular.
Conectar o número que já uso no celular
Caminho em que o número segue no aplicativo WhatsApp Business e fala pelo painel ao mesmo tempo; o popup deve ser seguido no próprio celular.
Conectar com o Facebook (2 minutos)
O botão único quando só o caminho do número novo está disponível.
Ver o passo a passo deste caminho →
Abre o guia Conectar WhatsApp no roteiro do caminho escolhido.
O que mais muda
Expande os cuidados do número no celular: desligar as respostas automáticas do aplicativo, aparelhos vinculados, versão mínima do aplicativo e o que não aparece no extrato.
Modo avançado: colar credenciais da Cloud API
Expande o formulário manual, para quem já tem o aplicativo na Meta e as credenciais em mãos.
Veja o guia passo a passo →
Abre o guia Conectar WhatsApp.
Conectar
Envia as credenciais do formulário manual. Se o número for o mesmo de uma conta antiga, ela volta para a mesma linha, com o histórico.
  • Comparação dos caminhos: Um número novo, só para a IA (aplicativo no celular não usa, histórico começa do zero, listas de transmissão e grupos seguem funcionando, selo verde pode pedir, velocidade de disparo maior) e O número que você já usa (aplicativo continua funcionando, histórico vem junto, listas de transmissão desativadas pela Meta, a IA não enxerga grupos, selo verde não é concedido, velocidade menor e fixa).
  • Durante o cadastro o botão mostra Siga no popup do Facebook… e depois Concluindo conexão….
  • Formulário manual: Número conectado com sucesso. ou a frase do motivo da recusa (limite de contas, número já conectado em outra empresa).

Web chat no seu site

O chat próprio da plataforma, com a mesma IA atendendo os visitantes do site, sem provedor externo.

Campos e filtros

Código de instalação
O trecho para colar antes do fechamento do body em todas as páginas do site onde o chat deve aparecer.

Botões e ações

Ativar web chat
Liga o canal em um clique; não passa por aprovação.
Copiar
Copia o código de instalação (o botão mostra que copiou).
Personalizar web chat →
Abre a tela de cores, logo, textos e teste com a IA.
  • Em conta de parceiro com marca própria, enquanto o endereço do parceiro não está no ar: O código de instalação ainda não está disponível. O chat já atende; o código aparece quando o parceiro liberar.

Conectar SMS / Trocar provedor de SMS

Escolha o provedor em que você tem conta (Zenvia, Sinch, Comtele ou SMSDev). Um provedor por vez: o novo substitui o anterior.

Campos e filtros

Provedorobrigatório
Muda os campos pedidos logo abaixo.
API Token
Zenvia e Sinch.
Remetente (número ou palavra-chave)
Zenvia.
Service Plan ID
Sinch.
Número remetente
Sinch.
Chave de API (auth-key)
Comtele.
Identificador do remetente
Comtele.
Chave de API
SMSDev.
Webhook de recebimento (cole no painel do provedor p/ receber respostas)
Aparece com o canal ligado. Sem colá-lo no provedor, as respostas dos clientes não chegam ao Inbox.

Botões e ações

Copiar
Copia o endereço do webhook de recebimento.
Conectar ‹canal›
Salva as credenciais e liga o canal com o provedor escolhido.
  • As credenciais são armazenadas com segurança e nunca reexibidas.

Conectar E-mail / Trocar provedor de E-mail

Por API (SendGrid, Mailgun, Resend, Postmark) ou por SMTP, que cobre Amazon SES e qualquer outro servidor.

Campos e filtros

Provedorobrigatório
SMTP — Amazon SES e outros, SendGrid, Mailgun, Resend ou Postmark.
Servidor SMTP
SMTP.
Porta
SMTP.
Usuário SMTP
SMTP.
Senha SMTP
SMTP; nunca reexibida.
E-mail remetente
Todos os provedores.
API Key
SendGrid, Mailgun e Resend.
Domínio de envio
Mailgun.
Server Token
Postmark.

Botões e ações

Copiar
Copia o endereço do webhook de recebimento, que aparece com o canal ligado.
Conectar ‹canal›
Salva as credenciais e liga o e-mail.

Diálogo Desconectar ‹conta›?

A confirmação antes de derrubar uma conta. O texto muda: conta comum (para de receber e enviar na hora e apaga as credenciais), número no celular (o número segue no aplicativo) ou Instagram (as conversas ficam, os gatilhos param e a autorização continua do lado do Instagram).

Botões e ações

Desconectar conta
Confirma. As outras contas do canal seguem atendendo.
  • Se era a conta padrão: Esta é a conta padrão do canal. A mais antiga entre as que sobrarem assume, e o aviso de confirmação diz qual.
  • Erro: Não foi possível desconectar. Tente novamente. O diálogo só fecha quando deu certo.

Diálogo Renomear conta

O apelido aparece na lista de contas, no Inbox e no cartão do funil.

Campos e filtros

Nome da contaobrigatório
Até 60 caracteres, como a equipe chama o número.

Botões e ações

Salvar nome
Grava o apelido.

Diálogo Quem atende em ‹conta›?

Cada conta pode ter a própria persona, o que permite duas marcas ou duas franquias no mesmo painel.

Campos e filtros

Persona desta conta
Persona da empresa (padrão) ou uma persona ativa. Vinculando uma variante, o teste A/B continua sorteando entre as personas desta conta.

Botões e ações

Salvar persona
Grava o vínculo; a linha da conta passa a dizer Atende como ‹persona›.
Tentar de novo
Aparece quando a lista de personas não carregou.
  • Sem persona ativa: a tela pede para criar ou reativar uma em Personas A/B.

Estados da tela

Carregando
Quatro blocos cinzas no lugar dos canais.
Se der erro
Não foi possível carregar os seus canais, avisando que isso não quer dizer que eles estão desconectados e pedindo para não refazer a conexão antes de conseguir ler a tela, com Tentar de novo.
Nenhum canal conectado
Cada bloco diz Nenhuma conta conectada e oferece Conectar ‹canal›.
Volta da autorização do Instagram
O cartão do Instagram mostra Confirmando a autorização com o Instagram… e, em seguida, o teste de conexão.

Conectar WhatsApp

A tela Conectar WhatsApp é o guia passo a passo para ligar o WhatsApp oficial da Meta ao painel: criar o aplicativo na Meta, gerar o token permanente, cadastrar o webhook e colar tudo em Conexões, ou manter o número que já está no celular.

Endereço no painel: /app/conexoes/guia · Quem usa: Dono, Admin, Atendente

A tela Conectar WhatsApp na conta de demonstração, com dados fictícios e os valores desfocados.

Como chegar: Em Conexões, pelo link Veja o guia passo a passo → do cartão Conectar WhatsApp ou por Ver o passo a passo deste caminho → de cada caminho (o do número no celular abre o roteiro próprio).

Conectar seu WhatsApp ao painel

A abertura do roteiro de sempre: usa a API oficial do WhatsApp, leva cerca de 30 minutos na primeira vez e termina com os códigos colados em Conexões.

Botões e ações

Agendar com o suporte
Abre um e-mail para marcar uma chamada em que a equipe faz o processo com você. Não aparece em conta de parceiro com marca própria.
Conexões
Link que volta à tela Conexões.
Copiar
Cada endereço e permissão do guia é um botão que copia o texto (developers.facebook.com, business.facebook.com/settings, as permissões e o endereço do webhook).

Os oito passos

Cada passo tem um quadro que imita a tela da Meta.

  • 1. Crie o app no painel da Meta: caso de uso Conectar-se com os clientes pelo WhatsApp, vinculado ao Business da empresa.
  • 2. Anote os dois IDs: Phone Number ID e WhatsApp Business Account ID (WABA).
  • 3. Gere o token permanente (não use o da Etapa 1!): usuário do sistema Administrador, ativos com controle total, expiração Nunca e as permissões whatsapp_business_messaging e whatsapp_business_management.
  • 4. Copie o App Secret: Configurações do app, Básico, Chave Secreta do Aplicativo.
  • 5. Envie os modelos de mensagem para aprovação: retomada_conversa e boas_vindas, com os textos sugeridos.
  • 6. Cadastre o webhook: a URL de retorno que o guia mostra, o mesmo Verify Token e o campo messages assinado.
  • 7. Cole tudo na tela Conexões e mande um oi de outro celular.
  • 8. Quando for usar o número oficial da empresa: o número sai do aplicativo do celular; número fixo pode ser verificado por ligação de voz.

Preciso verificar minha empresa na Meta?

Para começar, não: sem verificação a IA atende sem limite quem chama; o limite vale para as conversas que você inicia com modelos.

Botões e ações

Abrir em tamanho real
Cada print real da Meta abre em tamanho real numa aba nova.
  • Onde verificar (Central de segurança, Iniciar verificação), os documentos aceitos no Brasil e o prazo usual.
  • Como é o passo a passo (telas reais da Meta): seis prints, da Central de Segurança ao selo Aprovado.

Conectar o número que você já usa no celular

O roteiro do caminho em que o mesmo número segue no aplicativo WhatsApp Business e fala pelo painel.

  • 1. Confira o aplicativo no celular: WhatsApp Business 2.24.17 ou mais novo, no aparelho principal do número.
  • 2. Desligue as respostas automáticas do aplicativo: Mensagem de saudação e Mensagem de ausência.
  • 3. Saiba o que acontece com os aparelhos vinculados: todos são desconectados; Windows e relógios não voltam a funcionar.
  • 4. Conecte pelo botão, no próprio celular.
  • 5. Mande um “oi” de outro número: o que você responde pelo celular aparece no painel como Enviada pelo celular.
  • O que muda neste caminho: listas de transmissão, grupos, selo verde, velocidade de disparo, dependência do aparelho e o que sai do celular.

Personalizar web chat

A tela Personalizar web chat serve para deixar o chat do site com a cara da empresa (cores, logo, textos e o que perguntar antes da conversa), ver a prévia ao vivo e conversar de verdade com a própria IA antes de instalar.

Endereço no painel: /app/conexoes/webchat · Quem usa: Dono, Admin, Atendente

A tela Personalizar web chat na conta de demonstração, com dados fictícios e os valores desfocados.

Como chegar: Em Conexões, no cartão Web chat no seu site, pelo link Personalizar web chat →.

Aparência

Campos e filtros

Cor principal
Seis cores prontas, o seletor de cor livre e o campo do código hexadecimal.
Posição na tela
Canto direito ou Canto esquerdo.
Tema
Automático (segue o visitante), Claro ou Escuro.
Arredondamento dos cantos: ‹n›px
Régua de arredondamento dos cantos da janela do chat.
Logo (aparece no cabeçalho — até 150KB)
PNG, JPEG, SVG ou WebP. Arquivo maior é recusado com aviso.

Botões e ações

Cor ‹código›
Cada amostra pronta aplica aquela cor.
Cor personalizada
Abre o seletor de cor do navegador.
Cor em hexadecimal
Campo para digitar a cor no formato #RRGGBB.
Degradê na cor (recomendado)
Liga ou desliga o degradê na cor principal.
Remover
Tira o logo atual.

Textos

Campos e filtros

Título do chat
O nome no topo da janela do chat.
Saudação inicial
A primeira frase que o visitante vê.
Mensagem fora do horário de atendimento
O que o chat diz fora do horário.

Antes da conversa

O que o visitante informa antes de falar com a IA, sempre com o consentimento da LGPD.

Campos e filtros

Texto do consentimento
A frase que o visitante aceita antes de começar.

Botões e ações

Pedir nome
Pede o nome antes da conversa.
Pedir e-mail
Pede o e-mail antes da conversa.
Pedir WhatsApp/telefone
Pede o telefone antes da conversa.
Som de notificação
Liga o som quando chega resposta.
Selo da plataforma no rodapé
Mostra ou esconde o selo no rodapé do chat. Não aparece em conta de parceiro com marca própria (lá o selo fica sempre desligado).
Salvar personalização
Grava tudo; o site passa a mostrar o chat novo.

Prévia ao vivo

O próprio chat, o mesmo arquivo que vai para o site, ao lado do formulário.

Botões e ações

Aparência
Mostra como o visitante vai ver o chat, com respostas de exemplo, para ajustar o visual.
Conversar com a IA
Abre uma conversa de verdade com a sua IA (persona, base e perguntas de qualificação). Usa o saldo e aparece no Inbox como Teste do painel.
Recomeçar
Abre outra conversa de teste do zero, como um cliente novo chegando.
  • Se o teste não abrir: Não foi possível abrir a conversa de teste agora. Confira se o web chat está ativo em Conexões.

Estados da tela

Carregando
Um bloco cinza no lugar do formulário.
Sem nada ainda
O web chat ainda não está ativo. com o link Ative na tela de Conexões →.
Se der erro
Não foi possível carregar o seu web chat, avisando que isso não quer dizer que ele está desativado e que a personalização segue salva, com Tentar de novo.
Algum valor salvo não é aceito pelo chat
Aviso Estes campos não estão sendo aplicados no seu site: com os campos (cor fora do formato, logo grande demais ou texto com marcação); os visitantes veem o padrão até corrigir e salvar.

Passo a passo

Como conectar o WhatsApp oficial

  1. No menu, abra Conexões e role até o cartão Conectar WhatsApp.
  2. Se a tela perguntar como conectar, escolha Conectar um número novo (número só da IA) ou Conectar o número que já uso no celular; se houver um botão só, clique em Conectar com o Facebook (2 minutos).
  3. No popup, entre com a conta do Facebook da sua empresa, escolha ou crie o número e conclua.
  4. Espere o botão sair de Concluindo conexão…: a conta aparece em Onde a sua IA atende como Conectada.
  5. De outro celular, mande um oi para o número e confira se a conversa aparece no Inbox em segundos.
  6. Nos três pontos da conta, clique em Renomear e dê um apelido.

Como conectar o número que você já usa no celular

  1. No celular, atualize o WhatsApp Business e desligue a Mensagem de saudação e a Mensagem de ausência.
  2. Em Conexões, no cartão Conectar WhatsApp, abra O que mais muda e leia os cuidados.
  3. Clique em Conectar o número que já uso no celular e siga o popup no próprio celular, com o aplicativo aberto.
  4. A conta aparece com o selo no celular; vincule de novo os aparelhos que caírem.
  5. Para o roteiro completo, use Ver o passo a passo deste caminho →.

Como conectar o WhatsApp pelo modo avançado (credenciais da Cloud API)

  1. Siga o guia Conectar WhatsApp (link Veja o guia passo a passo →) para criar o app, gerar o token permanente e cadastrar o webhook na Meta.
  2. Em Conexões, abra Modo avançado: colar credenciais da Cloud API.
  3. Preencha Phone Number ID, WABA ID (opcional), Access Token, App Secret e Verify Token.
  4. Clique em Conectar e espere Número conectado com sucesso.

Como conectar o Instagram ao painel

  1. Confirme que a conta do Instagram é Profissional (Empresa ou Criador de conteúdo).
  2. Em Conexões, no cartão Instagram, clique em Conectar Instagram e autorize no site do Instagram com todas as permissões marcadas.
  3. De volta ao painel, mande um oi no Direct da conta a partir de outro perfil enquanto a tela mostra Escutando….
  4. Ao aparecer Tudo certo. Seu Instagram está atendendo., use Gatilhos e boas-vindas para configurar o que acontece depois.

Como ativar e instalar o web chat no seu site

  1. Em Conexões, no cartão Web chat no seu site, clique em Ativar web chat.
  2. Clique em Copiar ao lado do Código de instalação.
  3. Peça para quem cuida do site colar o código antes do fechamento do body em todas as páginas.
  4. Abra o site numa janela anônima e escreva: a conversa deve aparecer no Inbox marcada como web chat.

Como personalizar e testar o web chat com a IA

  1. Em Conexões, clique em Personalizar web chat →.
  2. Ajuste Cor principal, Posição na tela, Tema, o logo e os textos, olhando a prévia na aba Aparência.
  3. Em Antes da conversa, escolha o que pedir (Pedir nome, Pedir e-mail, Pedir WhatsApp/telefone) e revise o Texto do consentimento.
  4. Clique em Salvar personalização.
  5. Na aba Conversar com a IA, converse como um cliente; Recomeçar abre uma conversa nova.

Como escolher o número padrão e a persona de cada número

  1. Em Conexões, abra os três pontos da conta.
  2. Clique em Definir como padrão para que ela responda quando ninguém escolheu outra conta.
  3. Clique em Escolher persona, escolha em Persona desta conta e clique em Salvar persona.
  4. A linha passa a dizer Atende como ‹persona›.

Como conectar SMS ou e-mail com o seu provedor

  1. Em Conexões, role até o cartão de SMS ou de E-mail.
  2. Em Provedor, escolha o seu e preencha os campos que aparecem.
  3. Clique no botão de conectar do cartão.
  4. Com o canal ligado, clique em Copiar no Webhook de recebimento e cole no painel do provedor para receber as respostas.

Perguntas frequentes

O que significa o selo no celular na linha de um número?

Que o número foi conectado pelo caminho em que ele continua funcionando no aplicativo WhatsApp Business do celular e, ao mesmo tempo, fala pelo painel. Os números sem o selo são exclusivos da IA.

O que quer dizer Precisa de atenção ou Aguardando a primeira mensagem no estado da conta?

Aguardando a primeira mensagem é uma conta recém-conectada que ainda não recebeu nada. Precisa de atenção indica um problema que pede ação, e o motivo aparece em laranja logo abaixo do apelido.

A tela de Conexões deu erro ao carregar. Devo conectar de novo?

Não. O erro é de leitura da tela, não quer dizer que os canais caíram. Clique em Tentar de novo e só mexa nas conexões depois de conseguir ver a lista.

O atendente consegue conectar ou desconectar canais?

Não. Conexões é de dono e administrador: para o atendente o item não aparece e o endereço volta ao Painel. Ele atende normalmente as conversas que chegam por todos os canais no Inbox.

Vinculei uma persona a um número. O teste A/B continua?

Continua. Se a persona vinculada tiver variante, aquela conta segue sorteando entre A e B, só que entre as personas dela.

Por que o código de instalação do web chat não aparece para mim?

Em conta de parceiro com marca própria, o endereço em que o chat é publicado é definido pelo parceiro. Enquanto ele não estiver no ar, o chat já atende pelo teste do painel, mas o código fica indisponível; fale com o parceiro.

Por que o meu logo não aparece no chat do site?

Provavelmente o valor salvo não é aceito pelo chat, como um logo acima do limite. Personalizar web chat mostra o aviso Estes campos não estão sendo aplicados no seu site com o campo; corrija e salve.

Desconectei o número da matriz por engano. Perco as conversas?

Não. Conversas e contatos ficam; as conversas daquele número passam a ser atendidas pela conta padrão. Conecte o mesmo número de novo e ele volta para a mesma linha, com o histórico, desde que haja vaga.

Guia da Central de ajuda

Conexões

Ligar WhatsApp, Instagram, SMS, e-mail e o chat do seu site — e, no WhatsApp, até cinco números na mesma conta. É o primeiro passo de todos: enquanto nenhum canal estiver conectado, o painel funciona e não recebe nada.

Todo o resto do painel depende desta tela. Sem canal conectado, o Inbox fica vazio, a IA não tem com quem falar e as campanhas não têm por onde sair — não porque algo está quebrado, mas porque ninguém abriu a porta ainda.

Por qual canal começar

A decisão é de tempo, não de preferência. Os quatro canais têm custos de esforço muito diferentes:

WhatsApp — reserve 30 minutos
É o canal principal e o único que depende da Meta. Parte do caminho acontece dentro do painel deles e tem confirmação que demora o que demora. Faça num horário calmo, não entre duas reuniões.
Web chat — um clique
Não depende de terceiro nenhum. É a saída para ter um canal recebendo hoje, enquanto o WhatsApp anda.
SMS e e-mail — depois
Exigem conta prévia num provedor. Se você ainda não tem, isso vem antes do painel: sem credencial não há o que colar.

A tela por partes

Cada canal é um bloco, e dentro dele vêm as contas que você conectou. O WhatsApp aceita mais de uma; SMS, e-mail e web chat trabalham com uma conta por vez.

Na tela: Tela de Conexões com o bloco do WhatsApp mostrando dois números conectados e, abaixo, os blocos de SMS, e-mail e web chat. Um bloco por canal, uma linha por conta.

  1. Onde a sua IA atende: Cada canal fala direto com a conta que você conecta no provedor: a conta é sua, as credenciais são suas, e você pode sair quando quiser. Venha de onde vier, tudo cai no mesmo Inbox.
  2. Quantas contas você já usa: 2 de 5 contas é o placar do canal: quantos números estão conectados e quantos cabem. Cinco é o teto de fábrica do WhatsApp — se a sua operação precisar de mais, é só pedir ao suporte. O placar só aparece nos canais que aceitam mais de uma conta.
  3. O apelido e a conta padrão: O apelido é o nome que a sua equipe já usa — "Matriz — Vendas", "Filial Canoas" —, e é ele que aparece no Inbox e no cartão do funil. Padrão marca a conta que responde quando ninguém escolheu outra.
  4. O estado e o menu de três pontos: Conectada é o estado que você quer ver aqui. Quando algo precisar da sua atenção, o aviso vem em laranja embaixo do apelido, não neste selo. Os três pontos abrem Definir como padrão, Renomear e Desconectar.
  5. Conectar outro número: Leva ao formulário logo abaixo. Sem vaga, o botão fica apagado e a tela diz por quê, ali do lado: Você já usa 5 de 5 contas. Desconecte uma para conectar outra.
  6. SMS e e-mail, com o provedor à mostra: Cada bloco diz por qual provedor o canal está ligado — aqui, Zenvia e SendGrid. Se você não reconhece o provedor que aparece, alguém do time conectou outro: confira antes de disparar qualquer coisa.

Mais de um número de WhatsApp

Dá para conectar até cinco números de WhatsApp na mesma conta — matriz e filial, vendas e pós-venda, uma linha por marca. Todos caem no mesmo Inbox e, por padrão, com a mesma IA e a mesma base de conhecimento; o que muda é por qual porta a conversa entrou. Se você quiser separar, cada conta pode ter a sua própria persona e enxergar só os documentos que são dela.

A conversa responde pela conta que a recebeu
Quem escreveu para a filial recebe resposta pela filial — no celular do lead, é o mesmo chat de sempre. Por isso o mesmo lead pode ter duas conversas abertas aqui dentro, uma por número: no aparelho dele também são dois chats.
O apelido é seu
Até 60 caracteres, em Renomear. Sem apelido, a lista mostra o número — o que funciona, mas não diz nada para quem está olhando o Inbox às pressas.
A conta padrão é a reserva
Ela responde pelo que não tem conta escolhida: conversas antigas, campanhas sem número definido, cadências que ainda não têm conversa aberta. Trocar a padrão é um clique em Definir como padrão.
Cada conta pode atender com a sua persona
A linha da conta diz Atende como… — a persona da empresa quando ninguém escolheu nada (o padrão), ou o nome da persona vinculada. Para trocar, use Escolher persona no menu da conta. Vale para números de WhatsApp e para contas de Instagram, e é o que permite duas marcas no mesmo painel — ver Personas A/B e Base de conhecimento.
Cada número tem os seus modelos
Os textos aprovados vivem na conta da Meta de cada número. É por isso que a campanha pergunta o número antes do modelo — ver Modelos de mensagem.

Onde a escolha aparece: no Inbox e no Funil como filtro, para você olhar só o que entrou por um número; em Campanhas e nas cadências como campo de envio, para decidir por onde a leva sai.

Conectar o WhatsApp

Na tela: Cartão Conectar WhatsApp com o botão de entrar pelo Facebook e, aberto abaixo, o modo avançado com os campos da Cloud API. O caminho curto em cima; os campos manuais só aparecem quando você abre o modo avançado.

  1. O caminho curto: Você entra com a conta do Facebook da sua empresa, escolhe (ou cria) o número e pronto — sem copiar código nenhum. É o caminho que quase todo mundo deve usar, e a conexão se renova sozinha.
  2. Modo avançado: Só abra se o aplicativo na Meta já existe e você tem as credenciais em mãos. Veja o guia passo a passo abre o roteiro completo sem tirar você do painel.
  3. Que número é este: O Phone Number ID é o identificador que a Meta dá ao número. O Número exibido é opcional e serve só para você reconhecer a linha na lista — o apelido, você escolhe depois, em Renomear.
  4. O WABA ID diz quem paga: É por este identificador que se sabe de quem é a conta em que o número mora — e, portanto, quem recebe a fatura do modelo entregue. Deixando em branco, nada é debitado do seu saldo por modelo. Ver Saldo & Recargas.
  5. Os segredos: Access Token, App Secret e Verify Token. Eles são guardados e nunca reexibidos — guarde-os onde você guarda senha. O Access Token colado aqui precisa ser o permanente, o assunto do próximo bloco.
  1. Prefira o caminho curto: Entrar com a conta do Facebook da própria empresa e escolher o número resolve tudo sem copiar credencial nenhuma. Só caia no Modo avançado se o aplicativo na Meta já existe e você tem as credenciais em mãos.
  2. Gere o token permanente: O token que a Meta mostra na primeira etapa expira em 24 horas. Esta é a causa número um de "conectou ontem, parou hoje". O guia da tela mostra exatamente onde gerar o que não expira.
  3. Mande uma mensagem de teste: De outro celular, para o seu número. Ela precisa aparecer no Inbox em segundos. Enquanto isso não acontecer, não considere conectado — mesmo que a linha esteja verde.
  4. Dê um apelido à conta: Nos três pontos, Renomear. Com dois números no ar, "+55 51 3333-0100" no alto da conversa não diz nada; "Filial Canoas" diz tudo.
  5. Aprove pelo menos um modelo: Fora da janela de 24 horas do WhatsApp só sai mensagem aprovada. Sem nenhum modelo pronto, você fica sem como reabrir uma conversa que esfriou. Veja Modelos de mensagem.

Manter o número que você já usa no celular

Existem dois caminhos para conectar o WhatsApp, e os dois são oficiais da Meta. A diferença é o que acontece com o número que você já usa: no caminho de sempre ele passa a ser exclusivo da IA e sai do aplicativo do celular; no segundo, ele continua funcionando no aplicativo e fala pelo painel ao mesmo tempo.

O segundo caminho resolve uma objeção, e é a mais comum: não perder o número que está na fachada, no cartão e no Google há cinco anos. Ele não resolve nenhuma outra — e o que custa está logo abaixo, porque saber disso depois é o que gera arrependimento no terceiro mês.

Listas de transmissão
A Meta as desativa ao entrar neste fluxo. Não é escolha nossa, e não dá para reverter pelo painel.
Grupos
Não sincronizam e não geram evento. A IA não enxerga grupo, e não vai enxergar.
Selo verde
A Meta não concede o selo a número que continua no aplicativo WhatsApp Business. Os dois são excludentes.
Velocidade de disparo
Menor, e fixa. Um número exclusivo da API envia mais rápido e sobe de patamar sozinho; este não.
Aparelhos vinculados
Todos são desconectados no processo e precisam ser vinculados de novo. Windows e relógios não voltam a funcionar: mensagem enviada por eles não chega até nós e não aparece no painel.
Dependência do celular
Desinstalar o aplicativo, trocar de aparelho, registrar o número de novo ou deixar o celular principal inativo por cerca de duas semanas derruba a conexão. Quando isso acontece, mandamos um e-mail e a conta aparece com um aviso amarelo na lista.

Quando você responde pelo celular, a mensagem aparece no painel com o rótulo Enviada pelo celular, e a IA para de responder naquela conversa por um tempo, para não falar por cima de você. Ela volta sozinha quando o prazo vence — você ajusta os minutos, e se ela volta sozinha, em Configurações.

Não existe trocar de modo depois. Ir do caminho de sempre para este exige o número voltar ao aplicativo; o contrário exige apagá-lo de lá. Nos dois casos é uma conexão nova, e por isso a tela nunca oferece um botão de trocar.

Ligar o chat do seu site

  1. Ative: Ativar web chat, um clique. Não passa por aprovação de ninguém.
  2. Cole o código no site: Aparece o Código de instalação. Ele vai antes do fechamento do </body>, em todas as páginas onde você quer o chat. Quem cuida do seu site faz isso em dois minutos.
  3. Deixe com a sua cara: Personalizar web chat abre cores, logo (até 150KB), saudação e o que perguntar antes de a conversa começar — com prévia ao vivo ao lado, então você vê o resultado antes de publicar. Na aba Aparência as respostas são de exemplo: ela serve para ajustar o visual.
  4. Converse com a sua IA, sem instalar nada: Na mesma tela, a aba Conversar com a IA abre uma conversa de verdade: a sua persona, a sua base de conhecimento e as suas perguntas de qualificação, respondendo ali mesmo. Dá para testar antes de colar o código em qualquer site — e antes de conectar o WhatsApp. A conversa aparece no Inbox como Teste do painel, recebe nota e entra no Funil como qualquer outra, e usa o saldo da conta. Recomeçar abre outra conversa do zero, como um cliente novo chegando.
  5. Teste como visitante: Com o código no site, abra-o numa janela anônima e escreva. A conversa tem que aparecer no Inbox, marcada como web chat.

Quanto você pergunta antes da conversa é uma escolha com consequência: pedir nome e telefone rende contato melhor e afasta parte dos visitantes; não pedir nada rende mais conversa e mais gente sem como retornar. Comece pedindo pouco e aperte depois, olhando o que chega em Base de contatos.

Conectar o Instagram

Conectado, o Direct da sua conta cai no Inbox como qualquer conversa, e a mesma IA atende. A conexão é feita no site do Instagram, numa janela própria — sua senha nunca passa pelo painel. Dá para conectar mais de uma conta, cada uma com o próprio apelido e a marcação de Padrão, como no WhatsApp.

  1. Abra o seu perfil no app do Instagram: Toque no menu ≡ no canto superior direito e entre em Configurações.
  2. Tipo de conta e ferramentas: Dentro de Conta, toque em Mudar para conta profissional.
  3. Escolha Empresa ou Criador de conteúdo: Os dois tipos funcionam. Escolha a categoria que melhor descreve o negócio.
  4. Conclua e volte ao painel: Pronto — agora o botão Conectar Instagram da tela de Conexões consegue autorizar a conta.

Ao autorizar, deixe marcadas todas as permissões que a tela pedir. Se alguma ficar desmarcada, a tela recusa e diz qual faltou — é só autorizar de novo com tudo marcado.

O teste de conexão do Instagram

Depois de autorizar, a conta fica aguardando o teste de conexão — e ele não é pulável, de propósito: uma conta que autorizou mas não recebe mensagem é uma conta quebrada, e o painel não vai chamá-la de conectada por otimismo. O teste é simples: de outro perfil (outro celular, ou alguém da equipe), mande um oi no Direct para a conta que você conectou. A confirmação aparece sozinha na tela, na hora em que a mensagem chegar — a espera é de até 3 minutos, com contagem.

  • Se a mensagem não chegar, quase sempre é uma destas três, nesta ordem: a chave “Permitir acesso a mensagens” desligada no app do Instagram (Configurações → Mensagens e respostas do story → Ferramentas conectadas); a conta autorizada não é a que recebeu o oi (confira o @); ou o Instagram levando alguns minutos no primeiro evento — teste de novo.
  • A autorização se renova sozinha todo dia. Se o Instagram recusar a renovação (senha trocada, acesso revogado por lá), a linha da conta fica amarela com um botão de Reconectar — e nesse meio tempo nenhuma mensagem entra nem sai.
  • Uma conta de Instagram só pertence a uma empresa no painel. Se ela já está conectada em outra, a tela recusa e nunca diz qual — se a conta é sua, o suporte resolve junto.

Desconectar, sem letra miúda: as conversas ficam no histórico — nada é apagado; nenhuma mensagem nova entra nem sai por aquela conta; e os gatilhos de comentário param na hora. O que a tela não tem como desfazer é a autorização do lado do Instagram: lá o app continua autorizado até você removê-lo em Configurações → Site e apps, no próprio Instagram.

SMS e e-mail

  • SMS: Zenvia, Sinch, Comtele ou SMSDev.
  • E-mail: SMTP (Amazon SES e outros), SendGrid, Mailgun, Resend ou Postmark.
  • Um provedor por vez em cada um destes canais — o novo substitui o anterior sem confirmação.
  • As credenciais são da sua conta no provedor e nunca são reexibidas depois de salvas. Guarde-as onde você guarda senha; se perder, gere de novo lá.

O aviso embaixo do apelido

Quando as mensagens que chegam por um número estão sendo recusadas na porta, a linha daquela conta ganha um aviso em laranja logo abaixo do apelido, dizendo o que está acontecendo e o que fazer. Hoje há um caso que produz esse aviso: mensagens chegando com assinatura inválida e sendo descartadas — o que quase sempre significa que o App Secret guardado aqui não é mais o que está no painel da Meta.

  • A conta continua marcada como Conectada e segue funcionando para todo o resto: ela envia, aparece nos filtros do Inbox e do funil e pode ser escolhida numa campanha. O que não está entrando são as mensagens recusadas.
  • O aviso só nasce depois de algumas recusas seguidas — uma mensagem estranha isolada não vira alarme.
  • Ele some sozinho assim que a primeira mensagem válida voltar a entrar. Não há botão de dispensar, e não precisa: ele é o retrato do que está acontecendo agora.
  • Renomear, definir como padrão e desconectar continuam disponíveis nos três pontos, como em qualquer conta.
  1. Confira o App Secret na Meta: No painel da Meta, em Configurações do app → Básico, a Chave Secreta do Aplicativo. É ela que precisa bater com a que está guardada aqui.
  2. Reconecte a conta: Cole o valor certo no formulário de conectar, no mesmo número. Ele volta para a mesma linha de sempre — não nasce conta duplicada e o histórico continua junto.
  3. Mande uma mensagem de teste: De outro celular, para aquele número. Ela chegando no Inbox, o aviso desaparece da linha por conta própria.

Se a Meta sinalizar queda de qualidade de um dos seus números, as campanhas daquele número são pausadas e as dos outros seguem rodando. A retomada é sua, quando o número se recuperar — ver Campanhas.

Desconectar e trocar de provedor

  • A tela pergunta antes, dizendo qual conta vai cair.
  • As outras contas do canal continuam atendendo — desconectar a filial não mexe na matriz.
  • Se a conta desconectada era a padrão, a mais antiga entre as que sobrarem assume o lugar, e a tela avisa qual foi.
  • As conversas que estavam com ela não somem: voltam a ser atendidas pela conta padrão.
  • Religar o mesmo número depois volta para a mesma linha de sempre — não nasce uma conta duplicada, e o histórico continua junto. Mas ele volta a ocupar uma vaga, então precisa haver vaga livre.
  • A persona vinculada e os documentos marcados para aquela conta ficam guardados: religando, ela volta atendendo do mesmo jeito, sem nada para refazer.

Uma verdade que evita surpresa: desconectar aqui encerra tudo do nosso lado — a conta cai na hora e as credenciais somem —, mas não desfaz nada do lado da Meta. No Gerenciador de Negócios, a conta do WhatsApp continua compartilhada com a plataforma (lá ainda aparece como conectada), e o número não volta sozinho para o aplicativo do celular. Se você quer remover a plataforma de verdade, o passo é seu, no painel da Meta: Gerenciador de Negócios → Contas do WhatsApp → remover o parceiro.

Vale para todos os casos: só administrador ou dono conecta, renomeia e desconecta — se os botões não aparecem para você, é o seu papel na conta, não um erro da tela.

O que custa

Nada nesta tela debita saldo. O que custa é a operação depois — cada mensagem processada pela IA, cada SMS, cada e-mail —, e isso está em Carteira. Já o modelo entregue pelo WhatsApp segue a conta em que o número está: conectando o seu próprio WhatsApp aqui, é a Meta que cobra você direto, no seu cartão, e a plataforma não cobra nada por cima. O mesmo vale para o provedor de SMS e o de e-mail que você contrata por fora.

Com mais de um número, quem cobra passa a depender de por qual deles a mensagem saiu — cada conta responde pela própria fatura. A tabela de preços da Carteira mostra o caso da conta padrão.

Quando a mensagem não chega

  • Conectou ontem, parou hoje. É o token de 24 horas. Gere o permanente pelo guia da tela e conecte de novo.
  • A mensagem de teste não aparece no Inbox. Confira o número mostrado na linha da conta: se não é o seu, você conectou o número errado.
  • Só um dos seus números parou. Olhe a linha daquela conta: se houver aviso em laranja embaixo do apelido, o motivo está escrito ali.
  • Falta metade das conversas no Inbox. Provavelmente há um filtro de conta ligado na lista — o marcador Todas o desliga.
  • Você manda SMS ou e-mail e a resposta some. O webhook de recebimento não foi colado no painel do provedor.
  • O chat não aparece no site. O código não está na página, ou está depois do </body>. Peça para conferirem a página inicial primeiro.
  • O campo de resposta trava numa conversa antiga. Isso não é conexão: é a janela de 24 horas do WhatsApp, e a saída é um modelo aprovado — veja Inbox.

Como é quando está bem

  • Cada conta em Conectada, com o número (ou o provedor) certo à vista.
  • Apelido em toda conta de WhatsApp, e a Padrão sendo a que você quer que responda por omissão.
  • Uma mensagem mandada de fora aparecendo no Inbox em segundos, e não em minutos.
  • Pelo menos um modelo aprovado, para conseguir reabrir conversa depois das 24 horas.
  • As credenciais do provedor guardadas fora do painel — porque aqui elas não são reexibidas.

No painel: Abrir Conexões. Se você só quer um canal no ar hoje, comece pelo web chat: é um clique.