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
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.