# AttendTo — Manual completo do painel > Como usar a plataforma AttendTo por completo: cada menu, cada tela e cada > botão do painel da empresa e do portal do revendedor, quem pode usar (dono, > admin, atendente), o passo a passo das tarefas do dia a dia e as perguntas > frequentes. Resumo do produto: https://attendto.com.br/llms.txt · Para ler no navegador: > https://attendto.com.br/manual ## Sumário - [Primeiros passos: como entrar no painel, ativar a conta e preparar o primeiro dia de atendimento com IA](https://attendto.com.br/manual/primeiros-passos) - [Menu lateral, barra do topo e atalhos do painel: busca Ctrl K, notificações, tema escuro e perfil](https://attendto.com.br/manual/barra-do-topo) - [Painel: a visão geral do atendimento com IA no WhatsApp, em tempo real](https://attendto.com.br/manual/painel) - [Inbox: como atender, assumir e transferir conversas do WhatsApp com a IA](https://attendto.com.br/manual/inbox) - [Funil: quadro kanban de vendas com etapas, prazos, rodízio e ganho ou perdido](https://attendto.com.br/manual/funil) - [Follow-up: cadências automáticas que retomam o lead que parou de responder](https://attendto.com.br/manual/follow-up) - [CRM & Graph: lista de leads por temperatura, grafo de empresas e ficha do lead com BANT e jornada](https://attendto.com.br/manual/crm) - [Base de contatos: filtrar, importar planilha CSV, exportar e organizar contatos com etiquetas e LGPD](https://attendto.com.br/manual/base-de-contatos) - [Empresas: lista de empresas dos contatos, duplicatas prováveis e como unificar empresas repetidas](https://attendto.com.br/manual/empresas) - [Agenda: reuniões que a IA marca na conversa, lado a lado com o seu Google Agenda](https://attendto.com.br/manual/agenda) - [Handoff: a fila de transbordo da IA para atendimento humano, com o dossiê do lead](https://attendto.com.br/manual/handoff) - [Supervisão: como acompanhar as conversas e a carga de cada atendente](https://attendto.com.br/manual/supervisao) - [Tickets: o histórico de cada atendimento humano, do transbordo à resolução](https://attendto.com.br/manual/tickets) - [IA própria: conectar os modelos de IA da sua empresa (OpenAI, Anthropic, Google, Azure, Bedrock) e escolher quem faz cada tarefa](https://attendto.com.br/manual/ia-propria) - [Analytics: funil de conversão, conversão por canal, origem dos leads e consumo de saldo](https://attendto.com.br/manual/analytics) - [Revenue: ciclo de vendas, taxa de ganho por cliente ideal e motivos de perda](https://attendto.com.br/manual/revenue) - [Investimento → Venda: custo por lead, custo por venda e retorno de cada anúncio](https://attendto.com.br/manual/investimento) - [Pergunte à IA: objeções dos leads, qualificações e perguntas sobre os números da conta](https://attendto.com.br/manual/pergunte-a-ia) - [Monitor de sucesso: análise RFV de clientes, importação de pedidos e agentes de reativação](https://attendto.com.br/manual/monitor-de-sucesso) - [Personas A/B: teste duas versões da IA de atendimento e promova a que converte mais](https://attendto.com.br/manual/personas) - [Intent & catálogo: cadastre ofertas, respostas gravadas e veja a intenção de compra de cada lead](https://attendto.com.br/manual/intent-e-catalogo) - [Qualificação de leads com IA: públicos, perguntas BANT e nota de 0 a 100](https://attendto.com.br/manual/qualificacao) - [Base de conhecimento da IA: ensine sua empresa com texto, FAQ, site e arquivos](https://attendto.com.br/manual/base-de-conhecimento) - [Base avançada: memória da empresa, consultas ao seu sistema, webhooks de entrada e fluxos da IA](https://attendto.com.br/manual/base-avancada) - [Voz & tom: transcrição de áudios do WhatsApp e voz da IA para responder em áudio](https://attendto.com.br/manual/voz-e-tom) - [Modelos de mensagem do WhatsApp: criar template, escolher categoria e enviar para aprovação da Meta](https://attendto.com.br/manual/modelos-de-mensagem) - [Campanhas de WhatsApp: enviar modelo aprovado para um público da base, ver o custo antes e acompanhar a entrega](https://attendto.com.br/manual/campanhas) - [Saldo & Recargas: como recarregar por Pix, boleto ou cartão, ver o extrato e o plano](https://attendto.com.br/manual/saldo-e-recargas) - [Compliance: trilha de auditoria, LGPD, opt-out e direito ao apagamento dos leads](https://attendto.com.br/manual/compliance) - [Conexões: como conectar o WhatsApp oficial, Instagram, SMS, e-mail e o web chat](https://attendto.com.br/manual/conexoes) - [Instagram: gatilhos de comentário, IA nos comentários, boas-vindas no Direct e moderação](https://attendto.com.br/manual/instagram) - [Módulos: como ativar a Base de conhecimento avançada, o Revenue AI e outros complementos da conta](https://attendto.com.br/manual/modulos) - [Integrações: receber leads por API, avisar o seu CRM por webhook e devolver conversões à Meta](https://attendto.com.br/manual/integracoes) - [Configurações do painel: equipe, segmento, horário de atendimento, IA, marca e endereço próprio](https://attendto.com.br/manual/configuracoes) - [Central de ajuda do painel: guias de cada tela com imagens, busca e passo a passo](https://attendto.com.br/manual/central-de-ajuda) - [Acesso ao portal do revendedor: entrar, definir a senha e assinar o contrato de revenda](https://attendto.com.br/manual/revenda-acesso) - [Portal do parceiro de indicação: link de indicação, comissões e nota fiscal](https://attendto.com.br/manual/parceiro-de-indicacao) - [Visão geral da revenda: receita do mês, meta, saúde da carteira e repasses](https://attendto.com.br/manual/revenda-visao-geral) - [Sua marca: como montar o white label com nome, logo, cores e endereço próprio](https://attendto.com.br/manual/revenda-sua-marca) - [Carteira da revenda: criar conta de cliente, definir preço e reenviar o link de acesso](https://attendto.com.br/manual/revenda-carteira) - [Preços e margens da revenda: margem sobre o uso, margem por conta e mensalidade](https://attendto.com.br/manual/revenda-precos-e-margens) - [Módulos da revenda: como oferecer e habilitar módulos pagos para os seus clientes](https://attendto.com.br/manual/revenda-modulos) - [Repasses da revenda: conta de recebimento e extrato do que já caiu](https://attendto.com.br/manual/revenda-repasses) - [Conta de demonstração da revenda: apresente a plataforma com a sua marca](https://attendto.com.br/manual/revenda-demonstracao) ## Primeiros passos: como entrar no painel, ativar a conta e preparar o primeiro dia de atendimento com IA URL: https://attendto.com.br/manual/primeiros-passos Menu: Geral > Primeiros passos Primeiros passos reúne as telas de entrada do painel (entrar, recuperar a senha, aceitar convite, ativar a conta) e a ordem recomendada para deixar a IA atendendo no primeiro dia. Quando aparece: As telas de entrada, de recuperação de senha e de convite valem para todas as contas. A ativação em quatro passos existe só na conta montada pela proposta de um especialista; o link de ativação do parceiro, só na conta contratada por um parceiro; e Criar conta só aparece no endereço próprio de um parceiro que liberou o cadastro. ### Quem pode usar - Dono: Recebe o link da proposta (ou o link do parceiro), cria a senha, aceita os Termos, paga a primeira mensalidade e conecta os modelos de IA e o WhatsApp. É o único que convida pessoas para a equipe, em Configurações, seção Equipe. - Admin: Entra pelo link de convite que o dono enviou, cria a própria senha e passa a ver o painel com tudo o que o papel Admin alcança. Não convida outras pessoas. - Atendente: Entra pelo link de convite que o dono enviou e cria a própria senha. O menu chega sem os itens de administração da conta (cobrança, canais, configurações e outros). ### Telas #### Entrar A tela Entrar serve para acessar o painel com e-mail e senha, com código extra quando o aparelho é novo ou quando a conta tem verificação em duas etapas. Endereço no painel: `/login` ![Captura da tela Entrar. A tela Entrar serve para acessar o painel com e-mail e senha, com código extra quando o aparelho é novo ou quando a conta tem verificação em duas etapas.](https://attendto.com.br/prints-do-manual/primeiros-passos--entrar.png) A tela Entrar na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Pelo endereço do painel. Quem já está com a sessão aberta é levado direto para o Painel. No endereço próprio de uma empresa ou de um parceiro, a tela aparece com a logo, as cores e o nome dele. ##### Formulário de entrada O título é Bem-vindo de volta; abaixo vêm os campos e o botão. Campos e filtros: - **E-mail** (obrigatório): O e-mail com que você foi cadastrado ou convidado. - **Senha** (obrigatório): A sua senha. O ícone de olho ao lado mostra ou esconde o que foi digitado. - **Código de verificação**: Aparece só quando você entra por um aparelho novo: a plataforma envia um código de 6 dígitos para o seu e-mail e pede que você o digite aqui. - **Código do autenticador (2FA)**: Aparece só quando a conta tem verificação em duas etapas ligada: digite o código atual do app autenticador do seu celular. Botões e ações: - **Mostrar senha**: Mostra a senha digitada; o mesmo botão passa a se chamar Ocultar senha. - **Esqueci minha senha**: Abre a recuperação de senha por código no e-mail. Fica visível sempre, inclusive no endereço próprio de um parceiro. - **Entrar**: Confere os dados e abre o Painel. Enquanto confere, o botão mostra Entrando... - **Fale com um especialista**: Aparece na linha Ainda não é cliente? e leva ao formulário de contato com um especialista, que monta a proposta da conta. - **Criar conta**: Só no endereço próprio de um parceiro que liberou o cadastro: abre a tela Criar conta, na linha Ainda não tem conta?. Também aparece: - No computador, o lado esquerdo mostra uma prévia ilustrativa da IA qualificando um contato; no celular, um cabeçalho compacto faz esse papel. É decoração: o formulário é o mesmo. - No endereço próprio, a tela traz a marca da empresa ou do parceiro e uma linha sobre consentimento e LGPD no rodapé. ##### Estados da tela - Carregando: No endereço próprio, a tela fica em branco por um instante enquanto descobre de quem é a marca, para não mostrar outra identidade por engano. - Se der erro: Dados errados mostram Não foi possível entrar. Verifique suas credenciais. Se o serviço oscilar, aparece um aviso para tentar de novo em instantes, podendo usar o mesmo código. - Aparelho desconhecido: Enviamos um código para o seu e-mail — digite-o abaixo. O campo Código de verificação surge no formulário. - Conta com verificação em duas etapas: Digite o código do seu app autenticador para concluir. O campo do autenticador surge no formulário. - Código errado ou vencido: Código inválido ou expirado. Confira o e-mail ou reenvie (ou, no autenticador, confira o app e tente de novo). #### Esqueci minha senha A tela Esqueci minha senha serve para criar uma senha nova a partir de um código de 6 dígitos enviado ao e-mail da conta, sem precisar pedir ajuda a ninguém. Endereço no painel: `/esqueci-a-senha` ![Captura da tela Esqueci minha senha. A tela Esqueci minha senha serve para criar uma senha nova a partir de um código de 6 dígitos enviado ao e-mail da conta, sem precisar pedir ajuda a ninguém.](https://attendto.com.br/prints-do-manual/primeiros-passos--esqueci-a-senha.png) A tela Esqueci minha senha na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Pelo link Esqueci minha senha, logo abaixo do campo Senha na tela Entrar. ##### Passo 1: pedir o código Informe o e-mail da conta para receber o código. Campos e filtros: - **E-mail da conta** (obrigatório): Use o mesmo e-mail com que você entra no painel. Botões e ações: - **Enviar código**: Envia o código de 6 dígitos para o e-mail informado e leva ao passo seguinte. - **Voltar para o login**: Volta para a tela Entrar (linha Lembrou a senha?). Também aparece: - A resposta é a mesma para e-mail cadastrado e não cadastrado: a tela não revela quem tem conta. ##### Passo 2: digitar o código e a senha nova O código vale por alguns minutos e só pode ser usado uma vez; o prazo aparece na própria tela. Campos e filtros: - **Código de 6 dígitos** (obrigatório): O código que chegou no e-mail. Aceita só números. - **Senha nova** (obrigatório): Pelo menos 8 caracteres. - **Confirme a senha nova** (obrigatório): Repita a senha nova; as duas precisam ser iguais. Botões e ações: - **Redefinir senha**: Troca a senha e encerra todas as sessões abertas da conta. - **Usar outro e-mail**: Volta ao passo 1 para pedir o código em outro e-mail. - **Reenviar código**: Pede um código novo; o anterior deixa de valer. Logo depois de um envio o botão mostra uma contagem regressiva. - **Reenviar em ‹n›s**: A contagem até poder pedir outro código. ##### Passo 3: senha redefinida Confirma a troca e explica o que mudou. Botões e ações: - **Entrar com a senha nova**: Leva à tela Entrar. Também aparece: - Quem estava usando a conta em outro aparelho precisa entrar de novo, inclusive alguém que tivesse a senha antiga. - A verificação em duas etapas continua valendo: o app autenticador segue sendo pedido no login. ##### Estados da tela - Se der erro: Código errado ou vencido mostra Código inválido ou expirado. Confira o e-mail ou peça um código novo. Senhas diferentes mostram As duas senhas não coincidem. Muitas tentativas pela mesma rede pedem para aguardar alguns minutos ou trocar de conexão (os dados do celular servem). - Sem conexão: Não consegui falar com o servidor. Verifique sua conexão e tente de novo. #### Aceitar convite da equipe A tela Aceitar convite da equipe serve para a pessoa convidada pelo dono criar a própria senha e entrar no painel da empresa com o papel definido no convite. Endereço no painel: `/convite/‹…›` Como chegar: Pelo link que o dono copia em Configurações, seção Equipe, botão + Convidar, e envia à pessoa (por WhatsApp ou e-mail). O link vale por 7 dias. Funciona mesmo que outra conta esteja aberta no navegador. ##### Quem convidou e para quê Um quadro mostra o nome da empresa que convidou, o nome, o e-mail e o papel do convidado. Também aparece: - ‹Empresa› convidou você para a equipe. - Nome · e-mail · papel (Dono, Admin ou Atendente). - No endereço próprio da empresa, o topo traz a logo dela. ##### Criar a senha Campos e filtros: - **Crie uma senha** (obrigatório): Pelo menos 8 caracteres. - **Confirme a senha** (obrigatório): Repita a senha; as duas precisam ser iguais. Botões e ações: - **Criar conta e entrar**: Cria o acesso e abre o Painel já com a sessão iniciada. ##### Estados da tela - Carregando: Um indicador girando enquanto o convite é conferido. - Se der erro: Convite inexistente, vencido ou já usado mostra a frase que explica o caso, no lugar do formulário. Se o e-mail já tem conta, aparece Este e-mail já tem uma conta — entre pela tela de login. #### Sua proposta chegou A tela Sua proposta chegou serve para o responsável pela empresa abrir o link da proposta do especialista, conferir o que foi combinado e criar a senha da conta (passo 1 de 4 da ativação). Endereço no painel: `/ativar/‹…›` Como chegar: Pelo link que o especialista envia por e-mail ou WhatsApp depois de montar a proposta. O mesmo endereço também serve ao link do parceiro (tela Bem-vindo, logo abaixo); o tipo do link decide qual tela abre. ##### Cabeçalho da ativação Comum a todos os passos da ativação. Botões e ações: - **Falar com o especialista**: Abre o formulário de contato com o especialista que montou a proposta. Também aparece: - Ativação da conta · ‹empresa›. - O trilho dos 4 passos: Criar senha, Aceitar os Termos, Pagar e Ativar. No celular vira a barra Passo ‹n› de 4. ##### Criar a senha Olá, ‹nome›. Sua proposta chegou. A senha cria a conta e já abre a sessão. Campos e filtros: - **E-mail de acesso**: É o e-mail da proposta e não pode ser editado aqui. Para trocar, fale com o especialista. - **Senha** (obrigatório): Pelo menos 8 caracteres, com letras e números. As duas regras ficam marcadas conforme você digita. - **Repita a senha** (obrigatório): A mesma senha de novo. Botões e ações: - **Mostrar senha**: Mostra as duas senhas; o botão passa a ser Esconder senha. - **Criar senha e continuar**: Cria a conta e leva ao passo 2, os Termos de Uso, na tela Ativação da conta. Também aparece: - Regras visíveis: Pelo menos 8 caracteres e Letras e números. ##### Sua proposta O resumo do que foi combinado com o especialista, ao lado do formulário. Também aparece: - A data até quando a proposta vale. - A mensalidade e, se houver, o desconto com fidelidade. - A franquia de mensagens por mês e como o excedente é cobrado (quando a conta usa os seus modelos). - A implantação, cobrada uma vez com a primeira mensalidade, quando existe. - Base de conhecimento avançada incluída, quando faz parte da proposta. - Sua IA, seus modelos: você conecta os modelos que já contrata (conversa, busca e transcrição) e paga direto ao seu provedor. Ou, se a proposta usa a IA da plataforma, os créditos de IA incluídos por mês. - A fidelidade, quando existe, e a regra de saída antecipada. - Hoje você paga: a primeira mensalidade (e a implantação, se houver). Os valores aparecem na tela antes de qualquer pagamento. ##### Estados da tela - Carregando: Linhas cinzas no lugar do conteúdo enquanto a proposta abre. - Se der erro: Não foi possível abrir a proposta, com o botão Tentar de novo. - Proposta vencida: Esta proposta venceu em ‹data›. Cada proposta vale 15 dias. Os botões Pedir uma proposta nova (o especialista recebe o pedido e responde no seu WhatsApp em horário comercial, e a tela mostra Pedido enviado) e Falar com o especialista. - Link já usado ou incompleto: Este link não abre uma proposta, com Entrar na minha conta (para quem já criou a senha) e Falar com o especialista. #### Bem-vindo A tela Bem-vindo serve para o cliente de um parceiro abrir o link de ativação que recebeu, aceitar os Termos e criar a senha da conta que o parceiro já deixou pronta. Endereço no painel: `/ativar/‹…›` Como chegar: Pelo link de ativação que o parceiro envia (em geral pelo WhatsApp). A tela mostra o nome da sua empresa, não o da plataforma. ##### Criar a senha Bem-vindo, ‹nome›. A conta da ‹empresa› está pronta; você acessa com o e-mail mostrado. Campos e filtros: - **Sua senha** (obrigatório): Pelo menos 8 caracteres. O aviso fica vermelho enquanto faltar. - **Repita a senha** (obrigatório): As duas senhas precisam ser iguais. Botões e ações: - **Mostrar senha**: Mostra a senha digitada. - **Termos de Uso**: Abre os Termos de Uso em outra aba. - **Política de Privacidade**: Abre a Política de Privacidade em outra aba. - **Criar senha e entrar**: Só fica ativo com a senha válida, repetida e a caixa de aceite marcada. Cria o acesso, registra o aceite e abre o Painel. Também aparece: - Caixa de aceite: Li e aceito os Termos de Uso e a Política de Privacidade da plataforma que opera este atendimento, em nome desta conta. O aceite vem antes de usar a conta. ##### Estados da tela - Carregando: Blocos cinzas enquanto o convite é conferido. - Se der erro: Este link não funciona mais, com a explicação do motivo (ou um pedido para tentar de novo em instantes). #### Ativação da conta A tela Ativação da conta serve para concluir os passos 2 a 4 da conta montada pela proposta do especialista: aceitar os Termos, pagar a primeira mensalidade e conectar os modelos de IA e o WhatsApp. Endereço no painel: `/ativacao` Como chegar: Logo depois de criar a senha pelo link da proposta. Se você sair no meio, o Painel mostra Falta pouco para a IA começar a atender, com o botão Continuar a ativação; e a Carteira mostra a fatura em aberto com Pagar. Quem usa: Dono. ##### Passo 2: Termos de Uso A versão dos Termos própria da conta da proposta, com o trecho sobre a sua IA em destaque (marcado novo). Botões e ações: - **Baixar PDF**: Abre os Termos da proposta prontos para imprimir ou salvar em PDF, em outra aba. - **Li e aceito os Termos de Uso, versão de ‹data›**: A caixa de aceite. O aceite fica registrado com data, hora e o e-mail da proposta. - **Aceitar e continuar**: Só fica ativo com a caixa marcada. Registra o aceite e leva ao pagamento. ##### Passo 3: Pagamento da primeira mensalidade Escolha a forma de pagamento; a tela muda sozinha quando o banco confirmar. Botões e ações: - **Pix**: Confirma na hora. Mostra o QR Code e o código copia e cola na própria tela. - **Boleto**: Até 2 dias úteis para o banco avisar. - **Cartão**: Crédito, à vista. - **Copiar o código Pix**: Copia o código copia e cola do Pix. O código vale 30 minutos; depois, a tela gera outro. - **Gerar boleto**: Abre o boleto na página de pagamento, em outra aba. - **Pagar ‹valor› com cartão**: Abre o pagamento com cartão em outra aba; esta tela muda sozinha quando o banco confirmar. Também aparece: - O que você paga hoje: 1ª mensalidade, implantação (se houver) e o total. - Próxima cobrança: o valor e a data, mais o excedente se passar da franquia de mensagens. - Você pode desistir em até 7 dias depois do pagamento, com o valor devolvido. - Selo ao vivo: Aguardando o pagamento. Esta tela muda sozinha quando o banco confirmar. ##### Passo 4: Para ativar Pagamento confirmado. Faltam estes passos para a IA começar a atender os seus leads; a barra mostra ‹n› de ‹total› prontos. Botões e ações: - **Conectar ‹tipo de modelo›**: Abre a gaveta de conectar modelo da IA própria, já no tipo que falta (conversa, busca ou transcrição). Use a chave da sua conta no provedor. - **Abrir Configurações → Segurança**: Aparece quando falta a verificação em duas etapas, exigida para conectar e testar modelos. Depois de ativá-la, volte pelo Painel em Continuar a ativação. - **Conectar o WhatsApp**: Abre a janela da Meta para entrar com a conta do Facebook que administra o WhatsApp da empresa e escolher o número (leva uns 3 minutos). Também aparece: - Etiquetas de cada modelo: pronto (com marca de conferido) ou falta. Resposta em áudio é opcional e não segura a ativação. - Com a IA da plataforma na proposta, o item dos modelos aparece como pulado. - Pode fechar esta tela: o painel guarda onde você parou. ##### Sua conta está ativa Aparece quando os itens obrigatórios ficam prontos. Botões e ações: - **Ir para o painel**: Abre o Painel; a IA já responde os leads que chegarem no WhatsApp. Também aparece: - IA respondendo com os seus modelos: conversa, busca e transcrição (ou com os créditos da IA da plataforma). - A franquia de mensagens por mês e a data em que o ciclo renova. - Base de conhecimento avançada incluída, quando faz parte da proposta: comece subindo seus documentos. ##### Estados da tela - Carregando: Linhas cinzas enquanto a ativação carrega. - Se der erro: Não foi possível carregar a ativação, com o botão Tentar de novo. - Conta sem ativação pela proposta: Esta conta não tem ativação pela proposta. O painel da conta está no endereço de sempre, com o botão Ir para o painel. - Pagamento com cartão recusado: O pagamento não passou. O banco recusou a cobrança; nenhum valor foi cobrado. Tente outro cartão ou pague com Pix. - Conclusão recusada por fatura em aberto: A mensagem do motivo e o botão Ir para a Carteira, onde a fatura é paga. #### Criar conta A tela Criar conta serve para quem chegou sozinho ao endereço próprio de um parceiro abrir a conta da empresa, quando esse parceiro liberou o cadastro. Endereço no painel: `/criar-conta` Como chegar: Pelo link Criar conta da tela Entrar, só no endereço próprio de um parceiro com o cadastro liberado. Em qualquer outro endereço não existe cadastro direto: o link leva ao formulário de contato com um especialista, que monta a proposta. Quem já está logado vai direto ao Painel. ##### Formulário de cadastro Criar sua conta no ‹nome do produto›. Leva um minuto; a IA começa a atender assim que você entrar. Campos e filtros: - **Nome da sua empresa** (obrigatório): Como a empresa vai aparecer no painel. - **Seu nome** (obrigatório): O nome do responsável pela conta. - **Seu e-mail** (obrigatório): É por aqui que você vai entrar. - **Crie uma senha** (obrigatório): Pelo menos 8 caracteres. Use algo que só você saiba. - **Repita a senha** (obrigatório): As duas senhas precisam ser iguais. Botões e ações: - **Termos de Uso**: Abre os Termos de Uso. - **Política de Privacidade**: Abre a Política de Privacidade. - **Criar conta e entrar**: Só fica ativo com todos os campos válidos e a caixa de aceite marcada. Cria a conta, registra o aceite e abre o Painel. - **Entrar**: Para quem já tem conta (linha Já tem conta?): volta à tela Entrar. Também aparece: - Quadro do plano: o nome do produto e o valor mensal definidos pelo parceiro. - Você não paga nada agora: a conta entra no ar assim que você cria a senha, e o parceiro combina com você como e quando a mensalidade começa. - O painel da esquerda é o mesmo da tela de entrada do parceiro. ##### Estados da tela - Carregando: Os campos aparecem em cinza, já no lugar final, enquanto o formulário carrega. - Se der erro: Não foi possível criar a conta agora. Tente de novo em instantes (ou a explicação do problema, como e-mail já usado). - Cadastro fechado ou endereço indisponível: Esta página não está disponível. Não é possível criar uma conta por aqui neste momento, com o botão Ir para a entrada. ### Passo a passo #### Como deixar a IA atendendo no primeiro dia 1. Conecte o WhatsApp em **Conexões** (sem número conectado, nenhuma conversa chega). 2. Escolha o segmento em **Configurações**, seção **Seu segmento**: ele ajusta o modelo do negócio, o funil e as perguntas da IA. 3. Preencha a **Base de conhecimento** com preços, prazos, área de atendimento e as perguntas que você mais ouve. 4. Defina a persona e o tom em **Configurações**, seção **IA & persona** (e ajuste o jeito de falar em **Voz & tom**). 5. Convide a equipe em **Configurações**, seção **Equipe**, botão **+ Convidar**, e envie o link a cada pessoa. 6. Teste pelo **Inbox**: mande uma mensagem de outro celular para o número conectado e acompanhe a conversa e a nota do lead ao vivo. #### Como entrar no painel pela primeira vez com a proposta do especialista 1. Abra o link da proposta que chegou por e-mail ou WhatsApp. 2. Confira o quadro **Sua proposta** e crie a senha; toque em **Criar senha e continuar**. 3. Leia os Termos, marque a caixa de aceite e toque em **Aceitar e continuar**. 4. Escolha **Pix**, **Boleto** ou **Cartão** e pague a primeira mensalidade; a tela avança sozinha quando o banco confirmar. 5. Conecte os modelos de IA que faltam e toque em **Conectar o WhatsApp**. 6. Na tela de conta ativa, toque em **Ir para o painel**. #### Como recuperar a senha esquecida 1. Na tela Entrar, toque em **Esqueci minha senha**. 2. Digite o e-mail da conta e toque em **Enviar código**. 3. Copie o código de 6 dígitos do e-mail, digite a senha nova duas vezes e toque em **Redefinir senha**. 4. Toque em **Entrar com a senha nova** e entre normalmente. #### Como aceitar o convite para a equipe 1. Abra o link de convite que o dono da conta enviou. 2. Confira o nome da empresa, o seu e-mail e o seu papel. 3. Preencha **Crie uma senha** e **Confirme a senha**. 4. Toque em **Criar conta e entrar**: o Painel abre com a sua sessão. #### Como ativar a conta que o parceiro criou para a sua empresa 1. Abra o link de ativação que o parceiro enviou. 2. Crie a senha em **Sua senha** e repita em **Repita a senha**. 3. Marque a caixa de aceite dos **Termos de Uso** e da **Política de Privacidade**. 4. Toque em **Criar senha e entrar**. #### Como voltar para a ativação que ficou pela metade 1. Entre no painel normalmente. 2. No Painel, toque em **Continuar a ativação** no aviso Falta pouco para a IA começar a atender. 3. Se faltar a verificação em duas etapas para conectar os modelos, use **Abrir Configurações → Segurança**, ative e volte pelo mesmo aviso. ### Perguntas frequentes #### Dá para criar uma conta sozinho pelo site? Não. Conta nova nasce da proposta de um especialista: você fala com ele, ele monta a proposta e manda o link para criar a senha. A exceção é o endereço próprio de um parceiro que liberou o cadastro, onde existe a tela Criar conta. #### Por que a tela de entrada pediu um código no meu e-mail? Porque você entrou por um aparelho ou navegador que a plataforma ainda não conhecia. Digite o código de 6 dígitos que chegou no e-mail e a entrada continua. #### O link do convite da equipe expirou. E agora? O link vale por 7 dias. Peça ao dono da conta para cancelar o convite pendente em Configurações, seção Equipe, e convidar de novo: um link novo é gerado. #### Quem pode convidar pessoas para a equipe? Só o dono da conta. O botão + Convidar fica em Configurações, seção Equipe, e o convite já define o papel: Admin ou Atendente. #### Redefinir a senha desliga a verificação em duas etapas? Não. A senha nova encerra as sessões abertas em outros aparelhos, mas o app autenticador continua sendo pedido no login. #### Fechei a ativação no meio do caminho. Perdi o que fiz? Não. O painel guarda o passo em que você parou. Entre de novo e use Continuar a ativação no Painel; a ativação abre exatamente no passo seguinte. #### Já tenho uma conta aberta neste navegador. Consigo abrir um convite ou link de ativação? Sim. As telas de convite, de ativação e de recuperação de senha abrem mesmo com outra sessão ativa no navegador. #### Abri o painel e caí numa tela pedindo para confirmar os Termos. É normal? Sim, na conta contratada por um parceiro a confirmação dos Termos vem antes de operar. Se preferir, Ver e exportar meus dados abre o painel só para leitura até a confirmação. ### Guia: Como o trabalho acontece A volta completa: da primeira mensagem do lead até a venda fechada, e quem faz o quê em cada etapa. Você tem uma vendedora que atende no WhatsApp a qualquer hora, nunca esquece de responder e anota tudo. Ela é de inteligência artificial. Este painel é onde você acompanha o que ela faz, entra na conversa quando quiser e transforma conversa em venda. Leia esta página uma vez. Ela mostra a volta inteira. Depois vá direto na tela que você precisa. #### 1. O lead manda mensagem Alguém vê o seu anúncio, o seu perfil ou o seu cartão e chama no WhatsApp. No mesmo instante aparece uma conversa nova no [Inbox](https://attendto.com.br/manual/inbox). Você não precisa fazer nada para que ela apareça. Junto com a conversa nasce a **ficha do contato**: nome, telefone, de onde veio. Se a pessoa clicou num anúncio, a ficha guarda qual foi. #### 2. A sua IA responde e descobre A IA responde em segundos, no tom que você definiu, com as informações que você ensinou a ela. Enquanto conversa, ela descobre quatro coisas — as mesmas quatro que qualquer bom vendedor procura saber: - **O que a pessoa precisa**: Qual é o problema dela, com as palavras dela. - **Quanto ela pode gastar**: Faixa de valor, orçamento, se já pesquisou preço. - **Quem decide**: É ela quem assina, ou precisa falar com sócio, marido, chefe. - **Para quando**: É para esta semana ou é curiosidade de longo prazo. Com isso a IA dá uma **nota de 0 a 100** e uma cor: quente, morno ou frio. É o que faz você olhar primeiro para quem está pronto para comprar. Detalhes em [Qualificação](https://attendto.com.br/manual/qualificacao). Nada disso acontece numa caixa fechada: cada decisão fica registrada na ficha do lead, com o motivo. Quando quiser saber **por que ela respondeu aquilo**, o caminho é [O que a IA faz por dentro](https://attendto.com.br/manual/barra-do-topo). > **Ela não inventa:** A IA só fala do que você colocou na Base de conhecimento e no catálogo. Antes de mandar, ela ainda confere a própria resposta e apaga o que não tem lastro — está explicado em [O que a IA faz por dentro](https://attendto.com.br/manual/barra-do-topo). Quando não sabe, ela diz que vai confirmar e chama uma pessoa. #### 3. Você assume a conversa Em três situações a conversa sai da IA e vai para uma pessoa: o lead pede para falar com alguém, a IA percebe que chegou no limite do que sabe, ou o lead ficou quente o bastante para valer o seu tempo. A conversa aparece como **Aguardando humano** e alguém do time assume. Do lado do lead, quem passa a assinar é o nome da pessoa — nunca o nome da IA. Veja [Transbordo para humano](https://attendto.com.br/manual/handoff). #### 4. O negócio anda no quadro Cada lead é um cartão no [Funil](https://attendto.com.br/manual/funil). Você arrasta da coluna "Qualificando" para "Proposta enviada", de "Proposta enviada" para "Fechado". Bate o olho e sabe quanto tem em jogo. Algumas mudanças acontecem sozinhas: quando a IA marca uma reunião, o cartão anda junto. Toda vez que isso acontece, o cartão mostra o motivo — você nunca fica sem saber por que uma coisa se mexeu. #### 5. Quem sumiu volta a ser chamado A maior parte das vendas perdidas não é perdida por preço: é perdida por silêncio. Duas ferramentas resolvem isso. - **Cadência**: um lead parou de responder, e o painel volta a chamar ele sozinho, no intervalo que você escolher. - **Campanha**: você escolhe um grupo de contatos e manda a mesma mensagem para todo mundo de uma vez. É o [envio em lote](https://attendto.com.br/manual/campanhas). > **Depois de 24 horas em silêncio, a regra muda:** O WhatsApp só deixa você escrever livremente por 24 horas depois da última mensagem do lead. Passou disso, só com **mensagem aprovada** — e aí ela é cobrada. É por isso que existem os [Modelos de mensagem](https://attendto.com.br/manual/modelos-de-mensagem). #### Por onde começar hoje 1. **Conecte o seu WhatsApp**: Sem isso nada chega. Em [Conexões](https://attendto.com.br/manual/conexoes#conexoes) tem o passo a passo. Se a sua operação tem mais de uma linha — matriz e filial, vendas e pós-venda —, dá para conectar **até cinco números**, e cada conversa continua respondendo pelo número por onde entrou. 2. **Ensine a sua IA**: Em [Base de conhecimento](https://attendto.com.br/manual/base-de-conhecimento#conhecimento) coloque preço, prazo, área de atendimento e as perguntas que você mais ouve. É o que separa uma IA útil de uma IA genérica. 3. **Escolha o tom**: Em [Voz & tom](https://attendto.com.br/manual/voz-e-tom#voz) decide-se se ela fala como consultor ou como amigo. 4. **Diga o que ela precisa descobrir**: Em [Qualificação](https://attendto.com.br/manual/qualificacao#qualificacao) você ajusta as perguntas por tipo de cliente. 5. **Deixe o Inbox aberto no primeiro dia**: Leia as respostas dela por algumas horas. É assim que se ganha confiança. No painel: Ir para o Painel. O resumo do dia: quantos chegaram, quantos estão quentes, quem espera resposta. ### Guia: Termos de Uso: aceite, versões e o que fica registrado Por que a plataforma pede a confirmação dos Termos, o que muda entre a conta comum e a conta contratada por um parceiro, e exatamente o que é gravado como prova do aceite. Os Termos de Uso são o contrato entre a sua empresa e a empresa que **fornece a plataforma**. Em algum momento a plataforma vai pedir que alguém da sua equipe confirme esses Termos — marcando uma caixa, não só clicando em um botão. Este guia explica quando isso acontece, o que muda no painel enquanto a confirmação está pendente e o que fica guardado depois que você confirma. #### Quando a confirmação é pedida - **Ao criar a conta.** A caixa está no cadastro pelo endereço do seu parceiro e na tela em que você cria a sua senha. Confirmar ali resolve tudo — nada mais aparece depois. - **Quando sai uma versão nova.** Cada versão tem um carimbo (por exemplo, `2026-08-16`) visível no alto do documento. Se a versão vigente for mais nova do que a que a sua conta aceitou, a plataforma pede de novo. - **Se a sua conta é anterior ao registro do aceite.** Contas abertas antes de a plataforma passar a registrar aceites entram no mesmo fluxo, porque não existe evidência do que foi aceito. #### Duas portas, e a diferença entre elas - **Aviso no topo (conta comum)**: Uma faixa aparece no alto de todas as telas dizendo que os Termos foram atualizados. **O painel continua liberado**: você trabalha normalmente e confirma quando quiser. Clique em *Revisar e confirmar*, leia o documento, marque a caixa e pronto — a faixa some. - **Modo somente leitura (conta contratada por um parceiro)**: Aqui a confirmação **vem antes de operar**: a primeira tela é a de aceite, porque o contrato entre o parceiro que vendeu a sua conta e a empresa que fornece a plataforma exige que a aceitação seja anterior ao uso. Mas ela não tranca os seus dados: o botão *Ver e exportar meus dados* abre o painel em **modo somente leitura** — você lê conversas, consulta o CRM e exporta tudo; só não é possível criar nem alterar nada até confirmar. É uma vez só, e leva menos de um minuto. > **Se a conferência falhar, você não fica trancado:** Se a plataforma **não conseguir conferir** o aceite (uma falha momentânea de rede ou de servidor), você vê uma faixa dizendo exatamente isso, com um botão de tentar de novo — e o painel **segue liberado**. Falha nossa não tranca a sua conta, e também não conta como aceite: a confirmação volta a ser pedida assim que a consulta responder. #### O que fica registrado Quando alguém confirma, estas informações são gravadas — é o que transforma um clique em prova de contratação, e está descrito na seção *Aceite, versões e evidência eletrônica* dos próprios Termos: - a **conta** em nome de quem o aceite foi dado; - o **usuário** que praticou o ato (nome e e-mail de quem estava logado); - a **versão** aceita; - a **data e a hora**; - o **endereço IP** de onde veio a confirmação; - a **identificação do navegador ou dispositivo** (o chamado *user agent*); - e **qual dos dois textos** foi aceito — o documento da conta contratada por parceiro traz uma seção a mais, e a prova registra essa diferença. O endereço IP é dado pessoal, e por isso está declarado na Política de Privacidade: ele é guardado como **evidência de autoria** do aceite, e para nada mais — não há medição da sua navegação dentro do painel. Essa evidência é conservada durante a relação contratual e por, no mínimo, cinco anos depois do fim dela. > **Uma vez por conta, e o histórico não se apaga:** Um aceite **vale para a conta inteira**, não só para quem clicou: sua equipe não precisa confirmar uma por uma. E um reaceite nunca apaga o anterior — o histórico de versões aceitas fica todo guardado. #### Quem pode confirmar Qualquer pessoa com acesso ao painel pode confirmar, em nome da conta. É de propósito: se só o dono pudesse, uma equipe inteira ficaria parada esperando ele aparecer. O registro guarda **quem** confirmou, e a confirmação também fica na trilha de auditoria, em Compliance, com o rótulo *Termos de Uso aceitos*. #### E o plano Enterprise com IA própria? No plano Enterprise com IA própria, preço, uso justo, fidelidade e o uso dos seus modelos estão num documento à parte, as **Condições do Plano Enterprise**, assinado na assinatura eletrônica por quem assina pela sua empresa e pela empresa que fornece a plataforma. Os Termos de Uso continuam os mesmos e não pedem novo aceite. O PDF assinado fica na Carteira, em **Contrato e documentos**. #### E a conta contratada pela proposta? A conta montada por um especialista aceita uma **versão própria** dos Termos, na ativação: os valores são os da proposta aceita, e o trecho **A inteligência artificial é sua** diz que os modelos são da sua empresa e pagos ao seu provedor, que a plataforma, o Inbox e o CRM seguem se o provedor parar, quem é controlador e operador dos dados, e que as tarifas da Meta são faturadas pela própria Meta ao titular da conta do WhatsApp Business. Mais em [Como funciona a sua contratação](https://attendto.com.br/manual/primeiros-passos). #### Ler o documento inteiro Os links *Termos de Uso* e *Política de Privacidade*, nas telas de aceite, abrem os documentos completos em uma nova aba — a leitura não faz você perder o que estava fazendo. Os dois documentos nomeiam a empresa que fornece a plataforma, com razão social e CNPJ, mesmo quando a sua conta é atendida sob a marca de um parceiro: a lei exige que você saiba quem trata os seus dados, e isso não é um detalhe escondido, é uma obrigação escrita também no contrato do parceiro. No painel: Abrir Compliance. A trilha de auditoria mostra quando alguém da sua equipe aceitou, e qual versão. ### Guia: Como funciona a sua contratação Da proposta do especialista à conta ativa: os quatro passos da ativação, a franquia e o excedente, a sua IA, as tarifas da Meta, a fatura em aberto e como cancelar. A sua conta foi montada **sob medida** por um especialista: a mensalidade, a franquia de mensagens, o valor por mil mensagens acima dela e a implantação são os que vocês combinaram. Este guia mostra o caminho inteiro, da proposta ao dia a dia, e o que acontece com a cobrança em cada ciclo. #### A proposta - O especialista monta a proposta com você e envia o link **por e-mail** (e pelo WhatsApp, quando a conversa com ele está aberta). - O link **vale 15 dias** e abre **uma vez**: depois de criar a senha, você entra pela tela de acesso de sempre. - Venceu? Na própria página do link há o botão **Pedir uma proposta nova** — o especialista confere os valores e manda outro. #### A ativação em 4 passos 1. **Criar a senha**: O e-mail de acesso é o da proposta. A senha precisa de pelo menos 8 caracteres, com letras e números. 2. **Aceitar os Termos de Uso**: Leia o trecho em destaque, **A inteligência artificial é sua**: ele diz que os modelos de IA são seus e pagos ao seu provedor, e como ficam as tarifas da Meta. O aceite fica registrado com data, hora e o seu e-mail. 3. **Pagar a primeira mensalidade**: Junto vai a implantação, quando houver, cobrada uma vez só. **Pix** confirma na hora (o código vale 30 minutos e a tela gera outro); **boleto** leva até 2 dias úteis; **cartão** abre a página de pagamento. A tela muda sozinha quando o banco confirma. 4. **Conectar os modelos e o WhatsApp**: Conversa, busca e transcrição são obrigatórios; resposta em áudio é opcional. Para conectar e testar os modelos, a sua conta precisa da verificação em duas etapas: ative em **Configurações → Segurança** e volte pelo Painel, em **Continuar a ativação**. Depois, conecte o WhatsApp da empresa. Com os dois prontos, a conta fica ativa na hora. > **Dica:** Pode fechar a tela no meio do caminho: o painel guarda onde você parou e mostra **Continuar a ativação**. #### Franquia e excedente - Com os modelos da sua empresa, a proposta tem uma **franquia de mensagens** por mês. O ciclo **renova no dia da ativação**, e o cartão no rodapé do menu mostra as mensagens do ciclo ao vivo. - Você recebe avisos quando o ciclo chega a **80%** e a **100%** da franquia. - Passou da franquia? O **excedente**, pelo valor por mil da proposta, entra na **fatura seguinte**, junto com a mensalidade. #### Fatura em aberto No começo de cada ciclo sai a fatura: a mensalidade e, se houver, o excedente do ciclo anterior. Ela chega por e-mail e aparece na **Carteira**, no cartão **Fatura em aberto**, com os itens, o vencimento e o botão **Pagar** (Pix, boleto ou cartão). A primeira fatura se paga na própria ativação. > **Depois do vencimento:** Há uma carência de 5 dias depois do vencimento. Sem o pagamento, a conta é suspensa até a fatura ser paga — os seus dados continuam guardados. No painel: Abrir a Carteira. #### A sua IA - **Os modelos são seus**: Os modelos de IA (conversa, busca, transcrição e, se quiser, resposta em áudio) são contratados por você e **pagos direto ao seu provedor**. A mensalidade não inclui o custo deles. Eles são conectados em [IA própria](https://attendto.com.br/manual/ia-propria). - **Se o provedor parar**: Se a conta no provedor ficar sem saldo, for suspensa ou mudar de regra, a IA deixa de responder até você resolver com ele. **O Inbox e o CRM seguem funcionando**, e as conversas vão para a sua equipe. - **Quem cuida dos dados**: A sua empresa é a **controladora** dos dados dos seus leads; a empresa que fornece a plataforma é a **operadora** e trata esses dados só para prestar o serviço, conforme a LGPD. #### As tarifas da Meta É o item 4 do trecho da IA nos Termos, em poucas palavras: o que a Meta cobra pelo WhatsApp (conversas e modelos de mensagem) é faturado **pela própria Meta**, direto ao titular da conta do WhatsApp Business. Se o número estiver numa conta da plataforma, e não na sua, o valor aparece no seu consumo. > **Se a sua proposta veio com a IA da plataforma:** A conta começa respondendo com a IA da plataforma, sem conectar modelos. Os **créditos de IA** do mês já estão dentro da mensalidade; acabando, o consumo sai do saldo pré-pago, pela tabela da Carteira. O cartão do menu mostra os créditos ao vivo. #### Cancelar **Posso cancelar quando quiser?** Sem fidelidade, sim: cancele na Carteira, e a conta segue funcionando até o fim do ciclo já pago. Nenhuma fatura nova é emitida. **E se a proposta teve desconto com fidelidade?** A fidelidade é de 12 meses. Saindo antes, a multa é de 20% das mensalidades que faltarem, no máximo 3 mensalidades. Para encerrar nesse período, fale com o especialista. **Mudei de ideia logo depois de pagar. E agora?** Você pode desistir em até **7 dias depois do pagamento**, pela Carteira, e o valor pago volta no mesmo meio de pagamento. O que o aceite registra e como funcionam as versões está em [Termos de Uso](https://attendto.com.br/manual/primeiros-passos). ### Guia: A IA da plataforma nesta conta Recebeu o aviso no topo do painel? Entenda o que muda na data indicada, o que continua igual e como seguir com a IA da sua empresa. A plataforma passou a funcionar com a IA da própria empresa: no **Plano sob medida**, a IA de atendimento roda no modelo de IA que a sua empresa já usa ou vai contratar. As contas que usavam a nossa IA sem plano contratado recebem um aviso no topo do painel e por e-mail, com a data em que a nossa IA deixa de responder. #### O que muda na data - Sim: Até a véspera da data, a nossa IA segue respondendo os seus leads normalmente. - Sim: Na data, a nossa IA é desligada nesta conta e o saldo de boas-vindas do período de teste é encerrado. O extrato da Carteira mostra a linha **Saldo de boas-vindas encerrado — fim do período de teste**. - Sim: O dinheiro que você recarregou não é encerrado: só o que sobrou do crédito de boas-vindas. - Sim: As conversas não param: elas continuam chegando no Inbox e vão para a fila da sua equipe responder. - Sim: Contatos, histórico, funil e configurações ficam como estão. Nada é apagado. > **Com a IA desligada, ninguém responde sozinho:** A partir da data, cada conversa nova entra na fila da equipe. Distribua as conversas entre os atendentes para nenhum lead ficar sem resposta. #### O aviso no topo do painel - **Aviso com data**: Mostra o dia em que a nossa IA deixa de responder nesta conta. Até a véspera, nada muda. - **IA mantida**: A sua conta segue com a nossa IA. Nada desliga: a IA continua respondendo e o consumo sai do saldo pré-pago, como hoje. - **IA desligada**: Mostra o dia em que a IA desta conta foi desligada. As conversas seguem chegando no Inbox para a equipe. O **X** do aviso esconde a faixa até o dia seguinte, neste navegador. Ela volta no próximo acesso a partir de amanhã. O cartão de saldo do menu também mostra a data e, depois dela, **IA desligada**. #### Como falar com um especialista 1. **Toque em Falar com especialista**: O botão está no aviso do topo, no cartão de saldo e na Carteira. O link do e-mail abre o mesmo formulário. 2. **Confira o nome e o WhatsApp**: Eles já vêm preenchidos com os dados da sua conta (marcados com **da sua conta**). Corrija se precisar e toque em **Continuar**. 3. **Se quiser, adiante algumas respostas**: Empresa, segmento, conversas por mês, tamanho da equipe e se já usa alguma IA. Tudo é opcional: dá para **Pular**. 4. **Aguarde a mensagem no WhatsApp**: Uma pessoa da nossa equipe chama você em até 2 horas úteis (segunda a sexta, das 9h às 18h) para entender a sua operação e montar a proposta. **Dá para religar a IA depois da data?** Dá. Fale com um especialista: ele monta a proposta para a IA voltar a responder, agora com o modelo da sua empresa. **Vou perder as minhas conversas ou os meus contatos?** Não. Só a resposta automática da nossa IA para. Tudo o que está na conta continua lá, e as conversas novas seguem chegando. **O saldo de boas-vindas encerrado volta se eu contratar?** Não. Ele era o crédito do período de teste. O que você recarregou com o seu dinheiro continua na Carteira. No painel: Abrir a Carteira. Veja o saldo e o extrato da conta. Como as pessoas procuram: como entrar no painel; esqueci minha senha; recuperar senha por código no e-mail; aceitar convite da equipe; link de convite expirou; ativar conta pela proposta; link de ativação do parceiro; primeira mensalidade pix boleto cartão; conectar modelos de ia na ativação; código de verificação no login; verificação em duas etapas no login; o que fazer no primeiro dia; como criar conta. ## Menu lateral, barra do topo e atalhos do painel: busca Ctrl K, notificações, tema escuro e perfil URL: https://attendto.com.br/manual/barra-do-topo Menu: Geral > Menu lateral, barra do topo e atalhos O menu lateral e a barra do topo são a moldura de todas as telas do painel: levam a cada item do menu, buscam leads, conversas e páginas, mostram os avisos e guardam o perfil, o tema e a saída. ### Quem pode usar - Dono: Vê o menu completo (os itens que dependem de plano ou módulo aparecem quando a conta os tem), todos os avisos do sino e as faixas do topo, inclusive a de exclusão de conta agendada. - Admin: Vê o mesmo menu do dono. No sino, não recebe o aviso de webhook pausado (só o dono). Vê a faixa sobre a leitura de imagens e a de Termos, mas não a de exclusão de conta. - Atendente: Vê um menu reduzido: somem IA própria, Base avançada, Módulos, Supervisão, Follow-up, Investimento, Campanhas, Modelos de mensagem, Saldo & Recargas, Compliance, Conexões, Instagram, Integrações e Configurações. Abrir uma dessas telas pelo endereço leva de volta ao Painel. A busca também não lista essas telas. ### Telas #### Menu O menu lateral do painel serve para ir a qualquer tela, agrupadas em OPERAÇÃO, INTELIGÊNCIA e CONTA, e para ver de relance quem espera no Inbox e como estão os créditos e o saldo. Endereço no painel: `/app` ![Captura da tela Menu. O menu lateral do painel serve para ir a qualquer tela, agrupadas em OPERAÇÃO, INTELIGÊNCIA e CONTA, e para ver de relance quem espera no Inbox e como estão os créditos e o saldo.](https://attendto.com.br/prints-do-manual/barra-do-topo--menu-lateral.png) A tela Menu na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Fica à esquerda em todas as telas do computador. No celular, abre pelo botão Abrir menu, no canto esquerdo da barra do topo. ##### Marca da conta No alto do menu: a logo da empresa (ou o nome dela) e, recolhido, só o ícone ou a inicial. Também aparece: - Clicar na marca leva ao Painel. - Em conta com marca própria ou contratada por um parceiro, aparece a marca da empresa ou do parceiro, nunca a da plataforma. ##### Grupos e itens do menu Os itens na ordem do menu; o item da tela aberta fica destacado na cor da marca. Botões e ações: - **Inbox**: Abre o Inbox. Ao lado aparece o número de conversas aguardando um atendente. - **‹n› aguardando**: O contador do Inbox: quantas conversas esperam atendimento humano. Com o menu recolhido vira um ponto no canto do ícone; se a contagem não carregar, aparece um ponto de exclamação em vez de sumir. - **Novo**: Pílula ao lado de um item que acabou de entrar no menu (por exemplo, Investimento e Base avançada). - **Enterprise**: Pílula ao lado de IA própria nas contas do plano Enterprise. - **Base avançada**: Item com submenu (Visão geral, Memória da empresa, Ações, Fluxos, Webhooks): clicar abre ou fecha a lista. Abre sozinho quando você está numa tela dele. Memória da empresa mostra o número de fatos para revisar. - **Instagram**: Item com submenu (Gatilhos, IA nos comentários, Boas-vindas, Perguntas de abertura, Stories, Lives, Moderação). Só existe com o canal liberado para a conta. Também aparece: - OPERAÇÃO: Painel, Inbox, Funil, Follow-up, CRM & Graph, Base de contatos, Empresas, Agenda, Handoff, Supervisão, Tickets. - INTELIGÊNCIA: IA própria, Analytics, Revenue, Investimento, Pergunte à IA, Monitor de sucesso, Personas A/B, Intent & catálogo, Qualificação, Base de conhecimento, Base avançada, Voz & tom, Modelos de mensagem, Campanhas. - CONTA: Saldo & Recargas (Plano & Recargas na conta contratada por um parceiro), Compliance, Conexões, Instagram, Módulos, Integrações, Configurações. - Itens que só aparecem quando a conta tem: IA própria (Enterprise ou Plano sob medida), Revenue (módulo Revenue AI ativo), Base avançada (módulo ativo), Módulos (loja de módulos liberada) e Instagram (canal liberado). - Teclado: no item com submenu, Enter ou espaço abre e fecha, e as setas para cima e para baixo percorrem o item e os subitens. ##### Créditos e saldo O cartão no fim do menu com o consumo do ciclo e o saldo pré-pago, atualizado ao vivo. Botões e ações: - **Créditos e saldo**: Clicar no cartão abre o detalhe do consumo ao lado (no celular, uma folha de baixo para cima). Com o menu recolhido, vira um anel com a porcentagem. - **Recarregar**: Leva à Carteira para colocar saldo. - **Recarregar e religar a IA**: Aparece quando créditos e saldo zeraram e a IA parou. - **Ajustar teto**: Aparece quando há teto de gasto do dia ou do mês; leva ao ajuste do teto. - **Falar com especialista**: Substitui a recarga quando o plano está encerrando ou a IA da conta vai ser desligada. - **Seu plano · mensalidade e uso do mês**: Na conta contratada por um parceiro: leva ao plano e ao uso do mês. - **Ver carteira**: Aparece quando o saldo não pôde ser lido; leva à Carteira. Também aparece: - Linhas possíveis: Mensagens do ciclo, Créditos de IA, Saldo pré-pago, Teto de gasto do dia ou do mês. - Selo IA parada quando a IA deixou de responder por falta de saldo; aviso de quantos dias o saldo dura no ritmo atual. - Leitura que falhou mostra um travessão e Não foi possível ler agora. Isto não quer dizer que acabou. - No celular, com o menu fechado, só um alerta (IA parada, saldo baixo, teto) sobe para a barra do topo. ##### Recolher o menu Botões e ações: - **Recolher**: Encolhe o menu para só os ícones; passar o mouse sobre um ícone mostra o nome do item. A escolha fica guardada neste navegador. - **Expandir menu**: Volta o menu ao tamanho normal. Também aparece: - No Inbox o menu já abre recolhido, para a conversa ganhar largura; expandir ali vale só enquanto você estiver no Inbox. - No Inbox maximizado (tela cheia), o menu e a barra do topo somem até você sair do modo maximizado. ##### Estados da tela - Carregando: Um indicador girando no meio da tela enquanto a sessão é confirmada; o cartão de saldo mostra um bloco cinza enquanto carrega. - Contagem do Inbox indisponível: Ponto de exclamação no lugar do número: não foi possível contar quem está aguardando. #### Busca de comandos A busca de comandos serve para pular para qualquer página, lead, conversa ou guia da ajuda digitando, sem passar pelo menu, e abre com Ctrl K (Cmd K no Mac). Endereço no painel: `/app` ![Captura da tela Busca de comandos. A busca de comandos serve para pular para qualquer página, lead, conversa ou guia da ajuda digitando, sem passar pelo menu, e abre com Ctrl K (Cmd K no Mac).](https://attendto.com.br/prints-do-manual/barra-do-topo--busca.png) A tela Busca de comandos na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Pelo campo Buscar lead, conversa, página… na barra do topo (visível em telas largas) ou pelo atalho Ctrl K, em qualquer tela. ##### Abrir a busca Botões e ações: - **Buscar lead, conversa, página…**: O campo da barra do topo. Clicar abre a janela de busca. - **Ctrl K**: Atalho que abre e fecha a busca de qualquer tela (no Mac, Cmd K). ##### Janela de busca Campos e filtros: - **Buscar**: Digite parte do nome de uma página, de um lead, do assunto de uma conversa ou de uma dúvida. Leads e conversas aparecem a partir de 2 letras. Botões e ações: - **Navegar**: Setas para cima e para baixo percorrem os resultados. - **Abrir**: Enter abre o resultado destacado. - **Esc**: Fecha a busca (clicar fora também fecha). Também aparece: - Sem nada digitado: Ajuda desta tela (Como usar ‹tela›, o guia da tela em que você está), Buscas recentes (as últimas cinco que você abriu) e Ir para (todas as páginas do menu). - Com texto: Páginas, Ajuda (até três guias), Leads (nome e empresa ou telefone) e Conversas (nome do lead e situação: IA respondendo, Aguardando humano, Com atendente ou Encerrada). - O trecho que bate com o que você digitou fica destacado na cor da marca. - A lista Ir para segue as mesmas regras do menu lateral: mostra Instagram, Revenue, IA própria, Módulos e Base avançada quando a conta tem cada um, e esconde do atendente o que ele não vê no menu. ##### Estados da tela - Sem nada ainda: Nada encontrado para “‹termo›”. #### Notificações O sino de notificações e as faixas do topo servem para avisar o que pede ação agora: conversas aguardando atendimento, saldo baixo, IA parada, Termos para confirmar e mudanças na conta. Endereço no painel: `/app` ![Captura da tela Notificações. O sino de notificações e as faixas do topo servem para avisar o que pede ação agora: conversas aguardando atendimento, saldo baixo, IA parada, Termos para confirmar e mudanças na conta.](https://attendto.com.br/prints-do-manual/barra-do-topo--notificacoes.png) A tela Notificações na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: O sino fica na barra do topo, à direita, em todas as telas; as faixas aparecem acima de tudo quando há algo pendente. ##### Sino O número vermelho é o total de avisos ainda não vistos. Botões e ações: - **Notificações**: Abre a lista de avisos. Clicar num aviso marca como visto e leva à tela dele. - **marcar todas como vistas**: Apaga o pontinho de todos os avisos, inclusive os que ainda não desceram na lista, sem fechar o menu. - **Limpar notificações**: A lixeira: pede confirmação antes de tirar os avisos do sino. - **Tentar de novo**: Aparece quando os avisos não carregaram. Também aparece: - Tipos de aviso: ‹lead› está aguardando atendimento (leva ao Handoff), Saldo baixo, Recarga pendente, Assinatura precisa de atenção, A IA parou de responder — sem saldo, Webhook pausado (só o dono), Enterprise ainda não ativo (dono e admin), avisos da franquia e avisos do funil. - Ponto laranja indica aviso de atenção; ponto da cor da marca, informação. Um ponto vermelho à direita marca o que ainda não foi visto. - A lista rola por dentro e carrega mais avisos ao chegar no fim; quando acaba, mostra Não há mais avisos. - Quais tipos aparecem segue as preferências em Configurações, seção Notificações. - Se a contagem não carregar, o sino mostra um ponto de exclamação no lugar do número. ##### Limpar os avisos do sino? Confirmação da lixeira. Nada é apagado de verdade: se a conversa continuar esperando ou o saldo seguir baixo, o aviso volta com a próxima novidade. Botões e ações: - **Cancelar**: Fecha sem limpar. - **Limpar avisos**: Tira do sino todos os avisos que estão lá agora. ##### Faixas no topo do painel Avisos fixos acima do menu e da barra do topo, em todas as telas, até serem resolvidos. Botões e ações: - **Revisar e confirmar**: Na faixa de Termos atualizados: abre o link dos Termos e a caixa de aceite. - **Confirmar aceite**: Registra o aceite dos Termos em nome da conta (com a caixa marcada). - **Cancelar exclusão** (Dono): Só para o dono, na faixa Sua conta será excluída em ‹data›: cancela o pedido de exclusão. - **Ver a configuração**: Na faixa sobre a leitura de imagens: leva a Configurações, seção IA & persona. - **Entendi**: Dispensa a faixa sobre a leitura de imagens em todos os aparelhos. - **Falar com especialista**: Na faixa sobre a IA da conta: abre o formulário de contato com um especialista. - **Fechar o aviso até amanhã**: O X da faixa sobre a IA da conta: some e volta no próximo acesso a partir de amanhã. Também aparece: - Termos de Uso atualizados aguardando confirmação (ou modo somente leitura na conta contratada por um parceiro). - Não foi possível conferir o aceite dos Termos de Uso: o painel segue liberado, com Tentar de novo. - Exclusão de conta agendada, com a data (só o dono vê). - A IA agora lê as imagens que o lead envia (dono e admin, uma vez). - Aviso sobre a IA da conta: data em que a IA da plataforma deixa de responder, ou que ela já foi desligada. ##### Estados da tela - Carregando: Carregando avisos…, com três linhas cinzas. - Sem nada ainda: Tudo em dia. - Se der erro: Não foi possível carregar seus avisos. Isto não quer dizer que não há ninguém esperando atendimento. Botão Tentar de novo. #### Menu do usuário A barra do topo e o menu do usuário servem para saber em que tela você está, trocar o tema claro ou escuro, mudar a foto do perfil, abrir a Central de ajuda e Configurações e sair do painel. Endereço no painel: `/app` ![Captura da tela Menu do usuário. A barra do topo e o menu do usuário servem para saber em que tela você está, trocar o tema claro ou escuro, mudar a foto do perfil, abrir a Central de ajuda e Configurações e sair do painel.](https://attendto.com.br/prints-do-manual/barra-do-topo--menu-do-usuario.png) A tela Menu do usuário na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: A barra do topo fica no alto de todas as telas; o menu do usuário abre pela sua foto ou iniciais, no canto direito. ##### Barra do topo Botões e ações: - **Abrir menu**: Só no celular: abre o menu lateral como uma gaveta. - **Tema: claro**: O botão de tema mostra o tema atual. Cada clique passa para o próximo: claro, escuro e sistema (segue o do aparelho). - **Tema: escuro**: Tema escuro ligado; o próximo clique passa para Tema: sistema. - **Tema: sistema**: Segue o tema do aparelho; o próximo clique volta ao claro. Também aparece: - À esquerda, o nome da tela aberta e, em telas largas, uma frase sobre ela (por exemplo, Inbox · Conversas ao vivo com a SDR de IA). - Em telas largas, o campo da busca de comandos fica no meio. ##### Menu do usuário A foto ou as iniciais, o seu nome e o nome da conta; ao abrir, nome e e-mail no alto. Botões e ações: - **Foto do perfil**: Abre o diálogo para escolher, trocar ou remover a sua foto. - **Central de ajuda**: Abre a Central de ajuda já apontando para o guia da tela em que você estava. - **Configurações**: Abre Configurações. O atendente não tem acesso: a tela leva de volta ao Painel. - **Sair**: Encerra a sessão neste navegador e volta à tela Entrar. ##### Foto do perfil A foto aparece no menu do painel, para você e para a sua equipe. JPG, PNG ou WebP, no tamanho máximo indicado no diálogo. Botões e ações: - **Escolher foto**: Abre os arquivos do aparelho para escolher a imagem. - **Trocar foto**: Substitui a foto atual. - **Remover**: Apaga a foto; o painel volta a mostrar as suas iniciais. ##### Estados da tela - Se der erro: Foto em formato ou tamanho fora do aceito, ou falha ao salvar, aparece num aviso rápido no canto da tela. ### Passo a passo #### Como abrir qualquer tela ou lead pelo atalho Ctrl K 1. Em qualquer tela, aperte **Ctrl K** (no Mac, Cmd K) ou clique em **Buscar lead, conversa, página…**. 2. Digite parte do nome da página, do lead ou da dúvida. 3. Use as setas para escolher e **Enter** para abrir; **Esc** fecha. #### Como recolher o menu lateral para ganhar espaço 1. No fim do menu lateral, clique em **Recolher**. 2. Passe o mouse sobre um ícone para ver o nome do item. 3. Para voltar, clique no mesmo botão (**Expandir menu**). A escolha fica guardada neste navegador. #### Como ligar o tema escuro no painel 1. Na barra do topo, clique no botão de tema (**Tema: claro**). 2. Cada clique troca: claro, escuro e sistema. Pare em **Tema: escuro**. #### Como limpar as notificações do sino 1. Clique no sino (**Notificações**). 2. Para só apagar os pontinhos, use **marcar todas como vistas**. 3. Para tirar os avisos da lista, clique na lixeira e confirme em **Limpar avisos**. #### Como trocar a foto do perfil 1. Clique na sua foto ou iniciais, no canto direito da barra do topo. 2. Escolha **Foto do perfil**. 3. Clique em **Escolher foto** (ou **Trocar foto**) e selecione a imagem; para tirar, use **Remover**. #### Como sair do painel 1. Clique na sua foto ou iniciais, no canto direito da barra do topo. 2. Escolha **Sair**. ### Perguntas frequentes #### Por que o atendente não vê Configurações, Conexões e Saldo & Recargas no menu? Porque são telas de administração da conta: cobrança, canais, integrações, módulos, supervisão da equipe e configurações ficam com o dono e o admin. O atendente vê as telas de atendimento e de inteligência do dia a dia. #### O menu do Inbox abre sempre recolhido. Dá para mudar? No Inbox o menu nasce recolhido para a conversa ter mais largura. Você pode expandir ali mesmo; a escolha vale enquanto estiver no Inbox e não muda o menu das outras telas. #### O número do Inbox no menu é o mesmo do sino? O número do Inbox conta as conversas aguardando atendimento humano agora. O do sino conta todos os avisos ainda não vistos, que incluem essas conversas e outros assuntos, como saldo e assinatura. #### Limpei o sino e o aviso voltou. Por quê? Limpar só dispensa o que estava na lista. Se a conversa continuar esperando ou o saldo seguir baixo, o aviso volta com a próxima novidade. #### Por que um item do menu não aparece para mim? Ou o seu papel não alcança a tela, ou a conta ainda não tem o que ela exige: IA própria, Revenue, Base avançada, Módulos e Instagram só aparecem quando o plano, o módulo ou o canal estão ativos. #### Que atalhos de teclado o painel tem? Ctrl K (Cmd K no Mac) abre a busca de comandos; nela, setas navegam, Enter abre e Esc fecha. Na Central de ajuda, a barra / leva direto ao campo de busca. No menu, os itens com submenu abrem com Enter ou espaço e são percorridos com as setas. #### O tema escuro vale para toda a equipe? Não. O tema é escolha de cada pessoa, neste navegador. Com Tema: sistema, o painel acompanha o claro ou escuro do aparelho. ### Guia: O que a IA faz por dentro Por que ela respondeu aquilo, o que ela consegue e o que não consegue fazer sozinha, e onde você muda o comportamento dela. A resposta que o lead recebe não sai de um lugar só. Antes dela existir, a mensagem passa por vários especialistas, cada um com um trabalho estreito: um descobre o que a pessoa quer, outro dá a nota, outro escreve, outro confere o que foi escrito antes de mandar. Você não precisa decorar isso para usar o painel. Precisa quando acontecer uma destas três coisas: ela respondeu algo que você não esperava, ela chamou você numa hora estranha, ou você quer mudar o jeito dela e não sabe qual botão mexe naquilo. Este guia é para esses três momentos. #### Onde você vê a IA trabalhando Cada decisão fica registrada na ficha do lead, no cartão **Jornada do lead** — a linha do tempo da direita. É lá que estão os nomes deste guia. A mesma lista, mais curta, aparece na seção **Jornada** da gaveta que abre quando você clica num contato na [Base de contatos](https://attendto.com.br/manual/base-de-contatos). Na tela: Cartão Jornada do lead na ficha, com as decisões dos especialistas em ordem: compliance, intenção, qualificação, a resposta e a auditoria. A conversa de um lead real da conta de demonstração, de baixo para cima no tempo. 1. **Quem decidiu, e em que momento**: O nome do especialista e quando ele entrou. **Antes da resposta** são as travas, que decidem com a mensagem ainda na mão. **Agente** é quem lê, conclui ou escreve. 2. **A hora e quem assinou**: A sua IA assina as decisões dela com `ia:` na frente do nome dela. Quando quem agiu foi uma pessoa do time, aparece o nome da pessoa. 3. **O que ele concluiu**: A conclusão em uma linha. Aqui é a primeira nota do lead, ainda fria: ele só tinha dito o que precisava. Duas horas depois, mais abaixo, a mesma linha aparece com **pontuação 100 · banda Quente**. 4. **A auditoria mostrando o que cortou**: Esta é a linha mais útil da jornada. A IA tinha escrito um valor que não está cadastrado em lugar nenhum, e o trecho saiu **antes de o lead ler**. A justificativa traz o pedaço retirado entre aspas e o tempo que a conferência levou. 5. **A cor do ponto**: Ponto colorido é decisão de um especialista. Ponto vazado é um fato da conversa: o lead escreveu, a resposta saiu, o transbordo foi pedido. Nem toda linha tem a terceira parte. Quem justifica é quem tem o que justificar: a qualificação diz quais sinais capturou e quais faltam, a auditoria diz o que cortou, o transbordo diz por que chamou uma pessoa. As demais concluem e seguem. > **A jornada é de um lead por vez:** Não existe uma tela com o rastro de todas as conversas juntas. Você abre a ficha de quem te deixou em dúvida e lê a dele. Para o que a equipe fez — quem assumiu, quem devolveu, quem apagou —, o lugar é a trilha de [Compliance](https://attendto.com.br/manual/compliance). #### O que ela entende antes de responder Toda mensagem que chega é lida por cinco leitores diferentes ao mesmo tempo, antes de qualquer resposta ser escrita. Nenhum deles fala com o lead: eles só concluem coisas. - **Classificador de intenção**: O que a pessoa quer nesta mensagem: saudação, dúvida de produto, preço, intenção de compra, agendamento, suporte, pedir humano ou sair. É o que aparece como **Intenção prevista** no painel direito da conversa, e é o que casa o lead com uma oferta do seu [catálogo](https://attendto.com.br/manual/intent-e-catalogo). - **Análise de sentimento**: O humor de quem escreveu: positivo, neutro, negativo ou frustrado, com intensidade. Frustração alta chama uma pessoa sozinha, sem esperar o lead pedir. - **Extrator de dados**: Anota o que foi dito de passagem e que ninguém digitaria à mão: empresa, cargo, e-mail, outro telefone, o valor do negócio. É por isso que a ficha vai se preenchendo sem você tocar nela. - **Detector de Objeções**: Reconhece quando a mensagem traz uma resistência de venda — “tá caro”, “depois eu vejo”, “já uso outra” — e guarda o tipo e a frase dita. É o que alimenta a tela [Pergunte à IA](https://attendto.com.br/manual/pergunte-a-ia); pergunta de preço não conta, só resistência. - **Reconhecedor de público**: Descobre com qual dos seus públicos aquela pessoa se parece, para as perguntas certas serem feitas. Só entra em campo se você cadastrou mais de um público, e nunca inventa um que não existe. **Onde você manda nisso**: os públicos e o que cada um precisa descobrir ficam em [Qualificação](https://attendto.com.br/manual/qualificacao); as ofertas e as intenções que casam com cada uma, em [Intent & catálogo](https://attendto.com.br/manual/intent-e-catalogo). O sentimento, a extração de dados e as objeções não têm ajuste — eles leem o que está escrito. > **Público fixado à mão não é reavaliado:** Se alguém do time escolher o público de um lead na mão, o selo **Fixado à mão** aparece na ficha e a IA para de reavaliar aquele lead. É útil quando ela errou; é um problema quando ninguém lembra que fixou. #### Como ela decide quem vale a sua manhã O **Qualificador BANT** relê a conversa inteira a cada mensagem nova — não só a última frase — e procura os sinais que você declarou: o que a pessoa precisa, quanto pode gastar, se é ela quem decide e para quando. Disso sai a nota de 0 a 100 e a temperatura. **Onde você vê**: o anel de **Qualificação ao vivo** no painel direito da conversa, o cartão de qualificação na ficha do lead (*Nota 82 (Quente) — 3 de 4 sinais*), a cor na lista do Inbox e no cartão do funil, e a linha `pontuação 82 · banda Quente` na jornada. O porquê da nota não é um texto de justificativa: é **a frase do lead que provou cada sinal**, guardada ao lado dele. Sinal sem frase aparece como *ainda não capturado* — quer dizer que ela ainda não perguntou ou que a pessoa não respondeu, não que a resposta foi ruim. **Onde você manda nisso**: tudo em [Qualificação](https://attendto.com.br/manual/qualificacao) — quais sinais valem para cada público, como ela pergunta e quanto cada um pesa na nota. Mudar ali não reescreve nota de ninguém: vale da próxima mensagem de cada lead em diante. Com o módulo Revenue AI ligado, um segundo eixo entra ao lado da nota: a **aderência ao cliente ideal**. O **Perfil de Cliente Ideal** compara o lead com o que você declarou em [Configurações](https://attendto.com.br/manual/configuracoes) → Cliente ideal e devolve 0 a 100 com uma frase — no cartão do funil (`ICP 82`), na ficha e no dossiê. Ele roda no máximo uma vez por dia por lead, e só quando o lead disse algo novo. #### Como ela escreve a resposta A resposta é escrita pela **Conversa SDR**, e ela escreve com o que você deu. Nada mais que isso: - **Quem ela é** — o nome dela, a empresa que ela diz representar e o tom de voz, em [Personas A/B](https://attendto.com.br/manual/personas) e [Voz & tom](https://attendto.com.br/manual/voz-e-tom). Se a conta por onde a mensagem entrou tiver uma **persona vinculada**, é ela quem fala ali; sem vínculo, é a persona da empresa. - **O que a sua empresa faz** e as respostas prontas que você escreveu na persona. - **As ofertas ativas** do [catálogo](https://attendto.com.br/manual/intent-e-catalogo), com o preço do jeito que você escreveu. - **Os trechos da [Base de conhecimento](https://attendto.com.br/manual/base-de-conhecimento)** que têm a ver com a pergunta daquela mensagem — não a base inteira, os pedaços que servem. A busca olha também as últimas falas da conversa e os trechos que a IA recebeu para a resposta anterior: quando o cliente pergunta só "tem desconto?" ou "me passa o preço dos 2" logo depois de a IA oferecer um produto, o trecho daquele produto continua na mão dela. A pergunta nova continua mandando: "vocês entregam?" traz primeiro o que fala de entrega. E a conferência da resposta recebe também os trechos da resposta anterior: se a IA repetir um preço que acabou de dar, ele não é apagado só porque o cliente mudou de assunto. E, se você marcou documentos para contas específicas, só os que valem para a conta que recebeu a mensagem. - **O que já foi combinado** com aquele lead, que é a memória explicada logo abaixo. **Onde você vê**: a própria mensagem, com o nome da IA logo acima da bolha. Quando um atendente assume, o nome que aparece passa a ser o da pessoa — o lead nunca vê o nome da IA assinando uma mensagem humana, nem o contrário. Algumas respostas chegam com um **áudio na frente** — e ali não é a IA falando. É uma **resposta gravada**: a voz de alguém do time do dono, gravada uma vez para uma das perguntas de sempre ("quanto custa?", "quanto tempo leva?"). Quando a IA tem certeza de que o lead fez aquela pergunta, ela envia a gravação antes do texto; na dúvida, vai só o texto. **Onde você vê**: no [Inbox](https://attendto.com.br/manual/inbox), a bolha de áudio leva o rótulo **Resposta gravada**, com o título e — ao passar o mouse — a voz de quem gravou; na jornada do lead, a linha **Resposta gravada enviada** registra qual saiu. **Onde você manda nisso**: no cartão **Respostas gravadas** de [Intent & catálogo](https://attendto.com.br/manual/intent-e-catalogo). > **Base vazia é IA genérica:** A diferença entre uma resposta que fecha venda e uma resposta que enrola é quase sempre o que está cadastrado, não o tom. Preço, prazo, área de atendimento e as cinco perguntas que você mais ouve valem mais que qualquer ajuste de personalidade. #### Ela confere a própria resposta antes de enviar Escrita a resposta, ela **não sai direto**. Um segundo especialista, o **Auditor de Resposta**, lê o que foi escrito com uma pergunta só: *isto afirma algum fato sobre esta empresa que não está no que o dono cadastrou?* Preço, prazo, promessa, política, cobertura, capacidade, qualquer número. Ele foi ensinado a separar o que é fato do que não é, porque senão cortaria a conversa inteira. **Não é afirmar nada**: cumprimentar, fazer uma pergunta, repetir de volta o que o próprio lead acabou de contar sobre ele, dizer o próprio nome ou dizer que vai encaminhar para o time. - **Compromisso de horário conta como fato**: Mesmo sem número. Marcar um dia, prometer retorno "até amanhã" ou concordar com o prazo que o lead propôs é afirmar um prazo, e precisa estar cadastrado. - **Dinheiro só passa com lastro**: Ou o valor está no que você cadastrou, ou foi o próprio lead que disse aquele valor como orçamento dele. Número que o lead usou para outra coisa — quantidade de clientes, de funcionários, de seguidores — não autoriza preço nenhum. - **Pergunta do lead não é fonte**: "Vocês parcelam em 12 vezes?" não vira permissão para confirmar que parcela. Se a política não está cadastrada, a confirmação é invenção. Quando acha um trecho sem lastro, ele **só sabe apagar**. Não reescreve, não troca palavra, não ajusta número para baixo — tira o pedaço e entrega o resto, e no lugar pode entrar uma frase dizendo que aquele detalhe será confirmado com um atendente. Se o que sobrou não se sustenta, a resposta inteira é substituída por uma resposta segura, que não afirma nada: para uma pergunta, diz que vai confirmar o detalhe com um especialista. Com **Conduzir até o pedido completo** ligado, nenhuma das duas frases promete confirmação — dizem que o detalhe não está ali e oferecem uma pessoa da equipe —, e o cliente pronto para comprar que recebe a resposta segura vai para a equipe. **Onde você vê**: na jornada, a linha do Auditor diz em qual dos casos aquela resposta caiu — *resposta fundamentada*, *preço sem lastro corrigido*, *trecho sem lastro corrigido*, *resposta trocada* — e a justificativa mostra **o trecho exato que foi retirado**. É a evidência, não um resumo. > **Sem nada cadastrado, não há o que conferir:** A auditoria compara a resposta com o que você cadastrou. Numa conta em que o catálogo, a base de conhecimento e as respostas prontas estão vazios, não existe termo de comparação e ela não roda — sobra só uma trava que impede a IA de soltar valores. Cadastrar não é burocracia: é o que liga a conferência. Duas honestidades sobre o limite dela. A conferência **nunca segura o atendimento**: se ela mesma falhar, a resposta original vai, porque deixar o lead sem resposta é pior. E ela julga o que a resposta afirma sobre a **sua empresa** — se você cadastrou um preço errado, ela vai defender o preço errado com o mesmo empenho. #### Ela lembra do que já foi dito Numa conversa que se arrasta por dias, reler tudo a cada mensagem não é viável, e uma IA que esquece o que combinou na semana passada perde o lead. Por isso existe a **Memória do lead**: um resumo curto do relacionamento, refeito de tempos em tempos, com quem é a pessoa, o que ela busca, as objeções que levantou, os valores e prazos que citou, o que ficou combinado e qual é o próximo passo. Ela só entra em conversa que já ficou longa — troca de duas ou três mensagens não tem memória, e não precisa. E ela é montada **só com o que está escrito nas mensagens**: nada de deduzir profissão, renda ou intenção que ninguém disse. **Onde você vê**: a linha **Memória do lead** na jornada. Ela é o carimbo de que a IA se atualizou, com a data — que é o que diz de quando é o entendimento usado nas respostas de hoje. O texto guardado em si não é exibido em tela nenhuma. > **Quando a memória está errada:** Não existe hoje uma tela para editar esse resumo. O que funciona é corrigir **na própria conversa**: ela é refeita a partir das mensagens, então o que for dito depois entra. Se o erro for grave, assuma a conversa no Inbox e resolva você — e vale saber que a memória vale para o LEAD, nunca para a sua empresa: um preço não passa a ser verdade porque foi parar ali, o Auditor corta do mesmo jeito. #### Quando ela chama uma pessoa A **Política de transbordo** é uma regra fixa, não uma opinião: em cinco situações a conversa sai da IA e entra na fila do time, e o motivo fica escrito na fila para você saber por quê. Duas delas têm interruptor: com **Conduzir até o pedido completo** ligado, que é como a conta nova já nasce, a intenção de compra e o lead Quente deixam de transferir. - **Lead pediu atendimento humano**: Ele escreveu que quer falar com alguém. Sai na hora. - **Intenção de compra**: Ele sinalizou que quer fechar e já está Morno ou Quente (ou com a qualificação completa). É o momento em que um humano ganha dinheiro. Lead Frio que diz que quer comprar, ou que só escolhe uma opção que a IA ofereceu, continua com ela: a IA faz a próxima pergunta e a jornada registra **Intenção de compra sem evidência**. Fora do horário, esta regra e a do lead Quente põem a conversa na fila sem avisar o lead, e a IA segue com ele até a equipe abrir. Desligável em Configurações → IA & persona: com a condução até o pedido ligada, a IA segue com ele até o pedido completo. Se a conferência com a sua base reprovar a resposta, a IA reescreve até duas vezes; só na terceira reprovação ela passa para a equipe. - **Lead qualificado (Quente)**: A nota chegou na faixa quente e vale o seu tempo. Desligável no mesmo interruptor da intenção de compra. - **Baixa confiança na intenção**: Ela não entendeu o que a pessoa quis dizer, e insistir criaria atrito. - **Lead precisa de uma pessoa agora**: A IA percebeu que só uma pessoa resolve: o lead pediu ligação, se irritou com o atendimento automático ou pediu algo fora do alcance dela. - **Lead frustrado**: O sentimento azedou o bastante para uma pessoa assumir antes de piorar. - **Pedido completo**: Com a condução até o pedido ligada: o cliente respondeu tudo o que a Qualificação pede. A IA resume o pedido e a conversa vai para a equipe confirmar; fora do horário, sem aviso de horário ao cliente. Junto com o transbordo, o **Resumidor** entrega o briefing pronto para quem vai assumir: o resumo da conversa, o humor do lead e o próximo passo sugerido. É o que aparece no pacote da tela de [Transbordo](https://attendto.com.br/manual/handoff) — ninguém precisa ler cinquenta mensagens antes de responder. > **O que você controla nesses gatilhos:** Duas das cinco regras têm interruptor: em Configurações → **IA & persona**, **Conduzir até o pedido completo** (ligado de fábrica nas contas novas) faz a IA seguir com quem quer comprar ou ficou Quente, perguntando o que falta, uma coisa por vez, até o pedido completo. Pedido de pessoa, baixa confiança e frustração transferem sempre, com ou sem ele. Fora isso, você controla **quem vira Quente** pelo que a [Qualificação](https://attendto.com.br/manual/qualificacao) pede — a linha dos 75 pontos é fixa —, o prazo do SLA, o que acontece fora do horário, e pode passar qualquer conversa para o time na mão, pelo botão do Inbox. #### O aviso e a saída O **Compliance LGPD** faz duas coisas, e as duas são obrigação legal, não preferência. No primeiro contato, ele garante que o aviso de transparência vá junto com a resposta. E quando o lead pede para sair, ele **encerra na hora**: a resposta que estava sendo escrita é descartada, a despedida é enviada e a IA não escreve mais para aquela pessoa. **Onde você vê**: as linhas *Consentimento registrado* e *Opt-out registrado* na jornada do lead, e a trilha completa em [Compliance](https://attendto.com.br/manual/compliance). **Onde você manda nisso**: os textos do aviso e da despedida ficam em Configurações, na aba **Atendimento**. #### O que ela faz sem você pedir Três coisas acontecem sem ninguém clicar em nada, e todas as três você liga, desliga ou alimenta: 1. **Volta a chamar quem sumiu**: Um lead parou de responder e a IA escreve de novo, no intervalo que você definiu nas cadências, em Configurações. A mensagem é escrita na hora, com o contexto daquele lead — não é texto pronto igual para todo mundo. 2. **Manda o seu link de pagamento**: Quando o lead sinaliza compra e existe uma oferta que casa, ela compartilha o **link de pagamento que você cadastrou** naquela oferta, em [Intent & catálogo](https://attendto.com.br/manual/intent-e-catalogo). Oferta sem link cadastrado, nada é enviado: ela não tem de onde inventar um endereço de pagamento. 3. **Marca reunião na sua agenda**: Horário combinado vira compromisso real na [Agenda](https://attendto.com.br/manual/agenda), e essa parte é conferida por regra, não escrita por IA — é a diferença entre um horário que existe e um horário que soou bem na frase. #### O que ela não faz Vale saber tanto quanto o resto, e é o que costuma tirar o medo de deixar ela sozinha: - **Não dá preço que você não cadastrou.** Se escapar na escrita, sai antes de o lead ler. - **Não manda link de pagamento que não seja o seu**, cadastrado por você numa oferta. - **Não decide sozinha o horário de uma reunião** — a agenda é conferida contra o que está livre de verdade. - **Não continua falando com quem pediu para sair.** - **Não abre a transferência pelo que escreve.** Quem passa a conversa para o time é a política de transbordo, antes de a resposta ser escrita. Uma frase dela dizendo que vai chamar alguém não chama ninguém. - **Não assina com o nome de ninguém do seu time**, e nenhum atendente aparece para o lead com o nome dela. - **Não aprende sozinha com um lead para responder outro.** O que ela sabe sobre o seu negócio é o que você cadastrou; o que um lead conta fica com aquele lead. #### Os nomes que aparecem na jornada A lista para consulta rápida, do jeito que os nomes saem na ficha do lead. Ao lado de cada um vem o momento: **antes da resposta** para as travas, **agente** para quem lê, decide ou escreve. - **Classificador de intenção**: Concluiu o que o lead quer nesta mensagem. - **Reconhecedor de público**: Escolheu com qual dos seus públicos ele se parece. - **Qualificador BANT**: Recalculou a nota e a temperatura com a conversa inteira. - **Perfil de Cliente Ideal**: Comparou o lead com o perfil que você declarou em Cliente ideal e disse, em uma frase, o que bateu. - **Análise de sentimento**: Mediu o humor de quem escreveu. - **Extrator de dados**: Anotou na ficha um dado dito de passagem. - **Detector de Objeções**: Anotou a objeção dita na mensagem — é o que alimenta a tela [Pergunte à IA](https://attendto.com.br/manual/pergunte-a-ia). No **Modo atendimento** (venda direta) ele não roda, salvo com o Closer AI ligado. - **Compliance LGPD**: Deixou seguir, ou parou tudo porque o lead pediu para sair. - **Política de transbordo**: Decidiu se aquela conversa continua com a IA ou vai para o time. - **Resposta gravada**: Enviou, antes do texto, o áudio que o seu time gravou para a pergunta reconhecida. - **Conversa SDR**: Escreveu a resposta que o lead recebeu. - **Auditor de Resposta**: Conferiu essa resposta e disse se ela tinha lastro no que você cadastrou. - **Memória do lead**: Atualizou o entendimento acumulado daquele relacionamento. - **Resumidor**: Montou o briefing para o atendente que ia assumir. - **Closer de oferta**: Decidiu se era hora de mandar o seu link de pagamento. - **Closer**: Negociou dentro da escada de desconto que você definiu, tratou a objeção com o seu playbook ou chamou o humano com o dossiê (módulo Revenue AI). - **Follow-up SDR**: Escreveu a mensagem de retomada de quem tinha sumido. > **Nome novo na lista não é problema:** A lista muda quando a IA ganha uma habilidade nova. Se aparecer um nome que não está aqui, ele segue o mesmo padrão: o que concluiu na linha de baixo, e o porquê logo abaixo. #### Ela errou. E agora? Quase todo erro cai em um destes cinco, e cada um tem um lugar diferente para consertar. Comece sempre pela jornada do lead: ela diz qual dos cinco é. 1. **Falou algo errado sobre a sua empresa**: Corrija na fonte, não na conversa: [Base de conhecimento](https://attendto.com.br/manual/base-de-conhecimento) para informação, [catálogo](https://attendto.com.br/manual/intent-e-catalogo) para oferta e preço. Da próxima mensagem em diante ela usa o certo — e passa a ter contra o que ser conferida. 2. **Cortou demais e ficou evasiva**: É a auditoria trabalhando com pouco material. A linha dela na jornada mostra o trecho retirado; cadastre aquela informação e o corte para de acontecer. 3. **Perguntou a coisa errada**: O roteiro de perguntas é por público, em [Qualificação](https://attendto.com.br/manual/qualificacao). Se ela usou o público errado, dá para trocar na ficha do lead. 4. **O tom não é o da sua empresa**: [Voz & tom](https://attendto.com.br/manual/voz-e-tom) e [Personas A/B](https://attendto.com.br/manual/personas). Se a diferença for grande, teste duas versões antes de trocar de vez. 5. **Devia ter chamado você antes**: Assuma a conversa no [Inbox](https://attendto.com.br/manual/inbox) e responda **Discordo** na caixa de qualificação — esse voto é o que alimenta a precisão do transbordo. Se acontece sempre com o mesmo tipo de lead, o ajuste é nos pesos da qualificação. No painel: Abrir a lista de leads. Clique num lead para abrir a ficha dele e ler a jornada da conversa, decisão por decisão. Como as pessoas procuram: atalho ctrl k; busca rápida no painel; recolher menu lateral; tema escuro; modo escuro no painel; notificações do sino; limpar notificações; trocar foto do perfil; como sair da conta; atendente não vê configurações; menu sumiu; contador de conversas aguardando; cartão de saldo no menu. ## Painel: a visão geral do atendimento com IA no WhatsApp, em tempo real URL: https://attendto.com.br/manual/painel Menu: Operação > Painel O Painel é a primeira tela do painel: mostra, ao vivo, quantos leads a conta tem, quantos se qualificaram, quanto a IA demora para responder e quantas conversas esperam uma pessoa agora. ### Quem pode usar - Dono: Vê a tela inteira, inclusive os avisos de ativação da conta e de troca da planilha pela sincronização. - Admin: Vê a tela inteira, inclusive o aviso de troca da planilha pela sincronização. - Atendente: Vê os números, o funil, os agendamentos, a distribuição BANT, o bloco ao vivo, os leads e a persona em teste. Não vê o aviso da planilha, que é de quem administra a conta. ### Telas #### Painel A tela Painel serve para decidir, em segundos, onde colocar a atenção agora: na fila de quem espera um humano, no roteiro de qualificação ou em lugar nenhum. Endereço no painel: `/app` ![Captura da tela Painel. A tela Painel serve para decidir, em segundos, onde colocar a atenção agora: na fila de quem espera um humano, no roteiro de qualificação ou em lugar nenhum.](https://attendto.com.br/prints-do-manual/painel--visao-geral.png) A tela Painel na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: É a tela que abre ao entrar no painel e o primeiro item do menu, em OPERAÇÃO. O subtítulo no topo diz **Visão geral da operação**. ##### Avisos do topo Faixas que só aparecem quando há algo a fazer na conta; sem pendência, o espaço some. Botões e ações: - **Continuar a ativação** (Dono, Admin): Aparece quando a ativação da conta ficou pela metade, com o título **Falta pouco para a IA começar a atender**. Leva de volta ao passo em que você parou. - **Ver a comparação** (Dono, Admin): Aparece quando uma planilha importada na Base de conhecimento tem mais de 15 dias e o módulo da Base avançada está ligado. Abre a criação de uma sincronização que substitui a planilha. - **Conhecer o módulo** (Dono, Admin): Mesmo aviso da planilha antiga, quando o módulo da Base avançada ainda não está ligado. Abre a página do módulo na loja. Também aparece: - Nos primeiros 30 dias depois da ativação, a faixa verde **Conta ativa desde ‹data›** confirma que a IA já atende. - O aviso da planilha diz o nome do arquivo, a data da importação e que a planilha só sai quando a primeira sincronização terminar bem. ##### Cartões numéricos Quatro números fixos e um quinto opcional, todos só de leitura: clicar neles não leva a lugar nenhum. Campos e filtros: - **Leads no período**: Total de leads da conta desde sempre (a linha de baixo diz **total da sua conta**). Não zera por dia nem por mês. - **Taxa de qualificação**: Leads Quentes mais Mornos divididos pelo total, em porcentagem (**Quentes + Mornos sobre o total**). - **1ª resposta típica**: A mediana do tempo até a primeira resposta da conversa, com a meta escrita embaixo (**mediana · meta < 30s**). Mostra um traço quando ainda não há conversa para medir. - **Taxa de handoff**: A fatia das conversas que passou para uma pessoa da equipe (**conversas com transbordo**). - **Satisfação (CSAT)**: A média das notas de 1 a 5 dadas pelos leads e quantas notas existem. Só aparece depois da primeira nota. ##### FUNIL DE QUALIFICAÇÃO O cartão **Da conversa ao fechamento**: cinco barras, cada uma com o número e a porcentagem sobre o total de leads. Também aparece: - **Leads criados**: todos os leads da conta (a barra cheia). - **Qualificados (BANT)**: leads Quentes e Mornos. - **Quente**: só os leads na faixa mais alta da nota. - **Em handoff**: conversas aguardando humano ou em atendimento humano agora. - **Encerradas**: conversas encerradas. - As três primeiras linhas contam leads; as duas últimas contam conversas. ##### PRÓXIMOS AGENDAMENTOS As três reuniões mais próximas que a IA marcou. O cartão some quando não há reunião. Botões e ações: - **Ver agenda →**: Abre a Agenda com a semana inteira. - **‹reunião›**: Cada reunião mostra o dia, o nome do lead e o horário com a nota **marcada pela IA**. Clicar abre no Inbox a conversa em que ela foi combinada. ##### DISTRIBUIÇÃO BANT Como a base se divide pela nota da IA. Também aparece: - Uma linha para cada faixa — **Quente**, **Morno**, **Frio** e **Sem score** —, com a quantidade de leads e a porcentagem sobre o total. - Não é clicável: para ver a lista por trás de uma faixa, filtre no CRM & Graph ou na Base de contatos. ##### AO VIVO AGORA O estado deste instante, que atualiza sozinho. Campos e filtros: - **conversas ativas com a SDR de IA**: O número grande: conversas abertas neste momento. - **aguardando humano**: Conversas que esperam uma pessoa da equipe assumir. - **consumo hoje**: O que saiu do saldo da conta hoje, contado no fuso de quem está olhando a tela. Botões e ações: - **Abrir inbox →**: Abre o Inbox. ##### Leads qualificados recentes Os quatro leads com a nota mais alta da conta, com nome, empresa ou telefone, origem e a faixa com a nota. Botões e ações: - **Ver todos**: Abre o CRM & Graph com a lista completa de leads. - **‹lead›**: Cada linha abre a ficha do lead no CRM & Graph. ##### Persona em teste O resultado do teste A/B de persona dos últimos 30 dias, quando há um rodando. Botões e ações: - **Ver teste →**: Abre Personas A/B, com o teste ativo ou com o caminho para criar a variante B. Também aparece: - Com teste ativo: as variantes **A** e **B**, cada uma com o nome, a taxa de conversão e uma barra. A vencedora ganha moldura e a marca **vence** quando a amostra já basta. - Enquanto a amostra é pequena, a linha **Coletando dados** mostra quantos leads cada variante já tem diante do mínimo necessário. - Sem teste: a frase **Sem teste A/B ativo — crie uma variante B no editor de personas para começar a comparar.** ##### Estados da tela - Carregando: Três blocos cinzentos ocupam o lugar dos cartões até os números chegarem. - Sem nada ainda: Conta sem leads mostra os cartões e o funil zerados e, no bloco de leads, a frase **Nenhum lead ainda — eles aparecem conforme chegam mensagens.** - Se der erro: Quando os números não carregam, a tela inteira troca pelo aviso **Não foi possível carregar o seu painel**, explica que os números não zeraram e oferece **Tentar de novo**. - Só a lista de leads recentes falhou: O bloco mostra **Não foi possível carregar os leads recentes**, lembra que isso não quer dizer que não chegou ninguém e oferece **Tentar de novo**; o resto da tela segue normal. - Ainda não existe nota de satisfação: O cartão **Satisfação (CSAT)** não aparece; ficam só os quatro cartões fixos. - Nenhuma reunião marcada: O cartão **PRÓXIMOS AGENDAMENTOS** some e a coluna da direita começa pela **DISTRIBUIÇÃO BANT**. ### Passo a passo #### Como saber se tem lead esperando atendimento humano agora 1. Abra o **Painel** no menu. 2. No cartão **AO VIVO AGORA**, olhe o número de **aguardando humano**. 3. Se for maior que zero, clique em **Abrir inbox →** e atenda primeiro quem espera. #### Como ver o tempo de primeira resposta da IA 1. Abra o **Painel**. 2. Leia o cartão **1ª resposta típica**: é a mediana do tempo até a primeira resposta. 3. Compare com a meta escrita embaixo do número; acima dela, revise o horário de atendimento e a capacidade da equipe nos horários de pico. #### Como descobrir em que etapa os leads estão se perdendo 1. No **FUNIL DE QUALIFICAÇÃO**, compare a barra de **Leads criados** com a de **Qualificados (BANT)**. 2. Queda grande entre as duas indica conversas que acabam antes de o lead dar sinal: ajuste o roteiro em Qualificação. 3. Depois, compare **Qualificados (BANT)** com **Quente** para ver se os sinais estão separando quem está pronto para comprar. #### Como abrir a conversa de uma reunião marcada pela IA 1. No cartão **PRÓXIMOS AGENDAMENTOS**, encontre a reunião pelo dia e pelo nome do lead. 2. Clique nela: o Inbox abre na conversa em que o horário foi combinado. 3. Para a semana inteira, use **Ver agenda →**. #### Como acompanhar o teste A/B de persona pelo Painel 1. Role até o bloco **Persona em teste**. 2. Compare a taxa de conversão das variantes **A** e **B**; enquanto aparecer **Coletando dados**, ainda não há vencedora. 3. Clique em **Ver teste →** para abrir Personas A/B e encerrar ou ajustar o teste. ### Perguntas frequentes #### Por que os cartões do Painel não abrem a lista de leads quando eu clico? Os cartões numéricos, o funil e a distribuição BANT são só leitura. Para ver as pessoas por trás de um número, use os filtros do CRM & Graph ou da Base de contatos. #### O Painel precisa ser recarregado para atualizar? Não. O bloco ao vivo e os números mudam sozinhos conforme as conversas andam. Se um número parece parado, é porque nada mudou naquele intervalo. #### O Painel mostra resultados por período, como semana ou mês? Não. Ele mostra o estado de agora e o acumulado da conta. Comparação entre períodos fica em Analytics. #### Por que o cartão de satisfação não aparece no meu Painel? Ele só aparece depois que o primeiro lead dá uma nota. Enquanto a pergunta de satisfação não estiver ligada em Configurações, não há nota para mostrar. #### Os leads qualificados recentes são os que chegaram por último? Não exatamente: a lista traz os quatro leads com a nota mais alta da conta. Para ver por data de chegada, use o CRM & Graph ou a Base de contatos. #### O atendente vê o mesmo Painel que o dono? Vê os mesmos números e blocos. Só os avisos de administração da conta, como o da troca da planilha pela sincronização, ficam com o dono e os administradores. #### O que é a taxa de handoff no Painel? É a porcentagem de conversas que passou da IA para uma pessoa da equipe. Ela não tem valor certo: serve para perceber se a equipe está sendo chamada demais ou de menos. ### Guia: Painel A primeira tela do dia. Ela não resolve nada sozinha: serve para você decidir onde colocar a atenção nos próximos dez minutos. O Painel não é relatório. Relatório é [Analytics](https://attendto.com.br/manual/analytics), que compara períodos. Aqui você olha o estado de agora e sai com uma decisão só: **abrir o Inbox, mexer no roteiro, ou não fazer nada**. Se você terminou de ler e não sabe o que fazer, leia de novo pelos três critérios do fim desta página. #### A tela por partes Na tela: Painel com quatro cartões numéricos no topo, o funil de qualificação à esquerda e três cartões à direita. Números no topo, funil à esquerda, o que está acontecendo agora à direita. 1. **Os cartões do topo**: **Leads no período**, **Taxa de qualificação**, **1ª resposta típica** e **Taxa de handoff**. **Satisfação (CSAT)** entra como quinto cartão quando existirem notas. Eles são só leitura: clicar não leva a lugar nenhum. 2. **FUNIL DE QUALIFICAÇÃO**: Cinco linhas, de **Leads criados** até **Encerradas**. A largura da barra é a proporção sobre o total de leads. É onde o vazamento aparece: a linha que despenca é a etapa que está quebrada. 3. **PRÓXIMOS AGENDAMENTOS**: As três reuniões mais próximas. Clique numa delas e você cai na conversa que a marcou. **Ver agenda →** abre a semana inteira. Este cartão some quando não há reunião marcada. 4. **DISTRIBUIÇÃO BANT**: Como a sua base está dividida entre **Quente**, **Morno**, **Frio** e **Sem score**. Muito **Sem score** quer dizer conversas curtas demais para arrancar sinal, não lead ruim. 5. **AO VIVO AGORA**: Quantas conversas estão abertas neste instante, quantas estão **aguardando humano** e o **consumo hoje** em reais. **Abrir inbox →** leva direto para a fila. #### O que cada número quer dizer - **Leads no período**: Apesar do nome, é o **total da sua conta** — todo mundo que já entrou, desde sempre. Ele não zera na virada do dia nem do mês. Serve para saber o tamanho da base, não o crescimento dela. - **Taxa de qualificação**: Quentes mais Mornos, dividido pelo total. Diz quanta gente da base chegou a dar sinal de compra. Cai quando entra muito lead novo de uma vez — o que é normal depois de uma campanha. - **1ª resposta típica**: Quanto tempo o lead espera pela primeira resposta na conversa típica — é a **mediana**, não a média: uma conversa respondida dias depois (fio calado, fila humana) não puxa o número da conta inteira. A meta escrita no cartão é **menos de 30s**. Este é o número que mais mexe em venda: acima de um minuto, boa parte das pessoas já foi falar com outro. - **Taxa de handoff**: A fatia de conversas que precisou de gente. Não existe número certo: é alta demais quando o time não dá conta, e baixa demais quando ninguém está sendo chamado para fechar. - **Satisfação (CSAT)**: A média das notas de 1 a 5 que os leads deram. O cartão só existe depois da primeira nota — se ele não aparece, é porque a pergunta de satisfação ainda não foi ligada em [Configurações](https://attendto.com.br/manual/configuracoes). > **Leads no período não serve para reportar o mês:** É o total acumulado da conta. Quem anota esse número toda segunda e apresenta a diferença como o resultado do mês está somando gente que entrou há um ano. Crescimento por período está em [Analytics](https://attendto.com.br/manual/analytics), que é a tela feita para isso. #### Ler o funil sem se enganar As três primeiras linhas — **Leads criados**, **Qualificados (BANT)** e **Quente** — contam pessoas. As duas últimas — **Em handoff** e **Encerradas** — contam conversas. Por isso, nessas duas, o número vale mais que a porcentagem ao lado. - Cai muito de **Leads criados** para **Qualificados (BANT)**: as conversas morrem antes de a pessoa dar sinal. É roteiro, não volume — veja [Qualificação](https://attendto.com.br/manual/qualificacao). - **Qualificados** razoável e **Quente** quase zero: os sinais estão sendo capturados, mas o peso deles não separa ninguém. Também é [Qualificação](https://attendto.com.br/manual/qualificacao). - **Em handoff** crescendo sem parar: as perguntas que travam a conversa se repetem. Cada resposta escrita em [Base de conhecimento](https://attendto.com.br/manual/base-de-conhecimento) tira uma dessas da sua mesa. - **Encerradas** alto é bom sinal, não ruim: assunto que acabou. Se o lead voltar a escrever, a conversa reabre sozinha. #### O que leva a algum lugar Metade desta tela é leitura pura, e saber qual metade evita aquele minuto clicando em número que não responde. Navegam, e só eles: - **Ver agenda →** e cada reunião de **PRÓXIMOS AGENDAMENTOS** — a reunião abre a conversa em que ela foi combinada, não a [Agenda](https://attendto.com.br/manual/agenda). - **Abrir inbox →**, no cartão **AO VIVO AGORA**. - **Ver todos**, no bloco **Leads qualificados recentes** mais abaixo, que abre o [CRM & Graph](https://attendto.com.br/manual/crm); e cada lead da lista, que abre a ficha dele. - **Ver teste →**, no bloco **Persona em teste**, que abre [Personas A/B](https://attendto.com.br/manual/personas). - Os cartões numéricos do topo, o funil e a **DISTRIBUIÇÃO BANT** não são clicáveis. Para a lista por trás de um número, use os filtros do [CRM & Graph](https://attendto.com.br/manual/crm) ou da [Base de contatos](https://attendto.com.br/manual/base-de-contatos). #### Os três critérios de decisão 1. **Tem alguém aguardando humano?**: Se **aguardando humano** for maior que zero, pare aqui e abra o [Inbox](https://attendto.com.br/manual/inbox). Lead esperando é a única coisa nesta tela que piora enquanto você lê o resto. 2. **A 1ª resposta está acima da meta?**: Se estiver, o problema é de capacidade, não de conteúdo: é gente demais para pouca mão na hora do pico. Olhe [Transbordo para humano](https://attendto.com.br/manual/handoff) e o horário de atendimento antes de mexer em qualquer roteiro. 3. **A qualificação está baixa com bastante lead?**: Base grande e **Taxa de qualificação** baixa é sintoma de roteiro, não de tráfego. Trazer mais gente só aumenta o denominador. Ajuste os sinais em [Qualificação](https://attendto.com.br/manual/qualificacao) e volte em uma semana. 4. **Nada disso?**: Então o dia está sob controle e o melhor uso da sua próxima hora não está nesta tela. Escreva uma resposta nova em [Base de conhecimento](https://attendto.com.br/manual/base-de-conhecimento). #### Como é quando está redondo - **1ª resposta típica** abaixo de 30s, sem depender de ninguém estar de plantão. - **aguardando humano** em zero na maior parte do dia, subindo só nos momentos em que faz sentido chamar gente. - **Sem score** minguando semana após semana na **DISTRIBUIÇÃO BANT**: as conversas estão durando o suficiente para a pessoa contar o que precisa. - **PRÓXIMOS AGENDAMENTOS** com nome nele. Cartão vazio some da tela — e sumir sempre é sinal de olhar a [Agenda](https://attendto.com.br/manual/agenda). - **consumo hoje** num valor que você reconhece. Salto sem campanha no ar merece uma passada em [Saldo & Recargas](https://attendto.com.br/manual/saldo-e-recargas). > **Os números atualizam sozinhos:** Não precisa recarregar a página para ver a fila mudar. Se um número parece congelado, é porque nada aconteceu — não porque a tela travou. No painel: Abrir o Painel. Como as pessoas procuram: painel de atendimento com ia; dashboard de vendas whatsapp; tempo de primeira resposta; taxa de qualificação de leads; funil de qualificação bant; quantos leads aguardando humano; taxa de handoff; csat atendimento; visão geral do atendimento; próximos agendamentos da ia; consumo do dia; teste a/b de persona. ## Inbox: como atender, assumir e transferir conversas do WhatsApp com a IA URL: https://attendto.com.br/manual/inbox Menu: Operação > Inbox O Inbox é a caixa de entrada do painel: todas as conversas de todos os canais chegam numa lista só, em tempo real, e é nele que a equipe acompanha a IA, assume a conversa, responde e devolve para a IA. ### Quem pode usar - Dono: Usa tudo: lê, atribui, responde, devolve, encerra, envia modelos, etiqueta, anota, exclui conversas pelo menu **Mais ações** e, em conversa do chat do site com telefone, usa **Continuar no WhatsApp**. - Admin: Usa tudo o que o dono usa, inclusive **Excluir conversa**; o botão **Continuar no WhatsApp** é só do dono. - Atendente: Lê todas as conversas, atribui, responde, devolve para a IA, encerra, envia modelos, etiqueta e anota. Não vê **Excluir conversa** nem **Continuar no WhatsApp**. ### Telas #### Inbox A tela Inbox serve para ver todas as conversas da conta numa lista ao vivo, filtrar por quem está com a conversa, canal, conta e etiqueta, e abrir a próxima pessoa que aguarda atendimento. Endereço no painel: `/app/inbox` ![Captura da tela Inbox. A tela Inbox serve para ver todas as conversas da conta numa lista ao vivo, filtrar por quem está com a conversa, canal, conta e etiqueta, e abrir a próxima pessoa que aguarda atendimento.](https://attendto.com.br/prints-do-manual/inbox--lista-de-conversas.png) A tela Inbox na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Pelo item **Inbox** do menu, em OPERAÇÃO. O número ao lado do item conta as conversas aguardando humano; um ponto de exclamação no lugar do número quer dizer que a contagem não pôde ser feita. Também pelo botão **Abrir inbox →** do Painel. ##### Menu recolhido No Inbox o menu lateral vira uma coluna de ícones para a conversa ganhar largura. Também aparece: - Passe o mouse num ícone para ver o nome do item. - O botão do pé do menu abre o menu inteiro enquanto você está no Inbox; nas outras telas ele volta a ficar como você deixou. ##### Cabeçalho da lista: Conversas O título da coluna e os botões de ajuste da lista. Botões e ações: - **Confortável**: Densidade da lista com avatar grande, prévia da mensagem, faixa da nota e etiquetas em cada linha. - **Compacta**: Densidade com linhas mais baixas: nome, mensagem e um ponto na cor da faixa da nota. Cabem quase o dobro de conversas. - **Atalhos de teclado**: Abre a lista de atalhos do Inbox (o mesmo que a tecla **?**). Não aparece no celular. - **Recolher lista de conversas**: Recolhe a lista num trilho fino de avatares (o mesmo que a tecla **[**). A escolha fica guardada neste navegador. Também aparece: - Na primeira vez que você muda a densidade, recolhe a lista ou o dossiê, aparece o aviso **Escolha guardada: o Inbox abre assim da próxima vez.** ##### Busca e filtros Todos os recortes valem juntos, são feitos sobre a conta inteira (não só sobre o que já carregou) e ficam no endereço da página, prontos para virar link. Campos e filtros: - **Buscar por nome, telefone ou empresa**: Acha a conversa pelo contato: nome, telefone, empresa ou e-mail. A busca é aplicada depois de uma pausa curta na digitação. - **Etiquetas**: Menu com as etiquetas usadas nas conversas e, ao lado de cada uma, quantas conversas ela traz no recorte de canal escolhido. **Todas as etiquetas** desliga o filtro. Escolhida, a etiqueta vira uma pílula com **x** para limpar. O menu só aparece quando existe alguma etiqueta. - **Conta**: Fileira que só aparece quando um mesmo canal tem duas ou mais contas ativas (por exemplo, dois números de WhatsApp). Cada botão mostra o apelido ou o número da conta; **Todas** devolve tudo. Botões e ações: - **Todas**: Na fileira de atendimento, mostra as conversas em qualquer situação. - **Com a IA**: Só as conversas que a IA está conduzindo. - **Na fila**: Só as conversas aguardando humano. - **Com atendente**: Só as conversas que uma pessoa da equipe assumiu. - **Encerradas**: Só as conversas encerradas. - **Todos**: Na fileira de canal, desliga o filtro de canal. A fileira aparece quando há conversas de mais de um canal, com um botão por canal (WhatsApp, Web chat, Instagram, SMS, E-mail). ##### Linha da conversa Uma linha por conversa, a mais recente em cima, com carregamento contínuo ao rolar. Também aparece: - Avatar do contato com o selo do canal no canto. Contato do Instagram mostra a foto do perfil; sem foto, aparecem as iniciais. - Ponto colorido com a cor da faixa da nota e, em conversa do Instagram, o ícone do Instagram antes do nome. - Nome do lead e há quanto tempo foi a última atividade. - Prévia da última mensagem; áudio sem texto aparece como **Áudio**. - Faixa da nota com o número (**Quente**, **Morno**, **Frio** ou **Sem score**). - Selo **Comentário** quando a conversa nasceu de um comentário no Instagram. - Selo vermelho **IA pausada — sem saldo** quando a IA parou por falta de saldo. - Selo **IA calada — resposta pelo celular** quando alguém respondeu o lead pelo celular e a IA ficou quieta naquela conversa. - Selo **SLA violado** quando a espera passou do prazo combinado, ou o texto **aguardando ‹tempo›** para quem está na fila. - As duas primeiras etiquetas do contato e, se houver mais, **+‹n›** (passe o mouse para ver as outras). - A posição de rolagem da lista é mantida ao abrir uma conversa e voltar. ##### Trilho da lista recolhida A lista recolhida vira uma coluna estreita de avatares. Botões e ações: - **Abrir lista de conversas**: Abre a lista de novo (tecla **[**). - **Buscar conversas**: Reabre a lista já com o cursor no campo de busca. - **‹avatar do contato›**: Abre a conversa daquele contato. O anel tem a cor da faixa da nota, e um ponto marca quem aguarda humano; o nome, a faixa e a espera aparecem ao passar o mouse. Também aparece: - No alto, um número conta quantas conversas aguardam atendimento. ##### Sem conversa aberta: Selecione uma conversa O meio da tela, antes de você abrir uma conversa. Botões e ações: - **Abrir a próxima aguardando**: Abre a conversa que espera há mais tempo pela equipe. O atalho **Alt + ↓** faz o mesmo. Também aparece: - A frase diz **Ninguém aguardando atendimento agora.** ou quantas pessoas aguardam e há quanto tempo espera a mais antiga. - Uma linha lembra os atalhos: **Alt + ↓** abre a próxima e **?** mostra todos. ##### Diálogo Atalhos do Inbox Aberto pela tecla **?** ou pelo botão de teclado. Os atalhos de uma tecla só funcionam fora do campo de resposta. Botões e ações: - **Recolher ou abrir a lista**: Tecla **[**. - **Recolher ou abrir o dossiê**: Tecla **]**. - **Maximizar ou restaurar o chat**: Tecla **F**. - **Maximizar ou restaurar (também dentro do campo)**: **Ctrl + Shift + M**, que vale em qualquer lugar. - **Trocar de conversa (maximizado)**: **Alt + K** abre o seletor de conversas com busca. - **Conversa anterior**: **Alt + ↑**. - **Próxima conversa**: **Alt + ↓**; sem conversa aberta, abre a próxima aguardando. - **Fechar gaveta, seletor ou sair do modo ampliado**: **Esc**. - **Enviar a resposta**: **Enter** no campo de resposta. - **Quebrar a linha**: **Shift + Enter** no campo de resposta. - **Fechar**: Fecha a lista de atalhos. ##### Aviso de IA desligada Faixa no alto da lista quando a IA da conta foi desligada. Também aparece: - Título **As conversas novas vão para a fila da equipe**: ninguém responde automaticamente e as conversas precisam ser distribuídas entre os atendentes. ##### Estados da tela - Carregando: Cinco linhas cinzentas ocupam a lista até as conversas chegarem; ao rolar, uma linha cinzenta no fim indica que a próxima leva está vindo. - Sem nada ainda: Conta sem conversas mostra **Nenhuma conversa ainda.** - Se der erro: A lista mostra **Não foi possível carregar as conversas**, explica que nenhuma mensagem foi perdida e oferece **Tentar de novo**. - Filtro ligado e nada encontrado: A frase **Nenhuma conversa ‹recorte›** nomeia todos os filtros ligados (busca, etiqueta, canal, situação e conta) e o botão **Ver todas as conversas** limpa todos de uma vez. - As etiquetas não carregaram: No lugar do menu aparece **Não consegui carregar as etiquetas**, com **Tentar de novo**; as conversas continuam na lista. - Tela de até 1023 px ou celular: O Inbox vira uma coluna só: aparece a lista ou a conversa, nunca as duas lado a lado. #### Conversa ao vivo A conversa aberta do Inbox serve para ler o histórico inteiro com o lead, ver o dossiê antes de escrever, assumir ou repassar o atendimento, responder com texto, anexo, áudio ou modelo aprovado, devolver para a IA e encerrar. Endereço no painel: `/app/inbox/‹…›` ![Captura da tela Conversa ao vivo. A conversa aberta do Inbox serve para ler o histórico inteiro com o lead, ver o dossiê antes de escrever, assumir ou repassar o atendimento, responder com texto, anexo, áudio ou modelo aprovado, devolver para a IA e encerrar.](https://attendto.com.br/prints-do-manual/inbox--conversa-aberta.png) A tela Conversa ao vivo na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Clicando numa linha da lista do Inbox, em **Abrir a próxima aguardando**, em **Assumir conversa** no Handoff, em **Abrir conversa** nos Tickets, em **Abrir no Inbox** na Supervisão, numa reunião de **PRÓXIMOS AGENDAMENTOS** no Painel ou pela busca geral do painel. O título da tela diz **Inbox** e o subtítulo **Conversa ao vivo**. ##### Cabeçalho: quem é o lead A primeira linha identifica o lead; a segunda diz por onde a conversa chegou. Botões e ações: - **Voltar para a lista de conversas**: Seta que só aparece no celular e em telas estreitas; volta para a lista mantendo os filtros. - **Continuar no WhatsApp** (Dono): Em conversa do chat do site em que o visitante deixou telefone, transforma o contato num contato de WhatsApp e abre a conversa por lá, onde a primeira mensagem sai por modelo aprovado. Se o número já tinha contato, a conversa abre nele. Também aparece: - Avatar, nome do lead e a faixa da nota com o número. - Pílula **LGPD** quando o lead deu consentimento, ou **Sem consentimento**. - Selo da negociação conduzida pela IA: **Closer em ação**, **Closer chamou o humano** ou **Closer fechou**. - Selo **Fechou o chat há ‹tempo›** quando o visitante do chat do site fechou a janela; some sozinho quando ele volta. - Selo **Segue a conta** quando o lead do Instagram segue o perfil da empresa. - Na segunda linha: empresa e telefone, o canal, o apelido da conta quando o canal tem mais de uma, **no celular** quando o número também é usado no aplicativo do celular, e a origem (**veio da integração ‹nome›** ou **veio de anúncio**, com a campanha). - **digitando…** aparece quando o visitante do chat do site está escrevendo. ##### Cabeçalho: quem atende e as ações À direita do cabeçalho ficam a atribuição e as ações sobre a conversa. Botões e ações: - **‹atendente ou situação› · atribuir**: Mostra quem atende (com as iniciais) ou, sem ninguém, a situação: **IA respondendo**, **Aguardando humano**, **IA pausada — sem saldo**, **IA calada — resposta pelo celular** ou **Encerrada**. Clicar abre o menu **ATRIBUIR A** com a equipe; escolher alguém atribui a conversa na hora e mostra **Conversa atribuída a ‹nome›**. - **Devolver para a IA**: Tira a conversa da pessoa e devolve para a IA, que retoma o acompanhamento. Não aparece com a conversa encerrada nem quando a IA da conta foi desligada. - **Encerrar**: Encerra a conversa e mostra **Conversa encerrada. Se o lead escrever de novo, ela volta para a IA.** O botão some depois de usado. - **Maximizar o chat**: A conversa ocupa a janela inteira: somem o menu, o cabeçalho do painel, a lista e o dossiê (teclas **F** ou **Ctrl + Shift + M**). O botão passa a dizer **Restaurar**, e **Esc** também volta. - **Mais ações**: Os três pontos abrem o menu da conversa. No computador ele aparece só para dono e admin, com **Excluir conversa**; no celular ele também reúne a atribuição, **Devolver para a IA** e **Encerrar**. - **Excluir conversa** (Dono, Admin): Item do menu **Mais ações** (com a nota **Apaga as mensagens e os arquivos**) que abre a confirmação de exclusão. - **Trocar de conversa**: Só no celular: abre o seletor de conversas com busca. - **Abrir dossiê do lead**: Só no celular: sobe o dossiê numa folha de baixo para cima. ##### Botões do modo maximizado Com o chat maximizado, o cabeçalho ganha os atalhos para não precisar restaurar. Botões e ações: - **Conversas**: Abre o seletor **Trocar de conversa** com o campo **Buscar conversa…**; as setas navegam, **Enter** abre e **Esc** fecha (atalho **Alt + K**). - **Conversa anterior**: Abre a conversa de cima na lista (**Alt + ↑**). - **Próxima conversa**: Abre a conversa de baixo na lista (**Alt + ↓**). - **Dossiê**: Abre o dossiê numa gaveta por cima da conversa (tecla **]**); **Fechar dossiê** ou **Esc** fecham. - **Restaurar**: Volta ao tamanho normal, com a lista e o dossiê. Também aparece: - No seletor, a busca procura pelo nome e pela última mensagem; sem resultado, aparece **Nenhuma conversa com esse nome.** ##### Faixa de etiquetas e resumo do dossiê A faixa logo abaixo do cabeçalho resume o que você precisa ler antes de escrever. Botões e ações: - **+ Etiqueta**: Abre o diálogo **Colocar uma etiqueta**. Não aparece para contato anonimizado a pedido do titular. - **‹etiqueta› x**: O **x** de cada etiqueta abre a confirmação **Remover esta etiqueta?**. - **Dossiê completo**: Abre ou recolhe a coluna do dossiê (tecla **]**). Também aparece: - Sem etiqueta: **Sem etiquetas.**; contato anonimizado: **Contato anonimizado (LGPD): sem etiquetas.** - **Pedido**: os itens que a IA já montou com o lead, ou **ainda sem itens**. - **Próximo passo**: o que a IA combinou como passo seguinte, ou **entender o que a pessoa precisa**. - **Travou em**: a objeção mais recente do lead, ou **nada até agora**. ##### Diálogo Colocar uma etiqueta Aplica uma etiqueta existente ou cria uma nova. É a mesma etiqueta da Base de contatos e dos públicos de Campanhas. Campos e filtros: - **Buscar ou criar etiqueta**: Filtra as etiquetas que a conta já usa, sem diferenciar maiúsculas. Aceita até 60 caracteres. **Enter** aplica a única sugestão ou cria a etiqueta nova. Botões e ações: - **‹etiqueta sugerida›**: Aplica a etiqueta ao contato e mostra **Etiqueta "‹nome›" aplicada**. - **Criar "‹nome›"**: Cria a etiqueta com o nome digitado e aplica. Fica apagado quando o nome já existe, mesmo escrito com outras maiúsculas. - **Cancelar**: Fecha sem mudar nada. Também aparece: - Frases da lista vazia: **Este contato já tem a etiqueta "‹nome›".**, **Nenhuma etiqueta criada ainda. Escreva o nome da primeira acima.**, **Este contato já tem todas as etiquetas existentes.** ou **Nenhuma etiqueta com "‹texto›".** - Contato no limite de etiquetas: o diálogo avisa que é preciso remover uma antes, e o botão vira **Fechar**. - Se a lista de etiquetas existentes não carregar, ainda dá para criar uma nova, com o aviso de que ela pode repetir uma que já existe. ##### Confirmação Remover esta etiqueta? A etiqueta sai só deste contato, no Inbox e na Base de contatos; os outros contatos que a usam não mudam. Botões e ações: - **Remover etiqueta**: Tira a etiqueta e mostra **Etiqueta "‹nome›" removida**. - **Cancelar**: Mantém a etiqueta. ##### Mensagens O histórico da conversa, que abre já no fim e acompanha as mensagens novas enquanto você está perto do fim. Botões e ações: - **Ouvir áudio**: Toca o áudio no player do painel. A onda ao lado mostra o andamento: clique num ponto para pular, ou use **Espaço** e as setas (5 segundos para cada lado). - **‹velocidade›**: Troca a velocidade do áudio entre 1×, 1,5× e 2× sem parar a reprodução. - **‹vídeo› · toque para carregar**: O vídeo só é baixado quando você clica nele. - **‹documento›**: Clicar no documento baixa o arquivo. Também aparece: - Separador de dia (**Hoje**, **Ontem** ou a data) e avisos do sistema numa pílula central. - Mensagens do lead de um lado e da equipe ou da IA do outro, cada uma com o nome real de quem escreveu, o horário e o recibo de entrega: **Enviada**, **Entregue**, **Lida**, **Falhou** ou **Envio não confirmado**. - Mensagem que falhou mostra o motivo em português logo abaixo da bolha. - **Não entregue · fora da janela de 24h**: a mensagem ficou registrada, mas o WhatsApp não entrega texto livre fora da janela. - **Aviso automático · não é a resposta**: o aviso de recebimento enviado enquanto a IA estava pausada. - **Enviada pelo celular**, **Respondeu ao seu story**, **Menção em story**, **Resposta gravada · ‹título›**, **Enviada pela cadência · passo ‹n›** e **Primeiro contato automático** contam de onde a mensagem veio. - Em imagens que a IA leu: o que ela leu, a marca **Respondeu com o que leu na foto das ‹hora›** e, enquanto lê, **A IA está lendo a imagem…** (quando a conta mostra a leitura para a equipe). - Balão de três pontos quando o visitante do chat do site está digitando. ##### Avisos acima da caixa de resposta Faixas que explicam por que a IA parou ou por que a resposta não sai, sempre com o caminho para resolver. Botões e ações: - **Recarregar agora**: Aparece no aviso **A IA parou de responder por falta de saldo** e abre Saldo & Recargas. Responder como atendente não consome saldo. - **Devolver para a IA**: No aviso **Você respondeu pelo celular.**, devolve a conversa para a IA antes do prazo em que ela ficaria calada. - **Reabrir conversa**: No aviso de janela de 24h fechada, abre o diálogo para escolher um modelo aprovado e reabrir a conversa. Também aparece: - **A IA parou de responder por falta de saldo**: diz se o lead recebeu só o aviso automático de recebimento ou se a mensagem dele está sem resposta. - **Você respondeu pelo celular.**: a IA não responde nesta conversa até a data mostrada ou até alguém devolver. - **A IA desta conta foi desligada: a conversa segue com a equipe.**: aparece no lugar do botão de devolver. - Conversa do Instagram nascida de comentário: **Mensagem do gatilho enviada** — o Instagram permite uma só mensagem a partir de um comentário, e a conversa abre quando a pessoa responder. - Instagram fora da janela: não existe modelo de retomada; dá para responder assim que a pessoa escrever de novo. - **A janela de 24h do WhatsApp fechou — mensagens livres não são entregues.** com o botão **Reabrir conversa**. - Modelo de reabertura já enviado: uma linha discreta diz há quanto tempo ele saiu e que a conversa aguarda a resposta do lead; enquanto isso não dá para reenviar. - **Conversa encerrada.** com a lembrança de que ela volta para a IA se o lead escrever. ##### Caixa de resposta Uma linha que cresce conforme você escreve. A linha de cima diz em nome de quem a resposta sai. Campos e filtros: - **Escreva sua resposta…**: O texto da resposta. **Enter** envia, **Shift + Enter** quebra a linha e **/** com o campo vazio abre os modelos aprovados. Com um anexo escolhido, o campo vira **Legenda do anexo (opcional)…**. Na conversa encerrada fica travado. Botões e ações: - **Anexar arquivo**: Escolhe uma imagem, PDF, Word, Excel ou CSV de até 16 MB. O arquivo aparece numa linha com o nome e o tamanho antes de enviar. - **Remover anexo**: Tira o arquivo escolhido antes do envio. - **Inserir emoji**: Abre o seletor de emoji e coloca o escolhido onde está o cursor. - **Enviar modelo aprovado**: Abre o diálogo de modelos com a janela de 24h aberta (atalho **/**). Só em conversa de WhatsApp; o modelo tem custo por entrega mesmo com a janela aberta. - **Gravar mensagem de voz**: Só em conversa de WhatsApp: começa a gravar. Na primeira vez o navegador pede permissão de microfone. - **Parar a gravação**: Termina a gravação e mostra a prévia para ouvir antes de enviar (o botão **Parar** da faixa faz o mesmo). - **Descartar a gravação**: Apaga a prévia gravada; durante a gravação o mesmo botão se chama **Cancelar a gravação**. - **Responder**: Envia o texto como atendente (tecla **Enter**). Com anexo vira **Enviar anexo**; com áudio gravado, **Enviar áudio**. Sem ninguém atendendo, a conversa passa primeiro para você. Também aparece: - Linha de cima: **Você responde como ‹nome›**, **Ao responder, a conversa passa para você** ou **Escolha quem atende no topo para responder**. - Faltando menos de duas horas para a janela fechar: **A janela fecha em ‹tempo›** e o que acontece depois. - Durante a gravação: ponto vermelho, cronômetro e **Gravando…**. Sem permissão: **Permissão de microfone negada.** com o caminho para liberar. - Navegador que só grava num formato que o WhatsApp não aceita: o microfone fica apagado e a dica manda gravar no celular e enviar pelo anexo. - Ao passar o mouse no botão de envio travado, a dica diz o motivo (janela fechada, conversa encerrada, ninguém atendendo). - Rodapé: **Enter envia · Shift+Enter quebra a linha · / abre os modelos**. - Trocar de conversa descarta o texto, o anexo e a gravação que estavam pendentes, para nada sair na conversa errada. ##### Diálogo de modelo aprovado Com a janela fechada o título é **Reabrir a conversa com ‹nome›**; com ela aberta, **Enviar um modelo para ‹nome›**. Campos e filtros: - **Buscar por nome ou texto do modelo**: Aparece quando a conta tem seis modelos ou mais. - **Título**: Valor da variável do cabeçalho, quando o modelo tem uma. - **{{‹n›}}**: Um campo por variável do corpo. O **{{1}}** já vem com o primeiro nome do lead; as demais nascem vazias e ficam marcadas até serem preenchidas. Botões e ações: - **‹modelo›**: Cada linha mostra o nome, a categoria, o idioma (quando a conta tem mais de um) e o começo do texto; clicar escolhe o modelo. - **Trocar**: Volta para a lista e escolhe outro modelo. - **Enviar modelo**: Envia o modelo com os valores preenchidos. Fica travado sem modelo escolhido, com variável vazia ou com modelo que tem botão de link com variável; a dica diz o motivo. - **Cancelar**: Fecha sem enviar. - **Ir para Conexões**: Aparece quando o WhatsApp não está conectado. - **Criar um modelo**: Aparece quando ainda não há modelo aprovado e abre Modelos de mensagem. Também aparece: - Com a janela aberta, um aviso diz quem cobra o modelo nesta conta (a Meta, na conta do próprio cliente, ou o saldo da conta) antes do clique. - **O que muda a cada lead** lista as variáveis; **O que o lead recebe** mostra a prévia da mensagem montada. - Modelo sem variável: o lead recebe exatamente o texto aprovado. - Depois de enviar: **Modelo enviado — a janela reabre quando o lead responder.** (janela fechada) ou **Modelo enviado.** ##### Dossiê do lead (coluna da direita) Nasce recolhido num trilho fino e abre como coluna, gaveta (maximizado) ou folha (celular). Botões e ações: - **Abrir dossiê do lead**: No trilho, abre a coluna inteira (tecla **]**). - **Recolher dossiê do lead**: Recolhe a coluna de volta ao trilho (tecla **]**). - **Fechar dossiê**: Fecha a gaveta ou a folha (tecla **Esc**). - **Pedido em montagem**: Ícone do trilho que abre o dossiê já no pedido; só existe quando há itens. - **O que a IA já combinou**: Abre o dossiê no resumo da conversa. - **Onde ele travou**: Abre o dossiê nas objeções; a dica mostra a mais recente. - **Como a nota andou**: Abre o dossiê no histórico da nota. - **Auditoria**: Abre o dossiê na trilha de eventos da conversa. Também aparece: - No trilho, um anel pequeno mostra a nota do lead na cor da faixa. ##### QUALIFICAÇÃO AO VIVO O primeiro cartão do dossiê: a nota do lead e quantos sinais a IA já descobriu. Botões e ações: - **Gerar handoff para humano →**: Só com a IA respondendo: passa a conversa para a fila do Handoff. A IA escreve o resumo do dossiê nesse momento (o botão mostra **Resumindo a conversa…**) e o aviso **Transbordo solicitado — na fila do Handoff** confirma. - **Concordo**: Na pergunta **A qualificação da IA está correta?**, registra que a nota da IA acertou. Aparece com a conversa em atendimento humano e só uma vez por conversa; o voto alimenta o número **Handoff accuracy** do Handoff. - **Discordo**: Registra que a qualificação da IA errou. Também aparece: - Anel com a nota e a faixa, e a frase **‹n› de ‹m› sinais** — o que a IA já descobriu, não previsão de venda. ##### PEDIDO EM MONTAGEM e IMAGENS DESTA CONVERSA Aparecem só quando a conversa tem pedido em andamento ou imagens lidas pela IA. Também aparece: - Cada item do pedido diz de onde veio (da foto, com o horário, ou da conversa) e a quantidade. - **Recebe**: como o cliente quer receber. **Receita**: quem da equipe confere, quando há receita ou remédio na foto. - **Pergunta para ‹quem›**: a pergunta que só a equipe responde e que a IA anotou. - **Lidas pela IA**: quantas imagens a IA leu e o valor cobrado do saldo por elas. **Limite da conversa**: quantas foram lidas hoje diante do limite, ou **sem limite**. ##### DOSSIÊ DO LEAD O mesmo relatório da tela de Handoff: por que veio para um humano, o que a IA combinou, onde o lead travou, como a nota andou, o ritmo da conversa, o que a IA guardou e as anotações da equipe. Campos e filtros: - **O que o próximo atendente precisa saber?**: Campo da anotação da equipe, presa ao lead e não só a esta conversa. **Ctrl + Enter** salva; perto do limite de caracteres, o contador mostra quantos faltam. Botões e ações: - **Anotar**: Salva a anotação com o seu nome e a data. - **Remover a anotação de ‹autor›**: A lixeira de cada anotação abre **Remover esta anotação?**, que mostra o texto e pede **Remover anotação**. Não dá para desfazer. Também aparece: - O detalhe de cada bloco está na página do Handoff deste manual, que usa o mesmo dossiê. ##### INTENÇÃO PREVISTA O que a IA prevê que o lead quer, quando há previsão. Também aparece: - A intenção, a confiança com a data da detecção e, quando houver, **Oferta sugerida** com a oferta do catálogo. - Sem previsão: **Nenhuma predição de intenção para este lead ainda.** ##### Auditoria Os eventos registrados nesta conversa: atribuições, transbordos, devoluções, encerramentos e avaliações. Também aparece: - Cada evento mostra o que aconteceu, quem fez, detalhes quando houver e a data e hora. - Sem eventos: **Sem eventos.** Se a trilha não carregar: **Não foi possível carregar a auditoria**, com **Tentar de novo**. ##### Confirmação Excluir a conversa Aberta por **Excluir conversa** no menu **Mais ações**. Serve para limpar conversas de teste e não dá para desfazer. O foco nasce no **Cancelar**. Campos e filtros: - **Excluir também o contato**: Caixa opcional que tira o contato da Base de contatos e do Funil, com etiquetas, anotações e as outras conversas dele. - **Para excluir também o contato, digite**: Aparece com a caixa marcada: é preciso digitar **EXCLUIR** para liberar o botão. Botões e ações: - **Cancelar**: Fecha sem apagar nada. - **Excluir conversa** (Dono, Admin): Apaga a conversa; com a caixa marcada, o botão vira **Excluir conversa e contato**. A conversa some da lista para toda a equipe e a tela volta para a lista. Também aparece: - **Será apagado**: as mensagens, as fotos, áudios e arquivos e, quando existirem, reuniões agendadas, pedidos e a presença do contato em listas de campanha. - **Continua**: o contato na Base de contatos e no Funil (se a caixa não estiver marcada), o que já foi cobrado na Carteira e, na auditoria, quem excluiu e quando, sem o conteúdo das mensagens. - O rodapé avisa o que acontece se a pessoa escrever de novo: conversa nova do zero, ou contato novo sem histórico. - Se a exclusão falhar: **Não foi possível excluir.** com o motivo; nada é apagado. ##### Estados da tela - Carregando: A silhueta da conversa aparece em cinza (cabeçalho, bolhas e caixa de resposta) e, com o dossiê aberto, os blocos dele também, para nada pular quando os dados chegam. - Se der erro: A conversa troca pelo aviso **Não foi possível carregar esta conversa**, que deixa claro que nenhuma mensagem foi apagada, com **Tentar de novo**. A caixa de resposta não aparece, para ninguém responder sem ver o histórico. - Outra pessoa da equipe excluiu a conversa aberta: Aparece **Esta conversa foi excluída por outra pessoa da equipe.** e a tela volta para a lista. - Conversa encerrada: Somem **Devolver para a IA** e **Encerrar**, o aviso **Conversa encerrada.** fica acima do campo e o campo trava; modelo aprovado ainda pode ser enviado. - Janela de 24h fechada no WhatsApp: O envio de texto, anexo e áudio trava, e o aviso oferece **Reabrir conversa** com um modelo aprovado. - IA pausada por falta de saldo: O botão de quem atende fica em destaque com **IA pausada — sem saldo** e o aviso com **Recarregar agora** aparece acima do campo. - Celular ou tela de até 1023 px: A conversa ocupa a tela inteira, com a seta de voltar, o botão de trocar de conversa, o do dossiê em folha e o menu **Mais ações** reunindo atribuir, devolver e encerrar. ### Passo a passo #### Como assumir uma conversa da IA no Inbox 1. Abra o **Inbox** e clique na conversa (ou em **Abrir a próxima aguardando**). 2. Leia a faixa de **Pedido**, **Próximo passo** e **Travou em**; para o resto, clique em **Dossiê completo**. 3. Escreva no campo **Escreva sua resposta…** e clique em **Responder**: sem ninguém atendendo, a conversa passa para você e a IA para de responder. 4. O lead vê o seu nome na mensagem, nunca o nome da IA. #### Como transferir a conversa para outro atendente 1. Abra a conversa no **Inbox**. 2. No alto, à direita, clique no botão de quem atende (ou na situação, como **IA respondendo**). 3. Em **ATRIBUIR A**, escolha a pessoa: a conversa passa para ela na hora e aparece **Conversa atribuída a ‹nome›**. #### Como devolver a conversa para a IA 1. Com a conversa aberta, clique em **Devolver para a IA**, no cabeçalho (no celular, em **Mais ações**). 2. A IA retoma o acompanhamento e aparece **Conversa devolvida para a IA.** 3. Se o assunto acabou de vez, use **Encerrar** no lugar. #### Como responder um lead depois que a janela de 24 horas do WhatsApp fechou 1. Na conversa, procure o aviso **A janela de 24h do WhatsApp fechou** acima da caixa de resposta. 2. Clique em **Reabrir conversa** e escolha um modelo aprovado na lista. 3. Confira as variáveis em **O que muda a cada lead** e a prévia em **O que o lead recebe**. 4. Clique em **Enviar modelo**. Quando o lead responder, a janela abre de novo e o texto livre volta a funcionar. #### Como enviar mensagem de voz para o cliente pelo Inbox 1. Abra uma conversa de WhatsApp com a janela de 24h aberta. 2. Clique em **Gravar mensagem de voz** e permita o microfone, se o navegador pedir. 3. Fale e clique em **Parar a gravação**; ouça a prévia. 4. Clique em **Enviar áudio**, ou em **Descartar a gravação** para gravar de novo. #### Como etiquetar um contato e filtrar o Inbox por etiqueta 1. Na conversa, clique em **+ Etiqueta**, procure em **Buscar ou criar etiqueta** e clique numa existente ou em **Criar "‹nome›"**. 2. Na lista, abra o menu **Etiquetas** e escolha a etiqueta: só as conversas com ela aparecem. 3. Para voltar, clique no **x** da pílula da etiqueta ou em **Todas as etiquetas**. #### Como excluir uma conversa de teste 1. Abra a conversa e clique em **Mais ações** (os três pontos do cabeçalho). 2. Clique em **Excluir conversa** e confira o que será apagado e o que continua. 3. Para apagar também o contato, marque **Excluir também o contato** e digite **EXCLUIR**. 4. Clique em **Excluir conversa** (ou **Excluir conversa e contato**). Só dono e admin têm essa opção. #### Como maximizar a conversa e trocar de conversa pelo teclado 1. Com a conversa aberta, aperte **F** (fora do campo de resposta) ou clique em **Maximizar o chat**. 2. Use **Alt + ↑** e **Alt + ↓** para a conversa anterior e a próxima, ou **Alt + K** para buscar uma conversa. 3. Aperte **]** para ver o dossiê numa gaveta e **Esc** para restaurar. ### Perguntas frequentes #### Abrir uma conversa no Inbox tira ela da IA? Não. Ler não muda nada. A conversa só sai da IA quando alguém responde por ela, é atribuído no botão de quem atende ou clica em **Gerar handoff para humano →**. #### Por que o botão Responder está apagado? Passe o mouse sobre ele para ver o motivo. Os casos comuns são a janela de 24h fechada, a conversa encerrada ou ninguém da equipe ligado ao seu usuário para responder; nesse último caso, escolha quem atende no topo da conversa. #### Que tipos de arquivo posso anexar numa conversa? Imagens (JPG, PNG, WebP), PDF, Word, Excel e CSV, de até 16 MB. Uma legenda opcional pode ir junto com o arquivo. #### Posso mandar um anexo e um áudio na mesma mensagem? Não. Ao começar uma gravação o anexo escolhido sai, e ao escolher um anexo a gravação é descartada: vai um de cada vez. #### O que acontece com o texto que eu estava escrevendo se eu trocar de conversa? Ele é descartado, junto com o anexo e a gravação pendentes. É de propósito: um rascunho de uma conversa nunca pode sair em outra. #### Por que algumas conversas mostram o nome da conta embaixo do nome do lead? Quando o mesmo canal tem duas ou mais contas ativas, o cabeçalho mostra por qual delas a conversa chegou. A resposta sai sempre pela mesma conta. #### O que significa IA calada — resposta pelo celular? Alguém respondeu o lead direto pelo aplicativo do celular, no mesmo número. A IA fica quieta naquela conversa até o horário mostrado ou até alguém clicar em **Devolver para a IA**. #### Para que serve o voto Concordo ou Discordo no dossiê? Ele diz se a nota que a IA deu ao lead estava certa. A soma dos votos vira o número **Handoff accuracy**, na tela de Handoff. #### O Inbox guarda o jeito que eu deixei a lista e o dossiê? Sim. Densidade, lista recolhida e dossiê recolhido ficam guardados para o seu usuário neste navegador. O modo maximizado não fica guardado: ele sai ao fechar a conversa. ### Guia: Inbox Todas as conversas num lugar só, ao vivo. É aqui que você lê o que a sua IA respondeu e entra quando quiser. O Inbox é a tela em que você passa mais tempo. Toda conversa do WhatsApp, do web chat e dos outros canais cai aqui, na mesma lista, em tempo real. Você não precisa ficar atualizando: mensagem nova aparece sozinha. #### A tela por partes Na tela: Tela do Inbox com o menu recolhido em ícones, a lista de conversas à esquerda, a conversa aberta no meio com a faixa de etiquetas e resumo, e o dossiê do lead recolhido num trilho à direita. O Inbox com uma conversa em andamento. 1. **O menu recolhe sozinho**: No Inbox o menu do painel vira uma coluna de ícones para a conversa ganhar largura. Passe o mouse num ícone para ver o nome, ou clique no botão do pé do menu para abri-lo inteiro enquanto estiver aqui — nas outras telas ele continua do jeito que você deixou. 2. **Os filtros**: A **busca** acha a conversa pelo contato — nome, telefone, empresa ou e-mail. **Etiquetas** recorta por etiqueta do contato; **Com a IA / Na fila / Com atendente / Encerradas** recorta por quem está com a conversa; as fileiras seguintes recortam por canal e pela **Conta** por onde ela entrou (as fileiras rolam de lado). Tudo pode ficar ligado ao mesmo tempo, e o recorte vira link. No alto, os dois botões de **densidade** (Confortável ou Compacta), o de **atalhos de teclado** e o que **recolhe a lista**. 3. **A lista de conversas**: Mais recente em cima. Cada linha traz o nome, o começo da última mensagem e há quanto tempo ela chegou. Embaixo vêm a temperatura do lead (**Quente**, **Morno**, **Frio**) e as etiquetas dele. Na densidade **Compacta** a linha mostra só nome e mensagem, com um ponto da cor da temperatura — cabem quase o dobro de conversas. 4. **Quem é, quem atende e as ações**: Nome, nota, consentimento (**LGPD**) e, na linha de baixo, telefone, canal, a conta por onde a conversa entrou e de onde o lead veio. À direita: **quem atende** — clicar abre a equipe, e escolher alguém atribui a conversa na hora; sem ninguém, ali aparece a situação (**IA respondendo**, **Aguardando humano**…). Depois vêm **Devolver para a IA**, **Encerrar**, o botão **Maximizar** e os três pontos de **Mais ações** (dono e administradores), com Excluir conversa. 5. **Etiquetas e o resumo do dossiê**: A faixa começa pelas etiquetas do lead, com o **x** para tirar e **+ Etiqueta** para colocar outra — a mesma etiqueta da [Base de contatos](https://attendto.com.br/manual/base-de-contatos). Depois vêm o **Pedido** que a IA está montando, o **Próximo passo** que ela combinou e onde o lead **Travou**, para você ler antes de escrever. **Dossiê completo** abre a coluna inteira. 6. **A conversa**: As mensagens do lead de um lado, as respostas do outro, com o horário de cada uma. A resposta da IA vem assinada com o nome dela, então você sempre sabe quem falou o quê. Em tela larga as mensagens ficam numa coluna de leitura no meio, para a frase não esticar de ponta a ponta. 7. **A caixa de resposta**: Uma linha que cresce enquanto você escreve. **Enter** envia e **Shift + Enter** quebra a linha. À esquerda ficam o clipe (anexo), o emoji e o modelo aprovado — **/** no campo vazio também abre os modelos; à direita, o microfone e **Responder**. A linha de cima avisa quando a janela de 24 horas está para fechar e diz em nome de quem sai a resposta: sem ninguém atendendo, **ao responder a conversa passa para você**. Ver Entrar na conversa. 8. **O dossiê do lead, recolhido**: O dossiê nasce num trilho fino: o anel com a nota do lead e um ícone por seção — pedido, o que a IA já combinou, onde ele travou, como a nota andou e auditoria. Clicar num ícone abre o dossiê já na seção; o botão do alto (ou a tecla **]**) abre e recolhe a coluna inteira. Ver Mais espaço para a conversa e [Transbordo para humano](https://attendto.com.br/manual/handoff). #### Mais espaço para a conversa O Inbox foi feito para quem passa o dia respondendo: tudo o que não é a conversa pode recolher. A escolha de como deixar a lista e o dossiê fica guardada para você neste navegador — da próxima vez o Inbox já abre do seu jeito. - **Recolher a lista** (botão no alto da lista ou a tecla **[**): ela vira um trilho com o avatar de cada conversa — o anel tem a cor da temperatura e um ponto marca quem está aguardando. O número no alto é a fila de espera, e a lupa reabre a lista já no campo de busca. - **Recolher o dossiê** (tecla **]**): ele vira o trilho do anel da nota e das seções. Clicar numa seção abre o dossiê rolado até ela. - **Maximizar** (o botão de quatro cantos no alto da conversa, a tecla **F** ou **Ctrl + Shift + M**): a conversa ocupa a janela inteira — somem o menu, o cabeçalho do painel, a lista e o dossiê. O botão vira **Restaurar**, e **Esc** também volta. Maximizado, **Conversas** (ou **Alt + K**) abre um seletor com busca para trocar de conversa, as setas ao lado (ou **Alt + ↑ / ↓**) passam para a anterior e a próxima, e **Dossiê** abre o dossiê numa gaveta por cima. - **Lista compacta**: os dois botões de densidade no alto da lista trocam entre Confortável e Compacta. - **No celular e em telas de até 1023 px** a conversa ocupa a tela inteira: a seta volta para a lista, o botão de setas troca de conversa, o do painel sobe o dossiê numa folha de baixo para cima, e **Mais ações** reúne quem atende, Devolver e Encerrar. > **Sem conversa aberta:** O meio da tela diz quantas pessoas estão aguardando e há quanto tempo espera a mais antiga. **Abrir a próxima aguardando** leva direto para ela. #### Quando o visitante fecha o chat do site Conversa que nasce no **chat do seu site** vive enquanto a aba estiver aberta. Se a pessoa fechar, o topo da conversa passa a mostrar **Fechou o chat há X** — e o que você escrever dali em diante fica registrado, mas ela não vê. O aviso espera alguns segundos antes de aparecer, de propósito: trocar de página no seu site desconecta e reconecta o chat, e sem essa carência o aviso piscaria à toa. Quando a pessoa volta, ele some sozinho. > **Viu o aviso? Mude de canal:** Se o lead deixou telefone ou e-mail, continue por lá — o botão **Continuar no WhatsApp** fica no topo da conversa. Responder no chat fechado é escrever para uma janela que não existe mais. #### As quatro situações de uma conversa Toda conversa está sempre em um destes quatro estados. Eles aparecem na lista e no alto da conversa, no botão de quem atende: - **IA respondendo**: O normal. A sua IA está tocando a conversa sozinha e você só acompanha. - **Aguardando humano**: Alguém do time precisa entrar. Ou o lead pediu, ou a IA chegou no limite do que sabe. É o número que aparece ao lado de **Inbox** no menu, e a fila inteira está em [Transbordo para humano](https://attendto.com.br/manual/handoff). - **Com atendente**: Uma pessoa assumiu. A IA fica quieta e não responde por cima de você. - **Encerrada**: O assunto acabou. Devolver e Encerrar saem do alto da conversa, o aviso **Conversa encerrada** aparece em cima do campo de resposta e o campo trava; se o lead escrever de novo, a conversa reabre sozinha e volta para a IA. #### Entrar na conversa 1. **Abra a conversa e leia o dossiê**: Clique na linha da lista. A faixa logo abaixo do nome já resume o pedido, o próximo passo e onde o lead travou. Para o **dossiê do lead** inteiro — o que a IA já combinou, as objeções que ele levantou e como a nota andou —, clique em **Dossiê completo**, aperte **]** ou clique num ícone do trilho da direita, que abre o dossiê já na seção. São trinta segundos que evitam a pergunta que ele já respondeu. 2. **Assuma**: Escreva e responda: sem ninguém atendendo, a conversa passa para você na hora. Para entregar a outra pessoa, clique em quem atende, no alto da conversa, e escolha o nome. A IA para na hora — não existe risco de vocês dois falarem juntos. 3. **Escreva como você escreveria**: O lead vê o **seu nome**, não o da IA. Para ele, a conversa simplesmente continuou com uma pessoa. 4. **Devolva quando terminar**: Acabou o que só você podia resolver? **Devolver para a IA**, no alto da conversa, e ela retoma o acompanhamento. Se o assunto morreu de vez, **Encerrar**: a tela confirma, os dois botões saem do alto e o aviso **Conversa encerrada** aparece em cima do campo de resposta. Se o lead escrever de novo, a conversa volta para a IA. > **Não precisa assumir para ler:** Abrir a conversa não tira nada da IA. Você pode ler todas as conversas do dia sem interferir em nenhuma. Quem é **Dono** ou **Admin** da conta também acompanha estas conversas por [Supervisão](https://attendto.com.br/manual/supervisao) — em modo leitura, sem responder por você. Toda leitura de supervisão fica registrada na trilha de auditoria: dá para ver quem leu e quando. #### Quando você tem mais de um número Com dois ou mais números de WhatsApp conectados, o Inbox ganha a fileira **Conta** logo abaixo dos canais. Ela lista os números daquele canal — só de canal que tem mais de um, porque com uma conta só o marcador não separaria nada. Clicar num deles recorta a lista para o que entrou por ele, e **Todas** devolve tudo. - O recorte fica no endereço da página: dá para deixar aberta a aba da filial e mandar o link para quem cuida dela. - O apelido da conta aparece no alto de cada conversa aberta — é o que diferencia duas conversas do **mesmo lead** que entraram por números diferentes. - Responder mantém a conversa naquela conta: quem escreveu para a filial recebe a resposta pela filial, sempre. - A fileira lista as contas do canal que tem mais de uma. Conta desconectada sai dali — o histórico dela continua na lista de conversas, e o estado de cada conta fica em [Conexões](https://attendto.com.br/manual/conexoes). > **Faltando metade das conversas?:** Antes de procurar defeito, olhe as fileiras de filtro: etiqueta, canal e conta contam **juntos**. O caminho de volta é clicar em **Todas** na fileira Conta e em **Todos** na de canal. #### Etiquetas: separar o que é seu do que é do time Etiqueta é um nome livre que você cola num contato — "orçamento enviado", "comércio", "volta em janeiro" — e depois usa para achar todo mundo que está na mesma situação. Ela é **uma coisa só** no produto inteiro: a que você criar aqui aparece na [Base de contatos](https://attendto.com.br/manual/base-de-contatos) e serve para montar público em [Campanhas](https://attendto.com.br/manual/campanhas). Não existem duas listas de etiquetas para manter. Na tela: Inbox com o filtro pela etiqueta residencial ligado, as etiquetas nas linhas da lista e as etiquetas no começo da faixa-resumo, no alto da conversa aberta. O Inbox filtrado pela etiqueta "residencial". 1. **O filtro por etiqueta**: Clique em **Etiquetas** e escolha uma. O número ao lado de cada uma é **quantas conversas** ela traz — clicou, é isso que aparece na lista, inclusive quando você já está com um canal escolhido: os dois filtros contam juntos. Escolhida, ela vira esta pílula; o **x** limpa o filtro. 2. **As etiquetas na linha**: Cada conversa mostra as duas primeiras etiquetas do contato. Quando há mais, aparece **+2** (ou +3…) — passe o mouse para ver quais são. 3. **Colocar e tirar, sem sair da conversa**: **+ Etiqueta** abre a lista das que já existem — clique numa para aplicar, ou escreva um nome novo e crie na hora. O **x** de cada uma tira a etiqueta deste contato, sempre perguntando antes. 1. **Abra a conversa e clique em + Etiqueta**: As etiquetas abrem a faixa logo abaixo do nome do lead, no alto da conversa — antes do resumo do pedido. 2. **Procure antes de criar**: A lista mostra as etiquetas que a sua conta já usa (o menu do filtro traz as 50 mais usadas). Escolher uma que existe é sempre melhor do que criar uma parecida: duas etiquetas quase iguais viram duas listas pela metade. 3. **Se não existe, escreva o nome e crie**: O botão **Criar** aparece com o nome que você escreveu (até 60 caracteres — etiqueta é rótulo, não frase). Ele fica apagado quando o nome já existe — inclusive escrito com outras maiúsculas: para o produto, "VIP" e "vip" são a mesma etiqueta, e ele te devolve a que já está lá. 4. **Para tirar, clique no x da etiqueta**: Uma confirmação aparece antes — aqui e também na ficha do contato, na [Base de contatos](https://attendto.com.br/manual/base-de-contatos): é a mesma etiqueta e o mesmo cuidado nos dois lugares. A etiqueta sai só deste contato; os outros que a usam continuam intactos. > **Etiqueta não é temperatura:** **Quente**, **Morno** e **Frio** são a nota que a IA calcula sozinha, e você não edita. Etiqueta é o contrário: é o que VOCÊ escreve, e a IA não mexe. As duas convivem na mesma linha porque respondem perguntas diferentes. > **O filtro cabe num link:** O endereço da página guarda o recorte — a etiqueta e o canal. Copie a barra de endereço e mande para um colega: ele abre o Inbox já filtrado. O recorte também não se perde quando você abre uma conversa nem quando volta dela no celular. > **Contato apagado a pedido do titular não recebe etiqueta:** Quando alguém pede a exclusão dos dados (LGPD), a conversa continua no histórico mas o contato aparece como **[removido]** e sem etiquetas — inclusive as que tinha. Etiqueta é texto que você escreve e pode conter dado pessoal, então esse contato deixa de aceitar etiqueta nova. O **+ Etiqueta** nem aparece na conversa dele. #### Excluir uma conversa (para limpar testes) Testou o atendimento com o seu próprio número e quer a lista limpa? Abra a conversa, clique nos **três pontos** do cabeçalho (**Mais ações**) e em **Excluir conversa**. Só o dono e os administradores da conta veem essa opção; para o atendente ela nem aparece. 1. **Confira o que sai e o que fica**: O aviso mostra quantas mensagens e quantos arquivos saem. O contato continua na Base de contatos e no Funil, o que já foi cobrado continua cobrado na Carteira e a auditoria guarda quem excluiu e quando — sem o conteúdo das mensagens. 2. **Se quiser, leve o contato junto**: Marque **Excluir também o contato** para apagar a pessoa de vez: ela sai da Base de contatos, do Funil e dos relatórios, com etiquetas, anotações e **todas as outras conversas** dela. Nesse caso o painel pede que você digite **EXCLUIR** para confirmar. 3. **Confirme no botão vermelho**: A conversa some da lista na hora — para você e para quem estiver com o Inbox aberto. Se alguém estava com ela na tela, o painel avisa e volta para a lista. > **Não dá para desfazer:** Conversa excluída não volta. Se a pessoa escrever de novo, começa uma conversa nova, do zero — e, se o contato também foi excluído, ela entra como contato novo, sem o histórico, e o que é cobrado uma vez por contato pode ser cobrado de novo. Enquanto um primeiro contato estiver saindo para a pessoa, o painel pede para esperar um minuto antes de excluir. Para quem pediu a exclusão dos próprios dados (LGPD), o caminho é outro: a anonimização, na ficha do contato. #### Mensagem de voz: fale, em vez de digitar Em conversa de WhatsApp, o botão de **microfone** fica à direita do campo de escrever, antes de **Responder**. É o mesmo gesto de sempre: clique para gravar, fale, clique para parar — e **ouça a prévia antes de enviar**. Não gostou? Descarte e grave de novo. O lead recebe como qualquer áudio de WhatsApp. Em áudio o seu nome não vai junto — não há onde escrevê-lo; se quiser se apresentar, diga na própria gravação. A lista completa de quando o nome vai e quando não vai está em [Transbordo para humano](https://attendto.com.br/manual/handoff). - Só em conversa de WhatsApp — nos outros canais o microfone nem aparece. - Vale a mesma janela de 24 horas do texto: com a porta fechada, primeiro reabra com um modelo aprovado. - Na primeira gravação o navegador pede permissão de microfone. Se você negar, a tela mostra o caminho para liberar. - Alguns navegadores gravam num formato que o WhatsApp não aceita (WebM). Nesse caso o botão avisa — grave no celular e envie pelo clipe. #### Ouvir um áudio da conversa Todo áudio — o que o lead mandou, o que a sua IA respondeu em voz e o que você gravou — toca no mesmo player, com a cara do painel. Clique no **play** e ele começa. Ao lado do play fica a **onda**, que vai se pintando conforme o áudio anda: clique em qualquer ponto dela para pular para lá. - **Velocidade 1× / 1,5× / 2×.** O botão à direita troca a velocidade e vale na hora, sem parar o áudio. É o que mais economiza tempo em fila de mensagem de voz. - **Pelo teclado.** Chegue na onda com Tab e use **Espaço** para tocar e pausar e as **setas** para avançar e voltar 5 segundos. - **Antes do primeiro play a duração aparece como `--:--`.** Não é defeito: o arquivo só é baixado quando você toca. Mostrar "0:00" ali seria fingir que já sabemos o tamanho dele. - **O áudio só desce quando você toca nele.** Uma conversa cheia de mensagens de voz não baixa tudo ao abrir — nem a sua internet nem a do celular pagam por áudio que ninguém ouviu. - **Com você atendendo, o áudio do lead chega para ouvir, sem texto embaixo.** É o padrão de toda conta e não custa nada; na lista de conversas a prévia diz **Áudio**. Com a IA atendendo, o áudio é sempre transcrito. #### A foto do contato na lista Conversa de **Instagram** aparece com a foto de perfil de quem escreveu — na lista, no alto da conversa, no cartão do [Funil](https://attendto.com.br/manual/funil) e no dossiê. É a foto pública do perfil, copiada para o seu painel; se a pessoa trocar, o painel acompanha na conversa seguinte. - **Sem foto, aparece um círculo com as iniciais do nome** e um selinho do canal no canto. O selinho existe para a ausência ler como desenho, e não como imagem quebrada. - **Contato de WhatsApp NUNCA vai ter foto** — e isso não é limitação do painel: o WhatsApp não entrega a foto do contato para nenhum sistema. Ali as iniciais são o retrato definitivo. - **A foto é dado pessoal.** Quando alguém pede a exclusão dos dados (LGPD), ela é apagada junto — e o contato volta às iniciais. #### Emoji O seletor de emoji fica ao lado do campo de escrever, e é o **mesmo** em todo lugar em que você compõe uma mensagem — inclusive nas telas do [Instagram](https://attendto.com.br/manual/instagram), na mensagem do gatilho e nas boas-vindas da conta. #### A janela de 24 horas Esta é a regra que mais confunde no começo, e ela não é nossa: é do WhatsApp. Depois que o lead te manda uma mensagem, você tem **24 horas** para escrever o que quiser, sem taxa de WhatsApp. Passadas as 24 horas sem ele responder, a porta fecha. (A Meta anunciou que passa a cobrar também as mensagens dentro dessa janela em **1º de outubro de 2026**.) Com a porta fechada, só entra **mensagem aprovada** — um texto que o WhatsApp já leu e liberou antes. O campo de resposta avisa e oferece os modelos que você tem prontos. Cada uma dessas custa: se o número está na sua própria conta do WhatsApp, quem cobra é a Meta, no seu cartão; se ele é hospedado por nós, sai do seu saldo. O diálogo diz qual é o seu caso antes de você mandar. Assim que o lead responde ao modelo, a janela abre de novo e tudo volta ao normal. Como criar e aprovar esses textos está em [Modelos de mensagem](https://attendto.com.br/manual/modelos-de-mensagem). Enquanto o modelo estiver esperando resposta, o botão de mandar outro fica bloqueado — reenviar sem o lead responder não abre a janela, só incomoda e custa de novo. O bloqueio cai sozinho quando ele responde, ou depois de 24 horas. > **Modelo que NÃO foi entregue não bloqueia:** Se o WhatsApp não conseguiu entregar o modelo, não há o que esperar: o botão continua liberado. E a bolha mostra o **motivo** da falha em português — número sem WhatsApp, modelo pausado, janela fechada —, porque cada um pede uma ação diferente. #### Conversa de Instagram: duas diferenças que valem saber O Direct de uma conta conectada cai aqui como qualquer conversa: mesma lista, mesma IA, mesmo dossiê. As diferenças estão na janela e em como algumas conversas nascem — o resto, inclusive os gatilhos de comentário e as boas-vindas da conta, está no guia do [Instagram](https://attendto.com.br/manual/instagram). - **A janela fechou? Não existe botão de reabrir.** O Instagram não permite retomar a conversa por modelo. Dá para responder assim que a pessoa escrever de novo — e é só isso mesmo: a linha discreta no lugar do botão não é um recurso faltando, é a regra do canal. - **O marcador "Comentário"** marca a origem: aquela conversa nasceu de alguém que comentou uma publicação e recebeu a mensagem do gatilho — e não de um Direct espontâneo. É o mesmo lead, com a origem contada com honestidade. - **Conversa nascida de gatilho começa esperando.** Enquanto a pessoa não responde, a tela mostra: "Mensagem do gatilho enviada — o Instagram permite uma só mensagem a partir de um comentário; a conversa abre quando a pessoa responder". O campo de escrever fica desabilitado até lá, com esse motivo à vista — não é defeito, é a regra da mensagem única. #### Coisas que economizam tempo - **?** abre a lista de atalhos do Inbox. Os de uma tecla só (**[**, **]**, **F**, **?**) valem fora do campo de resposta, para não atrapalhar quem está escrevendo; **Ctrl + Shift + M**, **Alt + K** e **Alt + ↑ / ↓** valem em qualquer lugar. - **Enter** envia a resposta e **Shift + Enter** quebra a linha. **/** no campo vazio abre os modelos aprovados. - O contador ao lado de **Inbox** no menu conta só as conversas aguardando humano. Se está zerado, ninguém está esperando por você. - `Ctrl K` abre a busca de qualquer tela e encontra o lead pelo nome, já abrindo a conversa dele. - A ficha ao lado é editável: corrija o nome ou a empresa ali mesmo e a correção vale em todo o painel. #### Quando alguma coisa parece errada - **A sua IA parou de responder**: Olhe a situação da conversa. **Aguardando recarga** significa saldo esgotado ou teto de gasto atingido — resolve em [Saldo & Recargas](https://attendto.com.br/manual/saldo-e-recargas) ou no teto, em [Configurações](https://attendto.com.br/manual/configuracoes). **Com atendente** significa que alguém do time assumiu e a IA está calada de propósito. - **Ela respondeu de madrugada e você não queria**: É o modo fora do horário, em [Configurações](https://attendto.com.br/manual/configuracoes). Ele decide se a IA atende 24 horas ou se manda só a mensagem de ausência. - **Ela respondeu algo que você não ensinou**: O que ela sabe vem de [Base de conhecimento](https://attendto.com.br/manual/base-de-conhecimento) e das ofertas de [Intent & catálogo](https://attendto.com.br/manual/intent-e-catalogo). Se a resposta ficou vaga, é sinal de buraco ali — e o painel de teste da base mostra exatamente o que ela teria usado. - **Não consigo enviar: só aparece a opção de modelo**: A janela de 24 horas fechou. É regra do WhatsApp, não do painel. Mande um modelo aprovado; quando o lead responder, a conversa volta ao normal. - **O lead diz que recebeu duas vezes**: Com o ritmo de conversa humana ligado, uma resposta sai em mensagens curtas separadas — é o comportamento esperado, e custa igual a uma. O ajuste está em [Configurações](https://attendto.com.br/manual/configuracoes). No painel: Abrir o Inbox. Como as pessoas procuram: como assumir conversa da ia; transferir conversa para atendente; devolver conversa para a ia; responder whatsapp fora das 24 horas; reabrir conversa com modelo aprovado; mandar áudio pelo painel; anexar arquivo na conversa; filtrar conversas por etiqueta; inbox de whatsapp para equipe; excluir conversa de teste; atalhos de teclado do inbox; maximizar conversa; dossiê do lead; ia parou de responder sem saldo. ## Funil: quadro kanban de vendas com etapas, prazos, rodízio e ganho ou perdido URL: https://attendto.com.br/manual/funil Menu: Operação > Funil O Funil é o quadro kanban do painel em que cada lead vira um cartão e cada coluna é uma etapa da venda, com prazo, rodízio, dados do negócio e desfecho de ganho ou perdido. ### Quem pode usar - Dono: Vê e usa tudo: cria quadros pela galeria de segmentos, abre Configurar quadro, muda colunas, papéis, campos, regras, prazos, aparência, nome e vocabulário, e exclui quadros. Também trabalha os cartões como qualquer pessoa da equipe. - Admin: O mesmo que o dono: cria, configura e exclui quadros, e trabalha os cartões. - Atendente: Vê o Funil no menu e trabalha os cartões: arrasta entre etapas, abre o painel do cartão, preenche os dados do negócio, edita o valor, aceita sugestões, marca ganho ou perdido, reabre e remove cartão. Os botões Novo quadro e Configurar quadro aparecem desligados, com a dica de que só administradores mudam o quadro; aberta pelo endereço, a galeria de segmentos e as configurações mostram o aviso de que são só para administradores. ### Telas #### Funil A tela Funil serve para acompanhar cada lead como um cartão num quadro kanban, mover o negócio entre as etapas e ver quanto está em jogo em cada uma. Endereço no painel: `/app/funil` ![Captura da tela Funil. A tela Funil serve para acompanhar cada lead como um cartão num quadro kanban, mover o negócio entre as etapas e ver quanto está em jogo em cada uma.](https://attendto.com.br/prints-do-manual/funil--quadro.png) A tela Funil na conta de demonstração, com dados fictícios e os valores desfocados. ##### Barra de quadros Troca o quadro à vista e leva à criação e às configurações do quadro. Botões e ações: - **‹nome do quadro›**: Um botão por quadro da conta. Abre aquele quadro; o que está aberto fica marcado. Ao entrar no Funil, abre o quadro padrão. - **Novo quadro** (Dono, Admin): Abre a galeria de segmentos para criar um quadro a partir de um modelo pronto. - **Configurar quadro** (Dono, Admin): Abre as Configurações do quadro aberto: colunas, campos, regras, prazos, aparência, nome e vocabulário. Também aparece: - O ícone do segmento ao lado do nome, no quadro criado por um modelo de segmento. - O selo Novo no quadro que acabou de ser criado. - Para quem não administra a conta, as dicas “Só administradores podem criar quadros” e “Só administradores podem editar o quadro” nos botões desligados. ##### Faixa de papéis pendentes Aparece no quadro antigo em que as colunas ainda não dizem o papel delas no funil. Botões e ações: - **Marcar os papéis** (Dono, Admin): Abre Configurar quadro direto na seção Colunas e etapas, para dar o papel de cada coluna. Também aparece: - O aviso “Marque o papel das colunas para o relatório e as conversões entenderem este quadro.” ##### Cartão do rodízio Aparece quando o quadro tem uma coluna que distribui os leads pelo rodízio da equipe. Também aparece: - O título “Rodízio ligado em ‹coluna› · ‹n› de ‹total› atendentes na fila”, com o vocabulário do quadro (por exemplo, corretores). - A frase do prazo: quanto tempo quem recebe tem para responder, para qual coluna o cartão vai quando responde e que, sem resposta, o lead passa para o próximo. - O lembrete de que três atrasos em 7 dias tiram a pessoa da fila. - Próximos: as iniciais de quem recebe os próximos leads, com “+‹n›” quando a fila é maior. - O selo “Recebendo leads” ou, no quadro ainda sem cartões, “Esperando o primeiro lead”. ##### Filtros do quadro Filtram os cartões já carregados e mostram o resumo do que está em aberto. Campos e filtros: - **Buscar**: Caixa “Nome ou empresa…”. Encontra pelo nome do lead, pela empresa, pelo título do cartão livre e pelos dados de texto do negócio que não são sensíveis. Não diferencia acento nem maiúscula. - **Atendente**: Quem está com o cartão. O rótulo segue o vocabulário do quadro (Corretor, Dentista…). Opções: Todos, “Sem ‹quem atende›” e cada pessoa que tem cartão no quadro. - **‹campo do negócio›**: Um seletor por campo do negócio de lista ou de sim ou não, não sensível, que este quadro usa (alguma coluna pede o campo ou algum cartão tem o valor). Opções: Todos e os valores do campo, ou Sim e Não. - **Campanha de anúncio**: Todas, cada campanha de onde vieram os leads do quadro, ou Sem anúncio. Botões e ações: - **Mais filtros**: Abre e fecha a faixa com os outros filtros e o resumo de ganhos e perdidos. Com algum desses filtros ligado, o botão mostra quantos estão ligados. - **Limpar filtros**: Aparece com qualquer filtro ligado. Desliga todos de uma vez e devolve o foco à busca. Também aparece: - O resumo “‹n› negócios em aberto · ‹valor› no funil”, que conta os cartões fora das colunas de perdido e soma o campo de moeda do quadro (ou o valor do negócio). Sem cartões em aberto: “Nenhum negócio em aberto”. - Os filtros valem enquanto você está no quadro; trocar de quadro ou recarregar a página volta tudo ao normal. ##### Mais filtros Os filtros recolhidos: nota, modo, anúncio, prazo, desfecho, canal e conta. Campos e filtros: - **Canal**: Todos os canais, WhatsApp, Web chat, SMS, E-mail ou Cadastro manual. - **Conta**: Só aparece quando há duas ou mais contas ativas no mesmo canal (por exemplo, dois números de WhatsApp). Todas as contas, ou uma delas pelo nome. Botões e ações: - **Quente**: Mostra só os leads com nota Quente. Combina com Morno, Frio e Sem score: marcar dois mostra os dois. - **Morno**: Mostra só os leads com nota Morno. - **Frio**: Mostra só os leads com nota Frio. - **Sem score**: Mostra só os leads que a IA ainda não pontuou. - **Manual**: Mostra só os cartões que alguém da equipe moveu à mão (a automação não move mais esses cartões sozinha). - **Automático**: Mostra só os cartões que seguem no automático, movidos pelas regras e pela IA. - **Anúncio**: Mostra só os leads que vieram de anúncio. - **Só estourados**: Aparece quando alguma coluna tem prazo. Mostra só os cartões que passaram do prazo da etapa; o número ao lado diz quantos são. - **Ganhos**: Aparece quando o quadro tem coluna de ganho ou de perdido. Mostra só os negócios ganhos. - **Perdidos**: Mostra só os negócios perdidos. Também aparece: - Nos quadros com coluna de desfecho, as pílulas “Ganhos 30 d”, “Perdidos 30 d” (quantos e quanto somam) e “Taxa de ganho” dos últimos 30 dias. ##### Ir para a etapa A fila de botões com as etapas, logo acima das colunas. Botões e ações: - **‹etapa› ‹n›**: Um botão por coluna, na cor dela, com quantos cartões tem (já com os filtros). Rola o quadro até a coluna; a etapa à vista fica marcada. ##### Colunas Cada coluna é uma etapa do funil, na ordem definida em Configurar quadro. Botões e ações: - **Mostrar mais ‹n› de ‹n›**: No pé da coluna com muitos cartões: mostra os próximos cartões da coluna, de 30 em 30. Também aparece: - A listra de cor no topo, o nome da etapa e a contagem de cartões (com os filtros, conta só os visíveis). - “A IA está conversando”, na coluna de entrada; “Desfecho: pede o motivo”, na coluna de perdido. - A pílula do prazo da etapa (15 min, 24 h…), com a dica do que o prazo significa ali. - A pílula Rodízio, quando a coluna distribui os leads pela fila; “Rodízio desligado”, quando a coluna está marcada mas o rodízio da conta está desligado em Configurações → Equipe. - A soma dos valores dos cartões visíveis, quando passa de zero (não aparece na coluna de perdido). - “Para entrar: ‹campos›”, quando a etapa pede dados antes de o cartão entrar. - Coluna vazia: borda tracejada e “Solte um cartão aqui”. ##### Cartão O resumo do negócio. Clicar abre o painel do cartão ao lado do quadro. Botões e ações: - **Preencher e mover**: No aviso “Pronto para ‹etapa› · faltam ‹dados›”: abre o diálogo que pede só o que falta e, ao salvar, aceita a sugestão da IA e move o cartão. - **Mover agora**: No aviso “Tudo pronto para ‹etapa›”: aceita a sugestão da IA e move o cartão para a etapa sugerida. - **Aceitar sugestão**: Na etiqueta “‹motivo› — mover?”: move o cartão para a coluna sugerida pela IA; o quadro rola até ele e o destaca. - **Dispensar sugestão**: Tira a sugestão do cartão, sem mover. - **Mais ações**: O botão de três pontos no rodapé do cartão (no topo, no cartão livre). Abre o menu de ações do cartão. Também aparece: - A foto ou as iniciais do lead, o nome e a pílula da nota (“Quente 88”, “Morno 67”); com desfecho, a pílula vira Ganho ou Perdido. - A linha de destaque: o primeiro dado de texto do negócio (o imóvel de interesse, numa imobiliária); no negócio perdido, o motivo da perda. - A nota do rodízio “Passou para ‹nome›: ‹outra pessoa› não assumiu em ‹prazo›”. - Até três dados do negócio na frente do cartão. - “Para ‹próxima etapa› faltam ‹dados›”, no cartão parado há um dia ou mais numa etapa. - Etiquetas: ICP ‹nota› (aderência ao cliente ideal), lead de teste, “IA moveu · ‹motivo›” (por até uma hora), Manual e o valor do negócio. - A última fala do lead, as letras N O A P do BANT (necessidade, orçamento, autoridade, prazo), o nome da conta (com duas ou mais contas no canal) e o ícone do canal. - A barra de jornada (“Etapa ‹n› de ‹total›”). - O rodapé: há quanto tempo o cartão está na etapa ou, com prazo, “‹tempo› de ‹prazo›” em verde, âmbar a partir da metade e vermelho com “estourou”; no ganho, o dia do ganho; com quem está o cartão ou “Com a IA”; e o ícone de anúncio. - O que o cartão mostra além dos dados do negócio se liga e desliga em Configurar quadro → Aparência do cartão. ##### Menu Mais ações do cartão Botões e ações: - **Ver detalhes**: Abre o painel do cartão (o caminho pelo teclado). - **Religar automação**: Só no cartão em modo Manual. Devolve o cartão ao automático: a IA volta a movê-lo sozinha. - **Abrir no Inbox**: Abre a conversa do lead no Inbox. Fica desligado, com a dica “Este lead ainda não tem conversa”, quando não há conversa. - **Editar valor**: Só no cartão com lead. Abre o diálogo do valor do negócio. - **Marcar como ganho**: Só sem desfecho. Abre o diálogo de ganho. - **Marcar como perdido**: Só sem desfecho. Abre o diálogo de perda, que pede o motivo. - **Reabrir negócio**: Só com desfecho. Limpa o ganho ou o perdido e devolve o cartão para a etapa anterior; o registro antigo fica no histórico. - **Remover do quadro**: Abre a confirmação para tirar o cartão deste quadro. ##### Diálogo Valor do negócio Título “Valor do negócio — ‹nome›”. Abre com o valor atual preenchido. Campos e filtros: - **Valor (R$)**: Aceita o valor digitado ou colado já formatado, com ponto de milhar e vírgula de centavos. Depois de salvo à mão, a estimativa da IA não sobrescreve mais. Botões e ações: - **Salvar valor**: Grava o valor e fecha. Valor que não se entende mostra “Digite um valor válido (ex.: 6.000,00)”. ##### Diálogo Remover do quadro Título “Remover ‹nome› do quadro?”. Botões e ações: - **Cancelar**: Fecha sem remover. - **Remover cartão**: Tira o cartão do quadro. No cartão com lead, o lead continua no CRM e nas conversas; o cartão livre é apagado. Não pode ser desfeito. ##### Diálogo Para entrar em ‹etapa›, preencha Abre ao avançar o cartão para uma etapa que pede dados que ele ainda não tem. Enquanto está aberto, o cartão fica no ar na coluna de destino. Campos e filtros: - **‹dado pedido pela etapa›** (obrigatório): Um campo por dado que falta, no tipo dele (texto, número, moeda, data, lista em botões ou sim ou não), com o texto de ajuda do campo. Vazio mostra “Preencha este dado.”, “Escolha uma opção.” ou “Informe a data.”. Botões e ações: - **Cancelar**: Fecha e devolve o cartão para a coluna de origem. - **Salvar e mover**: Grava os dados no cartão e move para a etapa. Também aparece: - A trilha origem para destino, com “‹n› dados pedidos”, e o nome do lead com o primeiro dado de texto. - A nota “Estes dados ficam no cartão. Voltar para uma etapa anterior nunca pede nada.” ##### Diálogo Marcar como ganho Abre pelo menu do cartão, pelo painel ou ao soltar o cartão na coluna de ganho. O cartão vai para a coluna de ganho, as cadências param e o negócio entra nos números. Campos e filtros: - **Valor do negócio**: Vem com o valor que o cartão já tem; com um campo de moeda preenchido (como o valor do imóvel), vem esse. Em branco mantém o valor atual. - **‹dado pedido pela coluna de ganho›** (obrigatório): Os dados que a coluna de ganho pede e o cartão ainda não tem. Botões e ações: - **Usar ‹valor›**: Aparece quando o valor digitado difere do campo de moeda: troca pelo valor do campo. - **Cancelar**: Fecha; o cartão fica onde estava. - **Confirmar ganho**: Marca o negócio como ganho e move o cartão para a coluna de ganho. - **Salvar e marcar como ganho**: O mesmo, quando a coluna de ganho pede dados: grava os dados e marca. ##### Diálogo Marcar como perdido “Por que perdemos?”: o motivo é obrigatório e alimenta o Revenue e o cliente ideal calculado. Campos e filtros: - **Observação (opcional)**: Um comentário curto sobre a perda, que fica no histórico. Botões e ações: - **Preço**: Motivo geral do produto. Os motivos aparecem nos grupos Deste quadro, Da sua conta e Gerais. - **Não é agora**: Motivo geral. - **Concorrente**: Motivo geral. - **Sem resposta**: Motivo geral. - **Não era para nós**: Motivo geral. - **Outro**: Motivo geral. - **‹motivo do quadro ou da conta›**: Os motivos criados para este quadro ou para a conta. Um motivo pode pedir um dado a mais, que abre logo abaixo. - **Cancelar**: Fecha; o cartão fica onde estava. - **Confirmar perdido**: Desligado até escolher o motivo. Marca como perdido, move para a coluna de perdido e para as cadências. ##### Arrastar e teclado Também aparece: - Arraste o cartão para outra coluna ou para outra posição; avançar para uma etapa que pede dados abre o diálogo “Para entrar em ‹etapa›, preencha”; soltar numa coluna de desfecho abre o diálogo de ganho ou de perda. - Voltar uma etapa nunca pede dados: o aviso “‹nome› voltou para ‹etapa›” confirma. - Mover à mão põe o cartão em modo Manual: a automação deixa de movê-lo sozinha até Religar automação. - Teclado: Enter abre o cartão; Alt com a seta para a direita ou para a esquerda move uma etapa; espaço pega e solta o cartão; as setas levam entre cartões e colunas; Esc cancela o arrasto. ##### Painel do cartão Abre ao lado do quadro, que continua visível e arrastável. Esc ou o X fecham e devolvem o foco ao cartão. Botões e ações: - **Fechar o cartão**: O X do topo: fecha o painel. Também aparece: - O nome, a etapa e há quanto tempo o cartão está nela (“‹etapa› · ‹tempo› na etapa”). - As pílulas da nota, de quem está com o cartão (“· pelo rodízio”, quando veio da fila) ou “Conversando com a IA”, do ICP e de Manual. - A origem: “Veio do anúncio: ‹campanha› › ‹conjunto› › ‹anúncio›”, “Origem: ‹integração›” ou “Origem: ‹canal›”. - Próxima etapa: “Para entrar em ‹etapa›” com ‹n› de ‹n› dados e a lista do que falta; “Próxima etapa: ‹etapa›” com “nada a preencher”; ou “Negócio ganho” / “Negócio perdido” com o motivo. ##### Dados do negócio Os campos da conta com o valor deste lead. Lista e sim ou não gravam na escolha; os demais, ao sair do campo. Campos e filtros: - **‹campo do negócio›**: Um por campo da conta, no tipo dele, com o texto de ajuda. Valor recusado mostra o motivo embaixo do campo. Botões e ações: - **Mostrar**: No campo sensível, que aparece mascarado: mostra o valor. Fica registrado na auditoria quem abriu o campo de qual lead. - **Tentar de novo**: Quando os dados não carregaram: busca de novo. Também aparece: - As pílulas Sensível, “Pedido para entrar em ‹etapa›” (a próxima etapa pede o campo) e “Pedido em ‹etapa›” (uma etapa mais adiante pede). - O aviso Salvo depois de gravar e a linha “Alterado por ‹pessoa› em ‹data›”. - Sem nada preenchido: “Nenhum dado do negócio ainda. Quem atende preenche aqui, ou o seu sistema envia pela API.” ##### Resumo da IA Também aparece: - O resumo da conversa escrito pela IA ou, sem ele, o que a IA guarda do lead. Só leitura: nada é gerado ao abrir. - Sem conversa: “Este lead ainda não conversou com a IA.”; sem resumo: “A IA ainda não resumiu esta conversa. O resumo aparece quando a conversa passa para um atendente.” ##### Negócio Valor, melhor momento, follow-up, negociação e desfecho do lead. Campos e filtros: - **Valor do negócio**: Abre ao clicar em Editar. Sem valor, aparece “Sem valor definido”. Botões e ações: - **Editar**: Abre a caixa do valor do negócio. - **Salvar**: Grava o valor; a IA não sobrescreve mais. - **Cancelar**: Fecha a caixa sem gravar. - **Liberar follow-ups**: Aparece quando o lead pediu para não receber follow-ups. Devolve o lead às regras de sempre, sem matricular de novo em nenhuma cadência. - **Entregar ao Closer**: Com o Closer disponível: a negociação passa para o Closer na próxima mensagem do lead. - **Assumir a negociação**: Com a negociação em curso no Closer: você assume e o Closer sai de cena. - **Marcar como ganho**: Abre o diálogo de ganho. - **Marcar como perdido**: Abre o diálogo de perda. - **Reabrir negócio**: Com desfecho: devolve o cartão para a etapa anterior. Também aparece: - “Melhor momento:” com a janela em que o lead costuma responder, quando aprendida. - A linha “Follow-up: ‹cadência› · passo ‹n› de ‹n› · próximo ‹dia e hora›” e a etiqueta “Pediu para não receber follow-ups” com a data. - O bloco do Closer, quando disponível: o estado da negociação, o teto definido pelo dono e as concessões feitas. - Com desfecho: o selo Ganho ou Perdido, com o motivo e a data. ##### Histórico A linha do tempo do cartão, a mais recente no topo. Botões e ações: - **Mostrar tudo (‹n›)**: Mostra todos os movimentos; por padrão aparecem os seis últimos. - **Tentar novamente**: Quando o histórico não carregou. Também aparece: - Cada item com quem fez e há quanto tempo: criado, movido pela IA, movido à mão, sugestão aceita ou dispensada, valor, cadência, ganho, perdido, reaberto, tarefa e dado alterado. - A linha “ficou ‹tempo› em ‹etapa›” entre dois movimentos. - Sem movimentos: “Sem movimentos ainda.” ##### Ações do painel Os botões fixos no pé do painel. Campos e filtros: - **Mover para a etapa**: O seletor “Mover para outra etapa…” com as outras colunas do quadro. Botões e ações: - **Mover para ‹próxima etapa›**: Move para a etapa seguinte, com o mesmo cuidado do arrasto (dados pedidos e desfecho). - **Mover**: Move para a etapa escolhida no seletor ao lado. Sem escolha, avisa “Escolha a etapa”. - **Abrir no Inbox**: Abre a conversa do lead. Desligado quando o lead ainda não tem conversa. - **Religar automação**: Só no cartão em modo Manual. - **Remover do quadro**: Abre a confirmação de remoção. ##### Cartão livre Cartão sem lead, criado à mão. O painel mostra o título e a descrição editáveis. Campos e filtros: - **Título**: Obrigatório para salvar. - **Descrição**: Texto livre do cartão. Botões e ações: - **Salvar**: Grava título e descrição. Fica desligado sem mudança ou sem título. ##### Quadro sem negócios ou sem colunas Botões e ações: - **Criar meu primeiro quadro** (Dono, Admin): Na conta sem nenhum quadro: abre a galeria de segmentos. - **Criar cartão**: No quadro sem cartões: cria um cartão livre na coluna de entrada e abre o painel dele. - **Receber leads de outro sistema**: No quadro sem cartões: abre Integrações para trazer leads de outro sistema. - **Configurar colunas** (Dono, Admin): No quadro sem colunas: abre Configurar quadro em Colunas e etapas. ##### Estados da tela - Carregando: Esqueleto da barra de filtros e de cinco colunas com a listra de cor; o leitor de tela ouve “Carregando o quadro”. - Sem nada ainda: Conta sem quadro: “Seu funil nasce aqui: crie o primeiro quadro”, com Criar meu primeiro quadro para administradores e “Peça a uma pessoa administradora para criar o primeiro quadro” para os demais. Quadro sem cartões: “Nenhum negócio neste quadro ainda”, dizendo em que coluna os leads novos entram, com Criar cartão e Receber leads de outro sistema. - Se der erro: “Não conseguimos carregar o funil” (ou “o quadro”), avisando que os quadros e cartões continuam salvos, com Tentar de novo. - Quadro sem colunas: “Este quadro ainda não tem colunas”, com Configurar colunas para administradores. - Colunas sem papel no funil: A faixa de papéis pendentes com Marcar os papéis. - Filtro sem resultado: As colunas vazias com “Solte um cartão aqui” e o resumo “Nenhum negócio em aberto”. #### Novo quadro A tela Novo quadro serve para criar um quadro do Funil a partir do modelo do seu segmento, que já traz etapas com papel, campos do negócio, motivos de perda e regras. Endereço no painel: `/app/funil/novo-quadro` ![Captura da tela Novo quadro. A tela Novo quadro serve para criar um quadro do Funil a partir do modelo do seu segmento, que já traz etapas com papel, campos do negócio, motivos de perda e regras.](https://attendto.com.br/prints-do-manual/funil--novo-quadro.png) A tela Novo quadro na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Botão Novo quadro na barra de quadros do Funil, ou Criar meu primeiro quadro quando a conta não tem nenhum. Quem usa: Dono, Admin. ##### Barra de quadros Botões e ações: - **‹nome do quadro›**: Abre aquele quadro no Funil. O quadro criado agora aparece destacado. - **Novo quadro**: Marcado nesta tela; o clique leva o foco à busca de segmento. ##### Busca e filtro Campos e filtros: - **Buscar segmento**: Caixa “Buscar segmento: dentista, loja, contador…”. Entende o nome do negócio, sinônimos e quem atende (“dentista” acha Odontologia, “férias” acha Turismo), sem acento, maiúscula nem hífen. Botões e ações: - **Limpar busca**: O X dentro da caixa: apaga a busca. - **Com cuidados do segmento**: Deixa só os segmentos com regras de conselho profissional e da LGPD. Também aparece: - A contagem “‹n› segmentos”, “‹n› de ‹total› segmentos” ou “Nenhum segmento”. ##### Galeria de segmentos Botões e ações: - **‹segmento›**: O cartão do segmento: abre o painel com o que vem junto. Clicar de novo fecha. - **Cuidados do segmento**: Selo dos segmentos regulados: abre o diálogo com os cuidados do conselho e da LGPD. - **Em branco**: Quadro sem colunas, sem campos e sem regras, para montar no editor. Também aparece: - A ilustração, o nome, “‹n› etapas · ‹n› campos · ‹n› motivos” e a trilha das etapas com a entrada e o ganho nas pontas. - O selo “Segmento da sua conta” no segmento escolhido para a conta, que vem primeiro. - A pílula “Gerado pela IA” no modelo que a IA montou para a conta. - No cartão Em branco: “Sem colunas: você monta no editor”. ##### Painel do segmento Abre ao lado da galeria com o modelo do segmento; Esc ou Fechar fecham. Campos e filtros: - **Nome do quadro** (obrigatório): Vem com o nome do modelo. Vazio mostra “Dê um nome ao quadro.”. Botões e ações: - **Fechar**: O X do topo do painel. Também aparece: - O ladrilho do segmento, “Modelo do segmento”, “Modelo do segmento · o da sua conta” ou “Sem modelo”, e o resumo “‹n› etapas · ‹n› campos · ‹n› motivos de perda”. ##### Colunas e papel no funil Também aparece: - Cada coluna do modelo com o papel dela (Entrada, Qualificado, Atendimento, Etapa intermediária, Ganho, Perdido). - Por coluna, quando houver: “Prazo de ‹prazo›” e “Pede ‹dados›”. - A nota de que relatórios e conversões usam as etapas deste quadro, com os nomes dele. ##### Campos do negócio Botões e ações: - **‹campo›**: Liga ou desliga o campo no quadro novo. Todos vêm marcados. Campo que já existe na conta não é duplicado. Também aparece: - A contagem “‹n› de ‹n›” campos escolhidos e o tipo de cada campo. - As pílulas Sensível, “Aparece no cartão” e “O cartão já mostra 3 campos; este fica no painel”. - “Pedido para entrar em ‹etapa›” ou, com o campo desmarcado, “‹etapa› não vai pedir este dado”. ##### Motivos de perda Campos e filtros: - **Novo motivo de perda**: Caixa “Ex.: Mudou de cidade”. Acrescenta um motivo só deste quadro. Botões e ações: - **Acrescentar**: Inclui o motivo. Vazio avisa “Escreva o motivo antes de acrescentar.”; repetido avisa “Esse motivo já está na lista.”. - **Tirar o motivo ‹motivo›**: O X no motivo acrescentado agora: tira da lista. Também aparece: - Os grupos Do segmento, “Da sua conta · valem em todos os quadros” e “Só deste quadro”. ##### Vocabulário do segmento Também aparece: - Quem atende (no singular e no plural), Quem é atendido e O que se negocia. - A nota de que o vocabulário aparece nos cartões, nos avisos e no rodízio deste quadro; nas telas que servem a todos os quadros fica “Atendente”. ##### Cuidados do segmento Bloco recolhível, aberto nos segmentos regulados. Também aparece: - A lista dos cuidados, com a referência legal em tom mais baixo, e a nota de que a persona, as perguntas e a cadência do modelo já seguem esses pontos. - O aviso “Resumo para orientar a configuração, não é parecer jurídico.” ##### Regras que já vêm ligadas Bloco recolhível com as regras automáticas do modelo. Também aparece: - A lista das regras; a que inicia a retomada leva “Ligue a cadência em Cadências” quando a cadência ainda está desligada. - A nota de que a cadência de retomada nasce desligada e só escreve enquanto a IA conduz a conversa. - Com o rodízio desligado na conta: “O rodízio está desligado na conta.”, com o caminho Configurações → Equipe. ##### Quem recebe os leads novos Botões e ações: - **Parar o quadro ‹nome› de receber leads novos**: Interruptor, ligado por padrão quando outro quadro cria cartão para lead novo: cada lead novo nasce só no quadro novo, sem cartão duplicado. Os cartões antigos ficam onde estão. Não aparece no Em branco. - **Tornar este o quadro padrão**: Interruptor: o quadro novo passa a abrir primeiro no Funil e a receber os leads das integrações quando nenhum quadro é escolhido. Também aparece: - Quando o padrão atual tem regras do Closer que citam as etapas dele, o aviso de revisar em Configurações → Closer. ##### Em branco Também aparece: - O campo Nome do quadro, o aviso “Você monta as colunas no editor” (dar o papel de cada coluna) e o interruptor Tornar este o quadro padrão. ##### Rodapé do painel Botões e ações: - **Cancelar**: Fecha o painel sem criar. - **Criar quadro**: Cria o quadro com o que está marcado. Erro avisa “Não conseguimos criar o quadro agora”, sem criar nada. - **Criar outro**: Depois de criar: fecha o painel e volta à busca. - **Abrir o quadro**: Depois de criar: abre o quadro novo no Funil. Também aparece: - Depois de criar: “Quadro ‹nome› criado”, em que coluna os próximos leads chegam e a lista do que foi montado. ##### Diálogo Cuidados do segmento Título “Cuidados do segmento · ‹segmento›”. Botões e ações: - **Entendi**: Fecha o diálogo. - **Ver o que vem junto**: Fecha o diálogo e abre o painel do segmento. Também aparece: - A lista numerada dos cuidados e a nota de que é resumo, não parecer jurídico. ##### Busca sem resultado e erro Botões e ações: - **Usar o Genérico**: Na busca sem resultado: limpa a busca e abre o modelo Genérico, que serve a qualquer negócio. - **Limpar busca**: Na busca sem resultado: apaga a busca. - **Tentar de novo**: Quando os modelos não carregaram: busca de novo. - **Começar em branco**: Quando os modelos não carregaram: abre o painel do Em branco. ##### Estados da tela - Carregando: Esqueletos de oito cartões e a contagem “Carregando…”; o painel do segmento mostra o esqueleto “Carregando o modelo do segmento”. - Sem nada ainda: Busca ou filtro sem resultado: “Nenhum segmento com “‹busca›”” (ou “com este filtro”), lembrando que o modelo Genérico serve para qualquer negócio, com Usar o Genérico e Limpar busca. - Se der erro: “Não conseguimos carregar os modelos de segmento agora”, avisando que nenhum quadro foi criado e o atual segue recebendo leads, com Tentar de novo e Começar em branco. Modelo que não abre: “Não conseguimos abrir este modelo agora”. - Pessoa sem papel de administrador: “Só administradores podem criar quadros”, pedindo que uma pessoa administradora crie o quadro do segmento. #### Configurações do quadro A tela Configurações do quadro serve para definir as colunas e o papel de cada uma no funil, os campos do negócio e o que cada etapa pede, as regras automáticas, os prazos e o rodízio, a aparência do cartão, o nome e o vocabulário do quadro. Endereço no painel: `/app/funil/‹…›/configuracoes` ![Captura da tela Configurações do quadro. A tela Configurações do quadro serve para definir as colunas e o papel de cada uma no funil, os campos do negócio e o que cada etapa pede, as regras automáticas, os prazos e o rodízio, a aparência do cartão, o nome e o vocabulário do quadro.](https://attendto.com.br/prints-do-manual/funil--configuracoes.png) A tela Configurações do quadro na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Botão Configurar quadro no Funil. Marcar os papéis e Configurar colunas abrem direto em Colunas e etapas. Sem seção escolhida, abre em Campos do cartão. Quem usa: Dono, Admin. ##### Cabeçalho e trilho O nome do quadro (“Funil · Quadro ‹nome›”) e o trilho das seções; as setas, Home e End andam pelo trilho. Botões e ações: - **Voltar ao quadro**: Volta ao Funil, no mesmo quadro. - **Colunas e etapas**: Seção das colunas, dos papéis e dos motivos de perda. - **Campos do cartão**: Seção dos campos do negócio e do que cada etapa pede. - **Regras automáticas**: Seção das regras QUANDO e ENTÃO. - **Rodízio e prazos**: Seção do prazo de cada etapa, do rodízio e do status e banda que a coluna marca no lead. - **Aparência do cartão**: Seção do que o cartão mostra além dos dados do negócio. - **Nome e vocabulário**: Seção do nome, da cor, do quadro padrão, do vocabulário e da exclusão do quadro. ##### Colunas e etapas A lista das colunas na ordem do quadro, com o papel de cada uma. Botões e ações: - **Nova coluna**: Abre o diálogo de coluna nova. Ela entra antes da coluna de ganho. - **Editar**: Abre o diálogo da coluna. - **Mudar a ordem de ‹coluna›**: A alça de cada coluna: arraste, ou use as setas para cima e para baixo com a alça em foco. A ordem grava na hora. Também aparece: - “‹n› colunas · ‹n› etapas intermediárias”. - Por coluna: o nome, “Pede ‹n› campos” ou “Não pede campo”, o prazo (“‹prazo› para assumir · rodízio”, “‹prazo› para o próximo passo” ou “Sem prazo”), “início da negociação” e o papel ou “Sem papel”. - A nota de que o papel alimenta o relatório Investimento → Venda, as conversões para os anúncios e os avisos dos webhooks. - A faixa de papéis pendentes, no quadro antigo sem papéis. ##### Diálogo da coluna Título “Nova coluna” ou “Editar a coluna ‹nome›”. Campos e filtros: - **Nome da coluna** (obrigatório): Até 40 letras. Vazio avisa “Dê um nome à coluna.”; repetido, “Já existe uma coluna com este nome neste quadro.”. - **Prazo para o próximo passo**: Sem prazo, 15 min, 30 min, 1 h, 24 h ou 3 dias (o prazo vindo do modelo também aparece). - **Cor**: Cinza, Azul, Verde, Âmbar, Ardósia, Petróleo, Verde-escuro ou Coral. - **Papel no funil**: Entrada, Qualificado, Atendimento, Etapa intermediária, Ganho ou Perdido. Os travados dizem por quê: “A primeira coluna é sempre a de entrada”, “A última coluna é sempre a de perdido”, “Só a primeira coluna”, “Só a última coluna”. “Já é o papel de ‹coluna›” não trava: ao salvar, a outra vira Etapa intermediária. Botões e ações: - **Levar o prazo e o rodízio**: Interruptor que aparece ao trocar o papel com outra coluna que tem prazo ou rodízio: ligado, eles vêm para esta coluna; desligado, ficam na outra. - **Início da negociação**: Interruptor, só na Etapa intermediária: daqui em diante o negócio conta como em negociação no Revenue e é a etapa em destaque no relatório. Só uma por quadro. - **Copiar o nome na API da coluna**: Copia o Nome na API, a chave que o seu sistema usa e que não muda ao renomear. - **Excluir coluna**: Só ao editar: abre a confirmação de exclusão. - **Cancelar**: Fecha sem salvar. - **Salvar coluna**: Grava as mudanças da coluna. - **Criar coluna**: Cria a coluna nova. Também aparece: - O quadro “Com o papel ‹papel›” explica o efeito do papel escolhido. - Tirar de uma coluna o papel Entrada, Qualificado, Ganho ou Perdido sem dar a outra avisa que o quadro precisa de uma coluna com esse papel. ##### Diálogo Excluir coluna Título “Excluir coluna “‹nome›”?”. Botões e ações: - **Cancelar**: Fecha sem excluir. - **Excluir coluna**: Exclui a coluna, os cartões dela e as regras que apontam para ela; os leads continuam no CRM. Desligado na coluna com papel obrigatório. Não pode ser desfeito. Também aparece: - Quantos cartões e quantas regras vão junto, ou que a coluna está vazia. ##### Motivos de perda Os motivos que o diálogo de perda oferece neste quadro. Campos e filtros: - **Novo motivo**: Caixa “Ex.: Escolheu outra empresa”. Vazio avisa “Escreva o motivo.”; repetido diz onde ele já existe. - **Vale para**: Toda a conta (aparece no diálogo de perda de todos os quadros) ou Só este quadro. Botões e ações: - **Acrescentar**: Inclui o motivo. - **Tirar o motivo ‹motivo›**: O X do motivo que pode sair. Os negócios já perdidos por ele continuam com o motivo no histórico. Também aparece: - Os grupos “Do modelo ‹segmento›”, “Da sua conta · valem em todos os quadros” e “Só deste quadro”, com “Nenhum ainda” no grupo vazio. - A nota de que os motivos gerais aparecem em todo quadro e de qual motivo pede um dado a mais. ##### Os seis papéis e onde o papel aparece Também aparece: - Cada papel com o que significa, quantas colunas podem ter e quais colunas deste quadro o usam. - Onde o papel aparece: Investimento → Venda, Conversões e Webhooks. ##### Campos do cartão Os campos do negócio valem para todos os quadros da conta. Botões e ações: - **Novo campo**: Abre o diálogo de campo novo. - **Mudar a ordem de ‹campo›**: A alça de cada campo: arraste, ou setas para cima e para baixo. Muda a ordem no cartão e no painel. - **No cartão**: Interruptor de cada campo: mostra na frente do cartão. Até três; o quarto avisa “O cartão já mostra 3 campos”. Desligado no campo sensível. - **Editar ‹campo›**: O lápis de cada campo: abre o diálogo do campo. - **Arquivados (‹n›)**: Abre e fecha a lista dos campos arquivados. - **Desarquivar**: Devolve o campo às telas, com os valores guardados. - **Usar os campos do modelo ‹segmento›**: Na conta sem campos, no quadro criado por um segmento: cria os campos do modelo. Também aparece: - “‹n› campos · ‹n› de 3 aparecem no cartão”. - Por campo: o nome, as pílulas Sensível e “Pedido em ‹etapa›”, o tipo (e quantas opções, na lista) e “preenchido em ‹n› negócios” ou “ainda sem valores”. ##### O que cada etapa pede Os dados que o atendente preenche antes de o cartão entrar em cada etapa. Botões e ações: - **Pedir campo**: Abre o menu “Pedir em ‹etapa›” com os campos que a etapa ainda não pede. - **‹campo›**: No menu: a etapa passa a pedir o campo, para os próximos cartões que entrarem. - **Parar de pedir ‹campo› em ‹etapa›**: O X na etiqueta do campo pedido. Os cartões já preenchidos não mudam. Também aparece: - “Não pede nada” na etapa sem exigência; a entrada e o perdido nunca pedem campo (o perdido pede o motivo). - O aviso “Só vale para avançar”: voltar uma etapa ou reabrir nunca pede dados. ##### Prévias Campos e filtros: - **Ao entrar na etapa**: Escolha a etapa para ver o mini diálogo “Para entrar em ‹etapa›, preencha” ou “O cartão entra em ‹etapa› direto”. Também aparece: - “Assim o atendente vê o cartão”: um cartão de exemplo com os campos da frente. - A nota de que até 3 campos aparecem na frente do cartão e campo sensível nunca aparece ali. ##### Diálogo do campo Título “Novo campo” ou “Editar ‹campo›”, com a prévia ao vivo ao lado. Campos e filtros: - **Nome do campo** (obrigatório): Caixa “Ex.: Renda familiar”. Vazio avisa “Dê um nome ao campo.”; repetido, “Já existe um campo com este nome. Escolha outro.”. - **Tipo**: Texto, Número, Moeda, Data, Lista ou Sim ou não. Não muda depois de criado. - **Opções da lista** (obrigatório): Só no tipo Lista: pelo menos duas opções (“Crie pelo menos duas opções.”), até 30. Enter cria a próxima; a alça muda a ordem pelas setas. - **Texto de ajuda**: Aparece embaixo do campo para o atendente. - **Pedido para entrar em**: As etapas deste quadro que pedem o campo. Só vale para avançar. Botões e ações: - **Copiar o nome na API**: Copia a chave do campo usada pelo seu sistema em fields. - **Marcar como sensível**: No aviso “Parece um dado pessoal” (renda, CPF, documento, nascimento…): marca o campo como sensível. - **Adicionar opção**: Acrescenta uma opção na lista. - **Remover opção ‹n›**: A lixeira de cada opção. - **Mostrar na frente do cartão**: Interruptor: o campo vai para a frente do cartão. Desligado no campo sensível ou com três campos já na frente. - **Dado sensível**: Interruptor: o campo nunca sai nos avisos para outros sistemas nem nas exportações, fica mascarado no painel e fora da frente do cartão. - **Manter sensível**: Na conta de segmento regulado, ao desligar Dado sensível de um campo que já era sensível: desiste da troca. - **Desmarcar mesmo assim**: Confirma a retirada da marca de sensível; fica registrado. - **Arquivar**: No campo com valores: some das telas e os valores ficam guardados. - **Excluir**: No campo ainda sem valores: apaga o campo. - **Cancelar**: Fecha sem salvar. - **Criar campo**: Cria o campo. - **Salvar**: Grava as mudanças do campo. Também aparece: - O Nome na API (para quem integra), que não muda depois que o campo tem valores. - A prévia ao vivo do cartão, “Como o atendente preenche” e o mini diálogo da primeira etapa que pede o campo. ##### Regras automáticas Quando algo acontece com o lead, o quadro move, sugere, avisa ou inicia uma cadência. Campos e filtros: - **Gatilho**: QUANDO lead é criado, lead é qualificado, lead vira quente, lead vira morno, reunião é marcada, lead é transferido para atendente, atendente respondeu ao lead, lead responde ou lead esfria sem resposta. - **Ação**: ENTÃO Mover cartão, Sugerir movimento, Disparar cadência ou Avisar atendentes. - **Coluna**: Só para Mover cartão e Sugerir movimento: a coluna de destino. - **Cadência**: Só para Disparar cadência: “Escolha a cadência”; a pausada aparece marcada como “(pausada)”. Botões e ações: - **Adicionar regra**: Cria a regra. Desligado enquanto falta a coluna ou a cadência. - **Remover regra**: A lixeira de cada regra: abre a confirmação “Remover esta regra?”, que tem Cancelar e Remover regra. Também aparece: - Cada regra como frase: “QUANDO ‹gatilho› ENTÃO ‹ação›”, com “só em ‹coluna›”, “só avança” ou “cadência desligada” quando valem. - Sem regras: “Nenhuma regra ainda — este quadro só se move no arrasto manual.” - Cartões que já se moveram por uma regra removida não voltam. ##### Rodízio e prazos Uma linha por coluna; cada mudança grava na hora. Campos e filtros: - **Status do lead**: O status que o lead recebe ao entrar na coluna: Sem status vinculado, Novo, Em conversa, Qualificado, Descartado, Transferido ou Opt-out. - **Banda**: A nota que o lead recebe ao entrar: Sem banda vinculada, Quente, Morno, Frio ou Sem score. - **Tempo máximo nesta etapa**: Em minutos, de 1 minuto a 30 dias; vazio é sem prazo. Grava ao sair do campo. Botões e ações: - **Distribui pelo rodízio quando o cartão entra aqui**: Caixa de marcar: o lead do cartão que entra na coluna vai para o próximo da fila. Só funciona com o rodízio ligado em Configurações → Equipe. Também aparece: - Sem colunas: “Sem colunas ainda — crie a primeira em Colunas e etapas.” ##### Aparência do cartão Caixas de marcar do que o cartão mostra além dos campos do negócio; todas vêm ligadas. Botões e ações: - **Valor do negócio**: Mostra o valor do negócio no cartão. - **Banda e score**: Mostra a pílula da nota (Quente 88). - **Aderência ao cliente ideal**: Mostra a etiqueta ICP. - **Origem de anúncio**: Mostra o ícone de anúncio. - **Tempo na coluna**: Mostra há quanto tempo o cartão está na etapa (com prazo, ele aparece sempre). - **Última fala do lead**: Mostra a última frase do lead. - **BANT (necessidade, orçamento, autoridade, prazo)**: Mostra as letras N O A P. - **Canal**: Mostra o ícone do canal e o nome da conta. - **Barra de jornada**: Mostra a barra de progresso pelas etapas. ##### Nome do quadro Campos e filtros: - **Nome**: Grava ao sair do campo ou com Enter. Vazio volta ao nome anterior. - **Cor do quadro**: Seis cores; grava na escolha. Botões e ações: - **Definir como padrão**: Torna este o quadro que abre primeiro no Funil e onde as integrações colocam os leads quando nenhum quadro é escolhido. No padrão, o botão diz “É o padrão”, desligado. ##### Vocabulário do quadro Como este quadro chama quem atende, quem é atendido, o que se negocia e o ganho. Campos e filtros: - **Quem atende**: Ex.: Corretor. Aparece no filtro, no cartão, nos avisos e no rodízio deste quadro. - **Quem atende, no plural**: Ex.: Corretores. - **Quem é atendido**: Ex.: Cliente. - **O que se negocia**: Ex.: Imóvel. - **Como chamar um ganho**: Usado no relatório Investimento → Venda. - **Ganhos, no plural**: Usado no relatório Investimento → Venda. Botões e ações: - **Salvar vocabulário**: Grava as seis palavras; desligado sem mudança. Alguma vazia avisa “Preencha as seis palavras do vocabulário.”. ##### Excluir quadro Tira o quadro do Funil. Os leads continuam no CRM; os cartões livres se perdem. Campos e filtros: - **Novo quadro padrão**: Só ao excluir o quadro padrão quando há outros: escolha qual vira o padrão; o botão de excluir só liga depois da escolha. Botões e ações: - **Excluir quadro**: Abre a confirmação “Excluir quadro “‹nome›”?”, com quantos cartões e quantos livres o quadro tem. - **Cancelar**: Fecha sem excluir. Também aparece: - Sendo o único quadro: um novo quadro padrão, do modelo Genérico, é criado na próxima visita ao Funil. - Não pode ser desfeito. ##### Estados da tela - Carregando: Esqueleto de título e linhas (“Carregando o quadro”); a seção Campos do cartão tem o esqueleto próprio “Carregando os campos”. - Sem nada ainda: Colunas e etapas sem colunas: “Nenhuma coluna ainda”. Campos do cartão sem campos: “Nenhum campo ainda”, com Novo campo e, no quadro de um segmento, Usar os campos do modelo. - Se der erro: “Não conseguimos carregar o quadro”, avisando que os cartões continuam salvos, com Tentar de novo. Na seção dos campos: “Não conseguimos carregar os campos do cartão”. - Pessoa sem papel de administrador: “Só administradores podem editar o quadro”, explicando que colunas, campos e regras são mudados por quem administra a conta, com Voltar ao quadro. ### Passo a passo #### Como criar um quadro do Funil pelo modelo do seu segmento 1. No Funil, clique em **Novo quadro**. 2. Busque o segmento em **Buscar segmento** (por exemplo, “dentista”) e clique no cartão dele. 3. No painel, confira o **Nome do quadro**, desmarque os campos que não quer e acrescente motivos de perda com **Acrescentar**. 4. Em Quem recebe os leads novos, decida se o quadro antigo para de receber leads novos e se o novo vira o padrão com **Tornar este o quadro padrão**. 5. Clique em **Criar quadro** e depois em **Abrir o quadro**. #### Como mover um cartão para a próxima etapa do Funil 1. Arraste o cartão para a coluna seguinte; ou abra o cartão e clique em **Mover para ‹próxima etapa›**. 2. Se a etapa pede dados, preencha o diálogo “Para entrar em ‹etapa›, preencha” e clique em **Salvar e mover**; **Cancelar** devolve o cartão. 3. Pelo teclado: com o cartão em foco, use Alt com a seta para a direita. 4. Para devolver o cartão ao automático depois de mover à mão, use **Religar automação** no menu **Mais ações**. #### Como marcar um negócio como ganho ou perdido 1. No cartão, abra **Mais ações** e escolha **Marcar como ganho** ou **Marcar como perdido** (ou arraste para a coluna de ganho ou de perdido). 2. No ganho, confira o **Valor do negócio** e clique em **Confirmar ganho**. 3. Na perda, escolha o motivo em “Por que perdemos?”, escreva a **Observação (opcional)** e clique em **Confirmar perdido**. 4. Para desfazer, use **Reabrir negócio**: o cartão volta para a etapa anterior. #### Como criar uma coluna e dar o papel dela no funil 1. No Funil, clique em **Configurar quadro** e abra **Colunas e etapas**. 2. Clique em **Nova coluna**, escreva o **Nome da coluna** e escolha a **Cor**. 3. Em **Papel no funil**, escolha o papel (por exemplo, Etapa intermediária) e, se quiser, ligue **Início da negociação**. 4. Clique em **Criar coluna** e arraste a alça para pôr a coluna na posição certa. #### Como colocar prazo (SLA) numa etapa e distribuir pelo rodízio 1. Em **Configurar quadro**, abra **Rodízio e prazos**. 2. Na linha da coluna, preencha **Tempo máximo nesta etapa** em minutos (vazio é sem prazo). 3. Marque **Distribui pelo rodízio quando o cartão entra aqui** para mandar o lead ao próximo da fila. 4. Confira se o rodízio está ligado em Configurações → Equipe; senão a coluna mostra “Rodízio desligado”. #### Como criar um campo do negócio e pedir o campo numa etapa 1. Em **Configurar quadro**, abra **Campos do cartão** e clique em **Novo campo**. 2. Preencha o **Nome do campo**, escolha o **Tipo** e, se for lista, as **Opções da lista**. 3. Em **Pedido para entrar em**, marque as etapas que pedem o campo; ligue **Mostrar na frente do cartão** ou **Dado sensível** se for o caso. 4. Clique em **Criar campo**. Para ajustar depois, use **Pedir campo** em O que cada etapa pede. #### Como criar uma regra automática no quadro do Funil 1. Em **Configurar quadro**, abra **Regras automáticas**. 2. Escolha o **Gatilho** (por exemplo, “QUANDO lead vira quente”) e a **Ação** (por exemplo, “ENTÃO Mover cartão”). 3. Escolha a **Coluna** de destino, ou a **Cadência** na ação Disparar cadência. 4. Clique em **Adicionar regra**. Para tirar, use **Remover regra** e confirme. #### Como excluir um quadro do Funil 1. Em **Configurar quadro**, abra **Nome e vocabulário**. 2. No cartão Excluir quadro, clique em **Excluir quadro**. 3. Se for o quadro padrão, escolha o **Novo quadro padrão**. 4. Confirme em **Excluir quadro**. Os leads continuam no CRM; os cartões livres se perdem. ### Perguntas frequentes #### Quem pode criar, configurar e excluir quadros do Funil? Só o dono e os administradores da conta. Atendentes trabalham os cartões (arrastar, preencher dados, marcar ganho ou perdido), mas veem Novo quadro e Configurar quadro desligados. #### Remover um cartão do quadro apaga o lead? Não. O lead continua no CRM e nas conversas; só o cartão deste quadro sai. O cartão livre, que não tem lead, é apagado de vez. #### O que significa o selo Manual no cartão? Que alguém da equipe moveu o cartão à mão. A partir daí as regras e a IA não movem mais esse cartão sozinhas, até alguém usar Religar automação. #### Por que o filtro de conta não aparece? Ele só aparece em Mais filtros quando há duas ou mais contas ativas no mesmo canal, como dois números de WhatsApp. Com uma conta só, ele não separaria nada. #### O que a busca do quadro encontra? O nome do lead, a empresa, o título do cartão livre e os dados de texto do negócio que não são sensíveis, sem diferenciar acento nem maiúscula. #### Os filtros do Funil ficam salvos? Não. Valem enquanto você está no quadro; ao trocar de quadro ou recarregar a página, voltam ao normal. #### Por que a soma não aparece no topo de uma coluna? A soma só aparece quando passa de zero e nunca na coluna de perdido. Ela usa o campo de moeda do quadro ou, sem ele, o valor do negócio dos cartões. #### Quem atende consegue ver um dado sensível do negócio? O campo sensível aparece mascarado no painel do cartão. O botão Mostrar revela o valor e deixa registrado na auditoria quem abriu qual campo de qual lead. ### Guia: Funil O quadro em que cada lead vira um cartão e cada coluna é uma etapa da venda. Arraste, veja quanto tem em jogo e deixe parte do trabalho no automático. Conversa boa que ninguém acompanha vira conversa perdida. O funil existe para que você veja, num olhar, em que pé está cada negócio e quanto dinheiro está parado em cada etapa. #### O quadro Na tela: O quadro Funil comercial: a barra de quadros, o rodízio, os filtros com o resumo e Mais filtros, os marcadores das etapas e as colunas com o nome, a contagem, o prazo e os cartões. Um cartão por lead, uma coluna por etapa. 1. **Qual quadro você está vendo**: Dá para ter mais de um: um para vendas novas, outro para renovação, outro para uma campanha específica. O quadro criado pelo modelo de um segmento leva o ícone do segmento, e **Novo quadro** abre a galeria de segmentos. Ao lado, **Configurar quadro** leva às colunas, aos campos e às regras; excluir um quadro fica lá, em **Nome e vocabulário**. 2. **Filtrar o quadro**: Busque pelo nome ou por um dado do negócio, filtre por quem atende, pelos campos de lista do negócio e pela campanha de anúncio. O resumo à direita diz quantos negócios estão em aberto e quanto somam. Ao lado dele, **Mais filtros** abre os outros: só os quentes, só os que a IA moveu (**Automático**), só os que você moveu (**Manual**), só quem veio de anúncio, **Só estourados**, **Ganhos** e **Perdidos**, o canal e, com mais de um número de WhatsApp conectado, a conta. Com algum deles ligado, o botão mostra quantos. 3. **Ir para a etapa**: Um marcador por etapa, com quantos cartões ela tem. O clique rola o quadro até a coluna, e o marcador da etapa à vista fica marcado. 4. **O topo da coluna**: Nome da etapa e quantos cartões; embaixo, o prazo, o rodízio e a **soma dos valores**, que só aparece quando passa de zero. A soma usa o primeiro campo de moeda que vai na frente do cartão (o valor do imóvel, no modelo Imobiliária); sem campo de moeda no quadro, o valor do negócio. É o número que responde "quanto tenho em proposta agora?". O resumo lá em cima soma também o valor do negócio dos cartões que ainda não têm o campo. 5. **O cartão**: No topo, o nome e a nota da conversa (Quente, Morno, Frio); logo abaixo, o primeiro dado de texto do negócio (o imóvel de interesse, no modelo Imobiliária) e, quando o rodízio passou o lead adiante, quem não assumiu a tempo; depois, os dados do negócio que vão na frente do cartão; no rodapé, há quanto tempo o cartão está na etapa, com quem está (ou **Com a IA**) e o ícone de anúncio. A **Aparência do cartão**, em Configurar quadro, liga também a última frase do lead, as letras **N O A P** do BANT, o canal e a barra de jornada. #### O básico 1. **Arraste o cartão**: Da coluna atual para a próxima. Quem prefere teclado: com o cartão em foco, as setas movem e o espaço solta. 2. **Coloque o valor do negócio**: Abra o cartão e escreva quanto vale. Sem isso a soma da coluna é só uma contagem de cabeças. 3. **Crie as suas colunas**: As etapas que vêm prontas são um ponto de partida. Em **Configurar quadro → Colunas e etapas**, renomeie, tire, crie e diga o papel de cada coluna no funil até o quadro descrever o seu jeito de vender. Quadro novo começa pelo modelo do seu segmento, em **Novo quadro** — o [Funil por segmento](https://attendto.com.br/manual/funil) explica; quem não acha o segmento usa o Genérico. > **O que você escreve vence o que a IA calculou:** Se você digitar o valor do negócio à mão, a IA não sobrescreve mais. O mesmo vale para a coluna: cartão movido por você fica onde você deixou. #### Deixar parte no automático Cada quadro pode ter regras: **quando acontece isto, faça aquilo**. É o que evita que você precise lembrar de mover cartão a cada reunião marcada. - **Gatilhos comuns**: O lead ficou quente, a IA marcou uma reunião, o lead sumiu por X dias, a conversa foi encerrada, chegou uma mensagem nova. Para a coluna do pedido pronto, use **lead vira quente → Mover cartão**: com **Conduzir até o pedido completo** ligado (o padrão das contas novas), em [Configurações](https://attendto.com.br/manual/configuracoes) → IA & persona, o gatilho **lead é transferido para atendente** dispara quando o pedido fica completo (a conversa vai para a equipe confirmar) ou quando a IA não consegue seguir com segurança. - **O que a regra pode fazer**: Mover o cartão de coluna, sugerir o movimento para alguém confirmar, disparar uma cadência ou avisar os atendentes. > **Comece com uma regra só:** Três regras criadas no mesmo dia se atropelam e você não descobre qual moveu o quê. Ligue uma, veja rodar por uma semana, depois ligue a próxima. #### Prazo por etapa e rodízio Na tela: Quadro Imobiliária com a coluna Qualificado marcada com o prazo de 15 min e o rodízio; o tempo de cada cartão aparece como “9 de 15 min”, em verde, âmbar ou vermelho, e Mais filtros aberto mostra o Só estourados com a contagem. O tempo do cartão muda de cor com o prazo; Só estourados, em Mais filtros, mostra quantos passaram. Cada coluna pode ter um **tempo máximo**: quanto um cartão pode ficar ali antes de estourar. Está em **Configurar quadro**: no diálogo de cada coluna (**Colunas e etapas**, “Prazo para o próximo passo”) ou em **Rodízio e prazos**, em minutos; vazio é sem prazo. Com prazo, o tempo no rodapé do cartão passa a contar contra ele ("9 de 15 min") e muda de cor: **verde** dentro do prazo, **âmbar** a partir da metade, **vermelho** quando estourou, e aí diz "estourou". O **Só estourados**, em **Mais filtros**, mostra quantos são e deixa só eles na tela. A mesma coluna pode **distribuir pelo rodízio**: quando um cartão entra nela (por arrasto, por sugestão aceita ou pela automação), a conversa do lead vai para o próximo atendente da fila, com o nome dele no cartão. O rodízio se liga em [Configurações → Equipe](https://attendto.com.br/manual/configuracoes); enquanto estiver desligado, a marca na coluna não faz nada. - **Strike**: Com o rodízio ligado, um cartão que estoura o prazo com um atendente responsável dá um strike para ele e passa o lead para o próximo da fila. Vale nas colunas de papel Entrada, Qualificado e Atendimento e nas colunas sem papel. Numa etapa intermediária, estourar só avisa quem está com o cartão (ou o dono da conta, quando o cartão não tem responsável ou quando o responsável não entra no painel), sem strike e sem trocar de atendente. A varredura roda a cada 5 minutos e cada estadia na coluna rende no máximo um strike ou um aviso. - **3 strikes em 7 dias**: O atendente sai do rodízio: para de receber lead novo até o dono devolver, em Equipe. Ele continua atendendo o que já tem. - **Ninguém disponível**: Se todos estão cheios ou fora do rodízio, o lead fica na fila de transbordo como sempre e o dono recebe um aviso. > **Comece com prazo folgado:** Um prazo que a equipe não cumpre no dia normal enche o quadro de vermelho e derruba todo mundo do rodízio na primeira semana. Meça o tempo típico da etapa antes e coloque o prazo um pouco acima. #### Ganho e perdido: o negócio tem fim Na tela: Diálogo Marcar como perdido sobre o quadro: os botões de motivo, um campo de observação e o botão Confirmar perdido. Perdido pede o motivo; ganho confirma o valor. O cartão vai para a coluna certa e a cadência para. A coluna de papel **Ganho** ou **Perdido** marca o desfecho do negócio: o papel se escolhe em **Configurar quadro → Colunas e etapas**, no diálogo da coluna. Quadros novos já nascem com os dois papéis marcados; nos que existem, você marca. A partir daí, soltar um cartão nessa coluna abre a pergunta: **por que perdemos?** ou **por quanto ganhamos?** (o valor do negócio: com um campo de moeda preenchido, como o valor do imóvel, é ele que vem, no lugar do orçamento que a IA estimou na conversa; um valor que alguém digitou fica, e a dica oferece usar o do campo). Os motivos vêm em três grupos: os deste quadro (os do modelo do segmento e os só dele), os da sua conta e os gerais do produto (preço, não é agora, concorrente, sem resposta, não era para nós, outro). Um motivo pode pedir um campo a mais, que aparece logo abaixo; e a coluna de ganho pode pedir os campos dela antes de marcar. Cancelar deixa o cartão onde estava. Também dá para marcar pelo menu **⋮** do cartão ou pelos botões do painel lateral, sem arrastar: o cartão vai sozinho para a coluna de desfecho. No cartão, a pílula da nota vira **Ganho** (com o dia do ganho no rodapé) ou **Perdido** (com o motivo embaixo do nome), as cadências de follow-up do lead param, a ficha do lead e o histórico do cartão registram quem marcou, quando e a observação. Em **Mais filtros** ficam **ganhos, perdidos e a taxa de ganho dos últimos 30 dias** e os filtros **Ganhos** e **Perdidos**. - **Reabrir negócio**: No menu do cartão ou no painel lateral. Limpa o desfecho, devolve o cartão para a etapa anterior à coluna de desfecho e deixa o registro antigo na trilha. As cadências não voltam sozinhas. - **Por que o motivo é obrigatório**: É dele que saem os números de Revenue (por que perdemos, quanto ficou parado por preço) e o cliente ideal calculado pela IA, que aprende com quem ganhou e quem perdeu. Sem motivo, o perdido não ensina nada. - **Coluna Perdido e status do lead**: A coluna Perdido dos modelos também muda o status do lead para desqualificado, como sempre fez. O desfecho é outro registro, do negócio; um lead desqualificado hoje pode virar negócio ganho depois de reaberto. #### Dentro do cartão Cada cartão começa pela **foto** de quem ele representa, quando ela existe — hoje, quem chegou pelo Instagram. Sem foto, o círculo com as iniciais: o quadro fica com a mesma cara do [Inbox](https://attendto.com.br/manual/inbox), e bate o olho reconhece a pessoa antes de ler o nome. Clicar no cartão (ou **Enter**, com ele em foco) abre o painel ao lado do quadro, que continua visível e arrastável: a etapa e há quanto tempo o cartão está nela, com quem está, de onde o lead veio, o **Resumo da IA** da conversa, o histórico do negócio (por onde ele passou e quanto tempo ficou em cada etapa) e o atalho **Abrir no Inbox**. É de onde sai a resposta para "o que aconteceu com esse cliente mesmo?". O **X** fecha o painel e devolve você ao cartão. No mesmo painel ficam os **Dados do negócio** (os campos da conta, que gravam quando você sai do campo), o quadro **Próxima etapa** com o que falta para o cartão avançar, e os botões **Mover para** a próxima etapa ou para outra. Até três campos aparecem também na frente do cartão. Como criar os campos e dizer o que cada etapa pede está no [Funil por segmento](https://attendto.com.br/manual/funil). #### Quando o quadro para de ajudar - **Uma coluna que só engorda**: Cartão entra e não sai é sintoma de etapa mal definida, não de time devagar. Pergunte o que precisa acontecer para o cartão sair dali; se ninguém souber responder em uma frase, a coluna não existe de verdade e vale juntá-la com a vizinha. - **A regra moveu um cartão que você não queria**: Arraste de volta. O que você faz à mão vence a automação, e o cartão traz o registro de quem o moveu e por quê — é assim que se descobre qual regra está larga demais. - **Cartões duplicados do mesmo lead**: Acontece quando a mesma pessoa entra por dois canais. Junte os contatos em [Base de contatos](https://attendto.com.br/manual/base-de-contatos) e o quadro passa a mostrar um cartão só. - **O valor do negócio não bate com a proposta**: O valor que você escreve à mão no cartão vence qualquer estimativa automática. Se está errado, é porque ninguém corrigiu depois que a proposta mudou. > **Um quadro saudável é assim:** Poucas colunas, cada uma com um critério de saída que cabe numa frase, e nenhum cartão parado há mais tempo que o seu ciclo normal de venda. Se você precisa rolar a coluna para ver o fim dela, provavelmente há duas etapas escondidas ali dentro. No painel: Abrir o Funil. ### Guia: Funil por segmento Modelo pronto, papel das etapas e o que cada uma pede #### Começar pelo modelo do seu segmento 1. **Abra Funil → Novo quadro**: A galeria mostra os 17 segmentos; a busca entende o nome do negócio (“dentista” acha Odontologia). O segmento da sua conta vem primeiro, com o selo **Segmento da sua conta**; se o modelo do seu segmento foi montado pela IA, ele aparece como mais um cartão, com a pílula **Gerado pela IA**. 2. **Abra o segmento**: Veja o que vem junto: as colunas com o papel de cada uma, os campos do negócio, os motivos de perda e, nos segmentos com cuidados, as regras do conselho e da LGPD. 3. **Ajuste o que vem junto**: Desmarque os campos que não quer e acrescente motivos de perda só deste quadro. A frente do cartão mostra até três campos, somando todos os quadros da conta: se o cartão já está cheio, o painel avisa quais ficam só no painel do cartão. 4. **Decida quem recebe os leads novos**: Decida se o quadro antigo para de receber leads novos e se o novo vira o padrão. Só as regras que criam cartão são desligadas: os avisos e a cadência de lead novo continuam. Na tela: A galeria de segmentos em Funil → Novo quadro: a barra de quadros, a busca por segmento, o filtro Com cuidados do segmento e os cartões de Imobiliária, Clínica médica, Odontologia e outros, cada um com as etapas, os campos e os motivos. A galeria de segmentos: cada cartão mostra as etapas, os campos e os motivos de perda que o quadro traz. Na tela: O quadro Imobiliária: a barra de quadros, o rodízio ligado em Qualificado, os filtros, o resumo dos negócios em aberto, os marcadores das etapas e as colunas com os cartões. O quadro criado pelo modelo Imobiliária. As etapas Pasta e Aprovação pedem dados antes de o cartão entrar. #### O papel de cada coluna O nome da coluna é seu. Em **Configurar quadro → Colunas e etapas**, cada coluna declara também o **papel no funil**, e é o papel que o Revenue, os webhooks e o relatório [Investimento → Venda](https://attendto.com.br/manual/investimento) usam: as barras e as colunas do relatório seguem as etapas do quadro, e a coluna de ganho diz o que conta como venda. | Papel | O que significa | Quantas por quadro | | --- | --- | --- | | Entrada | Onde o lead novo entra sozinho | Uma, a primeira coluna | | Qualificado | A IA qualificou; o rodízio e o prazo para assumir começam aqui | Uma | | Atendimento | Uma pessoa do time assumiu a conversa | Nenhuma ou uma | | Etapa intermediária | Os passos do seu processo | Quantas precisar | | Ganho | Negócio fechado: pede o valor | Uma | | Perdido | Negócio perdido: pede o motivo | Uma, a última coluna | > **Trocar o papel de coluna:** Para trocar o papel de ganho ou de qualificado de coluna, dê primeiro o papel a outra: o quadro nunca fica sem eles. Pelo mesmo motivo, a coluna de entrada, de qualificado, de ganho ou de perdido não se exclui. Ao dar a uma coluna um papel que já é de outra, a outra passa a ser Etapa intermediária. #### As etapas e o que cada uma pede Cada etapa pode pedir campos antes de o cartão entrar. Ao arrastar para uma etapa com campo faltando, abre o diálogo que pede o que falta. Voltar uma etapa ou reabrir nunca pede nada. No modelo Imobiliária: | Etapa | Pede | | --- | --- | | Visita | Imóvel de interesse | | Pasta | Valor do imóvel e tipo de financiamento | | Aprovação de crédito | Banco e data de envio da pasta | | Venda | Data da aprovação | Na tela: O diálogo Para entrar em Pasta, preencha: a trilha de Visita para Pasta, o campo Valor do imóvel em reais, as opções de Tipo de financiamento e os botões Cancelar e Salvar e mover. Ao avançar para uma etapa que pede dados, o diálogo pede só o que falta. Cancelar devolve o cartão à etapa de origem. Quando a IA quer mover o cartão e falta algum dado, o cartão ganha a sugestão de avançar, com a lista do que falta, e o atendente completa com um clique (**Preencher e mover**). Pelo teclado: com o cartão em foco, **Alt** com a seta para a direita ou para a esquerda move de etapa, e **Enter** abre o cartão. O que cada etapa pede fica em **Configurar quadro → Campos do cartão → O que cada etapa pede**. #### Rodízio e prazo O lead qualificado (ou transferido pela IA) cai na coluna de papel **Qualificado**, e o rodízio entrega ao próximo atendente da fila. Ele tem o prazo da coluna para responder ao lead (15 minutos no modelo Imobiliária). Quando responde, o cartão vai sozinho para a coluna de atendimento e o prazo para de correr. Sem resposta, o lead passa para o seguinte e o atendente leva um atraso; três atrasos em 7 dias tiram o atendente da fila. Numa etapa intermediária com prazo, estourar avisa quem está com o cartão (ou o dono da conta, quando essa pessoa não entra no painel), sem atraso e sem trocar de atendente. O cartão do quadro mostra quem está na fila e os próximos da vez, e o cartão do lead que passou adiante diz quem não assumiu a tempo. #### Motivos de perda O diálogo de perda pede um motivo. Os do modelo vêm do segmento; em **Colunas e etapas → Motivos de perda** você acrescenta os da conta (valem em todos os quadros) e os só deste quadro. Um motivo pode pedir um campo a mais: no modelo Imobiliária, “Crédito reprovado” pede o Motivo da reprovação. Tirar um motivo não apaga o histórico de quem já foi perdido por ele. #### Dados do negócio e dado sensível Os campos aparecem no painel do cartão, e até três deles na frente do cartão. O campo de moeda preenche como uma maquininha de cartão: os dois últimos dígitos são os centavos (38000000 vira 380.000,00). Eles valem para todos os quadros da conta e se criam em **Configurar quadro → Campos do cartão**: nome, tipo (texto, número, moeda, data, lista ou sim ou não), texto de ajuda e as etapas que pedem o campo. Na tela: Configurar quadro → Campos do cartão: a lista dos campos com o tipo, as etapas que pedem cada um, quantos negócios já têm valor e o interruptor No cartão; ao lado, a prévia do cartão e o que a etapa Pasta pede. Campos do cartão: o que aparece na frente do cartão (até três) e o que cada etapa pede antes de o cartão entrar. Campo marcado como sensível fica escondido até alguém clicar em **Mostrar**; o clique fica registrado, e o histórico mostra só “valor alterado”, sem o valor. Dado sensível não aparece na frente do cartão nem nos avisos para outros sistemas. Nos segmentos de saúde, os campos de saúde já vêm marcados como sensíveis. > **Arquivar em vez de excluir:** Campo que já tem valores não se exclui: arquive. Ele some das telas e os valores ficam guardados; ao desarquivar, eles voltam aos cartões. #### Atualizar a etapa pelo seu sistema O seu CRM pode mover o cartão pela API, com a chave da integração, usando o **Nome na API** de cada coluna (em Colunas e etapas). Essa permissão vem **desligada**: ligue em [Integrações → Entrada de leads](https://attendto.com.br/manual/integracoes) → **Editar**. Com ela desligada, a chave só envia leads. > **Atenção:** A venda marcada pelo seu sistema também vai para as [conversões da Meta](https://attendto.com.br/manual/integracoes). Ligue só para o sistema em que você confia. #### Perguntas frequentes **Um lead pode aparecer em dois quadros?** Pode, se os dois quadros tiverem regra de lead novo. Ao criar o quadro pelo modelo do segmento, deixe ligada a opção que para o quadro antigo de receber leads novos. **O meu segmento não está na lista. E agora?** Use o modelo Genérico: etapas simples, que você renomeia e completa em Colunas e etapas. O papel de cada coluna já vem marcado. Ou, em Configurações → Seu segmento, escolha **Outro segmento** e a IA monta o modelo do seu segmento, com prévia antes de usar ([Conta pronta para o seu segmento](https://attendto.com.br/manual/configuracoes)). **O que é o “em negociação” no Revenue?** No quadro Imobiliária, são os cartões em Pasta e em Aprovação de crédito. No painel: Abrir a galeria de segmentos. Como as pessoas procuram: kanban de vendas; funil de vendas whatsapp; como criar quadro no funil; arrastar cartão de etapa; marcar negócio como perdido; motivo de perda; prazo por etapa sla; rodízio de leads; campos personalizados do negócio; modelo de funil por segmento; regras automáticas do funil; excluir quadro do funil; valor do negócio no cartão. ## Follow-up: cadências automáticas que retomam o lead que parou de responder URL: https://attendto.com.br/manual/follow-up Menu: Operação > Follow-up O Follow-up é a tela das cadências: sequências automáticas de passos que retomam o lead que parou de responder e param sozinhas quando ele responde, quando um humano assume ou quando o negócio tem desfecho. Quando aparece: Só para dono e administradores. As abas Resultados, Biblioteca e Limites, o objetivo, o público, os gatilhos do Funil e do ICP, as condições, o teste A/B, o áudio da IA, a tarefa para o time e o ajuste ao melhor momento aparecem com o módulo Revenue AI ativo (follow-up avançado); sem ele, a tela mostra a régua linear. ### Quem pode usar - Dono: Vê o item no menu e faz tudo: cria, edita, liga, pausa e exclui cadências, vê os resultados, usa a biblioteca e muda os limites. - Admin: O mesmo que o dono, inclusive os limites. - Atendente: Não vê o item no menu. Aberta pelo endereço, a tela leva de volta ao Painel. ### Telas #### Follow-up A tela Follow-up serve para criar, ligar e acompanhar as cadências de follow-up, que mandam passos automáticos ao lead que sumiu e param quando ele responde. Endereço no painel: `/app/followup` ![Captura da tela Follow-up. A tela Follow-up serve para criar, ligar e acompanhar as cadências de follow-up, que mandam passos automáticos ao lead que sumiu e param quando ele responde.](https://attendto.com.br/prints-do-manual/follow-up--cadencias.png) A tela Follow-up na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Pelo item Follow-up do menu. A mesma seção existe em Configurações → Cadências. ##### Cabeçalho e abas O título muda com o módulo: “Cadências · o follow-up vira um fluxo” com o follow-up avançado, “Cadências de follow-up” sem ele. Botões e ações: - **Cadências**: A lista das cadências da conta (a aba que abre primeiro). - **Editor**: Aparece só enquanto uma cadência está sendo criada ou editada. - **Resultados**: Os números de uma cadência. Só com o follow-up avançado. - **Biblioteca**: As cadências prontas para usar. Só com o follow-up avançado. - **Limites**: Os freios que valem para todas as cadências. Só com o follow-up avançado. Também aparece: - Sem o módulo, o aviso de que o Follow-up avançado faz parte do módulo Revenue AI e se liga em Módulos. ##### Lista de cadências Botões e ações: - **Nova cadência**: Abre o editor com uma cadência em branco, pausada, com gatilho de 48 horas sem resposta e um passo. - **Ativa**: A caixa de cada cadência liga e pausa a régua; o texto ao lado diz Ativa ou Pausada. Ligar com passo de modelo sem modelo escolhido é recusado com a explicação. - **Resultados**: Abre a aba Resultados já nesta cadência. Só com o follow-up avançado. - **Editar**: Abre a cadência no editor. - **Excluir**: Abre a confirmação de exclusão. Também aparece: - O nome da cadência e “‹gatilho› · ‹n› passo(s)”. - As etiquetas do objetivo, “melhor momento”, “A/B”, “condições” e “tarefa”, quando a cadência tem. - Na cadência pausada com passo de modelo sem modelo: “Escolha o modelo aprovado para o passo ‹n› e ligue a cadência.” ##### Diálogo Excluir esta cadência? Botões e ações: - **Excluir cadência**: Exclui a cadência. Ela para de disparar na hora, inclusive para quem está no meio da sequência. Não pode ser desfeito; o X ou Esc fecham sem excluir. ##### Editor: resumo da cadência Título “Nova cadência” ou “Editar cadência”. Campos e filtros: - **Nome** (obrigatório): Caixa “Ex.: Recuperar quem sumiu”. Sem nome, Salvar cadência fica desligado. - **Objetivo**: Só com o follow-up avançado. Sem objetivo declarado, Agendar reunião, Retomar proposta, Recuperar negociação parada, Reativar “não é agora”, Reengajar lead frio ou Fazer voltar quem não compareceu. Entra na instrução de cada passo escrito pela IA. - **Gatilho de entrada**: Quando o lead entra: Sem resposta há X horas, Virou uma temperatura (BANT), Mudou de status ou Só pelo Funil (regra de retomada). Com o follow-up avançado, também Entrou numa etapa do Funil, Ficou N dias numa etapa, Estourou o prazo da etapa, Perdido por “não é agora” há N dias e ICP alto sem resposta há N horas. - **‹valor do gatilho›**: Muda com o gatilho: Horas sem resposta, Temperatura (Quente, Morno, Frio), Status (Novo, Em conversa, Qualificado, Descartado, Transferido), Etapa (o quadro, quando há mais de um, e a etapa do Funil), Etapa e dias (com os dias parado), Dias desde o perdido. No gatilho de prazo, a frase “Quando o cartão estoura o prazo da etapa (SLA) no Funil.” - **Público**: Só com o follow-up avançado. Mostra o resumo de quem entra (“Todo mundo que bate o gatilho”, “ICP ≥ 40”…); o clique em editar abre os campos do público. Botões e ações: - **Cadência ativa**: O interruptor do topo do editor: a cadência é salva ligada (Ativa) ou pausada (Pausada). Também aparece: - Na cadência com gatilho do follow-up avançado aberta sem o módulo: “Esta cadência usa um gatilho do follow-up avançado. Com o módulo Revenue AI desligado ela fica inerte: nada é matriculado até religar.” ##### Público Quem entra na cadência. Vazio é todo mundo que bate o gatilho. Campos e filtros: - **ICP mínimo**: Aderência ao cliente ideal a partir de, de 0 a 100. - **ICP máximo**: Aderência ao cliente ideal até, de 0 a 100. - **Valor mínimo (R$)**: Só leads com valor do negócio a partir deste. - **Temperatura**: Botões Quente, Morno, Frio e Sem score; marque um ou mais. - **Etiquetas**: Separadas por vírgula, como “vip, indicação”. ##### Passos Um cartão numerado por passo, na ordem em que saem. Campos e filtros: - **Tipo do passo ‹n›**: IA escreve (dentro de 24h), Mensagem fixa (dentro de 24h), Template aprovado e, com o follow-up avançado, Áudio da IA (dentro de 24h) e Tarefa para o time. - **Espera do passo ‹n› em horas**: A espera, em horas, desde o passo anterior (ou desde a entrada, no primeiro). - **Modelo aprovado**: No Template aprovado: a lista dos modelos aprovados da conta, com o idioma. Sem nenhum, o aviso para criar em Modelos de mensagem. Modelo que deixou de ser aprovado aparece com “— não está mais aprovado”. - **Instrução para a IA (opcional)**: No IA escreve: o que a IA deve fazer neste passo, com o histórico real do lead. - **Instrução para a IA (sai como áudio no WhatsApp; se a voz falhar, sai o texto)**: No Áudio da IA: a mesma instrução, falada pela voz da persona. - **Mensagem fixa (use {nome} e {ia})**: Na Mensagem fixa: o texto exato, com o nome do lead e o nome da IA. - **O que pedir ao time**: Na Tarefa para o time: a pendência que entra na ficha do lead. Nada sai para o lead. - **Prazo (horas)**: Na Tarefa para o time: o prazo da pendência, de 1 a 720 horas. - **Tom**: Só com o follow-up avançado, nos passos da IA: O da persona, Leve, Direto ou Urgente. - **Anexar oferta**: Só com o follow-up avançado: Nenhuma ou uma oferta ativa do catálogo para a IA citar. - **Pergunta de fechamento**: Só com o follow-up avançado: a pergunta com que o passo termina (por exemplo, dois horários). - **Variante B (A/B): metade dos leads recebe esta versão**: Com o Teste A/B por passo ligado: o texto ou a instrução alternativa do passo. Botões e ações: - **remover**: Tira o passo (aparece com dois passos ou mais). - **+ Adicionar passo**: Acrescenta um passo IA escreve com 24 horas de espera no fim. Também aparece: - As etiquetas WhatsApp, “fora da janela” (no Template aprovado: fora da janela de 24 h só modelo aprovado chega), “melhor momento” e “A/B”. - Avisos do modelo escolhido: quando ele tem mais de uma variável (a cadência só preenche o nome do lead) ou mídia no cabeçalho (a cadência não anexa arquivo). - Na Tarefa para o time: “Nada sai para o lead: a tarefa entra na ficha, o dono da conversa recebe push e sino, e a régua segue.” ##### Condição antes do passo Só com o follow-up avançado. Avaliada na hora em que o passo vence. Campos e filtros: - **Condição do passo ‹n›**: Sem condição (o passo sempre roda), ou se a mensagem anterior foi entregue e não foi lida, se foi lida e o lead não respondeu, se o lead levantou objeção, se a aderência ao cliente ideal é a partir de um número, se o valor do negócio é a partir de um valor. - **Valor da condição**: Nas condições de aderência (0 a 100) e de valor do negócio (em reais). - **Quando a condição vale**: Envia este passo, pula para um passo adiante ou encerra a cadência. Só adiante, nunca para trás. - **Quando a condição não vale**: As mesmas opções, para quando a condição não vale. Também aparece: - No primeiro passo, as condições de entregue e lido avisam que nunca valem: não há mensagem anterior. ##### Para quando Só com o follow-up avançado. O que interrompe a régua, sempre ligado. Também aparece: - Respondeu: para. - Marcado como ganho ou perdido: para. - “Não me chame mais”: para e marca o lead. - “Me chama em março”: dorme até a data. - Humano assumiu a conversa: para. - Opt-out ou fora das campanhas: para. ##### Canais e momento Só com o follow-up avançado (o Enviar por aparece também na régua linear). Campos e filtros: - **Enviar por**: Com duas ou mais contas de WhatsApp ativas (ou uma em coexistência): Conta padrão do canal ou uma das contas. Vale quando o lead ainda não tem conversa aberta; com conversa, sai pelo número dela. - **Adiar no máximo**: Em horas: o máximo que o ajuste ao melhor momento pode adiar cada passo. Só com o ajuste ligado. Botões e ações: - **Ajustar ao melhor momento do lead**: Adia cada passo até a janela em que aquele lead costuma responder, dentro do horário de atendimento; nunca antecipa. - **Teste A/B por passo**: Liga a Variante B nos passos: metade dos leads recebe A e metade B; em Resultados a resposta sai por variante. Também aparece: - Canal: WhatsApp (o canal do lead). - Retomar quando o lead pedir: automático. ##### Melhor momento · leads da conta Só com o follow-up avançado. Também aparece: - O mapa de dias (seg a dom) por faixas de duas horas, das 8h às 22h: quanto mais forte a cor, mais leads da conta respondem ali. - “‹n› lead(s) com janela aprendida (3 respostas ou mais)” ou “Ainda sem janela aprendida: a IA precisa de 3 respostas de um lead para saber quando ele costuma responder.” ##### Rodapé do editor Botões e ações: - **Cancelar**: Fecha o editor sem salvar e volta à lista. - **Salvar cadência**: Grava a cadência e volta à lista. Desligado sem nome, com o valor do gatilho inválido ou com passo de Template aprovado sem modelo (“Escolha o modelo aprovado do passo de template”). ##### Resultados O que a cadência fez no período: quem entrou, o funil de cada passo, o melhor passo e o melhor horário. Campos e filtros: - **Cadência**: Com duas ou mais cadências: qual cadência mostrar. Abre na primeira ativa. Botões e ações: - **‹n› dias**: Os botões 30 dias e 90 dias trocam o período. - **Fixar a variante ‹A ou B›**: Aparece quando uma variante vence com 30 envios ou mais de cada lado e 10 pontos de diferença: o texto vencedor vira o principal e o teste desliga. - **Tentar de novo**: Quando os números não carregaram. Também aparece: - Os números matriculados, em andamento, responderam (com a taxa), agendaram (com a taxa), ganhos e modelos pagos (o gasto com modelos no período). - Funil por passo: por passo, enviados, lidos, responderam e “desv” (pulados por condição); na tarefa, quantas foram criadas. - Melhor passo, melhor horário e as tarefas abertas. - Teste A/B: a resposta por variante, ou o aviso de que está desligado nesta cadência. - Com e sem ajuste ao melhor momento: a resposta de cada lado; “Medindo” enquanto não há passos suficientes. - As pausas inteligentes do período: réguas dormindo até a data pedida e leads que pediram para parar. ##### Biblioteca Cadências prontas: um clique abre no editor com passos, público e regras preenchidos. Nada liga sozinho. Botões e ações: - **Usar**: Abre a cadência pronta no editor, pausada. Onde há Template aprovado, escolha o modelo antes de salvar. Também aparece: - Retomada de proposta. - “Não é agora” em 60 dias. - Lead frio de anúncio. - Negociação parada há 7 dias. - ICP alto sem resposta. - Reengajar no melhor momento. - Prazo da etapa estourado. ##### Limites Freios que valem para todas as cadências da conta. Ao bater um teto, o passo espera e a régua não morre. Campos e filtros: - **Follow-ups por lead por semana**: Somando todas as cadências, de 1 a 30; o padrão aparece ao lado. - **Teto mensal com modelos pagos (0 = sem teto)**: O teto do gasto do mês com modelos aprovados nas cadências, em reais. Zero é sem teto. Botões e ações: - **Salvar limites**: Aparece depois de mudar um dos números. Grava os limites para todas as cadências. Também aparece: - Os freios que já existem: janela de 24 h (fora dela só modelo aprovado), horário de atendimento, humano com a conversa cala a cadência, e opt-out, base legal e fora das campanhas. - A nota do painel do módulo, que mostra o gasto do mês e os números das cadências. ##### Estados da tela - Carregando: Na aba Resultados, “Carregando…” enquanto os números chegam; a lista de modelos aprovados mostra “Carregando modelos…”. - Sem nada ainda: “Nenhuma cadência ainda.” (com o follow-up avançado, “Comece pela Biblioteca.”). Resultados sem matrícula: “Ninguém entrou nesta cadência nos últimos ‹n› dias. Os números aparecem a partir da primeira matrícula.” - Se der erro: “Não foi possível carregar as suas cadências”, lembrando que isso não quer dizer que não há nenhuma e que nenhuma régua foi desligada, com Tentar de novo. Na aba Resultados: “Não foi possível carregar os resultados” (a régua continua rodando). - Módulo Revenue AI desligado: Só as abas Cadências e Editor, o editor da régua linear e o aviso de que o follow-up avançado se liga em Módulos. - Salvar falhou: O aviso “Não foi possível salvar.”; a cadência continua aberta no editor. ### Passo a passo #### Como criar uma cadência de follow-up para quem parou de responder 1. Abra **Follow-up** no menu e clique em **Nova cadência**. 2. Dê um **Nome** e, no **Gatilho de entrada**, escolha “Sem resposta há X horas” com as horas. 3. Em cada passo, escolha o tipo (IA escreve, Mensagem fixa ou Template aprovado), a espera em horas e o texto; use **+ Adicionar passo** para mais passos. 4. Ligue o interruptor **Cadência ativa** e clique em **Salvar cadência**. #### Como usar uma cadência pronta da Biblioteca 1. Com o follow-up avançado ligado, abra a aba **Biblioteca**. 2. Clique em **Usar** na cadência que quer (por exemplo, Retomada de proposta). 3. No editor, ajuste o que quiser e escolha o **Modelo aprovado** nos passos de Template aprovado. 4. Ligue **Cadência ativa** e clique em **Salvar cadência**. #### Como pausar ou excluir uma cadência de follow-up 1. Na aba **Cadências**, desmarque a caixa **Ativa** da cadência para pausá-la. 2. Para apagar, clique em **Excluir** e confirme em **Excluir cadência**: ela para na hora, inclusive para quem está no meio. #### Como colocar uma condição num passo da cadência 1. Abra a cadência com **Editar**. 2. No passo, em “Antes deste passo”, escolha a condição (por exemplo, a mensagem anterior foi lida e o lead não respondeu). 3. Diga o que fazer quando vale e quando não vale: enviar o passo, pular para um passo adiante ou encerrar a cadência. 4. Clique em **Salvar cadência**. #### Como fazer um teste A/B na cadência e fixar a vencedora 1. No editor, em Canais e momento, ligue **Teste A/B por passo**. 2. Preencha a **Variante B (A/B): metade dos leads recebe esta versão** nos passos que quer comparar e salve. 3. Acompanhe na aba **Resultados**, no bloco Teste A/B. 4. Quando aparecer **Fixar a variante ‹A ou B›**, clique: o texto vencedor vira o principal e o teste desliga. #### Como limitar quantos follow-ups cada lead recebe por semana 1. Com o follow-up avançado ligado, abra a aba **Limites**. 2. Mude **Follow-ups por lead por semana** e, se quiser, o teto mensal com modelos pagos. 3. Clique em **Salvar limites**. Os limites valem para todas as cadências da conta. ### Perguntas frequentes #### Por que não consigo ligar a cadência? Provavelmente há um passo de Template aprovado sem modelo escolhido. Cada passo desses é mensagem paga, então a cadência só liga depois que você escolhe o modelo aprovado em todos eles. #### Qual a diferença entre IA escreve, Mensagem fixa e Template aprovado? IA escreve e Mensagem fixa só saem dentro da janela de 24 horas da conversa no WhatsApp. Fora dela, só chega o Template aprovado, que é um modelo de mensagem aprovado para a conta. #### Atendente pode criar ou mudar cadências? Não. O Follow-up é só do dono e dos administradores; para quem atende, o item não aparece no menu. #### Excluir uma cadência afeta quem já está nela? Sim. A cadência excluída para de disparar na hora, inclusive para os leads que estão no meio da sequência. Para só interromper por um tempo, pause em vez de excluir. #### Por que não vejo as abas Resultados, Biblioteca e Limites? Elas fazem parte do follow-up avançado, que vem com o módulo Revenue AI. Sem o módulo ativo, a tela mostra só a lista e o editor da régua linear. #### Posso escolher por qual número de WhatsApp a cadência envia? Sim, com duas ou mais contas de WhatsApp ativas: use Enviar por. Isso vale para o lead que ainda não tem conversa aberta; com conversa aberta, a cadência responde pelo número daquela conversa. #### O que acontece quando o lead bate o limite semanal ou o teto do mês? O passo espera e volta depois, na semana seguinte ou quando o mês vira. A cadência não é encerrada por causa do limite. ### Guia: Follow-up Cadências que retomam quem sumiu, passo a passo: o editor de fluxo, condições, teste A/B, tarefa para o time, pausa inteligente, biblioteca, limites e o painel de resultados. **Follow-up** é a tela das cadências: sequências de passos disparadas por um gatilho, que a IA escreve com o histórico real do lead e que **param sozinhas** quando ele responde, quando um humano assume a conversa e quando o negócio é marcado como ganho ou perdido. Fora do horário de atendimento nada sai. A mesma tela vive em [Configurações → Cadências](https://attendto.com.br/manual/configuracoes). Na tela: Tela Follow-up com as abas Cadências, Resultados, Biblioteca e Limites; a lista de réguas da conta com etiquetas de objetivo, melhor momento, A/B, condições e tarefa; botões Resultados, Editar e Excluir em cada linha. As réguas da conta. Cada linha diz o gatilho, quantos passos e o que ela tem de especial. Sem o módulo, a cadência é a **régua linear**: gatilho (sem resposta há N horas, virou uma temperatura, mudou de status), passos com espera em horas e um texto escrito pela IA (dentro da janela de 24 h), uma mensagem fixa ou um modelo aprovado (fora da janela). Com o módulo **Revenue AI** ligado ([Módulos](https://attendto.com.br/manual/configuracoes)), ela vira o **follow-up avançado** descrito abaixo. #### O editor de fluxo Na tela: Editor da cadência Retomada de proposta: no topo nome, objetivo, gatilho e público; à esquerda os passos em cartões numerados com tipo, espera, tom, oferta, pergunta de fechamento, variante B e a condição; à direita os cartões Para quando, Canais e momento e o mapa do melhor momento. Resumo em cima, passos à esquerda, regras e o melhor momento à direita. - **Resumo: nome, objetivo, gatilho e público**: O **objetivo** (agendar reunião, retomar proposta, recuperar negociação parada, reativar "não é agora", reengajar lead frio, fazer voltar quem não compareceu) entra no prompt de cada passo escrito pela IA. O **gatilho** decide quando o lead entra: além dos três da régua linear, entrou numa etapa do Funil, ficou N dias numa etapa, estourou o prazo da etapa, perdido por "não é agora" há N dias e aderência alta ao cliente ideal sem resposta há N horas. O **público** filtra quem entra: faixa de aderência ao cliente ideal, temperatura, etiquetas e valor mínimo do negócio; clique em "editar" para abrir os campos. - **Passos**: Cada cartão é um passo: o tipo (**IA escreve**, **mensagem fixa**, **template aprovado**, **áudio da IA** ou **tarefa para o time**), a espera em horas desde o passo anterior e, nos passos da IA, a instrução, o **tom** (leve, direto, urgente), a **oferta** do catálogo a mencionar e a **pergunta de fechamento**. As etiquetas do cartão dizem o que vale para ele: "fora da janela" no template, "melhor momento" quando o ajuste ao lead está ligado, "A/B" quando o passo tem variante B. - **Áudio da IA e tarefa para o time**: No **áudio da IA** o mesmo texto sai pela voz da persona no WhatsApp; se a síntese falhar, sai o texto. Na **tarefa para o time** nada vai para o lead: a pendência entra na ficha com prazo, o dono da conversa (ou o dono da conta) recebe push e sino, e a régua segue para o próximo passo. A tarefa aparece na linha do tempo do cartão. - **Condição antes do passo**: Cada passo pode ter uma condição, avaliada na hora em que ele vence: a mensagem anterior foi **entregue e não lida**, foi **lida e o lead não respondeu**, o lead **levantou objeção**, a **aderência ao cliente ideal** é de pelo menos X, o **valor do negócio** é de pelo menos Y. Você escolhe o que acontece quando vale e quando não vale: envia este passo, pula para um passo adiante ou encerra a cadência. Só adiante, nunca para trás. "Lido" só existe onde a Meta devolve o recibo de leitura; sem recibo a condição cai em "entregue". - **Para quando**: O cartão da direita lista o que interrompe a régua: o lead respondeu; o negócio foi marcado como ganho ou perdido; "não me chame mais" (para e marca o lead); "me chama em março" (a régua dorme até a data); um humano assumiu a conversa; opt-out ou fora das campanhas. - **Canais e momento**: O canal é o do lead (WhatsApp). **Ajustar ao melhor momento do lead** adia cada passo até a próxima janela em que aquele lead costuma responder, dentro do horário de atendimento e até o teto "adiar no máximo"; nunca antecipa. **Retomar quando o lead pedir** é automático. **Teste A/B por passo** liga a variante B: metade dos leads recebe A, metade B, sorteados pela matrícula. - **Mapa do melhor momento**: A partir de três respostas de um lead, a IA aprende a faixa de duas horas e os dias em que ele costuma responder (sem modelo de linguagem, custo zero). O mapa soma isso para todos os leads da conta: quanto mais escuro, mais leads respondem naquele dia e faixa. O de cada lead aparece no cartão e na ficha. Na tela: Parte de baixo do editor: o passo 3 do tipo Tarefa para o time com prazo, a condição "antes deste passo" com os caminhos se vale e se não vale, e à direita o mapa do melhor momento dos leads da conta por dia e faixa de horário. A condição de um passo e o mapa do melhor momento da conta. #### Pausa inteligente Quando o lead responde, a IA já entende o pedido. **"Me chama em março"** faz a régua que acabou de parar dormir até a data (às 9h, no seu fuso) e o próximo passo cita o combinado. **"Não me chame mais"** tira o lead de todas as cadências até você **liberar** na ficha ou no cartão. Não é opt-out (essa continua sendo decisão do titular pela palavra oficial): é só o follow-up que para. Tudo fica na ficha e na trilha de auditoria. #### Resultados por cadência Na tela: Aba Resultados da cadência Retomada de proposta: seis números (matriculados, em andamento, responderam, agendaram, ganhos, modelos pagos), o funil por passo em barras, o bloco do teste A/B com a resposta por variante e a comparação com e sem ajuste ao melhor momento. Tudo vem dos eventos gravados no envio, no recibo da Meta e na resposta; nada é recalculado do histórico. Em 30 ou 90 dias: matriculados, em andamento, responderam, agendaram, ganhos e o gasto com modelos pagos; o **funil por passo** (enviados, lidos, responderam e os desviados por condição); o **melhor passo** (a partir de 5 envios) e o **melhor horário**; o **A/B** com a resposta por variante e, com 30 envios de cada lado e 10 pontos de diferença, o botão para **fixar a vencedora** (o texto vencedor vira o principal e o teste desliga); a comparação **com e sem ajuste** ao melhor momento (a partir de 20 de cada lado; antes, "medindo"); e quantas pausas inteligentes aconteceram. #### Biblioteca e limites - **Biblioteca de cadências prontas**: Sete réguas com passos, público e regras preenchidos: retomada de proposta, "não é agora" em 60 dias, lead frio de anúncio, negociação parada há 7 dias, ICP alto sem resposta, reengajar no melhor momento e prazo da etapa estourado. Um clique abre no editor; nada liga sozinho. Onde há modelo aprovado, escolha o modelo antes de salvar. - **Limites**: Follow-ups por lead por semana, somando todas as cadências (padrão 3), e o **teto mensal de gasto com modelos** nas cadências (0 = sem teto). Ao bater um teto o passo espera e volta depois (na semana seguinte, ou quando o mês vira); a régua não morre. Janela de 24 h, posse humana da conversa, horário de atendimento e opt-out continuam valendo como sempre. - **No cartão, na ficha e no Inbox**: A linha "Follow-up: Retomada de proposta · passo 2 de 4 · próximo ter 18h" mostra a régua em andamento (ou "retoma em 15/10 (o lead pediu)"); a etiqueta "Pediu para não receber follow-ups" vem com o botão Liberar. No Inbox, a bolha que saiu por uma cadência traz a legenda "Enviada pela cadência · passo 2 · variante B". Como as pessoas procuram: follow-up automático whatsapp; cadência de mensagens; régua de follow-up; recuperar lead que sumiu; mensagem automática sem resposta; teste a/b de mensagem whatsapp; melhor horário para mandar mensagem; template aprovado no follow-up; limite de follow-up por lead; biblioteca de cadências prontas. ## CRM & Graph: lista de leads por temperatura, grafo de empresas e ficha do lead com BANT e jornada URL: https://attendto.com.br/manual/crm Menu: Operação > CRM & Graph O CRM & Graph é a tela do painel que mostra todos os leads separados por temperatura (Quente, Morno, Frio), desenha quem trabalha na mesma empresa e abre a ficha de cada pessoa com a qualificação, a jornada e as ações de LGPD. ### Quem pode usar - Dono: Vê tudo e faz tudo: liga e desliga as regras de reengajamento automático, exporta os dados de um lead, anonimiza (LGPD) e usa o botão Disparar mensagem do perfil de consumo. - Admin: Vê a lista, o grafo e a ficha, cadastra leads, registra opt-out e exporta os dados de um lead. Vê o cartão de reengajamento, mas os interruptores ficam travados, e não tem o botão de anonimizar nem o de disparar mensagem. - Atendente: Vê a lista, o grafo e a ficha, cadastra leads, inicia atendimento e registra opt-out. Não exporta dados, não anonimiza e não altera as regras de reengajamento. ### Telas #### CRM & Graph A tela CRM & Graph serve para encontrar um lead pelo nome ou telefone, filtrar a base por temperatura e ver no grafo quais pessoas pertencem à mesma empresa. Endereço no painel: `/app/crm` ![Captura da tela CRM & Graph. A tela CRM & Graph serve para encontrar um lead pelo nome ou telefone, filtrar a base por temperatura e ver no grafo quais pessoas pertencem à mesma empresa.](https://attendto.com.br/prints-do-manual/crm--lista-de-leads.png) A tela CRM & Graph na conta de demonstração, com dados fictícios e os valores desfocados. ##### Cabeçalho da lista O título Leads, a busca e o cadastro manual de um lead. Campos e filtros: - **Buscar por nome ou telefone**: Busca na base inteira, no servidor, depois de uma pausa curta na digitação. Procura só por nome e telefone; empresa e e-mail não entram na busca. Botões e ações: - **Novo lead**: Abre o diálogo Novo contato para cadastrar alguém à mão. Ao criar, a ficha do novo lead abre direto. ##### Filtros de temperatura Quatro botões de filtro que recortam a lista pela banda BANT, cada um com a contagem ao lado. Botões e ações: - **Todos**: Mostra todos os leads, sem filtro de temperatura. A contagem é o total da base. - **Quente**: Mostra só os leads na banda Quente. - **Morno**: Mostra só os leads na banda Morno. - **Frio**: Mostra só os leads na banda Frio. Também aparece: - Mudar o filtro ou a busca recomeça a lista do início. - Quente, Morno e Frio somados podem ficar abaixo de Todos: quem ainda não tem nota não entra em nenhum dos três. ##### Lista de leads Uma linha por lead, carregada aos poucos enquanto você rola. Campos e filtros: - **Lead / Empresa**: Avatar com as iniciais, o nome e, embaixo, a empresa do lead; sem empresa, aparece o telefone. - **Status**: Em que ponto a relação está: Novo, Em conversa, Qualificado, Transferido, Descartado ou Opt-out. - **BANT**: A nota de 0 a 100 com a cor da temperatura. Botões e ações: - **‹nome do lead›**: Clicar na linha abre a ficha daquele lead. Também aparece: - Rolagem contínua: ao chegar perto do fim, a próxima parte da lista carrega sozinha. - Rodapé com a posição: "‹n› de ‹total› — role para ver mais" enquanto há mais, e "‹total› leads neste recorte" quando acabou. - Enquanto a próxima parte chega, o rodapé mostra "Carregando mais leads…". ##### RELACIONAMENTOS O grafo que liga cada empresa às pessoas dela. Botões e ações: - **‹bolinha do lead›**: Cada lead é uma bolinha com as iniciais, na cor da temperatura. Clicar (ou Enter/Espaço com o foco nela) abre a ficha do lead. - **Tentar novamente**: Aparece quando o grafo não carregou e repete a leitura. Também aparece: - Selo com o número de empresas no canto do cartão. - Título "‹n› leads ligados a ‹n› empresas" quando há ligações; sem ligações, "Grafo de relacionamentos". - Cada empresa é um retângulo na cor da marca, com os leads em volta; a linha entre eles diz "lead". Embaixo de cada bolinha, o primeiro nome e a temperatura. - Lead sem empresa preenchida não aparece no grafo. - Aviso "Grafo truncado — mostrando as empresas com mais leads." quando há empresas demais para desenhar. - Vazio: "Nenhuma empresa detectada ainda — o grafo nasce quando leads informam a empresa." ##### Reengajamento automático Duas regras automáticas com interruptor, e o selo de quantas estão ativas. Campos e filtros: - **Dias de inatividade**: Na regra "Lead ‹banda› sem interação há ‹n› dias", o número de dias é editável: digite e saia do campo (ou aperte Enter). Aceita de 1 a 90; valor fora disso volta ao anterior. Botões e ações: - **Reengajar lead inativo por WhatsApp** (Dono): Interruptor da regra que manda sozinha um modelo "ainda faz sentido?" no WhatsApp para o lead parado. Cada envio tem custo por uso, cobrado do saldo. - **Alertar novo contato na mesma empresa** (Dono): Interruptor da regra que, quando chega um contato novo de uma empresa que já está na base, cria uma tarefa e avisa o dono da conta. Não envia mensagem a ninguém. - **Tentar novamente**: Aparece quando as regras não carregaram e repete a leitura. Também aparece: - Selo "‹n› ativas" ao lado do título. - Quando a regra de WhatsApp já enviou algo, aparece "‹n› envios em 30 dias" embaixo dela. - Para quem não é dono, os interruptores ficam apagados e o cartão avisa que só o dono pode alterar as regras. ##### Diálogo Novo contato O mesmo cadastro manual da Base de contatos, aberto pelo botão Novo lead. Campos e filtros: - **Nome** (obrigatório): Nome completo do lead. - **Telefone** (obrigatório): Com DDD; o exemplo da tela usa o formato +55 11 91234-5678. - **Empresa**: Opcional. Sugere as empresas que já existem na base enquanto você digita. - **CNPJ**: Opcional. Com os 14 caracteres completos, a tela consulta a Receita e preenche a empresa sozinha, mostrando "Preenchido pela Receita". - **E-mail**: Opcional. - **Etiquetas**: Opcional, separadas por vírgula. Botões e ações: - **Criar contato**: Salva o lead e abre a ficha dele. Só habilita com nome e telefone preenchidos. Também aparece: - Telefone que já existe na base é recusado com "Já existe um contato com este telefone." ##### Estados da tela - Carregando: Cinco faixas cinzas no lugar das linhas enquanto a lista carrega; o grafo e as regras têm o seu próprio esqueleto. - Sem nada ainda: "Nenhum lead encontrado. Eles aparecem aqui conforme chegam mensagens." — vale para a base vazia e para uma busca ou filtro sem resultado. - Se der erro: "Não foi possível carregar os seus leads", com o aviso de que isso não quer dizer que a base está vazia, e o botão Tentar de novo. #### Ficha do lead A tela Ficha do lead serve para ver tudo o que existe sobre uma pessoa — qualificação, contato, perfil de compra, engajamento e jornada — e agir sobre ela: abrir a conversa, registrar opt-out, exportar ou anonimizar os dados. Endereço no painel: `/app/crm/‹…›` ![Captura da tela Ficha do lead. A tela Ficha do lead serve para ver tudo o que existe sobre uma pessoa — qualificação, contato, perfil de compra, engajamento e jornada — e agir sobre ela: abrir a conversa, registrar opt-out, exportar ou anonimizar os dados.](https://attendto.com.br/prints-do-manual/crm--ficha-do-lead.png) A tela Ficha do lead na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Clique em qualquer linha da lista ou numa bolinha do grafo do CRM & Graph. Também abre ao criar um lead pelo botão Novo lead. ##### Voltar Botões e ações: - **CRM & Graph**: Volta para a lista de leads. ##### Cabeçalho do lead Quem é a pessoa e a fila de ações sobre ela. Botões e ações: - **Copiar telefone**: Botão de ícone que copia o telefone e avisa "Telefone copiado". Não aparece quando o lead não tem um telefone de verdade. - **Iniciar atendimento**: Abre a conversa do lead no Inbox. Sem conversa, cria uma nova, em que a primeira mensagem sai por modelo aprovado. Quando não dá, o botão fica apagado e a dica diz por quê. - **Voltar a receber campanhas**: Aparece só quando o lead está marcado como Fora das campanhas e desfaz a marca ali mesmo. - **Registrar opt-out**: Abre a confirmação "Registrar opt-out?". Confirmar faz o lead parar de receber mensagens e revoga o consentimento; nome, telefone e histórico ficam. - **Exportar dados** (Dono, Admin): Baixa tudo o que existe sobre o lead, para atender um pedido de portabilidade (LGPD). - **Anonimizar (LGPD)** (Dono): Abre a confirmação "Anonimizar lead?". Confirmar apaga nome, telefone, e-mail e empresa para sempre; as métricas somadas ficam. Não tem desfazer. - **Confirmar**: Botão dos dois diálogos de confirmação (opt-out e anonimizar) que executa a ação. Também aparece: - Foto de perfil quando existe (hoje, só de quem veio pelo Instagram); sem foto, as iniciais com o selo do canal da conversa. - Nome, a nota com a temperatura e o selo de Status da relação. - Selo "Segue a conta" quando o Instagram confirmou que a pessoa segue o perfil da empresa. - Selo "Lead de teste" para o lead criado pelo botão de teste de uma integração. - Linha com telefone, empresa e origem do lead. - Selo "Veio da integração ‹nome›" e selo "Veio do anúncio: ‹campanha› › ‹conjunto› › ‹anúncio›" quando a origem é conhecida. - As etiquetas do lead, como selos. - Selos "Opt-out registrado", "Fora das campanhas" (com o motivo na dica) e "Anonimizado" no lugar dos botões que deixam de fazer sentido. ##### Perfil de consumo (RFV) Recência, frequência e valor das compras do lead, quando há pedidos importados. Campos e filtros: - **Recência**: Nota de 1 a 5 para quão recente foi a última compra. - **Frequência**: Nota de 1 a 5 para quantas vezes comprou. - **Valor**: Nota de 1 a 5 para quanto gastou. - **Receita total**: Soma dos pedidos pagos. - **Pedidos pagos**: Quantos pedidos foram pagos. - **Ticket médio**: Valor médio por pedido pago. - **Última compra**: Há quantos dias foi a última compra. - **Em aberto**: Quantos pedidos estão em aberto. - **Valor em aberto**: Soma dos pedidos em aberto. Botões e ações: - **Disparar mensagem** (Dono): Dispara a abordagem do agente especialista para este contato, a mesma usada para o grupo de compra dele. O resultado aparece num aviso. Tem custo por uso. Também aparece: - Selo com o grupo de compra do lead (por exemplo, Campeões ou Em risco) e a "Próxima ação sugerida". - Sem pedidos, o cartão vira "Sem compras registradas" e indica importar pedidos no Monitor de sucesso ou conectar o sistema em Integrações. ##### Qualificação A nota, o público que vale para o lead e cada sinal com a frase que o comprovou. Botões e ações: - **Trocar o público deste lead**: Mostra o seletor de público. Só aparece quando a conta tem mais de um público configurado. - **Público deste lead**: Escolher um público fixa esse público para o lead: a IA para de reavaliar e a ficha passa a mostrar o selo FIXADO À MÃO. A nota atual fica; o roteiro novo vale da próxima mensagem. - **Cancelar**: Fecha o seletor sem trocar nada. - **Liberar follow-ups**: Aparece quando o lead pediu para não receber follow-ups. Devolve o lead às regras de cadência de sempre, sem matriculá-lo em nenhuma. - **Entregar ao Closer**: Com a capacidade Closer ligada na conta, entrega a negociação ao Closer, que entra na próxima mensagem do lead. - **Assumir a negociação**: Tira o Closer de cena e passa a negociação para você. Também aparece: - Título "Qualificação — ‹público›"; sem público identificado, "— padrão" com o público padrão. - Linha "Nota ‹n› (‹temperatura›) — ‹n› de ‹n› sinais". - "Aderência ao cliente ideal: ‹n›" e "Melhor momento para falar:" quando esses dados existem. - Linha do follow-up em andamento ("Follow-up: ‹régua› · passo ‹n› de ‹n›") e o selo "Pediu para não receber follow-ups" quando é o caso. - Bloco de negociação com o estado do Closer, o teto do dono e as concessões, quando a capacidade está ligada. - "Negócio ganho" ou "Negócio perdido · ‹motivo›", com data e autor, quando o desfecho foi registrado. - Cada sinal com uma barra: verde com a frase do lead quando capturado, "ainda não capturado" quando falta, e "não se aplica a este público" quando não vale para ele. ##### Contato Dados de contato, só para leitura. Campos e filtros: - **Telefone**: O telefone do lead, ou um travessão. - **E-mail**: O e-mail, ou um travessão. - **Empresa**: A empresa, ou um travessão. - **Origem**: Por onde o lead entrou (WhatsApp, Instagram, planilha, integração e outros). Também aparece: - Para editar estes dados, use a ficha lateral da Base de contatos. ##### Veio da integração Aparece só para quem chegou por uma integração de entrada. Botões e ações: - **Apagar lead de teste**: Só no lead de teste: abre a confirmação "Apagar este lead de teste?" e, confirmado, apaga o lead, a conversa e as entradas do teste e volta para a lista. Também aparece: - Cada entrada recebida, com data. - "Dados recebidos": os campos que chegaram junto; os sensíveis ficam escondidos. - Aviso quando a pessoa pediu para não receber mensagens e se cadastrou de novo pela integração. ##### Engajamento Os números da relação com o lead. Campos e filtros: - **Mensagens do contato**: Quantas mensagens o lead mandou. - **Respostas enviadas**: Quantas mensagens foram enviadas a ele. - **Reengajamentos**: Quantas vezes foi reengajado. - **Links de pagamento**: Quantos links de pagamento recebeu. - **Transbordos**: Quantas vezes a conversa passou para um humano. - **Lidas**: Quantas mensagens enviadas foram lidas. - **Atendimentos**: Atendimentos humanos concluídos. - **Falhas de entrega**: Aparece só quando alguma mensagem não foi entregue. Também aparece: - "Entregues (✓✓)": quantas mensagens chegaram ao aparelho, contando as lidas. - "Sentimento recente": os últimos sentimentos detectados na conversa, com a data na dica. ##### Compras Os pedidos do lead, quando existem. Também aparece: - Cada pedido com o código, o status (pago, em aberto ou cancelado), o valor, a data, a origem e os itens. ##### Jornada do lead A linha do tempo de tudo o que aconteceu com o lead. Também aparece: - Mensagens, mudanças de situação e as decisões dos agentes de IA, cada uma com data, hora e autor. - Nas decisões da IA aparecem o agente, a fase, o raciocínio e o grau de confiança. - Sem eventos: "Sem atividades ainda." ##### Estados da tela - Carregando: A jornada mostra quatro faixas cinzas enquanto carrega. - Se der erro: "Não foi possível carregar a ficha deste lead", com o aviso de que os dados continuam salvos e o botão Tentar de novo. Se só a jornada falhar, o cartão dela diz "Não foi possível carregar a jornada". - O lead foi anonimizado: O selo "Anonimizado" no lugar dos botões de opt-out, exportar e anonimizar. - O lead registrou opt-out: O selo "Opt-out registrado"; o botão Registrar opt-out some e Iniciar atendimento fica apagado. - Não dá para iniciar atendimento: O botão fica apagado e a dica explica: a pessoa pediu para não receber, está fora das campanhas, veio do chat do site, só recebe pelo canal em que escreveu ou não tem consentimento nem base legal declarada. ### Passo a passo #### Como encontrar um lead pelo nome ou telefone 1. Abra **CRM & Graph** no menu. 2. Digite parte do nome ou do telefone no campo **Buscar por nome ou telefone**. 3. Se quiser, estreite com um filtro de temperatura (**Quente**, **Morno** ou **Frio**). 4. Clique na linha do lead para abrir a ficha. #### Como cadastrar um lead à mão no CRM 1. Em **CRM & Graph**, clique em **Novo lead**. 2. Preencha **Nome** e **Telefone**; empresa, CNPJ, e-mail e etiquetas são opcionais. 3. Clique em **Criar contato**. A ficha do novo lead abre em seguida. #### Como descobrir quem é da mesma empresa 1. Em **CRM & Graph**, olhe o cartão **RELACIONAMENTOS** ao lado da lista. 2. Cada retângulo é uma empresa; as bolinhas em volta são as pessoas dela, coloridas pela temperatura. 3. Clique numa bolinha para abrir a ficha daquela pessoa. #### Como ligar o reengajamento automático de leads parados 1. Entre como dono da conta e abra **CRM & Graph**. 2. No cartão **Reengajamento automático**, ajuste o número de dias da regra do lead parado. 3. Ligue o interruptor **Reengajar lead inativo por WhatsApp**. Cada mensagem enviada por ela é cobrada do saldo. #### Como registrar que um lead não quer mais receber mensagens 1. Abra a ficha do lead. 2. Clique em **Registrar opt-out**. 3. Leia o aviso e clique em **Confirmar**. O selo **Opt-out registrado** aparece no cabeçalho. #### Como atender um pedido de exclusão de dados (LGPD) 1. Entre como dono da conta e abra a ficha do lead. 2. Clique em **Exportar dados** e guarde o arquivo, caso precise do histórico depois. 3. Clique em **Anonimizar (LGPD)**, leia o aviso de que a ação é irreversível e clique em **Confirmar**. #### Como corrigir o público de um lead 1. Na ficha, no cartão **Qualificação**, clique em **Trocar o público deste lead**. 2. Escolha o público certo no seletor. 3. A ficha passa a mostrar **FIXADO À MÃO**: a IA não reavalia mais o público dessa pessoa. ### Perguntas frequentes #### A busca do CRM procura pela empresa ou pelo e-mail? Não. A busca do CRM & Graph olha só nome e telefone. Para procurar por empresa, use a Base de contatos ou a tela Empresas. #### Posso editar o telefone ou o e-mail de um lead pela ficha do CRM? Não: o bloco Contato da ficha do CRM é só leitura. A edição de nome, empresa e e-mail fica na ficha lateral da Base de contatos. #### Por que o botão Iniciar atendimento está apagado? Passe o mouse sobre ele: a dica diz o motivo. Os casos são pessoa que pediu para não receber, contato fora das campanhas, contato do chat do site, contato que só recebe pelo canal em que escreveu e contato sem consentimento nem base legal declarada. #### Por que não vejo os botões Exportar dados e Anonimizar (LGPD)? Exportar dados aparece para dono e admin; Anonimizar (LGPD) só para o dono da conta. Em lead já anonimizado, os dois somem e fica o selo Anonimizado. #### O que quer dizer o selo FIXADO À MÃO na qualificação? Que alguém da equipe escolheu o público do lead manualmente. A partir daí a IA não reavalia mais o público dessa pessoa. #### Por que o perfil de consumo diz Sem compras registradas? Porque ainda não há pedidos daquele contato. Importe pedidos no Monitor de sucesso ou conecte o seu sistema em Integrações e o perfil RFV aparece. #### O que o botão Disparar mensagem do perfil de consumo faz? Envia a abordagem do agente especialista só para aquele contato, pela mesma regra usada para o grupo de compra dele. Só o dono vê o botão, e o envio tem custo por uso. #### A regra Alertar novo contato na mesma empresa gasta saldo? Não. Ela só cria uma tarefa e avisa o dono da conta, sem mandar mensagem para ninguém de fora. ### Guia: CRM & Graph A lista completa de leads por temperatura, o mapa de quem é da mesma empresa e a ficha de cada pessoa, com a jornada inteira. Esta tela e a [Base de contatos](https://attendto.com.br/manual/base-de-contatos) mostram as mesmas pessoas e existem separadas de propósito. Aqui a pergunta é **quem está quente e quem se liga a quem**: a lista carrega aos poucos enquanto você rola, e ao lado dela fica o mapa das empresas. Lá a pergunta é **como fatiar a base e agir em lote**: filtros por faceta, importar e exportar planilha, montar o público de uma campanha. O atalho para decidir: se você vai **olhar uma pessoa**, é aqui. Se vai **mexer em muitas de uma vez**, é na [Base de contatos](https://attendto.com.br/manual/base-de-contatos). #### A lista e o mapa Na tela: CRM & Graph com a lista de leads à esquerda e o card de relacionamentos com o grafo à direita. A lista completa à esquerda, o grafo de empresas à direita. 1. **Buscar e cadastrar**: A busca só olha **nome** e **telefone** — não procura por empresa nem por e-mail. **Novo lead** cadastra alguém à mão, útil para quem chegou por telefone ou indicação. 2. **Os quatro marcadores de temperatura**: **Todos**, **Quente**, **Morno** e **Frio**, cada um com a contagem. Quente, Morno e Frio somados não fecham o total: quem ainda não deu sinal nenhum fica de fora dos três. 3. **As três colunas**: **Lead / Empresa**, **Status** e **BANT**. Status é onde a relação está (`Novo`, `Em conversa`, `Qualificado`, `Transferido`, `Descartado`, `Opt-out`); BANT é a nota de 0 a 100 com a temperatura. 4. **A lista**: A lista carrega aos poucos: as primeiras 30 pessoas chegam na hora e as próximas vêm sozinhas enquanto você rola. O rodapé diz quantas já estão na tela e quantas há no recorte ("30 de 412 — role para ver mais"). A busca e os filtros de temperatura procuram na base inteira, não só no que já carregou. A segunda linha de cada pessoa é a empresa dela ou, quando não há empresa, o telefone. Clique para abrir a ficha. 5. **RELACIONAMENTOS**: Quantos leads estão ligados a quantas empresas. É a conta de quem tem empresa preenchida — todo o resto da base não entra neste número. 6. **O mapa**: Cada retângulo é uma empresa; as bolinhas em volta são as pessoas dela, coloridas pela temperatura. Clique numa bolinha e a ficha daquele lead abre. #### O que o grafo mostra e o que ele não mostra Ele desenha **um laço só: pessoas da mesma empresa**. Não existe sócio, decisor, indicação ou hierarquia — nada disso é perguntado em lugar nenhum, então não seria desenhado com dado de verdade. A linha entre a empresa e a pessoa diz `lead`, e é literalmente tudo o que ela afirma. Serve para uma coisa concreta e boa: descobrir que o contato novo que acabou de chegar é da mesma casa de alguém que você já atendeu — e entrar na conversa sabendo disso. - **Lead sem empresa não aparece.** A maioria das bases tem mais gente fora do mapa do que dentro, e isso não é defeito. - O desenho para em **60 bolinhas** no total. Passando disso aparece **Grafo truncado** e ficam as empresas com mais gente. Empresa nenhuma entra pela metade. - Ele nasce do campo **Empresa** do contato. Para uma pessoa aparecer ali, é preencher a empresa dela no painel lateral da [Base de contatos](https://attendto.com.br/manual/base-de-contatos). - Grafias diferentes viram empresas diferentes. Juntar `Padaria Bom Trigo` e `Padaria Bom Trigo Centro` é trabalho da tela [Empresas](https://attendto.com.br/manual/empresas). #### Reengajamento automático Abaixo do grafo há um cartão com duas regras, cada uma com um interruptor e um selo dizendo quantas estão ativas. **Só o dono da conta liga, desliga ou altera** — os demais veem o cartão e não conseguem mexer. - **Lead MORNO sem interação há N dias**: **Esta regra manda mensagem de WhatsApp sozinha, e cada envio debita o seu saldo.** O número de dias é editável ali mesmo: clique nele, digite e saia do campo. Quando a regra já rodou, aparece embaixo quantos envios ela fez em 30 dias. - **Novo contato detectado na mesma empresa**: Esta não manda nada para ninguém de fora: cria uma tarefa e avisa o dono da conta. É a que vale deixar ligada sem medo — o custo dela é a sua atenção, não o seu saldo. > **O interruptor de cima gasta dinheiro:** Ligar a regra de reengajamento por WhatsApp por curiosidade faz mensagem sair para gente de verdade, e cada uma é cobrada do saldo. Antes de ligar: confira o número de dias, e confira em [Saldo & Recargas](https://attendto.com.br/manual/saldo-e-recargas) quanto custa uma mensagem para o tamanho da sua base parada. #### A ficha do lead Clicar em qualquer linha abre a ficha. **Ela não tem abas** — é uma página só, que rola. Tudo o que existe sobre aquela pessoa está numa destas caixas. Na tela: Ficha de um lead com o cabeçalho de ações, o card de qualificação com os sinais e a jornada do lead ao lado. As ações no topo, a qualificação à esquerda, a linha do tempo à direita. 1. **Quem é a pessoa**: Nome, a nota com a temperatura, o **Status** da relação, e a linha com telefone, empresa e canal de origem. As etiquetas embaixo vêm do que foi marcado na [Base de contatos](https://attendto.com.br/manual/base-de-contatos). 2. **A fila de ações**: Copiar telefone, **Iniciar atendimento**, **Registrar opt-out**, **Exportar dados** e **Anonimizar (LGPD)**. As três últimas dependem do seu papel na conta, e a última não tem desfazer — leia a seção de LGPD antes de clicar. 3. **Qualificação**: A nota, quantos sinais de quantos foram capturados, e cada sinal com **a frase do lead que provou aquilo**. Sinal que não vale para o público dele aparece dito com todas as letras, nunca como pendência. 4. **Trocar o público deste lead**: Muda o roteiro de perguntas que vale para esta pessoa. Escolher à mão tem uma consequência permanente — está explicado logo abaixo. 5. **Jornada do lead**: A linha do tempo de tudo: mensagens, mudanças de situação e as decisões tomadas na conversa, cada uma com data, hora e autor. Vazia quer dizer que a conversa ainda não começou. 6. **Contato**: Telefone, e-mail, empresa e origem. **Estes campos são só leitura aqui** — quem edita cadastro é o painel lateral da [Base de contatos](https://attendto.com.br/manual/base-de-contatos). Rolando um pouco mais aparecem, quando houver dado para eles: **Perfil de consumo (RFV)** com recência, frequência e valor das compras; **Compras**, com os pedidos; e **Engajamento**, com quantas mensagens entraram, quantas saíram, quantas foram entregues e lidas. Sem pedido importado, o bloco de consumo diz que não há compras registradas em vez de mostrar zeros — veja [Monitor de sucesso](https://attendto.com.br/manual/monitor-de-sucesso). #### A foto e o selo "Segue a conta" O cabeçalho da ficha traz a **foto de perfil** do lead quando ela existe — hoje só quem chegou pelo Instagram tem. Sem foto, o círculo com as iniciais, com o selinho do canal: contato de WhatsApp não tem foto e nunca vai ter, porque o WhatsApp não entrega a foto do contato a nenhum sistema. Ao lado do nome pode aparecer o selo **Segue a conta**. Ele diz exatamente uma coisa: na última vez que perguntamos ao Instagram, essa pessoa seguia a sua conta. É uma pergunta que fazemos no máximo uma vez por dia, por contato. > **A ausência do selo não afirma nada:** Ficha **sem** o selo não quer dizer que a pessoa não te segue: quer dizer que não temos essa resposta — porque ela não veio do Instagram, porque a conta não tem essa permissão liberada ainda, ou porque o perfil é fechado. Só o **sim** confirmado vira selo; nós não deduzimos o não. A foto e esse vínculo são dado pessoal e morrem junto com o resto quando alguém pede a exclusão dos dados (mais abaixo, em **Opt-out, exportar e anonimizar**). #### Iniciar atendimento não assume nada O botão apenas **abre a conversa daquela pessoa no [Inbox](https://attendto.com.br/manual/inbox)**. Ele não transfere, não tira a conversa de quem estava nela e não avisa ninguém. Quem assume é você, lá dentro, escolhendo o seu nome e respondendo. Quando o contato ainda não tem conversa mas tem telefone de WhatsApp e autorização (consentimento ou base legal declarada), o botão **abre uma conversa nova** no Inbox. Ela nasce sem mensagens e com a janela de 24 horas fechada, então a primeira mensagem sai por **modelo aprovado**, pelo mesmo caminho de reabrir uma conversa. Se o botão estiver apagado, a dica diz o motivo, sempre nesta ordem: a pessoa pediu para não receber; o contato está fora das campanhas; ele veio do chat do site (aí o caminho é **Continuar no WhatsApp**, na ficha da Base de contatos e no cabeçalho da conversa no Inbox: um clique transforma o contato do chat num contato de WhatsApp com o telefone que ele informou, sem perder consentimento, qualificação nem etiquetas, e já abre a conversa para você enviar o modelo; se o número já tiver um contato na base, a conversa abre por ele); ou não há consentimento nem base legal declarada. #### Trocar o público de um lead Cada público tem o seu roteiro de perguntas, e o público de cada lead é reconhecido pela conversa. Quando o reconhecimento erra — a pessoa fala como consumidor mas está comprando para a empresa —, **Trocar o público deste lead** corrige. > **Escolher à mão é definitivo para aquele lead:** Feita a troca, o público daquela pessoa **para de ser reavaliado** e a ficha passa a mostrar o selo **FIXADO À MÃO**. A nota que já existe continua como está; o roteiro novo vale da próxima mensagem dela em diante. Se o caso é o reconhecimento errando sempre, o conserto é nos públicos em [Qualificação](https://attendto.com.br/manual/qualificacao), não lead a lead. #### Opt-out, exportar e anonimizar Três botões parecidos com efeitos muito diferentes. Vale ler antes de precisar, porque um deles não tem volta: - **Registrar opt-out**: A pessoa **para de receber mensagem** e o consentimento é revogado. Nome, telefone e histórico **continuam ali**. É o que se faz quando alguém pede para não ser mais incomodado. - **Exportar dados**: Baixa tudo o que existe sobre aquela pessoa. É a resposta a um pedido de portabilidade — e é o que salva a sua pele antes de anonimizar. - **Anonimizar (LGPD)**: Apaga **nome, telefone, e-mail e empresa** para sempre. As métricas somadas ficam, então os seus números não mudam; a pessoa é que deixa de existir na base. Só o dono da conta consegue. > **Anonimizar é irreversível — exporte antes:** Não há desfazer, nem por outro caminho, nem pedindo para alguém. Se existe qualquer chance de você precisar do histórico daquela relação depois, clique em **Exportar dados** primeiro e guarde o arquivo. E confira se o pedido não era só de opt-out: quem quer parar de receber mensagem quase nunca quer ser apagado. #### Como é quando está redondo - A maior parte dos leads tem **empresa preenchida**, e o grafo desenha grupos que você reconhece em vez de duas ou três empresas soltas. - Os marcadores **Quente**, **Morno** e **Frio** somados chegam perto do **Todos** — quer dizer que as conversas duram o suficiente para render sinal. - As fichas têm **Jornada do lead** com conteúdo, e não a frase de que não há atividade. - O interruptor de reengajamento por WhatsApp está do jeito que **você** decidiu, com um número de dias que faz sentido para o seu ciclo de venda. - Nenhum lead **Transferido** parado há dias — se houver, a fila real está em [Transbordo para humano](https://attendto.com.br/manual/handoff). No painel: Abrir o CRM & Graph. Como as pessoas procuram: lista de leads; crm de whatsapp; ficha do lead; lead quente morno frio; qualificação bant do lead; grafo de relacionamentos; leads da mesma empresa; reengajar lead parado; registrar opt-out; anonimizar lead lgpd; exportar dados do cliente; jornada do lead; perfil rfv do cliente; cadastrar lead manualmente. ## Base de contatos: filtrar, importar planilha CSV, exportar e organizar contatos com etiquetas e LGPD URL: https://attendto.com.br/manual/base-de-contatos Menu: Operação > Base de contatos A Base de contatos é a tela do painel que reúne todas as pessoas que falaram com a empresa ou vieram de planilha, com filtros que mostram a contagem antes do clique, importação e exportação em CSV, etiquetas e o registro de quem pode receber mensagem. ### Quem pode usar - Dono: Vê e faz tudo: importa e exporta CSV, edita contatos, aplica etiquetas, declara a base legal na ficha e usa o botão Continuar no WhatsApp nos contatos do chat do site. - Admin: Vê a base, filtra, cadastra e edita contatos, aplica e remove etiquetas, importa e exporta CSV. Não declara base legal na ficha e não vê o botão Continuar no WhatsApp. - Atendente: Vê a base, filtra, cadastra e edita contatos, aplica e remove etiquetas e inicia atendimento. Os botões Importar CSV e Exportar CSV não aparecem. ### Telas #### Base de contatos A tela Base de contatos serve para fatiar a base com filtros, conferir quem pode receber mensagem, importar ou exportar uma lista em CSV e abrir a ficha de cada contato para editar dados e etiquetas. Endereço no painel: `/app/contatos` ![Captura da tela Base de contatos. A tela Base de contatos serve para fatiar a base com filtros, conferir quem pode receber mensagem, importar ou exportar uma lista em CSV e abrir a ficha de cada contato para editar dados e etiquetas.](https://attendto.com.br/prints-do-manual/base-de-contatos--base-de-contatos.png) A tela Base de contatos na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Pelo menu, ou clicando numa empresa da tela Empresas: a Base de contatos abre já filtrada por aquela empresa. ##### Pulso da base Quatro números gerais da conta, que não mudam com os filtros. Também aparece: - "Total na base": contatos ativos na sua base. - "Novos hoje": contatos criados no dia. - "Quentes agora": leads na banda Quente, prontos para abordagem. - "Aguardando humano": conversas na fila de transbordo, com um ponto verde pulsando. - Se a leitura falhar, o número vira um travessão em vez de zero. ##### Listas inteligentes Atalhos no alto da coluna da esquerda, cada um com a contagem; passe o mouse para ver o recorte exato. Botões e ações: - **Todos os contatos**: Mostra a base inteira e desliga todos os filtros de uma vez. - **Quentes agora**: Filtra os contatos com nota BANT 75 ou mais. Clicar de novo desliga. - **Esperando nossa resposta**: Filtra quem mandou a última mensagem e ficou sem resposta além do prazo de resposta da conta, o mesmo que o Inbox cobra. - **Sem consentimento**: Filtra quem nunca manifestou consentimento. Alguns podem ter base legal declarada; o selo da ficha distingue. - **Reengajar · ‹banda› ‹n›d+**: Filtra os contatos da banda da regra de reengajamento sem interação há N dias ou mais. Banda e dias vêm da regra configurada no CRM & Graph. - **Importados hoje**: Filtra quem entrou por planilha desde a virada do dia. Quem já existia na base não conta. ##### Filtros por faceta Grupos de filtros na coluna da esquerda. Cada linha tem a contagem e uma barrinha proporcional; clicar liga, clicar de novo desliga. Campos e filtros: - **Banda BANT**: Quente, Morno, Frio ou Sem score. - **Canal**: Por onde o contato entrou: WhatsApp, Web chat, Instagram, Importados por planilha, Cadastro manual, Integração e outros. - **Status**: Novo, Em conversa, Qualificado, Transferido, Descartado ou Opt-out. - **Empresa**: As empresas com mais contatos, pelo nome oficial do cadastro. - **Etiquetas**: As etiquetas mais usadas na base. Também aparece: - Em telas estreitas a coluna vira um bloco recolhível chamado "Filtros e listas". - Os filtros ficam no endereço da página: copiar o link leva a mesma lista para outra pessoa da equipe. ##### Barra de ferramentas Temperatura rápida, busca, modo de exibição e as ações da base. Campos e filtros: - **Buscar contato, empresa, telefone…**: Busca livre por nome, empresa ou telefone; a lista atualiza depois de uma pausa curta na digitação. Botões e ações: - **Todos**: Desliga o filtro de temperatura. - **Quente**: Filtra a banda Quente; mostra a contagem ao lado. Clicar de novo desliga. - **Morno**: Filtra a banda Morno. - **Frio**: Filtra a banda Frio. - **Cartão**: Mostra um bloco por contato, com etiquetas e tudo à vista. A escolha fica lembrada neste navegador. - **Tabela**: Mostra uma linha por contato, ordenável por qualquer coluna. A escolha fica lembrada neste navegador. - **Importar CSV** (Dono, Admin): Abre o diálogo de importação de contatos por planilha. - **Exportar CSV** (Dono, Admin): Baixa um arquivo CSV com os contatos do recorte atual (filtros e busca aplicados). - **Novo contato**: Abre o diálogo de cadastro manual. ##### Lista em cartões O modo Cartão: um bloco por contato, carregado aos poucos enquanto você rola. Botões e ações: - **Abrir ficha de ‹nome›**: Clicar no cartão (ou Enter/Espaço com o foco nele) abre a ficha lateral do contato. Também aparece: - Faixa colorida à esquerda com a cor da temperatura. - Nome, empresa e canal de origem; as etiquetas como selos. - Selo "sem autorização" para quem não tem consentimento nem base legal; "base legal declarada" para quem tem só a base legal. - Status, há quanto tempo está na base e a nota BANT. ##### Lista em tabela O modo Tabela, para varrer e comparar muitas linhas. Clicar no cabeçalho ordena; o segundo clique inverte; o terceiro tira a ordenação. Campos e filtros: - **Contato**: Nome e empresa. Ordena de A a Z. A coluna fica fixa ao rolar a tabela para o lado. - **Nota**: Pontuação BANT de 0 a 100 e a temperatura. Ordena da maior para a menor. - **Alcançável**: Se dá para mandar mensagem: Consentimento, Base legal ou Sem autorização. - **Status**: Onde a conversa parou; ordena pela ordem do funil, não pelo alfabeto. - **Canal**: Por onde o contato entrou na base. - **Cadastrado**: Há quanto tempo o contato está na base; ordena do mais recente para o mais antigo. Também aparece: - Ao ordenar, a tela carrega o resto da base sozinha e avisa "Carregando a base inteira para ordenar — ‹n› de ‹total›." - Em base muito grande, avisa que ordenou só os primeiros e sugere estreitar os filtros para ordenar o conjunto inteiro. - Clicar numa linha (ou Enter/Espaço) abre a ficha lateral do contato. ##### Ficha do contato (painel lateral) Abre pela direita ao clicar num contato. Fecha no X ou com Esc. Também aparece: - Topo com a cor da temperatura, nome, selos de autorização e "Lead de teste", e a linha com empresa (ou telefone), temperatura e score. - Selos "Veio da integração" e "Veio do anúncio" quando a origem é conhecida. - Qualificação: "‹n› de ‹n› sinais" do público do contato, cada sinal com barra e a frase que o comprovou, ou "ainda não capturado". Sem qualificação, a ficha diz que os sinais aparecem quando a IA qualificar o contato na conversa. - Contato: Telefone, E-mail, Empresa e Origem. - Veio da integração: as entradas recebidas e os dados que chegaram junto, só para quem veio por integração. - Jornada: a linha do tempo com data e hora; o evento mais recente tem o ponto preenchido. Sem eventos, "Sem atividades ainda." ##### Pode receber mensagem? O bloco da ficha que diz de onde vem a autorização para falar com o contato. Botões e ações: - **Declarar base legal** (Dono): Aparece só em contato sem autorização registrada. Escolha o motivo no seletor (São meus clientes, Pediram para eu entrar em contato ou Já coletei o consentimento deles) e confirme no botão de mesmo nome. A declaração fica com o seu nome e a data, e o contato passa a entrar em campanha. Também aparece: - "Consentimento do titular": a pessoa respondeu no atendimento e recebeu o aviso de privacidade, ou autorizou no formulário de uma integração. - "Base legal declarada — ‹base›": quem declarou e quando, com o artigo da LGPD. A ficha deixa claro que não é consentimento do titular. - "Sem autorização registrada": o contato não entra em campanha até responder ou até o dono declarar a base legal. - "Pediu para não receber mensagens": vence tudo; o contato não entra em campanha e não recebe mensagem automática. ##### Etiquetas As etiquetas do contato, as mesmas do Inbox. Campos e filtros: - **Adicionar etiqueta**: Digite o nome e aperte Enter (ou saia do campo) para aplicar. Etiqueta repetida é ignorada. Botões e ações: - **Remover a etiqueta ‹nome›**: O X da etiqueta abre a confirmação "Remover esta etiqueta?". - **Remover etiqueta**: Confirma a remoção. A etiqueta sai deste contato aqui e no Inbox; os outros contatos que a usam não mudam. - **Cancelar**: Fecha a confirmação sem remover. Também aparece: - Sem etiquetas, aparece "Sem etiquetas ainda." ##### Rodapé da ficha As ações sobre o contato. Botões e ações: - **Continuar no WhatsApp** (Dono): Só para contato do chat do site que informou telefone: transforma o contato num contato de WhatsApp com aquele número, mantendo consentimento, qualificação e etiquetas, e abre a conversa no Inbox para enviar o modelo. - **Iniciar atendimento**: Abre a conversa do contato no Inbox, ou cria uma nova quando ele é alcançável por WhatsApp. Apagado, a dica diz por quê. - **Disparar**: Botão ainda desativado; a dica avisa que o envio manual chega numa fase futura. - **Editar**: Transforma o bloco Contato num formulário com Nome, Empresa e E-mail, com os botões Salvar e Cancelar. - **Salvar**: Grava as alterações de nome, empresa e e-mail. Exige o nome preenchido. ##### Diálogo Novo contato Cadastro manual de um contato, fora da conversa com a IA. Campos e filtros: - **Nome** (obrigatório): Nome completo. - **Telefone** (obrigatório): Com DDD, por exemplo +55 11 91234-5678. - **Empresa**: Opcional; sugere as empresas que já existem. - **CNPJ**: Opcional. Completo, consulta a Receita e preenche a empresa, com o aviso "Preenchido pela Receita". - **E-mail**: Opcional. - **Etiquetas**: Opcional, separadas por vírgula. Botões e ações: - **Criar contato**: Salva o contato e abre a ficha lateral dele. Só habilita com nome e telefone. Também aparece: - Telefone repetido é recusado com "Já existe um contato com este telefone." ##### Diálogo Importar contatos (CSV) Três etapas: escolher o arquivo, conferir as colunas e declarar a base legal, ver o resumo. Campos e filtros: - **Telefone** (obrigatório): Qual coluna da planilha é o telefone. A tela já sugere pela palavra do cabeçalho. - **Nome**: Qual coluna é o nome (ou "— nenhuma"). - **Empresa**: Qual coluna é a empresa (ou "— nenhuma"). - **E-mail**: Qual coluna é o e-mail (ou "— nenhuma"). - **Por que você pode falar com estes contatos?** (obrigatório): Escolha obrigatória entre São meus clientes, Pediram para eu entrar em contato e Já coletei o consentimento deles. Fica gravada com seu nome e a data e é o que autoriza os importados a receber campanha. Botões e ações: - **Arraste o CSV aqui ou clique para escolher**: Área para soltar o arquivo .csv ou abrir o seletor do computador. - **Baixar modelo de exemplo**: Baixa um CSV de exemplo com as colunas nome, telefone, empresa e email. - **Escolher outro**: Volta para a escolha do arquivo. - **Importar contatos**: Importa a planilha. Fica travado até a coluna do telefone e a base legal serem escolhidas; a dica diz qual falta. - **Importar outro**: Depois do resumo, recomeça com outro arquivo. - **Concluir**: Fecha o diálogo. Também aparece: - Na conferência, uma prévia das primeiras linhas com o nome de cada coluna. - Aviso fixo: a declaração não é o consentimento do titular, e contatos importados não são abordados automaticamente pela IA. - Resumo final com três números: criados, inválidos e no arquivo. ##### Fila de inválidos e importações recentes As linhas recusadas de uma importação, para corrigir uma a uma. Campos e filtros: - **Telefone corrigido**: O telefone da linha recusada, editável. Cada linha mostra o número da linha e o motivo da recusa. Botões e ações: - **Recriar**: Cria o contato com o telefone corrigido e marca a linha como "Contato criado". - **Corrigir**: Em "Importações recentes", abre a fila de inválidos daquela importação (vira "Fechar"). Também aparece: - "Corrigir inválidos (‹n›)" aparece logo após a importação, quando houve recusas. - "Importações recentes": cada arquivo com quantos foram criados e quantos inválidos, a data, a base legal declarada e quem declarou. ##### Estados da tela - Carregando: Faixas cinzas no formato do modo escolhido (blocos no modo Cartão, linhas no modo Tabela). - Sem nada ainda: "Nenhum contato neste recorte." Com filtro ligado, a tela explica que os filtros estão estreitando a lista e oferece Limpar filtros; sem filtro, convida a cadastrar o primeiro contato ou importar uma planilha. - Se der erro: "Não foi possível carregar os contatos." com o botão Tentar novamente. ### Passo a passo #### Como importar contatos de uma planilha CSV 1. Na **Base de contatos**, clique em **Importar CSV**. 2. Se precisar, clique em **Baixar modelo de exemplo** e preencha a planilha no mesmo formato. 3. Arraste o arquivo para a área **Arraste o CSV aqui ou clique para escolher**. 4. Confira na prévia qual coluna é **Telefone**, **Nome**, **Empresa** e **E-mail**. 5. Responda **Por que você pode falar com estes contatos?** escolhendo uma das três opções. 6. Clique em **Importar contatos** e leia o resumo de criados e inválidos. #### Como corrigir as linhas recusadas de uma importação 1. Abra **Importar CSV**; em **Importações recentes**, clique em **Corrigir** na importação com inválidos. 2. Em cada linha, ajuste o campo **Telefone corrigido**. 3. Clique em **Recriar**. A linha passa a mostrar **Contato criado**. #### Como exportar uma lista de contatos filtrada 1. Monte o recorte com as **Listas inteligentes**, os filtros da coluna da esquerda e a busca. 2. Clique em **Exportar CSV**. O arquivo traz só os contatos do recorte. #### Como colocar ou tirar uma etiqueta de um contato 1. Clique no contato para abrir a ficha lateral. 2. Em **Etiquetas**, digite o nome no campo **Adicionar etiqueta** e aperte Enter. 3. Para tirar, clique no X da etiqueta e confirme em **Remover etiqueta**. #### Como declarar a base legal de um contato sem autorização 1. Entre como dono da conta e abra a ficha do contato. 2. No bloco **Pode receber mensagem?**, escolha o motivo no seletor **Declarar base legal**. 3. Clique no botão **Declarar base legal**. O contato passa a entrar em campanha. #### Como ver quem está esperando resposta 1. Na coluna da esquerda, clique em **Esperando nossa resposta**. 2. Abra cada contato e use **Iniciar atendimento** para ir direto à conversa no Inbox. #### Como ordenar os contatos pela nota 1. Clique em **Tabela** ao lado da busca. 2. Clique no cabeçalho **Nota**: a primeira ordem é da maior para a menor; clique de novo para inverter. ### Perguntas frequentes #### A Base de contatos importa arquivo do Excel (.xlsx)? A importação desta tela aceita arquivo .csv. No Excel, use Salvar como e escolha CSV antes de importar. #### O que sai no arquivo do Exportar CSV? Os contatos do recorte que está na tela, com os filtros e a busca aplicados. Para exportar a base inteira, clique antes em Todos os contatos. #### Por que não vejo os botões Importar CSV e Exportar CSV? Eles aparecem só para dono e admin. Quem tem papel de atendente não importa nem exporta a base. #### Os números do topo mudam quando eu filtro? Não. Total na base, Novos hoje, Quentes agora e Aguardando humano são números gerais da conta. Quem muda com o filtro é a lista e as contagens da coluna da esquerda. #### A escolha entre Cartão e Tabela fica salva? Fica, neste navegador. Ela não vai no link: quem abre um link compartilhado recebe os filtros, mas vê a lista no modo que escolheu para si. #### Qual a diferença entre a ficha da Base de contatos e a ficha do CRM? A ficha lateral da Base de contatos edita nome, empresa, e-mail e etiquetas e declara a base legal. A ficha do CRM & Graph mostra o perfil de compra, o engajamento e as ações de LGPD, com o contato só para leitura. #### O que é o botão Disparar desativado na ficha? É o envio manual para um contato, que ainda não está disponível. Para falar com a pessoa agora, use Iniciar atendimento. ### Guia: Base de contatos Todo mundo que já falou com você, mais quem você trouxe de planilha. É daqui que sai o público de uma campanha. Cada pessoa que manda mensagem entra aqui sozinha. E você pode trazer a sua lista antiga de planilha. Esta é a base que sustenta tudo que é feito em massa. #### A tela Na tela: Base de contatos com o painel de filtros à esquerda e a lista de contatos à direita. Filtros à esquerda, contatos à direita. Cada filtro mostra quantos contatos ele alcança antes de você clicar. 1. **O tamanho da base**: Quantos contatos existem, quantos entraram hoje, quantos estão quentes e quantos esperam atendimento. Clique num número para ver a lista dele. 2. **Os filtros**: Listas prontas em cima; abaixo, temperatura, canal de origem e situação. O número ao lado de cada opção é quanta gente ela pega — você já sabe o tamanho antes de clicar. 3. **Busca e ações**: Procure por nome, empresa ou telefone; alterne entre cartão e tabela. É daqui que saem **Importar CSV**, **Exportar CSV** e **Novo contato**. 4. **A lista**: Nome, empresa, canal, etiquetas, situação e temperatura. Clique para abrir a ficha completa, com a conversa e a jornada do contato. #### As listas prontas, e quando usar cada uma No alto da coluna de filtros ficam listas já montadas, cada uma com a contagem ao lado. Elas são atalhos para as perguntas que se repetem toda semana, e a contagem serve para você decidir **antes** de clicar se vale a pena: - **Quentes agora**: Quem está pronto para uma abordagem hoje. Se este número cresce e ninguém liga, o problema não é geração de lead. - **Esperando nossa resposta**: Gente que escreveu e ficou sem resposta. É a lista que envelhece pior — vale abrir todo dia. - **Sem consentimento**: Contatos que não podem entrar em campanha. Um número alto aqui explica por que a sua última leva alcançou menos gente do que você esperava. - **Reengajar**: Quem esfriou sem dizer não. É a matéria-prima natural de uma campanha de retomada. - **Importados hoje**: Serve para conferir a importação que você acabou de fazer, antes de disparar qualquer coisa para ela. Ao lado da busca há duas formas de ver a mesma lista. **Cartão** mostra cada contato com etiquetas e temperatura, e é melhor para percorrer pouca gente com atenção. **Tabela** empilha muito mais linhas na mesma tela e é melhor para conferir uma importação ou varrer a base atrás de um caso. Em tabela, dá para ordenar clicando no cabeçalho da coluna — e, numa base grande, a tela avisa que a ordenação vale para os primeiros contatos, em vez de fingir que ordenou tudo. #### Trazer a sua lista de planilha 1. **Deixe a planilha simples**: Uma linha por pessoa, com nome e telefone no mínimo. E-mail e empresa ajudam. Salve como CSV. 2. **Confira as colunas**: Depois de enviar o arquivo, a tela mostra as primeiras linhas e pede para você dizer qual coluna é qual. Olhe a prévia: é aqui que se pega telefone na coluna do nome. 3. **Declare com que direito você tem esses contatos**: Esta é a parte obrigatória, e ela existe para te proteger. Você escolhe uma das três situações reais, e a sua escolha fica registrada com o seu nome e a data. 4. **Importe**: Quem já existe pelo telefone não entra duas vezes. E o telefone é entendido do jeito que estiver na planilha — com ou sem +55, com ou sem o nono dígito, com traço ou parêntese: é a mesma pessoa, e quando ela responder no WhatsApp a conversa cai neste contato, não num duplicado. No fim aparece quantos entraram e quantos foram ignorados, com o motivo. - **São meus clientes**: Gente que já comprou de você. É a relação comercial que dá o direito de falar. - **Pediram contato**: Preencheram formulário, deixaram o telefone no seu estande, pediram orçamento. - **Autorizaram receber mensagens**: Disseram sim, de forma explícita, a receber comunicação sua. > **Declarar não é o mesmo que ter permissão:** A declaração registra o **seu motivo** para ter aquela lista. Ela não transforma ninguém em quem pediu para receber mensagem. Lista comprada não se encaixa em nenhuma das três — e disparar para ela é problema seu antes de ser nosso. #### Quem pode receber mensagem A ficha de cada contato tem um bloco **Pode receber mensagem?**. Ele responde de um jeito só, sem letra miúda: - **O titular respondeu no atendimento** — a pessoa falou com você. É a autorização mais forte que existe. - **Base legal declarada** — você declarou o motivo, na importação ou na própria ficha (só o dono declara). Serve para campanha e para iniciar atendimento, e mostra quem declarou e quando. - **Sem autorização** — nem uma coisa nem outra. Fica de fora de qualquer disparo até o dono declarar a base legal ali mesmo, no bloco, escolhendo o motivo entre os três da importação. - **Pediu para não receber** — a pessoa se descadastrou. Isto vence tudo, sempre, inclusive base legal declarada. #### Quando a importação não sai como esperado - **Entrou muito menos gente do que a planilha tinha**: Quase sempre é telefone repetido: quem já existe pelo telefone não entra de novo. O resultado da importação diz quantos foram ignorados e por quê — leia antes de refazer o arquivo. - **Linhas recusadas por telefone inválido**: Número sem DDD, com texto no meio ou com menos dígitos do que deveria. Corrija na planilha e importe de novo: reimportar não duplica quem já entrou. - **Os nomes vieram na coluna errada**: A conferência de colunas foi passada rápido. Não há como desfazer a importação em bloco; corrija os contatos afetados pela ficha, ou refaça a planilha e importe por cima — o telefone é o que casa os registros. - **A campanha alcançou menos gente do que a lista**: Não é a importação: é consentimento. Abra a lista **Sem consentimento** e você vê exatamente quem ficou de fora. #### Organizar para achar depois - **Etiquetas** são livres: `obra em andamento`, `indicação do João`, `visitou a loja`. Filtre por elas na hora da campanha. - **Empresas** juntam contatos da mesma casa. Duas pessoas da mesma empresa aparecem ligadas em [Empresas](https://attendto.com.br/manual/empresas). - O filtro que você montou fica no endereço da página. Copie o link e mande para alguém do time: ele abre a mesma lista. > **Uma base bem organizada é assim:** **Sem consentimento** pequeno perto do total, **Esperando nossa resposta** perto de zero no fim do dia, e etiquetas que significam a mesma coisa para todo mundo do time. Com isso, montar o público de uma campanha vira um clique em vez de meia hora. No painel: Abrir a Base de contatos. Como as pessoas procuram: importar contatos csv; importar planilha de clientes; exportar contatos; filtrar contatos por etiqueta; lista de contatos whatsapp; base legal lgpd contatos; contatos sem consentimento; corrigir telefone inválido importação; etiquetar contato; contatos esperando resposta; editar contato; segmentar base de clientes. ## Empresas: lista de empresas dos contatos, duplicatas prováveis e como unificar empresas repetidas URL: https://attendto.com.br/manual/empresas Menu: Operação > Empresas A tela Empresas do painel lista as empresas que nasceram dos contatos, com CNPJ, segmento e número de contatos, e aponta as duplicatas prováveis para unificar duas grafias da mesma empresa num cadastro só. ### Quem pode usar - Dono: Vê a lista e as duplicatas, unifica empresas e dispensa sugestões com Não são a mesma. - Admin: Vê a lista e as duplicatas, unifica empresas e dispensa sugestões com Não são a mesma. - Atendente: Vê a lista e o painel de duplicatas prováveis, mas sem os botões Unificar e Não são a mesma. Clicar numa empresa abre os contatos dela normalmente. ### Telas #### Empresas A tela Empresas serve para conferir as empresas dos seus contatos, encontrar uma pelo nome, CNPJ ou segmento e juntar duas grafias da mesma empresa num cadastro só. Endereço no painel: `/app/empresas` ![Captura da tela Empresas. A tela Empresas serve para conferir as empresas dos seus contatos, encontrar uma pelo nome, CNPJ ou segmento e juntar duas grafias da mesma empresa num cadastro só.](https://attendto.com.br/prints-do-manual/empresas--empresas.png) A tela Empresas na conta de demonstração, com dados fictícios e os valores desfocados. ##### Duplicatas prováveis Painel em destaque que só aparece quando há grafias parecidas que podem ser a mesma empresa. Botões e ações: - **Unificar** (Dono, Admin): Abre a confirmação Unificar empresas para escolher qual empresa permanece. Nada é fundido no clique. - **Não são a mesma** (Dono, Admin): Abre a confirmação "Estas empresas não são a mesma?". Confirmado, o grupo deixa de ser sugerido entre si; nada é apagado nem unificado. Também aparece: - Selo com o número de grupos sugeridos ao lado do título. - Cada grupo mostra as grafias lado a lado, cada uma com o CNPJ (quando existe) e quantos contatos tem. - Um percentual com a dica "Similaridade entre os nomes": mede só o quanto os nomes se parecem. ##### Diálogo Estas empresas não são a mesma? A confirmação da dispensa de uma sugestão. Botões e ações: - **Cancelar**: Fecha sem dispensar. - **Não são a mesma**: Dispensa o grupo. Logo depois aparece um aviso com o botão Desfazer, que traz a sugestão de volta. - **Desfazer**: No aviso após dispensar, devolve a sugestão à lista de duplicatas. Também aparece: - Se uma empresa nova parecida chegar depois, a sugestão nova aparece normalmente. ##### Diálogo Unificar empresas Escolha de qual empresa permanece e a frase com a consequência, antes de confirmar. Campos e filtros: - **Empresa que permanece**: Lista das empresas do grupo, com CNPJ e número de contatos. Já vem marcada a que tem mais contatos, com o selo Permanece; dá para escolher outra. Botões e ações: - **Cancelar**: Fecha sem unificar. - **Unificar empresas**: Passa os contatos das outras empresas para a que permanece e remove as outras. Não tem desfazer. Também aparece: - Frase em destaque: quantos contatos passam para a empresa que fica, quais nomes serão removidos e "Esta ação não pode ser desfeita." - Em grupo com três ou mais empresas, a fusão acontece uma por vez; se uma falhar, as anteriores continuam feitas e o aviso diz quantas foram unificadas. - Ao terminar, o aviso confirma "Empresas unificadas em ‹nome›" e quantos contatos foram repontados. ##### Busca Campos e filtros: - **Buscar empresa, CNPJ, segmento…**: Filtra a lista por nome (sem diferenciar acento), por dígitos do CNPJ ou por segmento. Em base grande, procura na base inteira a partir de dois caracteres. Também aparece: - Contagem ao lado: "‹n› de ‹total› empresas", ou "‹n› resultados" quando a busca é feita na base inteira. - Em base grande, aviso de que a lista mostra as empresas com mais contatos e que a busca encontra as demais. ##### Lista de empresas Uma linha por empresa, as com mais contatos primeiro. Botões e ações: - **Ver os contatos de ‹empresa› na Base de contatos**: Clicar na linha abre a Base de contatos já filtrada por aquela empresa. Também aparece: - Nome da empresa. - CNPJ formatado, ou "sem CNPJ". - Segmento, quando conhecido. - Número de contatos ligados à empresa. ##### Estados da tela - Carregando: Uma faixa cinza no lugar do painel de duplicatas e seis faixas no lugar da lista. - Sem nada ainda: "Nenhuma empresa ainda": as empresas nascem dos contatos, então é preciso cadastrar um contato com empresa na Base de contatos. Com busca sem resultado: "Nenhuma empresa encontrada com esta busca." - Se der erro: "Não foi possível carregar as empresas." com o botão Tentar novamente. - Não há duplicata suspeita: O painel Duplicatas prováveis simplesmente não aparece. - Unificação recusada: Um aviso de erro com o motivo, por exemplo quando as empresas têm CNPJs diferentes preenchidos ou quando uma delas já não existe. ### Passo a passo #### Como unificar duas empresas repetidas 1. Abra **Empresas** no menu. 2. No painel **Duplicatas prováveis**, confira se as grafias são mesmo da mesma empresa. 3. Clique em **Unificar**. 4. Escolha qual empresa permanece e leia a frase com a consequência. 5. Clique em **Unificar empresas**. #### Como dispensar uma sugestão de duplicata errada 1. No painel **Duplicatas prováveis**, clique em **Não são a mesma** no grupo. 2. Confirme em **Não são a mesma** no diálogo. 3. Se mudar de ideia logo em seguida, clique em **Desfazer** no aviso. #### Como ver todos os contatos de uma empresa 1. Em **Empresas**, encontre a empresa pela busca **Buscar empresa, CNPJ, segmento…**. 2. Clique na linha da empresa. A **Base de contatos** abre filtrada por ela. #### Como cadastrar uma empresa nova 1. Não há cadastro direto de empresa: vá à **Base de contatos**. 2. Clique em **Novo contato** e preencha **Empresa** (ou o **CNPJ**, que preenche a empresa pela Receita). 3. Ao salvar, a empresa passa a aparecer em **Empresas**. ### Perguntas frequentes #### Dá para criar ou editar uma empresa direto nesta tela? Não. A tela Empresas não tem cadastro: a empresa nasce quando um contato tem o campo Empresa preenchido, na Base de contatos. #### Por que não vejo o botão Unificar? Unificar e Não são a mesma aparecem só para dono e admin. O atendente vê o painel de duplicatas apenas para consulta. #### Qual empresa já vem marcada para permanecer na unificação? A que tem mais contatos. Você pode marcar outra antes de confirmar. #### O que acontece com os contatos da empresa removida? Eles passam para a empresa que permanece. O aviso final diz quantos contatos foram repontados. #### A busca encontra empresa pelo CNPJ com pontos e barras? Sim. A busca compara só os dígitos do CNPJ, então funciona com ou sem a pontuação. ### Guia: Empresas As empresas dos seus contatos, uma vez só. É aqui que duas grafias do mesmo cliente viram um cadastro — e a fusão não tem desfazer. Você nunca cadastra uma empresa aqui. Elas **nascem dos contatos**: preencher o campo Empresa de alguém na [Base de contatos](https://attendto.com.br/manual/base-de-contatos) faz a empresa passar a existir. Esta tela serve para o que vem depois — conferir se a mesma casa não virou dois cadastros por causa de uma grafia diferente. #### A tela Na tela: Tela Empresas com o painel de duplicatas prováveis no topo e a lista de empresas abaixo. As duplicatas sugeridas em cima, a lista completa embaixo. 1. **Duplicatas prováveis**: Este painel só aparece quando há suspeita. Nenhuma conta vazia mostra a faixa amarela — se ela não está aí, não há nada para revisar. 2. **O par sugerido**: As duas grafias lado a lado, cada uma com o CNPJ (quando existe) e quantos contatos tem. Quem tem mais contatos é o candidato natural a ficar. 3. **A semelhança e o Unificar**: O percentual mede só o quanto os **nomes** se parecem. **Unificar** abre a confirmação, onde você escolhe qual empresa permanece — nada é fundido no clique. 4. **Busca e contagem**: Procura por nome, CNPJ ou segmento. Ao lado, quantas empresas estão sendo mostradas de quantas existem. 5. **A lista**: Nome, CNPJ ou `sem CNPJ`, segmento e o número de contatos. Clicar numa linha abre a [Base de contatos](https://attendto.com.br/manual/base-de-contatos) já filtrada por aquela empresa. #### Unificar duas empresas 1. **Confira se é a mesma casa mesmo**: O percentual é **sugestão de grafia parecida**, não prova. `Auto Peças Zona Sul` e `Auto Peças Zona Norte` batem alto e são duas lojas diferentes. Quem decide é você. 2. **Clique em Unificar**: Abre a confirmação com as duas empresas e um seletor de qual permanece. A sugerida é a que tem mais contatos, mas dá para escolher a outra. 3. **Leia a frase de consequência**: Ela diz quantos contatos mudam de dono e qual nome será removido. Confira principalmente o **nome que fica**: é ele que vai aparecer em todo lugar depois. 4. **Confirme**: Os contatos passam para a empresa escolhida e a outra é apagada. Um aviso confirma quantos contatos foram remanejados. > **Unificar não tem desfazer:** Não há botão de voltar nesta tela nem em nenhuma outra: a empresa removida deixa de existir. E quando o painel sugere um grupo de três, a fusão acontece **uma de cada vez** — se a terceira falhar, as duas primeiras já aconteceram e continuam feitas. Em caso de dúvida, não una: duas empresas separadas atrapalham muito menos que um cadastro fundido errado. #### E quando NÃO são a mesma empresa? Nem toda grafia parecida é duplicata — duas corretoras com nomes quase iguais podem ser concorrentes. O botão **Não são a mesma** dispensa o grupo: ele sai da lista e não volta. Nada é apagado nem unificado, e o aviso logo após confirmar tem o **Desfazer**. Se uma empresa **nova** com nome parecido chegar depois, a sugestão nova aparece normalmente — a dispensa vale só entre as empresas que você revisou. #### Quando o painel não vai sugerir - Empresas com **CNPJ diferente e preenchido** nunca aparecem juntas — e, se você tentar, a fusão é recusada. CNPJ preenchido é a trava mais barata contra fusão errada. - Nomes que não se parecem passam batido. `Bom Trigo` e `Padaria do Seu Zé`, sendo a mesma casa, ficam separados: junte na mão preenchendo o mesmo nome de empresa nos contatos. - Grupos que você **dispensou** com o Não são a mesma. - **Só administrador ou dono unifica (e dispensa).** Quem tem papel de atendente vê o painel de duplicatas, mas sem os botões. #### Base grande A lista mostra no máximo **200 empresas**, as com mais contatos primeiro, e avisa quando está truncada. Passando disso, a busca deixa de filtrar só o que está na tela e passa a procurar na base inteira **a partir de dois caracteres** — se você digitou uma letra só e não achou, é isso. No painel: Abrir Empresas. Como as pessoas procuram: empresas duplicadas; unificar empresas; juntar empresa repetida; mesclar cadastro de empresa; buscar empresa por cnpj; contatos da mesma empresa; lista de empresas clientes; empresa com nome diferente. ## Agenda: reuniões que a IA marca na conversa, lado a lado com o seu Google Agenda URL: https://attendto.com.br/manual/agenda Menu: Operação > Agenda A Agenda é a tela de leitura da semana com as reuniões que a IA marcou durante as conversas com os leads, ao lado dos horários ocupados no seu Google Agenda. Quando aparece: Sempre no menu, para todos os papéis. A grade da semana aparece depois que o Google Agenda é conectado em Configurações, na aba Agenda; antes disso, a tela mostra o convite para conectar. ### Quem pode usar - Dono: Vê a semana e o detalhe de cada reunião, abre a conversa e conecta o Google Agenda pelo botão da tela, que leva a Configurações. - Admin: O mesmo que o dono. - Atendente: Vê a mesma semana, o detalhe das reuniões e abre a conversa. Conectar o Google Agenda fica com dono ou administrador: o botão leva a Configurações, que não abre para quem atende (volta ao Painel). ### Telas #### Agenda A tela Agenda serve para ver, semana a semana, as reuniões que a IA marcou com os leads e os horários já ocupados no Google Agenda, e abrir a conversa de cada reunião. Endereço no painel: `/app/agenda` ![Captura da tela Agenda. A tela Agenda serve para ver, semana a semana, as reuniões que a IA marcou com os leads e os horários já ocupados no Google Agenda, e abrir a conversa de cada reunião.](https://attendto.com.br/prints-do-manual/agenda--semana.png) A tela Agenda na conta de demonstração, com dados fictícios e os valores desfocados. ##### Navegação da semana A semana vai de domingo a sábado, como no Google Agenda. Botões e ações: - **Hoje**: Volta para a semana atual. Fica desligado quando você já está nela. - **Semana anterior**: A seta para a esquerda: mostra a semana anterior. - **Próxima semana**: A seta para a direita: mostra a semana seguinte. Também aparece: - O intervalo da semana, como “‹dia› – ‹dia› de ‹mês›”. - O selo verde com o e-mail da conta do Google ligada (ou “Google conectado”): confira se é a conta da empresa. ##### Legenda Também aparece: - Reunião marcada pela IA: o bloco colorido. - Ocupado no seu Google: o bloco cinza. ##### Grade da semana Sete colunas de dias e a faixa fixa das 07h às 20h; com tela estreita, a grade rola para o lado. Botões e ações: - **‹nome do lead› ‹horário›**: Cada reunião na grade, com o nome do lead e o horário de início. Abre o detalhe da reunião (dica “Detalhes da reunião com ‹nome›”). Também aparece: - O cabeçalho de cada dia (dom a sáb) com o número; o dia de hoje vem destacado. - Sábado e domingo levemente sombreados. - A régua de horas das 07h às 20h; compromisso fora dessa faixa não é desenhado. - Os blocos cinza: os horários ocupados no seu Google, sem título nem detalhe (só ocupado e livre é lido). - Na coluna de hoje, a linha vermelha do horário atual, que anda sozinha. ##### Detalhe da reunião Título “Reunião — ‹nome do lead›”, com o dia da semana, a data e o horário de início e fim. Botões e ações: - **Abrir conversa**: Fecha o detalhe e abre a conversa do lead no Inbox, para reler o que foi combinado. - **Ver no Google Agenda**: Abre o evento no Google Agenda, em outra aba. É lá que se remarca ou cancela. Só aparece quando o evento tem link. Também aparece: - A frase “Agendada automaticamente pela sua IA durante a conversa com o lead.” ##### Convite para conectar Ocupa a tela inteira enquanto o Google Agenda não está conectado. Botões e ações: - **Conectar Google Agenda** (Dono, Admin): Leva a Configurações, na aba Agenda, onde se conecta a conta do Google e se define o expediente das reuniões. Também aparece: - O título “Sua IA pode marcar reuniões sozinha” e a explicação: a IA oferece horários livres dentro do seu expediente, confirma com o lead e cria o evento, com convite por e-mail. ##### Estados da tela - Carregando: Um bloco esqueleto enquanto a conexão com o Google é verificada. - Sem nada ainda: Abaixo da grade: “Nenhuma reunião marcada pela IA ainda — quando um lead pedir um horário na conversa, ele aparece aqui em verde.” - Se der erro: “Não foi possível carregar as reuniões”, lembrando que isso não quer dizer que a semana está livre e que nenhum compromisso foi cancelado, com Tentar de novo. - Google Agenda não conectado: O convite “Sua IA pode marcar reuniões sozinha” com Conectar Google Agenda; as reuniões que já existiam ficam fora de vista até conectar de novo. ### Passo a passo #### Como conectar o Google Agenda para a IA marcar reuniões 1. Abra **Agenda** no menu e clique em **Conectar Google Agenda** (ou vá a Configurações, aba Agenda). 2. Clique em **Conectar Google Agenda** e entre com a conta do Google da empresa. 3. Marque os dias do expediente e o horário de início e fim de cada um. 4. Ajuste a **Duração da reunião (min)** e o **Intervalo entre reuniões (min)** e clique em **Salvar expediente**. 5. Volte à **Agenda** e confira o selo verde com o e-mail da conta certa. #### Como ver as reuniões da próxima semana 1. Abra **Agenda** no menu. 2. Clique em **Próxima semana** (a seta para a direita) quantas vezes precisar. 3. Clique em **Hoje** para voltar à semana atual. #### Como abrir a conversa de uma reunião marcada pela IA 1. Na grade, clique no bloco colorido da reunião. 2. No detalhe, clique em **Abrir conversa**: a conversa do lead abre no Inbox. #### Como remarcar ou cancelar uma reunião marcada pela IA 1. Clique na reunião na grade e depois em **Ver no Google Agenda**. 2. No Google Agenda, remarque ou apague o evento (apagar cancela também para o convidado). 3. Volte ao detalhe, clique em **Abrir conversa** e avise o lead você mesmo: o Google não manda recado pelo WhatsApp. ### Perguntas frequentes #### Dá para criar ou arrastar uma reunião direto na Agenda? Não. A Agenda é só de leitura: as reuniões nascem na conversa, quando o lead escolhe um dos horários que a IA oferece. Mudanças se fazem no Google Agenda. #### Quem atende consegue ver a Agenda? Sim. Todos os papéis veem a semana e o detalhe das reuniões. Só a conexão com o Google e o expediente, em Configurações, ficam com dono e administradores. #### Por que o botão Ver no Google Agenda não aparece numa reunião? Ele só aparece quando o evento tem o link do Google. Sem link, use Abrir conversa e confira o evento direto no Google Agenda. #### Os títulos dos meus compromissos particulares aparecem para a equipe? Não. Do Google só chegam os períodos ocupados, que a grade desenha como blocos cinza sem nome, sem participantes e sem descrição. #### Uma reunião marcada às 21h sumiu da grade? Ela existe, mas a grade só desenha das 07h às 20h. Confira no Google Agenda ou pela conversa do lead. ### Guia: Agenda A semana com as reuniões marcadas durante as conversas. É uma tela de leitura: quem define os horários é Configurações, e quem cancela é o Google Agenda. No meio de uma conversa o lead pergunta se dá para falar por vídeo, recebe três horários livres, escolhe um, e o evento nasce no seu Google Agenda. Esta tela é onde você vê isso acontecendo — **e só isso**. Aqui não se cria, não se arrasta, não se remarca e não se cancela reunião nenhuma. #### A semana Na tela: Agenda em grade semanal de domingo a sábado, das 07h às 20h, com uma reunião marcada na sexta. A semana de domingo a sábado, das 07h às 20h. 1. **Navegar e a conta conectada**: **Hoje** volta para a semana atual; as setas andam semana a semana. O selo verde ao lado do intervalo mostra **qual conta do Google** está ligada — vale conferir se é a conta certa da empresa. 2. **A legenda**: **Reunião marcada pela IA** é o bloco colorido; **Ocupado no seu Google** é o cinza. Só existem esses dois tipos de bloco na grade. 3. **Os dias**: Domingo a sábado, com o dia de hoje destacado. Sábado e domingo aparecem sombreados mesmo quando você atende neles. 4. **A faixa de horas**: A grade vai das **07h às 20h**, e essa faixa é fixa. Compromisso fora dela existe, mas não é desenhado aqui. 5. **As trilhas do dia**: Os retângulos cinza são os seus compromissos particulares do Google: aparecem como área ocupada, sem título nem detalhe. Nada do conteúdo deles é lido. 6. **Uma reunião marcada**: Nome do lead e horário. Clique e abre o detalhe, com **Abrir conversa** — para reler o que foi combinado antes de entrar na reunião — e **Ver no Google Agenda**. #### Onde se define a disponibilidade Não é aqui. É em [Configurações](https://attendto.com.br/manual/configuracoes), na aba **Agenda** (**Google Agenda e expediente**). É a tela que decide se alguma reunião vai existir, então vale abrir no primeiro dia mesmo sem intenção de mexer. - **Os dias da semana**: Cada dia tem uma caixa para marcar e, marcado, uma hora de início e uma de fim. Dia desmarcado aparece como `fechado` e nunca é oferecido. - **Duração da reunião (min)**: O tamanho do bloco que será reservado. Trinta minutos é o começo razoável para conversa de qualificação; uma hora enche a agenda rápido. - **Intervalo entre reuniões (min)**: O respiro obrigatório antes e depois de cada uma. Zero aqui produz aquele dia em que uma reunião começa no segundo em que a outra termina. Do seu calendário do Google só são lidos os **blocos de ocupado e livre**. Título, participante e descrição dos seus compromissos não são acessados, e é por isso que a grade mostra retângulos cinza sem nome. #### Como uma reunião é marcada 1. **O assunto aparece na conversa**: O lead pede um horário, ou a conversa chega ao ponto em que uma reunião é o próximo passo natural. 2. **Três horários são oferecidos**: Sempre com **no mínimo duas horas de antecedência**, dentro do expediente que você definiu, respeitando a duração, o intervalo e o que já está ocupado no seu Google. 3. **O lead escolhe**: Ele responde na própria conversa, sem sair do WhatsApp e sem link de agendamento. 4. **O evento nasce no Google Agenda**: E, se o contato tiver e-mail cadastrado, ele entra como convidado — o convite sai por e-mail direto do Google. Sem e-mail, o evento existe igual, só sem convite. #### Quando nenhuma reunião é oferecida > **Sem disponibilidade, o assunto simplesmente não é tocado:** Se não houver horário livre para oferecer, **nenhum horário é oferecido e o lead não é avisado disso**. A conversa segue normalmente, sem reunião e sem sinal de que faltou alguma coisa. Você não vê erro em lugar nenhum — vê uma agenda vazia e conclui que ninguém quis marcar. As três causas, em ordem de frequência: - **O Google Agenda não está conectado.** A tela inteira vira o convite **Conectar Google Agenda**, e as reuniões que já existiam ficam invisíveis enquanto isso — elas não sumiram, só não têm como ser lidas. - **Todos os dias estão desmarcados** em Configurações. É o estado de quem conectou o Google e não desceu até o expediente. - **A semana inteira está tomada** pelos seus próprios compromissos. Neste caso não há defeito nenhum: é falta de espaço, e o conserto é abrir espaço. > **Este expediente é outro, diferente do horário de atendimento:** O expediente da aba **Agenda** diz quando você aceita **reunião**. O horário em [Configurações](https://attendto.com.br/manual/configuracoes) → **Atendimento** diz quando há **gente** disponível para conversa. Configurar um e esquecer o outro é o que produz reunião marcada para as 19h30 de sexta com o escritório fechado. Deixe os dois coerentes desde o começo. #### Remarcar e cancelar Pela reunião na grade, **Ver no Google Agenda** abre o evento lá, e é lá que se remarca ou cancela — apagar o evento no Google cancela de verdade, inclusive para o convidado. Feito isso, avise o lead: use **Abrir conversa** no mesmo detalhe e escreva você mesmo. Cancelar no Google não manda recado nenhum pelo WhatsApp. #### Como é quando está redondo - O selo verde no topo mostra o **e-mail da conta certa** — a da empresa, não a pessoal de quem fez a configuração. - Os dias marcados em Configurações batem com os dias em que existe alguém para atender. - A grade tem blocos cinza (a sua vida real) e blocos coloridos (as reuniões que a conversa produziu) convivendo, em vez de uma semana em branco. - As reuniões caem **dentro da faixa de 07h às 20h**. Se você combina reuniões às 21h, elas não vão aparecer desenhadas aqui. - O [Painel](https://attendto.com.br/manual/painel) mostra o cartão **PRÓXIMOS AGENDAMENTOS**. Ele sumir do Painel é o primeiro sinal de que faz tempo que nada é marcado. No painel: Abrir a Agenda. Como as pessoas procuram: agenda de reuniões whatsapp; ia marca reunião; agendamento automático com lead; integrar google agenda; ver reuniões marcadas; cancelar reunião marcada pela ia; disponibilidade para reuniões; calendário de vendas. ## Handoff: a fila de transbordo da IA para atendimento humano, com o dossiê do lead URL: https://attendto.com.br/manual/handoff Menu: Operação > Handoff O Handoff é a fila de transbordo: reúne as conversas que a IA passou para uma pessoa da equipe, com o motivo, o tempo de espera e o dossiê do lead, e é onde se escolhe quem assume cada uma. ### Quem pode usar - Dono: Vê a fila e os números, lê o dossiê, escreve e remove anotações, escolhe o atendente, assume e devolve conversas para a IA. - Admin: Mesmo acesso do dono. - Atendente: Mesmo acesso: vê a fila, lê o dossiê, anota, escolhe o atendente, assume e devolve conversas para a IA. ### Telas #### Handoff A tela Handoff serve para ver quem está esperando um humano, entender por que a IA passou a conversa e entregá-la a um atendente que já entra sabendo o que o lead disse. Endereço no painel: `/app/handoff` ![Captura da tela Handoff. A tela Handoff serve para ver quem está esperando um humano, entender por que a IA passou a conversa e entregá-la a um atendente que já entra sabendo o que o lead disse.](https://attendto.com.br/prints-do-manual/handoff--fila-de-transbordo.png) A tela Handoff na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Pelo item **Handoff** do menu, em OPERAÇÃO. O subtítulo da tela diz **Transbordo humano estruturado**. ##### Números da fila Quatro cartões no topo, todos só de leitura. Campos e filtros: - **Handoff accuracy**: A porcentagem de vezes em que a equipe concordou com a qualificação da IA, a partir dos votos **Concordo** e **Discordo** dados no dossiê do Inbox. Embaixo, quantas avaliações existem, ou **sem feedback ainda**. - **Na fila agora**: Quantas conversas aguardam humano neste momento. Se a fila não puder ser lida, mostra um traço e **não foi possível contar**, nunca zero. - **Tempo médio aguardando**: A média de espera das conversas que estão na fila agora, em formato curto (minutos, horas ou dias). - **Satisfação (CSAT)**: A média das notas de 1 a 5 dadas pelos leads depois do atendimento e quantas notas existem, ou **sem notas ainda**. Botões e ações: - **por atendente**: Pílula no cartão de satisfação: ao passar o mouse, mostra a média e o número de notas de cada atendente. Só aparece quando já há notas por atendente. ##### Fila de transbordo A lista à esquerda: uma linha por conversa aguardando humano ou já em atendimento humano. Botões e ações: - **‹lead›**: Clicar na linha abre o dossiê daquele lead ao lado. A primeira conversa da fila já vem aberta. Também aparece: - Avatar e nome do lead, com o tempo de espera à direita. - O motivo do transbordo (por exemplo, o lead pediu uma pessoa ou o pedido ficou completo); sem motivo registrado, **Transbordo solicitado**, ou **Em atendimento humano** quando alguém já assumiu. - A faixa da nota com o número (**Quente**, **Morno**, **Frio** ou **Sem score**). - A linha escolhida fica destacada com uma barra lateral. ##### Cabeçalho do lead escolhido Quem é o lead, por onde chegou e a nota dele. Também aparece: - Nome, empresa ou telefone e o canal da conversa. - A faixa da nota com o número. ##### DOSSIÊ DO LEAD: abertura As primeiras linhas do dossiê dizem por que a conversa está aqui e há quanto tempo. Também aparece: - Selo **Esperando há ‹tempo›** quando a conversa aguarda humano. - **Por que veio para um humano:** seguido do motivo do transbordo. - Sem transbordo: **Sem transbordo: ‹nome› está com a conversa, e a IA não responde por cima.**, **Esta conversa ainda não foi transbordada — a IA segue conduzindo.** ou o aviso de que a IA está calada naquela conversa e até quando. - Total de mensagens desde o início da conversa e o **humor do lead** medido pela IA (passe o mouse para ver quando foi medido). ##### O QUE A IA JÁ COMBINOU O resumo desta conversa escrito pela IA no momento do transbordo. Também aparece: - Texto da IA, sem aspas, com **Próximo passo sugerido:** e a assinatura **Resumo da IA · ‹data›**. - Só vale para esta conversa: o que foi combinado em conversas anteriores do mesmo lead fica de fora. - Sem transbordo ainda, o bloco explica que o resumo nasce no transbordo. Com transbordo e sem resumo, diz que a IA não escreve quando não consegue ler a conversa a tempo. ##### ONDE ELE TRAVOU As objeções do lead em todas as conversas dele. Também aparece: - O tipo da objeção (classificação da IA), a data e, entre aspas, a frase literal do lead. - Objeção vinda de outra conversa leva a marca **de uma conversa anterior**. - Quando a lista é longa, a linha **Mostrando as ‹n› mais recentes de ‹total›.** avisa o corte. - Frase removida a pedido do titular (LGPD): a objeção continua listada, sem a citação. - Sem objeções: **Nenhuma objeção registrada para este lead — em conversa nenhuma.** ##### COMO A NOTA ANDOU O histórico da nota do lead e os sinais que a IA já capturou. Também aparece: - Gráfico de linha com as medições da nota e as fronteiras de morno (50) e quente (75) marcadas. Passe o mouse num ponto para ver a data e a nota. - Frase de resumo: **Subiu**, **Caiu** ou **Estável em ‹nota›** desde a primeira medição mostrada. - Com uma medição só, aparece o número da nota no lugar do gráfico, com a data da medição. - Cada sinal que a Qualificação pede aparece com **capturado** ou **ainda não** e, quando capturado, a frase do que a IA entendeu, marcada **como a IA entendeu**. ##### RITMO DA CONVERSA Mensagens por dia nos últimos 14 dias. Também aparece: - Barras separadas entre **Lead** e **Nosso lado**, com os totais na legenda. Dia sem mensagem fica vazio. - Embaixo, **A última coisa que ele disse, em ‹data›**, com a frase do lead. ##### ADERÊNCIA AO CLIENTE IDEAL Só aparece quando a conta descreveu o cliente ideal em Configurações. Também aparece: - Um anel de 0 a 100 e a frase de como a IA comparou o lead com o perfil, com a data da avaliação. ##### O QUE A IA GUARDOU DESTE LEAD A memória que a IA escreve para si mesma ao longo de todas as conversas do lead. Também aparece: - Texto da IA com a assinatura **Memória da IA · atualizada em ‹data›**. ##### ANOTAÇÕES DA EQUIPE A única parte do dossiê escrita pela equipe; fica presa ao lead, mesmo em conversas novas. Campos e filtros: - **O que o próximo atendente precisa saber?**: O texto da anotação. **Ctrl + Enter** salva; perto do limite de caracteres, o contador mostra quantos faltam. Botões e ações: - **Anotar**: Salva a anotação com o nome de quem escreveu e a data. - **Remover a anotação de ‹autor›**: A lixeira de cada anotação abre a confirmação **Remover esta anotação?**. Também aparece: - Sem anotações: **Ninguém anotou nada sobre este lead ainda.** - Se salvar falhar, o texto continua no campo com o aviso **Não foi possível salvar a anotação.** ##### Confirmação Remover esta anotação? Mostra quem escreveu e o texto. O resto do dossiê não muda, e a remoção não pode ser desfeita. Botões e ações: - **Remover anotação**: Apaga a anotação. - **Cancelar**: Mantém a anotação. ##### Assumir a conversa O rodapé do dossiê, com o lembrete **Ao assumir, o lead vê o nome do atendente — nunca o nome da IA.** Campos e filtros: - **Atendente** (obrigatório): Lista da equipe, começando em **Selecione…**. Escolha quem vai atender. Botões e ações: - **Assumir conversa**: Atribui a conversa ao atendente escolhido e abre ela no Inbox, pronta para responder. Fica apagado até alguém ser escolhido; durante o envio mostra **Assumindo…**. - **Devolver para a IA**: Tira a conversa da fila e devolve para a IA. Se falhar, o aviso diz que ela continua na fila. Quando a IA da conta foi desligada, o botão dá lugar à frase **A IA desta conta foi desligada: a conversa segue com a equipe.** ##### Estados da tela - Carregando: **Carregando a fila de transbordo…** até a primeira resposta (o cartão **Na fila agora** mostra um traço e diz carregando); o dossiê do lead escolhido aparece em blocos cinzentos até chegar. - Sem nada ainda: Sem ninguém na fila: **Nenhuma conversa aguardando transbordo humano.** - Se der erro: Se a fila não carregar: **Não foi possível carregar a fila de transbordo**, com o aviso de que pode haver gente esperando que a tela não conseguiu ler, e **Tentar de novo**. O cartão **Na fila agora** mostra um traço. - O dossiê do lead não carregou: O bloco mostra **Não foi possível carregar o dossiê**, pede para não decidir por ali até recarregar e oferece **Tentar de novo**. - Ainda não há votos nem notas: **Handoff accuracy** e **Satisfação (CSAT)** mostram um traço, com **sem feedback ainda** e **sem notas ainda**. ### Passo a passo #### Como assumir uma conversa que a IA passou para a equipe 1. Abra **Handoff** no menu. 2. Na **Fila de transbordo**, clique no lead que espera há mais tempo ou no mais quente. 3. Leia **Por que veio para um humano:**, **O QUE A IA JÁ COMBINOU** e **ONDE ELE TRAVOU**. 4. Em **Atendente**, escolha quem vai atender e clique em **Assumir conversa**: o Inbox abre na conversa, pronta para responder. #### Como devolver para a IA uma conversa que não precisava de humano 1. No **Handoff**, clique na conversa na fila. 2. Confira o motivo e o dossiê para ter certeza de que a IA dá conta. 3. Clique em **Devolver para a IA**: a conversa sai da fila e a IA retoma. #### Como deixar uma anotação para o próximo atendente 1. Abra o lead na fila do **Handoff** (ou o dossiê da conversa no Inbox). 2. Em **ANOTAÇÕES DA EQUIPE**, escreva no campo **O que o próximo atendente precisa saber?**. 3. Clique em **Anotar** ou aperte **Ctrl + Enter**. A anotação fica com o lead, inclusive em conversas futuras. #### Como medir se a IA está transferindo os leads certos 1. Peça à equipe para responder **A qualificação da IA está correta?** com **Concordo** ou **Discordo** no dossiê do Inbox depois de assumir. 2. Acompanhe o cartão **Handoff accuracy** no topo do Handoff. 3. Se a porcentagem estiver baixa, revise os sinais e os pesos em Qualificação. #### Como ver a satisfação dos leads por atendente 1. No **Handoff**, localize o cartão **Satisfação (CSAT)**. 2. Passe o mouse na pílula **por atendente** para ver a média e o número de notas de cada pessoa. ### Perguntas frequentes #### Qual a diferença entre assumir pelo Handoff e assumir pelo Inbox? O resultado é o mesmo: a conversa fica com a pessoa escolhida e a IA para. O Handoff mostra a fila com motivo, espera e dossiê lado a lado e deixa escolher outro atendente; no Inbox, quem responde assume para si ou escolhe alguém no botão de quem atende. #### Por que conversas já em atendimento continuam na fila do Handoff? A fila mostra quem aguarda humano e também quem já está com um atendente, para a gestão acompanhar os dois. O cartão **Na fila agora** conta só quem ainda está esperando. #### O que é Handoff accuracy? É a porcentagem de avaliações da equipe que concordaram com a qualificação da IA no momento do atendimento. Ela mostra se a IA está passando para humanos os leads certos. #### Assumir a conversa pelo Handoff envia alguma mensagem para o lead? Não. Assumir só muda quem atende e cala a IA. O lead recebe a primeira mensagem quando o atendente responde, já com o nome dele. #### Por que o resumo da IA está vazio no dossiê? O resumo é escrito no transbordo. Se a conversa ainda não foi transbordada, o bloco fica vazio de propósito; se foi e mesmo assim está vazio, a IA não conseguiu ler a conversa a tempo e preferiu não inventar. #### Quem pode apagar uma anotação da equipe? Qualquer pessoa da equipe com acesso ao dossiê, sempre depois da confirmação **Remover esta anotação?**. A remoção não pode ser desfeita. #### O tempo médio aguardando conta as conversas já atendidas? Não. Ele é a média de espera só das conversas que estão na fila agora, sem ninguém atendendo. ### Guia: Transbordo para humano Quando a conversa sai da IA e vai para uma pessoa do time, como isso acontece e o que o lead vê do outro lado. Nenhuma IA fecha tudo sozinha: mesmo quando ela conduz o pedido até o fim, é uma pessoa do time que confirma e segue daqui. O ponto em que ela passa a conversa para uma pessoa é o momento mais delicado do atendimento — e é o que esta tela cuida. #### Quando a conversa é passada - **O lead pediu**: "Quero falar com alguém", "me liga", "tem um atendente aí". A IA reconhece o pedido e para na hora, sem insistir. - **A IA não entendeu ou o lead se irritou**: Ela não entendeu o que a pessoa quis dizer, ou o lead ficou frustrado com o atendimento: a conversa vem para cá antes de piorar. Pergunta que ela não sabe responder não transfere sozinha, e ela não inventa: no padrão, diz que vai confirmar aquele detalhe com um especialista — frase que não abre transferência, então a conversa não aparece aqui por causa dela. Com **Conduzir até o pedido completo** ligado, ela diz que não tem a informação e pergunta se o lead quer falar com uma pessoa; se ele pedir, a conversa vem. - **O lead esquentou ou quer comprar**: A nota chegou na faixa Quente (75 pontos ou mais), ou ele disse que quer comprar já estando Morno (50 ou mais) ou com tudo o que a [Qualificação](https://attendto.com.br/manual/qualificacao) pede respondido. No **Modo atendimento** (venda direta, em [Configurações](https://attendto.com.br/manual/configuracoes) → IA & persona), quem diz que quer comprar transfere sem esperar a nota. Fora dele, intenção de compra de lead Frio não transfere: escolher uma opção ou passar um dado que a IA pediu ("Pix", "o original") não é pedido de compra, então ela segue qualificando, e a jornada registra **Intenção de compra sem evidência**. O que conta ponto é o que a Qualificação pede; as linhas dos 50 e dos 75 são fixas. Fora do horário de atendimento, este motivo não interrompe o lead: a conversa entra na fila sem aviso e a IA segue com ele até a equipe abrir. Se **Conduzir até o pedido completo** está ligado (conta nova já nasce assim), em [Configurações](https://attendto.com.br/manual/configuracoes#configuracoes) → IA & persona, este motivo em geral não transfere: a IA segue até o pedido completo. Ele só aparece aqui quando a IA não consegue responder com segurança naquela mensagem (a resposta foi barrada pela conferência ou o preço não está cadastrado): aí a conversa vem para a equipe com este motivo. - **O pedido ficou completo**: Com **Conduzir até o pedido completo** ligado, a mensagem em que o cliente responde o último item que a [Qualificação](https://attendto.com.br/manual/qualificacao) pede passa a conversa para cá com o motivo **Pedido completo**: ticket, aviso no sino e no celular e rodízio, como qualquer transbordo. O cliente lê o resumo do pedido escrito pela IA e que uma pessoa da equipe confirma tudo com ele por aqui. Fora do horário, ele não recebe aviso de horário e a conversa espera a abertura na fila. A IA continua respondendo até alguém assumir. - **Você entrou por conta própria**: Leu a conversa no Inbox e decidiu assumir. Não precisa de motivo nenhum. #### A frase que o lead lê na passagem Quando a IA passa a conversa, a frase muda conforme o motivo. Nenhuma promete prioridade ou prazo que a sua equipe não cadastrou. - **Esquentou ou quer comprar**: "Ótimo! Vou passar a conversa para uma pessoa da equipe, que segue com você daqui. É só um instante." - **Pediu uma pessoa**: "Claro! Vou chamar uma pessoa da equipe para falar com você. É só um instante." - **Se irritou**: "Sinto muito pelo transtorno. Vou chamar uma pessoa da equipe para te atender. É só um instante." - **A IA não entendeu**: "Vou chamar uma pessoa da equipe para seguir com você daqui. É só um instante." - **Fora do horário**: "Nossa equipe está fora do horário agora, mas a sua conversa ficou registrada e uma pessoa fala com você no próximo horário de atendimento. Enquanto isso, posso seguir te ajudando por aqui." Para quem se irritou, a frase começa pedindo desculpas. Quem esquentou ou quer comprar não ouve frase nenhuma: a IA segue a conversa e a sua equipe acha o lead na fila ao abrir. #### O que o lead vê Esta é a parte que mais importa e a que quase todo mundo erra. Quando você assume, o lead **passa a ver o seu nome**. Não o nome da IA, não "atendimento", não um robô com nome de gente. Como o nome aparece depende do canal. No **Web chat** ele fica acima da bolha, do mesmo jeito que você vê no painel. No **WhatsApp** e no **Instagram** não existe campo de remetente — toda mensagem chega do número e da conta da empresa —, então o nome vai no começo do próprio texto. É a única forma que esses dois canais permitem, e é o que impede o lead de passar uma hora conversando sem saber se está falando com uma pessoa. - **WhatsApp**: `*Luis Roberto:* Boa tarde, Augusto!` — em negrito, que é a marcação que o WhatsApp entende. - **Instagram**: `Luis Roberto: Boa tarde, Augusto!` — o Direct não tem negrito, então o nome vai em texto simples. - **Web chat**: `Boa tarde, Augusto!`, com **Luis Roberto** no topo da bolha — o widget mostra o nome, então ele não precisa ir no texto. - **E-mail**: `Luis Roberto: Boa tarde, Augusto!` no começo do corpo. O remetente do e-mail é o endereço da empresa, não o seu. No painel nada muda: você continua vendo só o que digitou, com o seu nome do lado de fora da bolha. O prefixo existe apenas na mensagem que sai. Há casos em que o nome não vai junto, por falta de lugar onde escrevê-lo: - **Modelo aprovado** — o texto é pré-aprovado pela Meta e não aceita acréscimo. - **Mensagem de voz** — é áudio; se quiser se apresentar, diga na própria gravação. - **Anexo sem legenda** — não há texto onde escrever; uma legenda que fosse só o seu nome seria ruído. - **SMS** — cada trecho da mensagem é cobrado à parte, e o tamanho do trecho muda conforme os acentos. Em vez de arriscar dobrar o custo de um envio, o nome não vai em SMS nenhum. - **Mensagem no limite de tamanho do canal** — aí a assinatura cai para a mensagem caber. Entregar vale mais que assinar. Fora esses casos, o nome vai sempre. Para quem está do outro lado, a conversa simplesmente continuou — só que agora com uma pessoa. Não há anúncio constrangedor de troca, não há repetição do que já foi dito. Todo o histórico continua ali. > **Leia antes de escrever:** O pior transbordo do mundo é o atendente que chega perguntando "em que posso ajudar?" depois de o lead já ter explicado tudo. A conversa inteira está na sua frente. Use. #### A tela de Handoff Na tela: Tela de Handoff com a fila de conversas aguardando atendimento humano. A fila de quem está esperando, com o motivo e há quanto tempo. 1. **Os números da fila**: Quantos esperam agora e há quanto tempo espera o mais antigo. Se **Tempo médio aguardando** cresce todo dia no mesmo horário, você descobriu onde falta gente. 2. **Quem está esperando**: Uma linha por conversa, com o motivo do transbordo e a temperatura do lead. Clique para abrir a ficha ao lado. 3. **O dossiê do lead**: Tudo que já se sabe dele: o que a IA combinou, onde ele travou, como a nota andou, o ritmo da conversa e as anotações da equipe. São os trinta segundos que você lê antes de escrever a primeira palavra — explicado em detalhe logo abaixo. No fim do dossiê ficam **Atendente** e **Assumir conversa**. Escolha quem vai atender e clique: o aviso logo acima do botão repete a única regra que não muda — o lead passa a ver o nome do atendente. Dá para assumir direto pelo [Inbox](https://attendto.com.br/manual/inbox) também. A diferença é que aqui a fila vem com o motivo, o tempo de espera e os sinais na frente — que é o que você precisa para decidir a ordem. #### O dossiê do lead É o relatório que aparece ao lado da fila — e o **mesmo** que fica no painel da conversa depois que você assume. Ele existe para você entrar sabendo, sem rolar a conversa inteira atrás do que já foi dito. Na tela: Dossiê do lead na tela de Handoff, com resumo da IA, objeções, gráficos e anotações. Tudo que já se sabe do lead, numa leitura só. 1. **O que a IA já combinou**: O resumo **desta conversa** e o próximo passo sugerido. Texto **da IA** — por isso vem sem aspas e assinado com a data. 2. **Onde ele travou**: O tipo da objeção é classificação da IA; a frase **entre aspas é do lead**, palavra por palavra. É o que você não deve fazê-lo repetir. 3. **Como a nota andou**: Ele esquentou ou esfriou, e **desde quando** — a lista de sinais só mostra o agora. As linhas pontilhadas, com o número escrito na ponta, são morno (50) e quente (75). Abaixo, cada sinal com o que a IA entendeu que ele disse. 4. **Ritmo da conversa**: Mensagens por dia, do lead e do seu lado. Dia vazio é silêncio de verdade. Embaixo, a última coisa que ele disse. 5. **O que a IA guardou**: A memória que ela escreve para si mesma nas conversas longas, com a data da última atualização. Logo abaixo ficam as **anotações da equipe**, a única parte do dossiê escrita por gente. - **O que a IA já combinou**: Uma ou duas frases do que ficou acertado **nesta conversa**, mais o próximo passo sugerido. É texto **escrito pela IA**, não fala do lead — por isso aparece sem aspas e assinado. O que foi combinado num fio anterior do mesmo lead não entra aqui: seria você cobrar hoje um acerto que esta conversa não teve. O resumo nasce **no transbordo** — no que a IA decide sozinha, no que um colega pede pelo botão "Gerar handoff para humano" e quando alguém assume uma conversa que ainda era dela; por isso o clique demora um instante, é ela escrevendo. **Enquanto ninguém transbordar, o bloco fica vazio, e isso é o esperado.** Depois de um transbordo ele também pode ficar vazio: quando a IA não consegue ler a conversa a tempo, ela prefere não escrever a escrever uma frase genérica — a tela diz que não há resumo em vez de inventar um. - **Onde ele travou**: As objeções que ele levantou, com a **frase literal** dele entre aspas. São do **lead**, não só deste fio: o que veio de uma conversa anterior aparece marcado assim, porque "achei caro" de março ainda vale hoje. O tipo (preço, prazo, confiança…) é classificação da IA; a frase é do lead. Quando há mais de doze, a lista mostra as mais recentes e diz de quantas são. Se o titular pediu a remoção da frase pela LGPD, a objeção continua listada e a citação some — a tela avisa. - **Como a nota andou**: A linha mostra a nota a cada medição, com as fronteiras de morno (50) e quente (75) marcadas e numeradas. Serve para uma pergunta que a lista de sinais não responde: ele **esquentou ou esfriou**, e desde quando. A nota é do **lead** e soma todas as conversas dele. Com uma medição só, aparece o número — um ponto não é uma linha. Nem toda mudança de nota vira ponto no histórico; quando a nota de agora não é a última medição registrada, a tela diz as duas. - **Ritmo da conversa**: Mensagens por dia nos últimos 14 dias, separadas entre o lead e o nosso lado. Dia sem mensagem aparece vazio de propósito: o silêncio conta. Doze do nosso lado para duas dele é um lead esfriando, e isso muda o tom da sua primeira frase. - **O que a IA guardou deste lead**: A memória que ela escreve para si mesma em conversas longas. Também é texto dela, não citação. Atravessa todos os fios do lead e só é reescrita de tempos em tempos — por isso vem com a data da última atualização, que costuma ser o fato mais velho da tela. - **De qual conversa é cada coisa**: Metade do dossiê é **desta conversa** (o resumo da IA, o humor do lead, o ritmo e a última fala dele) e metade é **do lead inteiro** (a nota, as objeções, a memória e as anotações). Cada bloco diz de qual dos dois está falando — um combinado emprestado de outro fio faria você cobrar o que ninguém prometeu aqui. - **Anotações da equipe**: O que **você** escreve para o próximo atendente. Fica presa ao lead: continua aqui amanhã, num fio de conversa novo. Remover pede confirmação, e tanto criar quanto remover ficam na trilha de auditoria — que registra quem, quando e o tamanho, nunca o texto: apagar a anotação apaga mesmo. Se o titular pedir o esquecimento (LGPD), as anotações sobre ele e a memória da IA somem junto. > **O dossiê não inventa:** Frase entre aspas é do lead, palavra por palavra. Texto sem aspas é da IA — inclusive a frase embaixo de cada sinal da nota, que é o que ela **entendeu** que ele disse, não o que ele digitou. E quando esta tela não consegue carregar, ela diz que **não conseguiu** — nunca mostra "nenhuma objeção" no lugar. A diferença entre "não tem" e "não sei" é a diferença entre uma decisão boa e uma ruim. #### Depois de resolver - **Devolva à IA** quando o assunto que exigia você acabou. Ela retoma o acompanhamento e continua chamando o lead se ele sumir. - **Encerre** quando a conversa terminou de verdade. Se o lead escrever de novo, ela reabre sozinha. - **Mova o cartão** no [Funil](https://attendto.com.br/manual/funil) se o negócio andou. Uma proposta enviada que fica parada em "Qualificando" some da sua cabeça em dois dias. #### Quando a fila começa a doer - **A fila vive com atraso marcado**: Ou o prazo está curto demais para o tamanho da equipe, ou a sua IA está passando conversa que ela poderia resolver. Antes de contratar gente, olhe os motivos de transbordo: se o mesmo assunto se repete, a resposta está faltando em [Base de conhecimento](https://attendto.com.br/manual/base-de-conhecimento) e o transbordo some sozinho. - **Todo mundo pede humano logo no começo**: Costuma ser desconfiança, não dúvida. Um tom mais direto e uma primeira resposta que já entrega algo útil reduzem isso — o tom se ajusta em [Configurações](https://attendto.com.br/manual/configuracoes). - **Assumi a conversa e o lead sumiu**: Confira o horário: se passou muito tempo desde a última mensagem dele, a janela do WhatsApp pode ter fechado e só um modelo aprovado entra. O campo de resposta avisa e oferece os modelos. Ver [Modelos de mensagem](https://attendto.com.br/manual/modelos-de-mensagem). - **Ninguém sabe de quem é a conversa**: Assumir é o que resolve: enquanto ninguém assume, a conversa fica de todos e de ninguém. Assuma antes de escrever, mesmo que você vá responder em dez segundos. > **Uma fila saudável é assim:** Vazia na maior parte do dia, com atraso raro e motivos variados. Motivo repetido é buraco de conteúdo; fila cheia o tempo todo é prazo mal escolhido ou equipe pequena — e as duas coisas se ajustam, mas não com o mesmo remédio. No painel: Abrir Handoff. Como as pessoas procuram: fila de transbordo; transbordo para humano; passar conversa da ia para atendente; assumir conversa do whatsapp; handoff accuracy; dossiê do lead; tempo de espera na fila; anotação para o próximo atendente; devolver para a ia; csat por atendente; por que a ia transferiu. ## Supervisão: como acompanhar as conversas e a carga de cada atendente URL: https://attendto.com.br/manual/supervisao Menu: Operação > Supervisão A Supervisão é a tela do gestor de atendimento: mostra ao vivo quantas conversas estão na fila, com a IA e com cada atendente, e abre qualquer conversa da equipe em modo somente leitura, com a leitura registrada na trilha de auditoria. Quando aparece: Aparece no menu só para o dono e os administradores da conta. ### Quem pode usar - Dono: Vê o pulso da operação, os cartões da equipe, a lista de conversas com todos os filtros e lê qualquer conversa. Cada leitura fica registrada na auditoria. - Admin: Mesmo acesso do dono, com o mesmo registro de leitura. - Atendente: Não vê o item no menu. Quem abre o endereço da Supervisão é levado de volta ao Painel, e as conversas dos colegas não são entregues. ### Telas #### Supervisão A tela Supervisão serve para o gestor ver quem está sobrecarregado agora, como cada atendente está indo no período e achar qualquer conversa da equipe por situação, banda, etiqueta, atendente ou busca. Endereço no painel: `/app/supervisao` ![Captura da tela Supervisão. A tela Supervisão serve para o gestor ver quem está sobrecarregado agora, como cada atendente está indo no período e achar qualquer conversa da equipe por situação, banda, etiqueta, atendente ou busca.](https://attendto.com.br/prints-do-manual/supervisao--visao-da-equipe.png) A tela Supervisão na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Pelo item **Supervisão** do menu, em OPERAÇÃO. O subtítulo diz **O que cada atendente está falando com cada lead**. Os filtros ficam no endereço da página, então um link copiado abre o mesmo recorte para outro gestor. ##### Pulso da operação **O agora é ao vivo; satisfação, transbordos e encerradas seguem o período.** Passe o mouse em cada número para ver a explicação. Campos e filtros: - **Na fila agora**: Conversas aguardando um humano assumir. Fica em destaque quando é maior que zero. - **Com a IA agora**: Conversas abertas que a IA conduz sozinha neste momento. - **Em atendimento humano**: Conversas abertas nas mãos de um atendente neste momento. - **IA pausada — sem saldo**: Conversas em que a IA parou porque o saldo acabou ou o teto de gasto foi atingido. Fica em vermelho quando é maior que zero. - **Satisfação (CSAT)**: Média das notas de 1 a 5 dadas no encerramento dentro do período, com o número de notas. - **Encerradas no período**: Conversas encerradas por atendentes dentro do período escolhido. Botões e ações: - **Hoje**: Período de hoje, contado à meia-noite do fuso da conta. - **7 dias**: Últimos 7 dias (o período padrão). - **30 dias**: Últimos 30 dias. - **Sempre**: Sem limite de data; útil quando a conversa procurada está fora das outras janelas. ##### Equipe **Clique num atendente para ver só as conversas dele.** Um cartão por pessoa da equipe. Campos e filtros: - **em atendimento**: O número grande do cartão: quantas conversas a pessoa tem agora. Com conversa ativa, um ponto pulsante aparece ao lado do nome. - **Última resposta**: Há quanto tempo a pessoa escreveu para um lead pela última vez, olhando os últimos 30 dias. Conta quem escreveu, mesmo que a conversa tenha sido devolvida ou repassada. - **CSAT**: Média de satisfação da pessoa no período e quantas notas ela recebeu. - **Transbordos**: Transbordos que a pessoa aceitou no período. - **Encerradas**: Conversas que a pessoa encerrou no período. Botões e ações: - **‹cartão do atendente›**: Clicar filtra a lista de conversas por aquela pessoa e muda o período para **Sempre**; clicar de novo solta o filtro. Também aparece: - O cartão mostra o papel da pessoa (**Dono**, **Admin** ou **Atendente**) e, quando ela não tem acesso ativo, o selo **Sem acesso** ou **Convite pendente**. ##### Conversas A lista das conversas da equipe no recorte escolhido, com carregamento contínuo ao rolar. Campos e filtros: - **Lead, telefone, empresa…**: Busca pelo nome, telefone, empresa ou e-mail do lead. Combina com todos os outros filtros. - **Etiquetas**: As mesmas etiquetas do Inbox e da Base de contatos. O número ao lado de cada uma conta as conversas do recorte atual; etiqueta que não traria nenhuma conversa não aparece. **Todas as etiquetas** desliga o filtro. Aqui a etiqueta só filtra: colocar e tirar é no Inbox. Botões e ações: - **Todas**: Mostra as conversas em qualquer situação. - **IA respondendo**: Só as conversas que a IA conduz. - **Aguardando humano**: Só as conversas na fila. - **Atendimento humano**: Só as conversas com um atendente. - **Aguardando recarga**: Só as conversas paradas por falta de saldo. - **Encerrada**: Só as conversas encerradas. - **Todas as bandas**: Desliga o filtro de banda. - **Quente**: Só leads na banda Quente. - **Morno**: Só leads na banda Morno. - **Frio**: Só leads na banda Frio. - **Sem score**: Só leads que ainda não têm nota. - **‹atendente› x**: Pílula do atendente escolhido no cartão; o **x** remove o filtro de atendente. - **Limpar filtros**: Desliga situação, banda, etiqueta, atendente e busca de uma vez. O período continua como está. - **‹conversa›**: Cada linha abre a conversa inteira em modo leitura. Também aparece: - Cada linha mostra o nome do lead, há quanto tempo foi a última atividade e a última mensagem com o nome de quem escreveu. - Selos da linha: a situação (em vermelho **IA pausada — sem saldo**; **IA calada — resposta pelo celular** quando alguém respondeu pelo celular), a banda com a nota, **com ‹atendente›** e o canal. ##### Estados da tela - Carregando: Blocos cinzentos ocupam o pulso, os cartões da equipe e a lista até os dados chegarem. - Sem nada ainda: Sem atendentes cadastrados: **Sua equipe ainda não tem atendentes**, com o caminho Configurações → Equipe para convidar alguém. - Se der erro: Se os números não carregarem, o pulso mostra um aviso com **Tentar de novo** e os cartões da equipe somem; se a lista falhar, ela avisa que nada foi perdido e oferece **Tentar de novo**. - Nenhuma conversa no recorte: A frase **Nenhuma conversa ‹recorte›** descreve todos os filtros ligados, inclusive o período, e sugere afrouxar um deles ou escolher **Sempre**. - As etiquetas não carregaram: Aparece **Não consegui carregar as etiquetas**, com **Tentar de novo**; a lista continua. - Atendente abre o endereço da tela: É levado ao Painel sem ver nada da Supervisão. #### Conversa em leitura A leitura de supervisão serve para o gestor ler na íntegra uma conversa da equipe, ao vivo, sem poder responder, transferir ou encerrar por ali. Endereço no painel: `/app/supervisao/‹…›` ![Captura da tela Conversa em leitura. A leitura de supervisão serve para o gestor ler na íntegra uma conversa da equipe, ao vivo, sem poder responder, transferir ou encerrar por ali.](https://attendto.com.br/prints-do-manual/supervisao--leitura-da-conversa.png) A tela Conversa em leitura na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Clicando numa conversa da lista da Supervisão. O título da tela diz **Supervisão** e o subtítulo **Conversa em leitura**. ##### Barra do topo O caminho de volta e o caminho para agir. Botões e ações: - **Voltar à supervisão**: Volta para a lista com os filtros que estavam ligados. - **Abrir no Inbox**: Abre a mesma conversa no Inbox, com todos os controles para atribuir, responder, devolver e encerrar. Também aparece: - Aviso fixo: **Leitura de supervisão, somente visualização — esta visita fica registrada na trilha de auditoria da conta.** ##### Cabeçalho da conversa Quem é o lead e em que situação a conversa está. Também aparece: - Avatar e nome do lead, com um ponto pulsante quando a conversa está aberta. - A banda com a nota, o canal e **com ‹atendente›** quando alguém atende. - A situação à direita: **IA respondendo**, **Aguardando humano**, **Atendimento humano**, **Encerrada**, **IA calada — resposta pelo celular** ou, em vermelho, **IA pausada — sem saldo**. ##### Mensagens A conversa exatamente como no Inbox, sem caixa de resposta. Botões e ações: - **Ouvir áudio**: Toca os áudios da conversa no player do painel. Também aparece: - Cada bolha traz o nome real de quem escreveu (a IA com o nome dela, o atendente com o dele), o horário e o recibo de entrega. - Anexos, áudios, respostas gravadas, avisos de mensagem não entregue e a leitura de imagens aparecem como no Inbox. - Mensagens novas entram sozinhas; a tela só acompanha o fim se você já estiver lá embaixo. ##### Estados da tela - Carregando: Bolhas cinzentas alternadas ocupam a conversa até ela chegar. - Se der erro: Se a conversa não carregar, aparece um aviso com **Tentar de novo**. - A conversa não existe mais: **Conversa não encontrada**: ela pode ter sido removida por anonimização (LGPD) ou o endereço veio incompleto. ### Passo a passo #### Como ver as conversas de um atendente específico 1. Abra **Supervisão** no menu. 2. Em **Equipe**, clique no cartão da pessoa: a lista de **Conversas** passa a mostrar só as dela, com o período em **Sempre**. 3. Para soltar o filtro, clique de novo no cartão ou no **x** da pílula com o nome. #### Como ler uma conversa de um atendente sem interferir 1. Na lista **Conversas** da Supervisão, clique na conversa. 2. Leia o histórico na tela de leitura: não há caixa de resposta nem botão de transferir. 3. Se precisar agir, clique em **Abrir no Inbox**. #### Como achar leads quentes esperando na fila 1. Na Supervisão, clique em **Aguardando humano**. 2. Clique em **Quente** na fileira de bandas. 3. Abra cada conversa e, para assumir, use **Abrir no Inbox**. #### Como achar conversas paradas por falta de saldo 1. Olhe o número **IA pausada — sem saldo** no **Pulso da operação**. 2. Na lista, clique em **Aguardando recarga** para ver quais são. 3. Recarregue em Saldo & Recargas ou assuma as conversas pelo Inbox, que o atendimento humano não depende de saldo. #### Como mandar um recorte da Supervisão para outro gestor 1. Ligue os filtros que quiser: situação, banda, etiqueta, atendente, período e busca. 2. Copie o endereço da página na barra do navegador. 3. Quem abrir o link (dono ou admin) vê exatamente o mesmo recorte. ### Perguntas frequentes #### O atendente fica sabendo que o gestor leu a conversa dele? A leitura fica registrada na trilha de auditoria da conta, com quem leu, qual conversa e quando. A tela de leitura avisa isso no topo. #### Dá para responder o lead pela Supervisão? Não. A leitura é somente visualização. Para responder, transferir ou encerrar, use **Abrir no Inbox**. #### Por que o número do cartão do atendente não bate com a lista filtrada por 7 dias? O número grande do cartão é a carga de agora, sem limite de data. Por isso, ao clicar no cartão, o período muda para **Sempre** e a lista passa a conter essas conversas. #### Quais números da Supervisão seguem o período escolhido? Satisfação, transbordos, encerradas e a lista de conversas seguem o período. Fila, IA, atendimento humano, sem saldo e o número grande de cada cartão são sempre o agora. #### Posso colocar etiqueta numa conversa pela Supervisão? Não. Na Supervisão a etiqueta só filtra a lista. Para colocar ou tirar etiqueta, abra a conversa no Inbox. #### Por que um atendente aparece com Convite pendente na Supervisão? A pessoa foi convidada em Configurações → Equipe e ainda não aceitou o convite. O cartão continua aparecendo para a carga e o histórico ficarem visíveis. #### Por que uma etiqueta some do menu quando eu troco de filtro? O menu só lista as etiquetas que trazem alguma conversa no recorte atual, e o número ao lado é quantas linhas o clique vai mostrar. Mudou o recorte, muda a lista. ### Guia: Supervisão da equipe O gerente vê quem está com quantas conversas, lê qualquer atendimento na íntegra e filtra a operação por atendente, status, banda, etiqueta e período. Quem gerencia um time de atendimento vive com duas perguntas: **quem está afogado agora** e **o que está sendo dito em meu nome**. A Supervisão responde as duas na mesma tela — números ao vivo por atendente em cima, e a leitura de qualquer conversa, na íntegra, a dois cliques. > **Tela de gerente:** Só **Dono** e **Admin** enxergam a Supervisão. O papel Atendente não vê o item no menu e o servidor recusa o acesso direto pela URL — não é esconderijo de link, é porta trancada. #### A visão por atendente O topo mostra o pulso de agora: quantas conversas aguardam um humano, quantas estão com a IA, quantas estão em atendimento e quantas pararam por falta de saldo. Logo abaixo, um cartão por atendente com a carga atual dele, há quanto tempo respondeu pela última vez, a satisfação (CSAT) do período, os transbordos que aceitou e as conversas que encerrou. > **IA pausada — sem saldo:** Este número em vermelho é o mais urgente da tela: são leads que escreveram e não tiveram resposta porque o saldo acabou ou o teto de gasto foi atingido. Resolva em [Saldo & Recargas](https://attendto.com.br/manual/saldo-e-recargas#saldo-e-recargas) — ou assuma a conversa no Inbox, que atendimento humano não depende de saldo. **Última resposta** e **encerradas** contam a autoria, não a posse: devolver a conversa para a IA ou repassá-la a um colega não apaga o que a pessoa escreveu, nem transfere o crédito para quem não atendeu. Na tela: Tela de Supervisão com o pulso da operação, os cartões da equipe e a lista de conversas filtrada 1. **Pulso da operação**: Fila, IA, atendimento humano e saldo são o AGORA — atualizam sozinhos conforme as mensagens chegam. Satisfação e encerradas seguem o período escolhido ao lado. 2. **Período**: Hoje, 7 dias, 30 dias ou Sempre. Vale para satisfação, encerradas e para a lista de conversas. Fila, IA, atendimento humano e o número grande de cada cartão NÃO seguem o período: são o agora. 3. **Um cartão por atendente**: O número grande é a carga de agora. Clique no cartão para a lista de baixo mostrar só as conversas daquela pessoa — clique de novo para soltar o filtro. 4. **Filtros que viram link**: Status, banda, etiqueta, atendente, período e busca moram no endereço da página. Copie a URL e mande para outro gerente: ele abre exatamente o mesmo recorte. 5. **O mergulho**: Cada linha abre a conversa inteira em modo leitura — quem falou o quê, com horário e recibo de entrega. Para agir, use o botão Abrir no Inbox. #### Ler sem interferir A leitura da Supervisão é **somente visualização**: não dá para responder, transferir nem encerrar por ali. É proposital — supervisionar é entender antes de agir. Quando for a hora de agir, o botão **Abrir no Inbox** leva à mesma conversa com todos os controles de sempre. - A conversa aparece exatamente como no Inbox: áudios, anexos, respostas gravadas, avisos de mensagem não entregue. - Mensagens novas entram sozinhas enquanto a tela está aberta — dá para acompanhar um atendimento delicado em tempo real. - O nome que aparece em cada bolha é o nome real de quem escreveu: a IA com o nome dela, o atendente com o dele. #### Toda leitura deixa rastro Abrir a conversa de um atendente na Supervisão fica registrado na trilha de auditoria da conta ([Compliance](https://attendto.com.br/manual/compliance#compliance)): quem leu, qual conversa e quando. Vale para todo mundo, inclusive para quem é dono da conta. > **Por que registramos — com todas as letras:** Supervisão é poder, e poder deixa rastro. O atendente pode ver na trilha que a conversa dele foi lida, e por quem. Isso protege os dois lados: o gerente mostra que acompanha com critério, e o time sabe que não existe leitura invisível. Releituras da mesma conversa pela mesma pessoa em sequência não se acumulam: a trilha guarda uma entrada por sessão de leitura (janela de 30 minutos), não uma por clique. #### Os filtros, um a um - **Atendente**: Clique no cartão da equipe. Só as conversas atribuídas àquela pessoa. - **Status**: IA respondendo, Aguardando humano, Atendimento humano ou Encerrada — o mesmo vocabulário do Inbox. - **Banda**: Quente, Morno, Frio ou Sem score — a banda BANT do lead, útil para conferir como o time trata os leads quentes. - **Etiqueta**: As MESMAS etiquetas que a equipe usa no [Inbox](https://attendto.com.br/manual/inbox) e na [Base de Contatos](https://attendto.com.br/manual/base-de-contatos) — é um vocabulário só. O número ao lado de cada etiqueta no menu já conta o recorte em que você está: com o período em 7 dias e um atendente escolhido, “Proposta 3” quer dizer três linhas nesta lista, não três no sistema inteiro. Etiqueta que não recorta nada aqui nem aparece na lista de opções. Aqui a etiqueta só **recorta**: aplicar e tirar etiqueta de um contato é no Inbox, porque a Supervisão é tela de leitura. - **Período**: Hoje, 7 dias, 30 dias ou **Sempre**, contando pela última atividade da conversa. O dia vira à meia-noite do fuso configurado em Configurações → Atendimento, não no do servidor. Clicar num cartão da equipe abre o período em Sempre: o número do cartão é o de agora, e ele não caberia numa janela de 30 dias. - **Busca**: Nome, telefone, empresa ou e-mail do lead. Combina com todos os outros filtros. No painel: Abrir a Supervisão. Como as pessoas procuram: supervisionar atendentes; ver conversas da equipe; monitorar atendimento do whatsapp; carga de cada atendente; csat por atendente; ler conversa do atendente; auditoria de leitura; filtrar conversas por banda; leads quentes na fila; conversas sem saldo; painel do gestor de atendimento. ## Tickets: o histórico de cada atendimento humano, do transbordo à resolução URL: https://attendto.com.br/manual/tickets Menu: Operação > Tickets Tickets é o registro dos atendimentos humanos: cada vez que uma conversa pede uma pessoa, nasce um ticket numerado com o assunto, quem assumiu e as datas de abertura e fechamento, para conferir o que ficou em aberto. ### Quem pode usar - Dono: Vê todos os tickets, filtra por situação, abre a conversa e resolve tickets. - Admin: Mesmo acesso do dono. - Atendente: Mesmo acesso: vê os tickets da conta, abre a conversa e resolve tickets. ### Telas #### Tickets A tela Tickets serve para conferir, uma vez por dia, se algum pedido de atendimento humano ficou sem ninguém, e para consultar quem atendeu cada episódio e quando ele terminou. Endereço no painel: `/app/tickets` ![Captura da tela Tickets. A tela Tickets serve para conferir, uma vez por dia, se algum pedido de atendimento humano ficou sem ninguém, e para consultar quem atendeu cada episódio e quando ele terminou.](https://attendto.com.br/prints-do-manual/tickets--lista-de-tickets.png) A tela Tickets na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Pelo item **Tickets** do menu, em OPERAÇÃO. O subtítulo da tela diz **Episódios de atendimento humano**. ##### Filtros Quatro botões no topo; só um fica ligado por vez. Campos e filtros: - **‹n› em aberto agora**: Contador à direita: quantos tickets da lista filtrada ainda não foram resolvidos. Com **Resolvidos** ligado, ele mostra zero. Se a lista falhar, diz **não foi possível contar os abertos**. Botões e ações: - **Todos**: Mostra os tickets em qualquer situação (o padrão). - **Abertos**: Só os tickets que pediram uma pessoa e ninguém assumiu. - **Em atendimento**: Só os tickets que alguém da equipe assumiu. - **Resolvidos**: Só os tickets encerrados. ##### Lista de tickets Uma linha por ticket. Botões e ações: - **Abrir conversa**: Abre no Inbox a conversa do ticket, onde se atende de verdade. - **Resolver**: Marca o ticket como resolvido e mostra **Ticket #‹n› resolvido**. Só fecha o registro: a conversa continua como estava. Não aparece em ticket já resolvido. Também aparece: - **#‹número›**: número fixo do ticket, que nunca se repete. - Avatar e nome do lead; contato anonimizado a pedido do titular aparece como **Contato removido**. - O assunto do atendimento, numa linha. - Quem assumiu, ou **Sem atendente**, e a data e hora de abertura seguida da de fechamento, quando houver. - A situação numa pílula colorida: **Aberto**, **Em atendimento** ou **Resolvido**. ##### Estados da tela - Carregando: Um cartão com **Carregando…** ocupa a lista. - Sem nada ainda: **Nenhum ticket por aqui**, com a explicação de que o ticket nasce quando uma conversa pede atendimento humano e se resolve quando ela é encerrada ou devolvida à IA. - Se der erro: **Não foi possível carregar os tickets**, com o aviso de que isso não quer dizer que não há atendimento em aberto e de que nenhum ticket foi encerrado por causa da falha, e **Tentar de novo**. - Resolver falhou: Aparece **Não foi possível resolver agora.** e o ticket continua na situação anterior. ### Passo a passo #### Como ver quem pediu atendimento humano e ninguém atendeu 1. Abra **Tickets** no menu. 2. Clique em **Abertos**. 3. Em cada linha, clique em **Abrir conversa** para atender pelo Inbox. #### Como fechar um ticket que já foi resolvido por fora 1. Em **Tickets**, encontre a linha pelo número ou pelo nome do lead. 2. Confirme pela conversa (**Abrir conversa**) que o assunto acabou mesmo. 3. Volte e clique em **Resolver**. A conversa não muda; só o registro fecha. #### Como encerrar o atendimento e o ticket juntos 1. Clique em **Abrir conversa** no ticket. 2. No Inbox, termine o assunto e clique em **Encerrar** (ou em **Devolver para a IA**). 3. O ticket fecha sozinho, com a data certa. #### Como consultar quem atendeu um cliente e quando 1. Em **Tickets**, clique em **Todos** ou **Resolvidos**. 2. Procure o nome do lead na lista. 3. Leia na linha quem assumiu e as datas de abertura e fechamento. ### Perguntas frequentes #### Preciso criar ticket manualmente? Não. O ticket nasce sozinho quando a conversa pede atendimento humano, e não duplica se a mesma conversa pedir de novo enquanto ele está aberto. #### Resolver o ticket avisa o cliente? Não. Resolver só fecha o registro nesta tela. Nenhuma mensagem é enviada e a conversa segue como estava. #### Um ticket resolvido pode ser reaberto? Não. Se o mesmo lead precisar de atendimento humano de novo, nasce um ticket novo, com outro número. #### Qual a diferença entre Tickets e Handoff? O Handoff é a fila de agora, com o dossiê para assumir. Tickets é o histórico de todos os episódios de atendimento humano, inclusive os que já terminaram. #### O contador de abertos vale para a conta inteira? Não. Ele conta os tickets não resolvidos da lista que está na tela, com o filtro escolhido. Para o total de abertos, deixe o filtro em **Todos** ou **Abertos**. #### O atendente pode resolver tickets de outro atendente? Pode. A tela mostra todos os tickets da conta para toda a equipe, e o botão **Resolver** aparece em qualquer ticket que ainda não foi resolvido. ### Guia: Tickets O histórico dos atendimentos humanos: número, assunto, quem assumiu e quando fechou. É registro, não fila de trabalho. Toda vez que uma conversa pede atendimento humano, nasce um ticket aqui. Ele guarda o essencial: o número, o assunto, quem assumiu, quando abriu e quando fechou. Quem está esperando **agora** você vê no [Transbordo para humano](https://attendto.com.br/manual/handoff), e o atendimento acontece no [Inbox](https://attendto.com.br/manual/inbox). Esta tela é a memória do que já passou. A decisão desta tela é curta e vale um minuto por dia: **ficou alguém em aberto que ninguém pegou?** Se ficou, você abre a conversa e resolve de verdade. Se não ficou, você fecha a tela e vai fazer outra coisa. #### A tela por partes Na tela: Tela de Tickets com os filtros no topo e três tickets listados, cada um com situação e botões de ação. Três tickets: um resolvido, um em atendimento e um aberto sem ninguém. 1. **Os quatro filtros**: **Todos**, **Abertos**, **Em atendimento** e **Resolvidos**. Só um deles exige ação: **Abertos** é gente que pediu uma pessoa e não foi atendida por ninguém. 2. **O contador conta a lista filtrada**: `2 em aberto agora` vale para o que está na tela, não para a conta inteira. Com o filtro **Resolvidos** ligado ele mostra 0 sempre — e isso não é boa notícia, é o filtro. 3. **Número, quem é e o assunto**: O número (`#1`, `#2`) é fixo e nunca se repete. O assunto resume o que a pessoa queria. Para descobrir o que mais tira a IA da conversa, você lê estas linhas a olho: a tela não junta assuntos parecidos. 4. **Quem assumiu e as duas datas**: O nome de quem pegou e o par abertura → fechamento. **Sem atendente** quer dizer que ninguém pegou. Não há cronômetro: quanto demorou é conta sua, olhando as duas datas. 5. **A situação**: **Aberto**, **Em atendimento** ou **Resolvido**. Não existe prioridade, urgência, cancelado nem reaberto — se o assunto voltar, nasce um ticket novo. 6. **Abrir conversa e Resolver**: **Abrir conversa** leva ao [Inbox](https://attendto.com.br/manual/inbox), que é onde se atende de verdade. **Resolver** fecha o registro aqui e mais nada. #### Os três estados, e só três - **Aberto**: A conversa pediu uma pessoa e ninguém assumiu. É o único estado que representa trabalho parado. - **Em atendimento**: Alguém do time assumiu a conversa. O nome de quem assumiu aparece na linha. - **Resolvido**: O episódio acabou. Ticket resolvido não volta atrás: se a mesma pessoa precisar de humano de novo, nasce um ticket novo, com número novo. O ticket nasce sozinho, no momento em que a conversa pede atendimento humano. Se a mesma conversa pedir de novo enquanto o ticket está vivo, **não duplica**: continua sendo um só. Por isso o número de tickets do dia é o número de episódios, não o número de mensagens aflitas. #### Resolver arruma a lista, não o atendimento > **O botão Resolver não encerra a conversa:** Clicar em **Resolver** limpa o registro daqui e nada mais. A conversa continua exatamente como estava — se uma pessoa estava atendendo, ela continua atendendo. Para acabar de verdade, é no [Inbox](https://attendto.com.br/manual/inbox): **Encerrar** ou **Devolver à IA**. Um ticket fecha de três jeitos, e dois deles nem acontecem nesta tela: - A conversa é **encerrada** no [Inbox](https://attendto.com.br/manual/inbox) — o ticket fecha junto. - A conversa é **devolvida à IA** — o episódio humano acabou, o ticket fecha junto. - Alguém clica em **Resolver** aqui — fecha só o registro. Use quando o atendimento já terminou por fora e a lista ficou suja. > **O caminho que evita mentira na lista:** Clique em **Abrir conversa**, termine o assunto no Inbox e encerre lá. O ticket fecha sozinho, com a data certa. Resolver por aqui sem passar pela conversa é o que produz lista limpa com cliente esperando. #### O que dá para ler aqui — e o que não dá Esta tela é uma lista honesta, não um painel. Ela mostra fatos: número, assunto, atendente, abertura, fechamento e situação. Com as duas datas você calcula quanto durou cada episódio, e lendo os assuntos em sequência você percebe o padrão do mês. - **Não existe** tempo médio de resposta nem de resolução: nenhum número desses é calculado aqui. - **Não existe** prazo combinado (o que muita gente chama de SLA) nem alarme de atraso. - **Não existe** agrupamento por assunto nem gráfico. A leitura é a olho, na lista. - Se o contato foi anonimizado a pedido dele, o nome vira **Contato removido** e o ticket permanece — o histórico do atendimento não some junto com os dados pessoais. Quer número, conversão e período comparado? É [Analytics](https://attendto.com.br/manual/analytics). Quer saber por que tanta gente pede humano? Os assuntos repetidos aqui costumam virar resposta nova na [Base de conhecimento](https://attendto.com.br/manual/base-de-conhecimento) ou ajuste em [Qualificação](https://attendto.com.br/manual/qualificacao). No painel: Abrir Tickets. Como as pessoas procuram: tickets de atendimento; histórico de atendimento humano; chamados em aberto; quem atendeu o cliente; resolver ticket; atendimento humano pendente; episódios de atendimento; registro de transbordo. ## IA própria: conectar os modelos de IA da sua empresa (OpenAI, Anthropic, Google, Azure, Bedrock) e escolher quem faz cada tarefa URL: https://attendto.com.br/manual/ia-propria Menu: Inteligência > IA própria A IA própria é a tela em que a empresa conecta os próprios modelos de IA, com a chave de API do provedor que ela escolheu, decide qual modelo faz cada tarefa do atendimento e acompanha saúde, consumo e segurança desses modelos. Quando aparece: Só aparece em conta do plano Enterprise com IA própria (ou do Plano sob medida que usa a IA da própria empresa, onde os textos trocam Enterprise pelo nome do plano). Não aparece em conta contratada por meio de um revendedor; sem o plano, o endereço direto volta ao Painel. ### Quem pode usar - Dono: Vê tudo. Com a verificação em duas etapas ativa, conecta, testa, pausa e troca a chave dos modelos, muda o roteamento e as regras, e é o único que muda contingência, gravação, permissões, avisos e teto. - Admin: Vê tudo. Muda modelos, roteamento e regras só se a conta não tiver ligado Só donos mudam modelos e regras, e também com a verificação em duas etapas ativa; os demais ajustes ficam com o dono. Exportar a trilha é liberado. - Atendente: Não vê o item no menu; quem abre o endereço direto volta para o Painel. ### Telas #### IA própria A tela IA própria serve para ativar o plano com os modelos da empresa, conectar e testar cada modelo, escolher o principal e a reserva de cada tarefa e acompanhar o uso justo do mês, a saúde e a segurança dos dados. Endereço no painel: `/app/ia-propria` Como chegar: Pelo menu, no grupo Inteligência, item IA própria com o selo Enterprise. Cada aba tem endereço próprio, então dá para mandar o link de uma aba específica. Quem usa: Dono, Admin. ##### Topo e contratação O atalho para o guia e, enquanto o plano está sendo contratado, o aviso com o passo da vez (assinar, pagar ou conectar). Botões e ações: - **Guia da IA própria**: Abre o guia da IA própria na Central de ajuda. - **Assinar agora**: Aparece só para quem assina pela empresa: abre o documento das Condições para assinatura eletrônica. - **Pedir reenvio**: Para os outros donos: pede que o documento seja reenviado a quem assina. - **Ler antes**: Abre as Condições do Plano Enterprise com os valores do contrato, para ler antes de assinar. - **Pagar agora**: Depois da assinatura, abre o link de pagamento da primeira mensalidade. - **Pagar a implantação**: Abre o link de pagamento da implantação, quando houver. - **Conectar o que falta**: Assinado e pago, abre a gaveta Conectar um modelo já no primeiro tipo que falta; se só falta escolher, leva ao Roteamento. Também aparece: - Avisos da contratação: Assine as Condições do Plano Enterprise para ativar, Falta pagar a primeira mensalidade e Enterprise ainda não ativo: as conversas vão para a sua equipe. ##### Topo da página (hero) O nome do plano, a situação da ativação e, depois de ativo, o uso justo do mês. Também aparece: - Selo Enterprise · IA própria e o título A inteligência é sua. A operação comercial roda aqui. - Pílulas: ‹n› modelos conectados (ou Nenhum modelo conectado), ‹n› tarefas roteadas e a contingência (Contingência: reserva, IA da plataforma, equipe ou Contingência: reserva, depois equipe). - Antes de ativar: as pílulas Enterprise ainda não ativo e Conversas com a sua equipe, e ‹n› modelos conectados, faltam ‹n›. - Quadro Ativação do Enterprise: pendente, ‹n› de ‹total› prontos, o medidor Modelos obrigatórios prontos com os tipos (conversa, busca, transcrição, fala) e a frase do que falta. Na contratação, os passos incluem assinatura e pagamento. - Quadro Uso justo do mês (depois de ativo): o selo no ritmo, acima do ritmo ou teto atingido, ‹n› de ‹n› mensagens, o medidor com a marca 80% avisa e a previsão No ritmo atual, o mês fecha em ‹n› mensagens. - Sem ciclo aberto: O primeiro ciclo começa quando a assinatura fica ativa. ##### Avisos abaixo do topo O que impede a mudança ou a ativação, com o atalho para resolver. Botões e ações: - **Abrir Configurações → Segurança**: Aparece quando a página está só para leitura porque falta a verificação em duas etapas. Leva à seção Segurança das Configurações. - **Conectar o que falta**: No aviso Enterprise ainda não ativo: as conversas vão para a sua equipe, abre a gaveta no primeiro modelo que falta. - **Pedir ajuda da implantação**: Abre um e-mail para o suporte com o assunto da implantação de busca e voz. Também aparece: - Aviso de leitura (cadeado): a frase de por que você lê sem poder mudar. - Depois de ativo, se a persona passou a responder áudio com áudio sem modelo de fala: A sua persona responde áudio com áudio, mas não há modelo de fala: a IA responde por texto. ##### Abas Cinco abas; a escolhida fica no endereço da página. Botões e ações: - **Visão geral**: Ativação, orquestração, indicadores e saúde dos modelos. - **Modelos**: Os modelos conectados, com a contagem ao lado do nome da aba. - **Roteamento**: Quem faz cada tarefa, regras por tipo de lead e o que acontece se os modelos falharem. - **Consumo**: Mensagens do mês, por dia, por modelo e os avisos do uso justo. - **Segurança e dados**: Permissões, o que sai para os modelos, gravação e trilha de alterações. Também aparece: - Teclado: setas para a esquerda e para a direita trocam de aba; Home vai para a primeira e End para a última. ##### Visão geral · Para ativar o Enterprise O cartão com cada modelo obrigatório e o que falta. Some quando a conta ativa. Botões e ações: - **Ler o guia**: Abre o guia na parte de ativação. - **Conectar**: Abre a gaveta Conectar um modelo já no tipo daquele passo. - **Escolher em Roteamento**: Para modelo já conectado que ainda não foi escolhido: leva à aba Roteamento. - **PDF assinado**: Na contratação, baixa o PDF das Condições assinadas. Também aparece: - Passos: Modelo de conversa, Modelo de busca (embeddings), Modelo de transcrição e Modelo de fala. - Selo de cada passo: pronto, não precisa (fala, quando a persona responde por texto) ou Lendo a base: ‹n›%. - Na contratação, os passos de assinatura e pagamento vêm antes dos modelos, com os selos assinado, pago e conectado. - Rodapé com quem oferece cada tipo: busca por OpenAI, Google, Azure OpenAI, Amazon Bedrock ou o seu servidor; transcrição por OpenAI, Google, Azure OpenAI ou o seu servidor; fala por OpenAI, Azure OpenAI ou o seu servidor. A Anthropic não tem modelos de busca nem de áudio. ##### Visão geral · Como a sua IA trabalha aqui dentro O diagrama da orquestração: os seus modelos de conversa à esquerda, o núcleo da plataforma no meio e os canais à direita. Também aparece: - Até três modelos aparecem; os demais viram +‹n› modelos, Ver em Modelos. O de conversa principal leva Principal. - Sem modelo: o nó A sua equipe, Enterprise ainda não ativo. - No núcleo: Intenção, Qualificação BANT, Perfil ideal, Conferência da resposta, Próxima melhor ação e Transbordo. - À direita: WhatsApp e Instagram (Atendimento), Agenda (Visitas e reuniões) e Funil e CRM (Até a venda). ##### Visão geral · Indicadores Quatro números dos últimos 7 dias. Também aparece: - Tempo de resposta: mediana de 7 dias, com a diferença para o período anterior. - Aprovadas na conferência: a porcentagem aprovada, com quantas foram reescritas e quantas viraram resposta segura. - Falhas dos seus modelos: a porcentagem e quantas foram cobertas pela reserva. - Custo estimado no seu provedor: pelos preços que você informou; sem preço, informe os preços em Modelos. ##### Visão geral · Saúde dos modelos agora As últimas 24 horas de cada modelo de conversa. Botões e ações: - **Ver modelos**: Leva à aba Modelos. - **Conectar um modelo**: Sem modelo conectado, leva à aba Modelos para conectar o primeiro. Também aparece: - Cada linha: provedor, nome, situação (no ar, lento, fora do ar ou pausado), tarefas, p50, sucesso e chamadas. - Aviso vermelho O ‹modelo› está fora do ar: a reserva e a contingência cobrem as tarefas dele. - Aviso amarelo quando um modelo está mais lento que a mediana dos últimos 7 dias, dizendo se isso atrasa a resposta ao lead. ##### Modelos Um cartão por modelo de conversa, o cartão para conectar outro e a grade Busca e voz. Botões e ações: - **Testar agora**: Abre o diálogo para testar o modelo de novo. - **Trocar chave**: Abre o diálogo para colar uma chave nova (provedores de nuvem). - **Editar**: No modelo de servidor próprio, abre a gaveta para mudar endereço, modelo, nome ou preço. - **Pausar**: Tira o modelo das tarefas sem apagá-lo; o botão vira Retomar. - **Retomar**: Volta o modelo pausado às tarefas. - **Conectar um modelo**: Cartão no fim da grade: abre a gaveta no tipo conversa. Lista OpenAI, Anthropic, Google, Azure, Bedrock ou o seu servidor. - **Ler o guia**: Sem nenhum modelo, abre o guia na parte de conectar. Também aparece: - Cartão do modelo: provedor, nome, a linha de origem (chave mascarada, endereço ou região e desde quando) e a situação. - Números: p50, sucesso e o preço por milhão (ou sem preço; no servidor próprio, servidor seu). - Selos do teste: Português, JSON estruturado, JSON com correção ou JSON reprovado, o contexto provado e as chamadas simultâneas. - Busca e voz: cartões com o selo Busca, Transcrição ou Fala; a busca mostra por busca, posições e preço; transcrição e fala mostram o tempo, sucesso e preço por minuto. Modelo sem tarefa aparece como sem tarefa. - Sem modelo de busca, transcrição ou fala: Nenhum modelo de busca, de transcrição ou de fala, com Conectar o que falta. ##### Diálogo Testar ‹modelo› de novo Roda de novo as checagens do modelo. Botões e ações: - **Testar agora**: Roda as checagens. O custo do teste aparece no rodapé antes; se for preciso esperar, a frase conta os segundos e o botão libera no fim. - **Cancelar**: Fecha sem testar; depois de começar, o botão vira Fechar. Também aparece: - Conversa: A chave conecta, Responde em português do Brasil, Devolve JSON no formato pedido, Aguenta uma conversa longa com a base e Atende chamadas ao mesmo tempo. - Se a chave falhar: A chave não conectou. Confira a chave e o modelo e teste de novo. ##### Diálogo Trocar a chave d‹o modelo› Cola uma chave nova, que é testada no provedor antes de valer. Campos e filtros: - **Chave de API** (obrigatório): A chave nova (Cole a chave nova). Fica cifrada; depois de salva, aparece só o começo e o fim. No Bedrock, aceita a chave do Bedrock ou o par de chaves de acesso. Botões e ações: - **Trocar chave**: Testa e grava a chave nova; avisa Chave trocada. Se o provedor recusar, o motivo aparece no próprio campo. - **Cancelar**: Fecha e apaga o que foi digitado. ##### Gaveta Conectar um modelo Três passos: escolher para que é e o provedor, preencher a chave e o modelo, testar e salvar. A mesma gaveta abre de todos os botões Conectar da página. Campos e filtros: - **Chave de API** (obrigatório): A chave do provedor. Fica cifrada e só é usada pelas suas tarefas. - **Modelo**: Lista de modelos sugeridos do provedor; Outro modelo… abre o campo Nome do modelo. - **Nome do modelo**: O nome exato do modelo, quando ele não está na lista. - **Nome da implantação**: No Azure OpenAI, o nome da implantação no lugar do modelo. - **ID do modelo**: No Amazon Bedrock, o ID do modelo. - **Endereço** (obrigatório): No servidor próprio, o endereço compatível com a API da OpenAI. - **Endereço do recurso** (obrigatório): No Azure OpenAI, o endereço do recurso. - **Região da AWS** (obrigatório): No Amazon Bedrock, a região da conta. - **Seu preço por milhão de tokens (opcional)**: Preço de entrada e de saída. Serve só para estimar o custo nas telas; a cobrança é do seu provedor. - **Seu preço por minuto de áudio (opcional)**: No modelo de transcrição, para estimar o custo. - **Seu preço por minuto de fala (opcional)**: No modelo de fala, para estimar o custo. - **Nome nesta conta**: Como o modelo aparece nas telas e na tabela de Roteamento. Botões e ações: - **Conversa e tarefas**: Passo 1, Para que é este modelo: responde, qualifica, resume. - **Busca na base**: Passo 1: modelo de embeddings da base de conhecimento. - **Transcrição do áudio**: Passo 1: ouve o áudio que o lead manda. - **Resposta falada**: Passo 1: responde áudio com áudio. - **OpenAI**: Provedor. Cada cartão diz o que ele oferece no tipo escolhido ou por que não oferece. - **Anthropic**: Provedor só de conversa: não tem modelo de busca nem de áudio. - **Google**: Provedor de conversa, busca e transcrição; fala ainda não. - **Azure OpenAI**: Provedor na assinatura da empresa, para todos os tipos. - **Amazon Bedrock**: Provedor na conta AWS da empresa, para conversa e busca; transcrição e fala ficam fora. - **Seu servidor**: Servidor da empresa compatível com a API da OpenAI. - **Colar outra chave**: Na busca e na voz, troca A mesma d‹o modelo› por uma chave nova. - **Continuar**: Vai do passo 1 para o passo 2. - **Voltar**: Volta um passo; no primeiro, o botão é Cancelar e fecha a gaveta. - **Testar o modelo**: Roda as checagens do tipo escolhido. O custo do teste aparece no rodapé antes. - **Testar de novo**: Quando o teste reprova, roda de novo depois de corrigir. - **Salvar modelo**: Salva o modelo aprovado; avisa Modelo conectado. Nenhuma tarefa muda até você escolher no Roteamento. - **Salvar**: Na edição: nome e preço salvam direto; endereço ou modelo mudado é testado de novo antes. Também aparece: - Na edição, o título vira Editar ‹o modelo› e o endereço antigo aparece como Antes: ‹endereço›; mudar o endereço pede a chave de novo. - Resultados: Pronto para usar (ou Pronto para a busca, Pronto para transcrever, Pronto para falar), Pronto, com uma limitação (sem JSON no formato pedido) e A chave não conectou. - Busca: Gera o vetor de um trecho em português, Acha o trecho certo numa busca de exemplo, Responde rápido o bastante para a conversa e a leitura de um lote de trechos, com a Busca de exemplo. - Transcrição: um áudio de exemplo em português, o acerto das palavras (com Ouvir) e o áudio do WhatsApp. Fala: uma fala curta em português, no formato que o WhatsApp aceita, com Ouvir a fala na voz da persona. - Na reprovação de busca e voz: Veja acima o que falhou. Ele não é salvo. ##### Roteamento · Quais dos seus modelos leem imagem Os modelos que servem para a leitura de imagem, conferidos no teste com uma foto de exemplo. Também aparece: - Cada modelo com o selo lê imagem, só texto, modelo de busca, modelo de transcrição, modelo de fala ou teste de novo. ##### Roteamento · Quem faz cada tarefa A tabela que escolhe o modelo principal, a reserva e mostra o tempo-limite de cada tarefa. Cada escolha salva na hora. Campos e filtros: - **Tarefa**: O nome e a descrição da tarefa, com o selo rota própria quando ela não segue a conversa. - **Modelo principal**: Quem responde a tarefa. Opções: os seus modelos permitidos, IA da plataforma (incluída) ou, na intenção, Decisor da plataforma (incluído). - **Reserva**: Quem assume se o principal falhar ou passar do tempo; Nenhuma deixa sem reserva. Só libera com principal escolhido. - **Tempo-limite**: O tempo máximo da chamada antes de a reserva assumir; da conversa ou padrão da tarefa quando herdado. Botões e ações: - **Seguir a conversa (‹modelo›)**: Nas tarefas que podem seguir a conversa: usa o principal, a reserva e o tempo-limite da Conversa com o lead. - **Conectar**: Na linha de busca, transcrição, fala ou imagem sem modelo: abre a gaveta no tipo daquela linha. - **Escolha o modelo de busca**: Na linha da busca: escolher um modelo abre o diálogo da leitura da base. - **Mostrar todas**: Mostra os grupos Seguem a conversa, Bastidores e Funcionam por regras, sem modelo de IA; o botão vira Mostrar menos. - **Usar como principal**: Confirma no diálogo Usar ‹modelo› como principal? quando o modelo escolhido era a reserva da tarefa, que fica sem reserva. - **Cancelar**: Fecha a confirmação sem mudar. Também aparece: - No topo, a estimativa ‹valor› / mês estimado, pelos preços informados em Modelos. - Busca, voz e imagem: cada linha só aceita modelos do tipo dela. Sem modelo aparece falta um modelo de busca (ou de transcrição, de fala, com visão). A reserva da busca é sempre a Busca por palavras, sem modelo; a reserva da fala pode ser Nenhuma (responde por texto); a da imagem, Nenhuma (a equipe vê a foto). - Bastidores: tarefas que não falam com o lead e rodam por trás para preparar a conta. - Funcionam por regras, sem modelo de IA: Por regras, sem custo; estão ali para mostrar todos que atendem o lead. - Rodapé com quantas tarefas seguem o modelo da conversa e quantas têm rota própria. ##### Roteamento · Leitura da base (troca do modelo de busca) Trocar o modelo de busca faz a base de conhecimento ser lida de novo; a tela mostra a estimativa antes. Botões e ações: - **Trocar e ler a base de novo**: Confirma a troca e começa a leitura; a busca segue no modelo atual até a base nova ficar completa. - **Voltar agora**: Volta a um modelo de busca usado nos últimos 7 dias: a troca é imediata e sem custo. - **Manter ‹modelo›**: Fecha sem trocar; na primeira escolha, o botão é Agora não. - **Cancelar a troca**: Durante a leitura, desiste e mantém o modelo atual. - **Retomar de onde parou**: Se a leitura parou por falha do provedor, continua do ponto em que estava. - **Desistir da troca**: Se a leitura parou, desiste e mantém o modelo atual. - **Entendi**: Fecha o aviso de leitura concluída. Também aparece: - O diálogo mostra os trechos e as fontes, os tokens e o custo estimado no seu provedor, e quanto tempo leva. - Durante a leitura: Lendo a base de novo com ‹modelo›, ‹n› de ‹n› trechos, com barra de progresso. - A base de hoje fica guardada por 7 dias para voltar sem custo. ##### Roteamento · Regras por tipo de lead Regras que trocam o modelo da conversa para certos leads; valem por cima da tabela, de cima para baixo, e a primeira que bater decide. Campos e filtros: - **Quando a regra vale**: A condição: o perfil ideal, houver objeção ou o cartão tiver a etiqueta. - **Nota mínima do perfil ideal**: Com a condição do perfil ideal: ‹n› ou mais. - **Objeção**: Com a condição de objeção: o tipo de objeção (ou a combinação salva). - **Etiqueta**: Com a condição de etiqueta: qual etiqueta do cartão. - **Modelo da regra**: O modelo de conversa que atende os leads da regra. Botões e ações: - **Nova regra**: Acrescenta uma regra. Sem modelo conectado, fica apagado com a dica Conecte um modelo para criar regras. - **Arrastar para mudar a ordem**: Alça para arrastar a regra. No teclado: espaço pega, setas para cima e para baixo movem, espaço solta e Esc cancela. - **Remover regra**: Abre a confirmação Remover esta regra?. - **Remover**: Confirma: as conversas da regra voltam a seguir a tabela. Também aparece: - Sem regras: Nenhuma regra. Todas as conversas seguem a tabela acima. ##### Roteamento · Se os seus modelos falharem A ordem que a mensagem segue até ser respondida; o lead nunca fica sem resposta. Botões e ações: - **A IA da plataforma** (Dono): O 2º passo é um botão de liga e desliga: ligado, a IA da plataforma responde só enquanto os seus modelos estiverem fora, com custo por uso no relatório do mês. Também aparece: - 1º A reserva da tarefa: sempre ligado. - 3º A sua equipe: a conversa vai para a fila com o aviso de que os modelos estão fora. - Na busca e na voz: a busca cai para a busca por palavras (a IA da plataforma não entra); a transcrição cai para a reserva, a IA da plataforma (se ligada) e a equipe, que recebe o áudio; a fala cai para a reserva, a IA da plataforma (se ligada) e, por fim, a resposta por texto. ##### Consumo As mensagens do ciclo, a previsão, o uso por modelo e os avisos do uso justo. Campos e filtros: - **Teto de excedente**: Até quanto a conta passa das mensagens incluídas: Sem teto ou ‹n› mil. Acima dele, nem a IA da plataforma nem os seus modelos respondem e a conversa vai para a equipe. Botões e ações: - **Este mês**: Mostra o gráfico Mensagens por dia do mês corrente. - **Mês passado**: Mostra o mês anterior; sem dados, Sem mensagens no mês passado. - **Aviso aos 80%** (Dono): Interruptor de Aos 80% das mensagens: e-mail e sino para os donos da conta. - **Aviso ao passar** (Dono): Interruptor de Ao passar das incluídas: avisa quando o excedente começa a entrar na fatura do mês. Também aparece: - Mensagens no mês: ‹n› de ‹n› incluídas · ‹n›%. - Previsão de fechamento: dentro do uso justo, acima do uso justo ou teto atingido. - Leads e transbordos: ‹n› leads, ‹n› quentes, ‹n› transbordos, sem cobrança. - Mensagens por dia: mensagem é cada fala do lead respondida pela IA, em qualquer canal. Legenda: dias passados, hoje e previsão. - Por modelo: tabela com Modelo, Entrada, Saída e Custo, em tokens e custo estimado pelos seus preços. - Quando a contingência foi usada, as linhas do que rodou na IA da plataforma (mensagens, tarefas de bastidor e áudios) com o valor. - Teto atingido: O teto de excedente do mês foi atingido; as conversas vão para a equipe até o mês virar ou até o teto mudar. ##### Segurança e dados Permissões da página, o que sai para os modelos, a gravação e a trilha de alterações. Campos e filtros: - **Gravação**: O que fica guardado das chamadas aos modelos: o texto das chamadas ou só números (tokens e tempo). Botões e ações: - **Só donos** (Dono): Interruptor de Só donos mudam modelos e regras: ligado, administradores veem sem editar. - **Duas etapas** (Dono): Interruptor de Exigir verificação em duas etapas para mudar esta página. - **Rotação** (Dono): Interruptor de Lembrar de trocar as chaves, a cada 90 dias. - **Exportar**: Baixa a trilha de alterações. Liberado para quem lê a página. - **Baixar PDF assinado**: No cartão Condições do Plano Enterprise · ‹número›, baixa o contrato assinado. Também aparece: - Chaves e acesso: as chaves ficam cifradas e nunca aparecem inteiras de novo. - O que sai para os seus modelos: Vai (conversa recente, contexto da empresa, trechos da base e, nos bastidores, números do painel sem nome nem contato) e Não vai (telefone, e-mail e documento do lead, trocados por marcadores). - Nota do áudio: o áudio do lead vai como está para o modelo de transcrição e o texto da resposta para o de fala; na busca, a pergunta vai com os dados pessoais mascarados. - Trilha de alterações: tudo o que mudou na página, com quem mudou e quando; sem itens, Nenhuma alteração ainda. ##### Estados da tela - Carregando: Carregando a IA própria…, com blocos cinza no lugar do conteúdo. - Sem nada ainda: Sem nenhum modelo, a aba Modelos mostra Conecte o primeiro modelo, explicando que as conversas vão para a equipe até os modelos estarem conectados e testados, com Conectar um modelo e Ler o guia. - Se der erro: Não conseguimos carregar a IA própria agora, com o botão Tentar de novo. - Plano ainda não ativo: As pílulas Enterprise ainda não ativo e Conversas com a sua equipe e o aviso amarelo: a IA não responde nenhum lead e cada conversa entra na fila da equipe com o motivo. - Conta sem permissão de mudar: O aviso com cadeado explicando o motivo; botões de mudança ficam apagados. - Teto de excedente atingido: O selo teto atingido no topo e o aviso na aba Consumo para aumentar ou tirar o teto. ### Passo a passo #### Como conectar um modelo da OpenAI, Anthropic ou Google com a chave de API 1. Ative a verificação em duas etapas em Configurações → Segurança, se ainda não estiver ativa. 2. Em **IA própria**, aba **Modelos**, clique em **Conectar um modelo**. 3. Escolha **Conversa e tarefas** e o provedor, e clique em **Continuar**. 4. Cole a **Chave de API**, escolha o **Modelo** e, se quiser, informe o preço e o **Nome nesta conta**. 5. Clique em **Testar o modelo** e, aprovado, em **Salvar modelo**. #### Como ativar o plano Enterprise com IA própria 1. Na **Visão geral**, siga o cartão **Para ativar o Enterprise** de cima para baixo. 2. Na contratação, use **Assinar agora** e depois **Pagar agora**. 3. Clique em **Conectar** em cada modelo que falta (conversa, busca, transcrição e, se a persona fala, fala). 4. Para modelo já conectado, use **Escolher em Roteamento** e escolha-o na linha da tarefa. #### Como escolher qual modelo responde cada tarefa e a reserva 1. Abra a aba **Roteamento**. 2. Na tabela **Quem faz cada tarefa**, escolha o **Modelo principal** da tarefa. 3. Escolha a **Reserva**, que assume se o principal falhar ou passar do tempo. 4. Clique em **Mostrar todas** para ver as tarefas que seguem a conversa e as de bastidores. #### Como trocar a chave de API de um modelo 1. Na aba **Modelos**, clique em **Trocar chave** no cartão do modelo. 2. Cole a chave nova no campo **Chave de API**. 3. Clique em **Trocar chave**: ela é testada no provedor e vale na hora. #### Como trocar o modelo de busca da base de conhecimento 1. Na aba **Roteamento**, na linha da busca, escolha o novo modelo. 2. Leia a estimativa de trechos, tokens e tempo no diálogo. 3. Clique em **Trocar e ler a base de novo**; a busca continua no modelo atual até a leitura terminar. 4. Se a leitura parar, use **Retomar de onde parou** ou **Desistir da troca**. #### Como usar um modelo diferente para leads de perfil ideal 1. Na aba **Roteamento**, no cartão **Regras por tipo de lead**, clique em **Nova regra**. 2. Em Quando, escolha o perfil ideal e a nota mínima. 3. Escolha o modelo que vai atender esses leads. 4. Arraste as regras para pôr a mais importante no topo: a primeira que bater decide. #### Como definir um teto de mensagens excedentes 1. Abra a aba **Consumo**. 2. Em **Avisos do uso justo**, escolha o **Teto de excedente** (ou **Sem teto**). 3. Ligue **Aviso aos 80%** e **Aviso ao passar** para ser avisado antes (só o dono). ### Perguntas frequentes #### Quais provedores de IA posso conectar? OpenAI, Anthropic, Google, Azure OpenAI, Amazon Bedrock ou um servidor da sua empresa compatível com a API da OpenAI. Cada tipo de modelo (conversa, busca, transcrição e fala) tem os provedores que o oferecem. #### Por que o atendente não vê a IA própria? A página é de dono e administrador. Para o atendente o item não aparece no menu, e o endereço direto volta ao Painel. #### Salvar um modelo já muda o atendimento? Não. O modelo salvo aparece no Roteamento, mas nenhuma tarefa muda até você escolhê-lo como principal ou reserva. #### Qual a diferença entre Pausar e trocar o modelo no Roteamento? Pausar tira o modelo de todas as tarefas de uma vez, sem apagar nada, e Retomar o devolve. No Roteamento você troca o modelo de uma tarefa específica. #### Testar o modelo tem custo? O teste faz chamadas reais ao seu provedor. O custo do teste aparece no rodapé antes de clicar em Testar, e quem cobra é o provedor. #### O que acontece com a chave depois de salva? Ela fica cifrada e nunca mais aparece inteira: a tela mostra só o começo e o fim. Para mudar, use Trocar chave. #### Posso mandar o link de uma aba específica? Pode. A aba aberta fica no endereço da página, então o link abre direto em Modelos, Roteamento, Consumo ou Segurança e dados. #### O que é a trilha de alterações? É o registro de tudo o que mudou na página, com quem mudou e quando. Pode ser exportada por quem lê a página. ### Guia: IA própria Conecte os modelos da sua empresa, escolha qual deles faz cada tarefa e acompanhe saúde, consumo e segurança. A operação comercial continua rodando aqui. No plano Enterprise, a inteligência é da sua empresa: você conecta os modelos que já usa ou contrata, escolhe qual faz cada tarefa e a plataforma cuida da conversa no WhatsApp e no Instagram, da qualificação, do funil, da agenda e do transbordo. **Todo agente que usa um modelo de IA para a sua conta usa os seus modelos** — os que falam com o lead e os que trabalham nos bastidores. **Leads, qualificações e transbordos não são cobrados no seu plano**; o uso dos modelos é cobrado pelo seu provedor, direto na sua conta com ele. > **Quem vê esta página:** Dono e administrador da conta veem tudo. Para **mudar** alguma coisa, a conta pede a verificação em duas etapas ativa, em **Configurações → Segurança**. Modelos, rotas e regras são dos donos (ou também dos administradores, se a conta deixar); contingência, gravação, permissões, avisos e teto são sempre dos donos. #### A tela por partes Na tela: Visão geral da IA própria: o uso justo do mês no alto, o diagrama da orquestração e os indicadores. A Visão geral responde, de relance, se a sua IA está saudável e quanto do mês já foi usado. 1. **O que está ligado**: Quantos modelos estão conectados, quantas tarefas podem ir aos seus modelos e o que acontece se eles falharem. 2. **Uso justo do mês**: As mensagens respondidas pela IA no mês, de quantas estão incluídas, e onde o mês fecha no ritmo atual. Aos 80% você recebe um aviso. 3. **Como a sua IA trabalha aqui dentro**: Os seus modelos de um lado, os canais do outro e, no meio, a orquestração: contexto da empresa, base de conhecimento, memória do lead, conferência da resposta e regras. 4. **Os quatro números**: - **Saúde dos modelos agora**: Para cada modelo: se está **no ar**, **lento**, **fora do ar** ou **pausado**, em quais tarefas trabalha e o tempo (p50), o sucesso e as chamadas das últimas 24 horas. - **Lento**: Na última hora, o modelo ficou mais que o dobro da própria mediana dos últimos 7 dias. A tela diz quais tarefas dele atrasam a resposta ao lead e em quanto tempo a reserva assume. - **Fora do ar**: O teste automático de hora em hora não conseguiu falar com o modelo duas vezes seguidas. A reserva e a contingência cobrem as tarefas dele, e os donos recebem um aviso. #### Ativar o Enterprise: assinar, pagar e conectar O Enterprise liga quando três coisas estão prontas: as **Condições do Plano Enterprise** assinadas, a **primeira mensalidade** paga e os modelos da sua empresa conectados. No Enterprise, tudo o que a IA faz pela sua conta roda nos seus modelos — inclusive ler a base de conhecimento e ouvir os áudios —, por isso entram um modelo de conversa e os de **busca, transcrição e fala** conectados, testados e escolhidos no Roteamento. Enquanto falta algo, um aviso no alto da página diz o que é, e o card **Para ativar o Enterprise** mostra os passos na ordem, com o que já foi feito marcado — inclusive os modelos que você conectou antes de assinar. 1. **Assinar as Condições do Plano Enterprise**: O documento chega por assinatura eletrônica para quem assina pela sua empresa, com o resumo do que foi combinado: nível, mensalidade, mensagens incluídas e fidelidade. Só essa pessoa vê **Assinar agora**; os outros donos veem para quem o documento foi enviado e podem **Pedir reenvio**. **Ler antes** abre o mesmo texto aqui no painel. O link vale 30 dias. 2. **Pagar a primeira mensalidade**: O link chega por e-mail aos donos da conta assim que as duas partes assinam — antes disso o passo aparece travado, com "depois da assinatura". Ele cobre a implantação e a primeira mensalidade. Os 7 dias para desistir contam a partir do pagamento, com devolução de tudo. 3. **Conectar a busca**: E o modelo de conversa: a busca na base só conta com ele pronto. Se ele ainda falta, o botão abre a conversa primeiro. 4. **Conectar a transcrição**: O áudio do lead vira texto no seu modelo. 5. **Conectar a fala**: Só aparece se a sua persona responde áudio com áudio; sem ela, a IA responde por texto. > **Conectar antes de assinar:** Você pode conectar os modelos antes de assinar. Nada dos seus modelos responde lead antes de o Enterprise ativar; até assinar e pagar, a conta segue no plano em que estava. Depois de ativado, o PDF assinado fica na **Carteira**, em **Contrato e documentos**, e aqui, na aba **Segurança e dados**. > **Enquanto não ativar, a IA não atende:** Cada conversa vai para a fila da sua equipe com o motivo ("Enterprise ainda não ativo: falta conectar …"), o lead recebe uma vez a frase de transbordo de sempre, os donos recebem um aviso por e-mail e no sino, e a mensalidade do plano já corre. Os pedidos à IA (Pergunte à IA, ajuste da qualificação, gerador de segmento, recalcular o cliente ideal) respondem "O Enterprise ainda não está ativo: conecte o que falta em IA própria para a IA trabalhar." e o passo de IA da régua é pulado. Depois de ativado, nada da conta volta à IA da plataforma por falta de modelo. Na tela: A IA própria durante a contratação: o aviso para assinar as Condições no alto, o hero com 1 de 4 prontos e o card Para ativar o Enterprise com assinar, pagar, a busca já conectada e a transcrição. 1. **O que falta agora**: Um aviso por vez: **Assinar agora** e **Ler antes** (ou **Pedir reenvio**, para os outros donos), depois **Pagar agora**, depois **Conectar o que falta**. 2. **Ativação do Enterprise**: Quantos passos estão prontos: assinatura, pagamento e os modelos. 3. **Para ativar o Enterprise**: Os passos na ordem. O pagamento fica travado até as duas assinaturas; os modelos conectados antes de assinar já aparecem marcados. - **Quem tem cada tipo**: Busca: OpenAI, Google, Azure OpenAI, Amazon Bedrock ou o seu servidor. Transcrição: OpenAI, Google, Azure OpenAI ou o seu servidor. Fala: OpenAI, Azure OpenAI ou o seu servidor. A Anthropic não tem modelos de busca nem de áudio. - **A mesma chave**: Se você já conectou um modelo de conversa da OpenAI (ou do mesmo recurso do Azure), a gaveta oferece "A mesma do …": a chave guardada serve para a busca e o áudio, sem colar de novo. Ela nunca vai para outro provedor nem para outro endereço. #### Conectar um modelo 1. **Abra Modelos e clique em Conectar um modelo**: Escolha para que é o modelo — **conversa e tarefas**, **busca na base**, **transcrição do áudio** ou **resposta falada** — e o provedor: OpenAI, Anthropic, Google, Azure OpenAI, Amazon Bedrock ou o seu servidor (compatível com a API da OpenAI). O provedor que não tem aquele tipo aparece apagado, com o porquê. 2. **Cole a chave (ou use a mesma) e escolha o modelo**: A chave fica cifrada e, depois de salva, aparece só o começo e o fim. No Azure informe o endereço do recurso e o nome da implantação; no Bedrock, a região e o ID do modelo; no seu servidor, o endereço (só https). O preço é opcional — por milhão de tokens na conversa e na busca, por minuto na transcrição e na fala — e serve só para estimar o custo nas telas. 3. **Teste o modelo**: Na conversa conferimos cinco coisas: a chave conecta, responde em português do Brasil, devolve JSON no formato pedido, aguenta uma conversa longa com a base e atende chamadas ao mesmo tempo (**cerca de 10 mil tokens** da sua conta). Na busca, se ele gera o vetor de um trecho, acha o trecho certo numa busca de exemplo, responde rápido e lê um lote de 100 trechos (**cerca de 3 mil tokens**). Na transcrição, um áudio de exemplo gravado no WhatsApp (**cerca de 70 segundos de áudio**), com o texto que ele escreveu e quantas palavras errou. Na fala, uma fala curta na voz da sua persona (**cerca de 10 segundos de fala**), que você pode ouvir. 4. **Salve**: Ele aparece na tabela de Roteamento. **Nenhuma tarefa muda até você escolher.** Na tela: A gaveta Conectar um modelo no passo da chave, com o aviso do custo do teste no rodapé. 1. **A chave**: Cifrada ao salvar. Ninguém da equipe vê a chave inteira de novo — nem você. 2. **O custo do teste**: O teste chama o seu modelo de verdade. Se você testar muitas vezes seguidas, a tela pede para aguardar alguns segundos. - **JSON com correção**: O modelo acertou o formato na segunda tentativa. Ele funciona, só um pouco mais devagar nas tarefas que pedem JSON. - **Contexto**: Quanto o teste PROVOU que o modelo aguenta (por exemplo, "8 mil de contexto"), não a janela anunciada pelo provedor. - **Simultâneas**: Quantas das 20 chamadas ao mesmo tempo o modelo respondeu. Menos que 20 aparece em destaque. Na tela: Os cartões dos modelos conectados, com tempo, sucesso, preço e as capacidades testadas. 1. **Cada modelo**: Tempo (p50) e sucesso das últimas 24 horas, o preço que você informou e o que o teste provou. **Testar agora** repete o teste; **Trocar chave** testa a chave nova antes de trocar; **Pausar** tira o modelo das tarefas sem apagar nada. Na tela: A gaveta Conectar um modelo de busca no fim do teste, com as checagens aprovadas, a busca de exemplo e o aviso de pronto para a busca. 1. **O que a busca precisa**: As cinco checagens da busca, com o resultado de cada uma. 2. **A busca de exemplo**: Uma pergunta de lead e o trecho que o modelo achou. Na transcrição aparece o áudio para ouvir e o que ele escreveu; na fala, a fala na voz da persona. Na tela: A grade Busca e voz da aba Modelos com os modelos de busca, de transcrição e de fala. 1. **Busca e voz**: Cada um só aparece na linha do tipo dele no Roteamento. A busca mostra o tempo por busca e o tamanho do vetor; a transcrição, quanto leva por minuto de áudio; a fala, até a fala ficar pronta. **sem tarefa**: conectado, mas sem linha no Roteamento. #### Quem faz cada tarefa Em **Roteamento**, cada tarefa tem um **modelo principal**, uma **reserva** e um **tempo-limite**. Se o principal falhar ou passar do tempo, a reserva assume. Intenção e transbordo podem ficar com o **decisor da plataforma (incluído)**. A busca, a transcrição, a fala e a leitura de imagem ficam no grupo **Busca, voz e imagem**, nos seus modelos de cada tipo (veja Busca e voz no Roteamento). Toda mudança vale na hora e fica na trilha. Em **Mostrar todas** aparecem todos os agentes que atendem a sua conta, em três grupos: - **Seguem a conversa**: Sentimento, objeções, memória do lead, follow-up, perfil do lead e comentários do Instagram rodam durante a conversa. Sem rota própria, usam o modelo, a reserva e o tempo-limite da Conversa com o lead; escolha outro modelo e a tarefa ganha **rota própria**. - **Bastidores**: Não falam com o lead: rodam por trás, para preparar a sua conta — o **aprendizado do cliente ideal**, o **especialista de grupo**, o **ajuste da qualificação**, o **gerador de segmento**, o **Pergunte à IA** e o **perfil de voz**. Sem rota própria, usam o modelo e a reserva da conversa, mas com o **tempo-limite padrão de cada tarefa** (de 10 a 60 segundos, pelo tamanho do trabalho); a rota própria se escolhe igual. - **Funcionam por regras, sem modelo de IA**: O humanizador, o agendador, o link de pagamento, a política de transbordo e a LGPD não usam modelo nenhum: não há nada para escolher e não custam nada. Estão na tabela para você ver todo mundo que atende o lead. Na tela: A tabela de Roteamento aberta em Mostrar todas, com as tarefas que seguem a conversa, os bastidores e os agentes por regras. 1. **Principal, reserva e tempo**: Escolha o modelo de cada tarefa. A reserva precisa ser outro modelo. 2. **Busca e voz**: A busca, a transcrição e a fala, cada uma só com os modelos do tipo dela. A busca troca lendo a base de novo. 3. **Seguem a conversa**: Usam o modelo, a reserva e o tempo da Conversa com o lead — até você escolher outro modelo, e aí a tarefa ganha **rota própria**. 4. **Bastidores**: As tarefas que preparam a sua conta sem falar com o lead. Também vão aos seus modelos. 5. **Por regras**: Os agentes que não usam modelo de IA: sem nada para escolher e sem custo. - **Regras por tipo de lead**: Valem por cima da tabela, de cima para baixo: quando o perfil ideal passa de uma nota, quando há uma objeção ou quando o cartão tem uma etiqueta, a conversa daquele lead usa outro modelo. Arraste para mudar a ordem (também pelo teclado: espaço, setas e espaço de novo). - **Se os seus modelos falharem**: O lead nunca fica sem resposta. > **Bastidores com os seus modelos fora do ar:** Com a contingência **desligada**, a tarefa não roda e nada é cobrado: no que você pede (Pergunte à IA, especialista de grupo, ajuste da qualificação, gerador de segmento, recalcular o cliente ideal) a tela avisa "Os modelos da empresa estão fora do ar. Tente de novo quando voltarem."; o que roda sozinho (aprendizado do cliente ideal, perfil de voz) tenta de novo na próxima vez. Se os modelos caírem com o ajuste ou o gerador já na fila, o pedido termina sem cobrar e a tela diz que os modelos da empresa estavam fora do ar. > **Na busca e na voz com os seus modelos fora do ar:** **Busca:** a busca por palavras, sempre ligada e sem custo — a IA da plataforma não entra, porque a sua base está nos vetores do seu modelo. O lead nunca fica sem resposta. #### Busca e voz no Roteamento No grupo **Busca e voz**, cada linha só aceita modelos do tipo dela e nenhuma roda na IA da plataforma. A **busca** não tem reserva de modelo: se o seu modelo falhar, a mensagem usa a **busca por palavras**, na mesma base, sem custo. A **transcrição** e a **fala** têm principal e reserva como as outras tarefas; sem modelo de fala, a resposta vai por texto. O áudio do lead acima de **20 MB ou 20 minutos** não vai ao modelo de transcrição (os provedores recusam): a conversa vai para a sua equipe ouvir. A **Leitura de imagem** é a linha nova do grupo e é **opcional**. Ela só aceita modelo de conversa que passou na checagem **Lê uma foto de exemplo** do teste de conexão; o cartão **Quais dos seus modelos leem imagem**, no topo do Roteamento, mostra quem passou. Não tem contingência: com os seus modelos fora do ar, a foto vai para a sua equipe. Sem a linha, a IA responde pela legenda da foto ou pede para o lead escrever. A imagem vai como chegou ao seu modelo, como o áudio: a máscara de dados pessoais vale para o texto. Ver [Leitura de imagens](https://attendto.com.br/manual/configuracoes). > **Trocar o modelo de busca faz a base ser lida de novo:** A busca compara a pergunta do lead com a sua base em forma de vetores, e vetores de modelos diferentes não se comparam. Por isso o modelo novo precisa ler a base inteira de novo — e a tela mostra antes os trechos, os tokens, o custo no seu provedor e o tempo. Enquanto a base é **lida de novo**, a busca segue no modelo de hoje e a troca acontece de uma vez, quando a base nova estiver completa; a fonte que você salvar no meio entra nas duas. Se o seu provedor recusar, você **retoma de onde parou** ou **desiste da troca**; uma leitura parada há 7 dias se desfaz sozinha. A base anterior fica guardada **7 dias**: escolher o modelo antigo de novo nesse prazo volta na hora, sem custo. Na tela: O diálogo de trocar o modelo de busca, com os trechos, o custo e o tempo da leitura da base. 1. **Antes de ler a base de novo**: Quantos trechos, quanto custa no seu provedor e quanto tempo leva. Voltando ao modelo da base guardada (até 7 dias), a troca é imediata e sem custo. #### Consumo e uso justo Na tela: A aba Consumo com as mensagens do mês, as barras por dia, o custo por modelo e os avisos. 1. **O mês em três números**: Mensagens usadas, a previsão de fechamento e os leads e transbordos do mês — sem cobrança. 2. **Avisos e teto**: Os avisos aos 80% e ao passar das incluídas vão por e-mail para os donos. O **teto de excedente** é um limite seu: acima dele, nem a IA da plataforma nem os seus modelos respondem, e a conversa vai para a equipe. Aumente ou tire o teto e a IA volta a responder na mensagem seguinte; as conversas que já foram para a fila continuam na fila da equipe. > **O que é uma mensagem:** Cada fala do lead respondida pela IA, em qualquer canal. Acima das incluídas no seu plano, cada mil a mais entra na fatura do mês — e o atendimento nunca para, a não ser que você defina um teto. > **Conta contratada pela proposta de um especialista:** A IA própria também vale para a conta montada sob medida, fora do Enterprise: a franquia de mensagens e o excedente são os da proposta, e o excedente entra na fatura seguinte. Veja [Como funciona a sua contratação](https://attendto.com.br/manual/primeiros-passos). #### Segurança e dados Na tela: A aba Segurança e dados com as chaves e o acesso, o que sai para os modelos e a trilha de alterações. 1. **Chaves e acesso**: Só donos mudam modelos e regras; exigir a verificação em duas etapas para mudar a página; lembrar de trocar as chaves a cada 90 dias. 2. **O que sai para os seus modelos**: Vai a conversa recente, o contexto da empresa e os trechos da base; nas tarefas de bastidores, também os números do painel e os negócios ganhos e perdidos, sem nome nem contato. **Não vão** telefone, e-mail e documento do lead: viram marcadores e a resposta volta com o valor certo. O áudio do lead vai como está para o seu modelo de transcrição, e o texto da resposta, para o seu modelo de fala; na busca, a pergunta do lead vai com telefone, e-mail e documento mascarados. Você escolhe se guardamos o texto das chamadas ou só números. 3. **Trilha de alterações**: Tudo o que mudou nesta página, com quem mudou e quando. **Exportar** baixa a trilha em CSV. Com as Condições assinadas, o alto desta aba mostra **Condições do Plano Enterprise** com o número do contrato, quem assinou e quando, e **Baixar PDF assinado** — o mesmo PDF da Carteira, para quem cuida da parte técnica achar sem passar por lá. #### Perguntas frequentes **Sem nenhum modelo conectado, a IA para?** Sim. Enquanto o Enterprise não está ativo, a IA não responde nenhum lead: as conversas vão para a sua equipe, com o motivo. No Enterprise nada da sua conta roda na IA da plataforma. **Quem paga os tokens dos meus modelos?** Você, direto ao seu provedor. Os custos mostrados aqui são estimativas pelos preços que você informou. **Por que não consigo mudar nada?** A conta pede a verificação em duas etapas para mudar esta página. Ative em Configurações → Segurança. Se a conta deixou só os donos mudarem, administradores leem sem editar. **O que acontece quando o modelo cai?** A reserva assume na hora; se ela também cair, a IA da plataforma responde (se a contingência estiver ligada) ou a conversa vai para a sua equipe. Nos bastidores, sem contingência, a tarefa espera os seus modelos voltarem. **Os agentes de bastidores também usam os meus modelos?** Sim. Todo agente que usa modelo de IA para a sua conta usa os seus modelos: por padrão, o mesmo da conversa; na tabela você pode dar a cada um uma rota própria. **A Anthropic serve para o Enterprise?** Serve para a conversa e as tarefas. A busca e o áudio precisam de outro provedor (OpenAI, Google, Azure OpenAI ou o seu servidor) — a nossa equipe de implantação ajuda. **Uso o Bedrock. E o áudio?** A busca roda no Titan, no próprio Bedrock. A transcrição e a fala, nesta versão, por OpenAI, Azure OpenAI ou o seu servidor (a transcrição também pelo Google). **Quanto custa ler a base de novo?** A tela mostra antes de trocar: os trechos, os tokens e o custo pelo preço que você informou em Modelos. Quem cobra é o seu provedor. **Posso voltar ao modelo de busca antigo?** Sim, em até 7 dias depois da troca: escolha o modelo antigo de novo e a busca volta na hora, sem custo. No painel: Abrir a IA própria. Como as pessoas procuram: conectar chave da openai; usar meu próprio modelo de ia; ia própria enterprise; conectar anthropic claude no whatsapp; azure openai atendimento; amazon bedrock chatbot; roteamento de modelos de ia; modelo de reserva fallback; modelo de embeddings base de conhecimento; transcrição de áudio com meu modelo; teto de excedente de mensagens; trocar chave de api; regras por tipo de lead. ## Analytics: funil de conversão, conversão por canal, origem dos leads e consumo de saldo URL: https://attendto.com.br/manual/analytics Menu: Inteligência > Analytics A tela Analytics serve para ver, em números reais do período, quantos leads entraram, em que etapa do funil eles param, quais canais e origens convertem e quanto saldo a conta consumiu por dia. ### Quem pode usar - Dono: Vê a tela inteira e usa todos os filtros. Nada aqui altera dados. - Admin: Vê a tela inteira e usa todos os filtros, como o dono. - Atendente: Também vê o item no menu e a tela inteira, só para leitura. ### Telas #### Analytics A tela Analytics serve para ler o funil de conversão, a conversão por canal, o resultado por persona, a fatia de cada origem e o consumo de saldo de um período escolhido. Endereço no painel: `/app/analytics` ![Captura da tela Analytics. A tela Analytics serve para ler o funil de conversão, a conversão por canal, o resultado por persona, a fatia de cada origem e o consumo de saldo de um período escolhido.](https://attendto.com.br/prints-do-manual/analytics--analytics.png) A tela Analytics na conta de demonstração, com dados fictícios e os valores desfocados. ##### Período e filtros A faixa de botões no topo escolhe o período e recorta os números por canal, persona e origem. Botões e ações: - **Últimos 30 dias**: Mostra os números dos últimos 30 dias. É o período que a tela abre por padrão. - **Últimos 7 dias**: Encurta todos os cartões para os últimos 7 dias. - **Hoje**: Mostra só o dia de hoje. - **Canal: ‹todos ou o canal escolhido›**: Abre a lista dos canais que tiveram movimento no período (WhatsApp, SMS, E-mail, Web chat). Escolher um canal recorta o funil, a conversão por canal, a persona e a origem; a primeira opção volta para todos. - **Persona: ‹todas ou a persona escolhida›**: Abre a lista das personas da conta e recorta os números pela persona que atendeu o lead. - **Origem: ‹todas ou a origem escolhida›**: Abre a lista das origens dos leads no período (WhatsApp, Instagram, Site, Cadastro manual, Importados por planilha, Integração e outras) e recorta os números por ela. - **Limpar filtros**: Aparece só com algum filtro ligado. Desliga Canal, Persona e Origem de uma vez e devolve a tela inteira. Também aparece: - O botão do período escolhido fica destacado com o degradê da marca. - O filtro ligado fica destacado e mostra o nome da opção escolhida; a lista marca a opção atual com um sinal de visto. - Ao trocar período ou filtro, os números anteriores continuam na tela até os novos chegarem, sem piscar. ##### Funil de conversão As seis etapas do período, com o número de leads e a porcentagem sobre os leads criados. Também aparece: - Subtítulo fixo: Cada etapa reflete eventos reais — sem inflar. - Leads criados: quem entrou no período. É a base de todas as porcentagens do cartão. - 1ª resposta da IA: quantos receberam a primeira resposta. - Qualificados agora (quente + morno): quem está quente ou morno neste momento. - Quente: a parte dos qualificados que está quente. - Handoff aceito: conversas transferidas para uma pessoa da equipe e aceitas. - Fechados: negócios ganhos. - Cada etapa mostra o número, a porcentagem sobre Leads criados e uma barra proporcional. ##### Conversão por canal Um bloco por canal com a taxa de conversão dele e o tamanho dele no total de conversas. Também aparece: - Nome do canal com a cor dele e a porcentagem de conversão à direita. - Barra: a fatia daquele canal no total de conversas do período (não é a conversão). - Linha de baixo: ‹n› conversas do canal no período. ##### Por persona Compara a conversão das duas versões da IA quando há teste A/B ativo. Botões e ações: - **Configurar personas**: Aparece quando não há teste A/B ativo, depois do texto Sem teste A/B ativo. Abre a tela de Personas para montar o teste. Também aparece: - Com teste ativo: o nome de cada variante, a porcentagem de conversão e uma barra. ##### Por origem De onde vieram os leads do período, em fatia do total. Também aparece: - Uma linha por origem com a porcentagem e uma barra. É fatia de leads, não taxa de conversão. ##### Consumo de saldo Quanto saldo a conta gastou por dia no período, sempre da conta inteira. Também aparece: - Barras por dia, do primeiro dia do período até hoje; dias sem gasto aparecem vazios. - Rodapé: o período e o total gasto nele. - Legenda /dia; com qualquer filtro ligado, ela passa a dizer /dia · geral (sem filtro), porque este cartão ignora os filtros. ##### Estados da tela - Carregando: Três blocos cinza no lugar dos cartões enquanto os números chegam. - Sem nada ainda: Sem leads no período, o funil diz Sem dados no período; com filtro ligado, Sem dados para os filtros neste período. Os cartões de canal e de origem também dizem Sem dados no período. - Se der erro: Um cartão com Não foi possível carregar o analytics. e o botão Tentar novamente, que pede os números de novo. ### Passo a passo #### Como ver a taxa de conversão do mês 1. Abra **Analytics** no menu, no grupo Inteligência. 2. Deixe o período em **Últimos 30 dias**. 3. No cartão **Funil de conversão**, leia a linha **Fechados**: a porcentagem dela é a conversão sobre todos os **Leads criados**. #### Como descobrir qual canal converte melhor 1. Em **Analytics**, escolha o período. 2. No cartão **Conversão por canal**, compare a porcentagem de cada canal. 3. Lembre que a barra mostra o tamanho do canal; canal com porcentagem alta e barra curta é onde vale colocar mais leads. #### Como filtrar o funil por canal, persona ou origem 1. Clique em **Canal**, **Persona** ou **Origem** na faixa do topo. 2. Escolha a opção na lista; o funil, o canal, a persona e a origem passam a mostrar só aquele recorte. 3. Para voltar a ver tudo, clique em **Limpar filtros**. #### Como saber quanto saldo foi gasto por dia 1. Em **Analytics**, escolha **Últimos 7 dias** ou **Últimos 30 dias**. 2. Veja o cartão **Consumo de saldo**: cada barra é um dia e o rodapé mostra o total do período. 3. Para o extrato detalhado e as recargas, abra a Carteira. #### Como comparar duas personas com teste A/B 1. Sem teste ativo, o cartão **Por persona** mostra **Configurar personas**: clique nele. 2. Monte o teste A/B na tela de Personas. 3. Volte ao **Analytics** e compare a conversão das duas variantes no cartão **Por persona**. ### Perguntas frequentes #### Trocar o período ou os filtros apaga ou muda algum dado? Não. A tela só lê. Período e filtros mudam apenas o que aparece nos cartões, e voltam ao padrão quando você sai da tela. #### Por que a lista de Canal ou de Origem tem poucas opções? As listas mostram só os canais e as origens que tiveram leads no período escolhido. Mude para Últimos 30 dias para ver mais opções. #### O filtro de Persona vale para o cartão Por persona? O cartão Por persona compara as duas variantes do teste A/B ativo, que é o que ele mede. O filtro de Persona recorta o funil, o canal e a origem. #### Qual a diferença entre Qualificados agora e o qualificado do relatório Investimento? Aqui a etapa conta quem está quente ou morno neste momento. No relatório Investimento → Venda, conta quem chegou a ser qualificado, pela IA ou pela equipe, mesmo que tenha mudado depois. #### O atendente consegue ver o Analytics? Sim. O item aparece para todos os papéis da equipe e a tela é só de leitura. #### Por que o Consumo de saldo não muda quando escolho um canal? O consumo é sempre da conta inteira. Com um filtro ligado, a legenda do cartão passa a dizer /dia · geral (sem filtro) para lembrar disso. Dias sem gasto aparecem como barra vazia. ### Guia: Analytics O funil em números: quantos chegaram, onde pararam, de onde vieram e quanto o período consumiu. Esta tela responde duas perguntas de dinheiro: **onde o funil vaza** e **onde vale investir mais**. E responde uma terceira, que é a mais útil de todas: aquela mudança que você fez semana passada melhorou ou piorou alguma coisa? > **Pode clicar em tudo:** Analytics é só leitura. Nenhum filtro daqui envia mensagem, apaga dado ou gasta saldo. Trocar período e recortar por canal não tem consequência nenhuma. #### A tela por partes Na tela: Tela de Analytics com filtros no topo, funil de conversão à esquerda, conversão por canal à direita e três cards embaixo. O funil de 30 dias e os recortes por canal, persona e origem. 1. **O período**: **Últimos 30 dias** é o padrão; **Últimos 7 dias** e **Hoje** encurtam. Com pouco movimento, período curto vira número de sorte: 2 leads em um dia não provam nada. 2. **Os três recortes**: **Canal**, **Persona** e **Origem** recortam tudo o que está abaixo — menos o consumo de saldo. **Limpar filtros** devolve a tela inteira. Número estranho? O primeiro suspeito é um filtro esquecido ligado. 3. **O funil e o denominador de todos**: Todos os percentuais são calculados sobre **Leads criados**, nunca de uma etapa para a outra. `Fechados 9,1%` quer dizer 9,1% de todos os leads criados — não 9,1% de quem chegou na etapa anterior. 4. **Aqui o número e a barra medem coisas diferentes**: O número (`27,3%`) é a conversão daquele canal. A **barra é a fatia dele no total de conversas**. Canal pequeno e bom aparece como número alto com barra curta — e costuma ser exatamente onde vale colocar mais gente. 5. **Por persona e por origem**: **Por persona** separa o resultado por versão da sua IA. **Por origem** mede outra coisa: é **fatia** — de onde vieram os leads, não quanto cada lugar converteu. Origem com 57,6% não converte 57,6%: ela trouxe 57,6% da gente. 6. **O consumo ignora os filtros**: Este card é sempre a conta inteira. Ao ligar qualquer filtro, a legenda passa a dizer `/dia · geral (sem filtro)` para avisar. Extrato, recarga e limite de gasto ficam na [Carteira](https://attendto.com.br/manual/saldo-e-recargas). #### As seis etapas do funil O card avisa em letra pequena: **cada etapa reflete eventos reais — sem inflar**. Ou seja, nada aqui é estimativa; é contagem do que aconteceu. - **Leads criados**: Todo mundo que entrou no período. É o denominador de todos os percentuais desta tela. - **1ª resposta da IA**: Quantos receberam a primeira resposta. Se este número for bem menor que o de cima, o problema não é venda: é canal, conexão ou consentimento. Confira em [Conexões](https://attendto.com.br/manual/conexoes). - **Qualificados agora (quente + morno)**: BANT é a sigla das quatro perguntas que qualificam alguém: se tem **orçamento**, se é **quem decide**, se tem a **necessidade** e se tem **prazo**. Aqui a etapa soma quem está quente ou morno agora. O relatório [Investimento → Venda](https://attendto.com.br/manual/investimento) conta de outro jeito: quem chegou a ser qualificado, pela IA ou pelo time. - **Quente**: Um pedaço dos qualificados, não uma etapa nova depois deles. As duas barras contam a mesma gente em parte — nunca some as duas. - **Handoff aceito**: Handoff é o transbordo: a conversa passa para uma pessoa do time e alguém aceita. A fila e os motivos estão em [Transbordo para humano](https://attendto.com.br/manual/handoff). - **Fechados**: Negócio ganho. Como as etapas contam eventos reais e nem todo lead passa por todas, é normal ver **Fechados** maior que **Handoff aceito**: houve quem fechasse sem precisar de pessoa. > **Leia os números inteiros, não os percentuais:** Como todos os percentuais são sobre **Leads criados**, eles não mostram queda de degrau. Para achar onde vaza, leia a coluna dos números de cima para baixo — `33 → 12 → 9` diz na hora que a perda maior foi entre chegar e receber a primeira resposta. #### Quatro jeitos de ler errado - **O percentual do funil não é etapa a etapa.** Tudo é fatia de **Leads criados**. Para conversão entre duas etapas, divida os números você mesmo. - **Em Conversão por canal, número e barra não são a mesma medida.** O número é a conversão do canal; a barra é o tamanho dele. Barra curta com número alto é oportunidade, não erro. - **Por origem é fatia, não conversão.** Ele responde de onde vem a gente, não quem compra. - **Consumo de saldo ignora os filtros.** É sempre a conta inteira, mesmo com um canal selecionado. #### A leitura de segunda-feira 1. **Fixe o período em 30 dias**: É o único recorte com gente suficiente para não oscilar por acaso. **Hoje** e **7 dias** servem para checar se algo quebrou, não para decidir. 2. **Ache o degrau**: Leia os números do funil de cima para baixo e marque a maior queda. Ali é o gargalo do mês, e é a única coisa que vale atacar nesta semana. 3. **Descubra de quem é o degrau**: Recorte por **Canal**, depois por **Origem**, depois por **Persona**. Se a queda existe em todo recorte, é a conversa. Se aparece em um só, é aquele canal ou aquela campanha. 4. **Mexa em uma coisa só e anote a data**: Tom, oferta, peso da qualificação: uma mudança por semana. Duas ao mesmo tempo e você nunca vai saber qual funcionou. 5. **Volte em sete dias**: Mesmo período, mesmos filtros. Esta tela é o único lugar que diz se a mudança valeu. Para comparar duas versões da IA com rigor de amostra, o lugar é [Personas A/B](https://attendto.com.br/manual/personas). #### Quando a tela parece errada - **Tudo zerado:** confira o período e os filtros. Depois confira se o canal está mesmo ligado em [Conexões](https://attendto.com.br/manual/conexoes) — sem canal ativo não entra lead. - **Leads entram e a 1ª resposta não sobe:** o problema é antes da conversa. Consentimento, horário de atendimento ou canal desconectado. - **Qualificados alto e fechados baixo:** a conversa está boa e o fim está travado. Olhe o [Funil](https://attendto.com.br/manual/funil) e o [Transbordo](https://attendto.com.br/manual/handoff) — costuma ser gente parada esperando pessoa. - **Consumo subindo sem lead novo:** envio em lote em andamento. Confira [Campanhas](https://attendto.com.br/manual/campanhas) e o limite de gasto na [Carteira](https://attendto.com.br/manual/saldo-e-recargas). No painel: Abrir Analytics. Como as pessoas procuram: relatório de conversão de leads; funil de conversão whatsapp; taxa de conversão por canal; de onde vêm meus leads; quanto gastei de saldo; métricas de atendimento; analytics de vendas; conversão por persona; relatório de leads do mês; onde estou perdendo cliente. ## Revenue: ciclo de vendas, taxa de ganho por cliente ideal e motivos de perda URL: https://attendto.com.br/manual/revenue Menu: Inteligência > Revenue A tela Revenue serve para ver o ciclo comercial inteiro em 30 ou 90 dias, provar com os próprios números se o cliente ideal ganha mais, entender por que os negócios são perdidos e o que a IA aprendeu sobre quem compra. Quando aparece: O item Revenue só aparece no menu com o módulo Revenue AI ativo na conta (ligado em Configurações → Módulos). ### Quem pode usar - Dono: Vê a tela inteira. A tela é só leitura; ligar o módulo é feito em Configurações → Módulos. - Admin: Vê a tela inteira, como o dono. - Atendente: Também vê o item no menu quando o módulo está ativo, só para leitura. ### Telas #### Revenue A tela Revenue serve para ler, num lugar só, o ciclo inbound com a taxa de cada etapa, a taxa de ganho por faixa de aderência ao cliente ideal, os perdidos por motivo e as ações sugeridas por regra. Endereço no painel: `/app/revenue` ![Captura da tela Revenue. A tela Revenue serve para ler, num lugar só, o ciclo inbound com a taxa de cada etapa, a taxa de ganho por faixa de aderência ao cliente ideal, os perdidos por motivo e as ações sugeridas por regra.](https://attendto.com.br/prints-do-manual/revenue--revenue.png) A tela Revenue na conta de demonstração, com dados fictícios e os valores desfocados. ##### Cabeçalho Revenue Intelligence O título da tela e a escolha do período. Botões e ações: - **30 dias**: Mostra os números dos últimos 30 dias. É o período que a tela abre. - **90 dias**: Alarga todos os cartões para os últimos 90 dias. Também aparece: - Subtítulo: O ciclo inbound de ponta a ponta, com o aprendizado voltando ao cliente ideal. ##### O ciclo As etapas do ciclo comercial, cada uma com o número de leads e a parcela sobre os leads novos do período. Também aparece: - Leads novos, avaliados pelo ICP, com ICP alto, qualificados, reunião marcada, em negociação e ganhos, nessa ordem. - Cada etapa mostra o número, uma barra e a porcentagem; em negociação e ganhos são retratos de agora, sem porcentagem. - A etapa de ganhos fica destacada com a borda da marca. - Linha de baixo: Ganhos no período, com o valor somado dos negócios ganhos. ##### O ICP funciona? A taxa de ganho entre os negócios com desfecho, separada por faixa de aderência ao cliente ideal. Também aparece: - Uma linha por faixa (alta, média, baixa e sem avaliação) com o número de negócios e a porcentagem de ganho. - Abaixo de cada faixa, o ticket médio ganho, quando houver. - As faixas baixa e sem avaliação aparecem em cinza; as demais, no degradê da marca. ##### Por que perdemos Os perdidos do período agrupados pelo motivo marcado no Funil, com o valor somado. Também aparece: - Uma linha por motivo com a quantidade, o valor somado e uma barra proporcional. ##### O que a IA aprendeu A última versão do cliente ideal calculado pela IA. Também aparece: - Título com a versão: ICP calculado v‹n›. - A frase que resume o cliente ideal, em destaque. - Os atributos com o peso de cada um e a evidência que o sustenta. - As diferenças em relação ao cliente ideal declarado pela conta. - Sem versão calculada, o cartão diz o que ainda falta (desfechos e ganhos) em vez de inventar. ##### Ações sugeridas Ações geradas por regra a partir dos números da tela, cada uma com o número que a justifica. Também aparece: - Título: Ações sugeridas (por regra, com o número que justifica). - Cada ação traz o texto e, abaixo, o número que a fez aparecer. ##### Estados da tela - Carregando: Blocos cinza no lugar do título e dos cartões. - Sem nada ainda: Sem desfechos no período, O ICP funciona? diz Sem negócios com desfecho no período. Marque ganho e perdido no Funil para medir. Sem perdas, Por que perdemos diz Nenhum negócio perdido no período. Sem regra disparada, Ações sugeridas diz Nenhuma regra disparou com os números deste período. Isso é bom sinal, ou pouca amostra. - Se der erro: Não foi possível carregar o Revenue, com Nada mudou. Tente de novo. e o botão Tentar de novo. - O módulo Revenue AI está desligado: O cartão O Revenue precisa do módulo Revenue AI ligado, explicando que sem o módulo os números não são calculados, e o botão Abrir Módulos. ### Passo a passo #### Como ligar o módulo Revenue AI para ver a tela Revenue 1. Abra Configurações e vá até **Módulos**; se a tela Revenue mostrar o aviso do módulo, use o botão **Abrir Módulos**. 2. Ligue o módulo **Revenue AI**. 3. Volte ao menu: o item **Revenue** aparece no grupo Inteligência. #### Como saber se o cliente ideal (ICP) realmente vende mais 1. Abra **Revenue** e escolha **90 dias** para ter mais negócios com desfecho. 2. No cartão **O ICP funciona?**, compare a porcentagem de ganho da faixa alta com a da faixa baixa. 3. Se o cartão disser que não há desfechos, marque ganho e perdido nos cartões do Funil e volte depois. #### Como ver os motivos de perda de negócios 1. Abra **Revenue** e escolha o período. 2. No cartão **Por que perdemos**, veja os motivos em ordem, com a quantidade e o valor somado. 3. Para corrigir um motivo, abra o cartão do lead no Funil: é de lá que o motivo vem. #### Como acompanhar em que etapa do ciclo os leads param 1. Em **Revenue**, leia o cartão **O ciclo** da esquerda para a direita. 2. Compare os números de etapas vizinhas para achar a maior queda. 3. Use as **Ações sugeridas** como ponto de partida: cada uma traz o número que a justifica. ### Perguntas frequentes #### Por que o item Revenue não aparece no meu menu? Ele só aparece com o módulo Revenue AI ativo. Sem o módulo, o item some do menu e quem abrir o endereço direto vê o aviso para ligar o módulo. #### A tela Revenue muda alguma coisa no Funil? Não. Ela só lê o que o Funil, o cliente ideal e os desfechos já registraram. Para mudar um número, mude o cartão no Funil. #### As ações sugeridas vêm de uma IA generativa? Não. Elas saem de regras aplicadas aos números da própria tela. Se nenhuma regra dispara, o cartão diz isso em vez de inventar uma ação. #### Qual período usar no Revenue? 30 dias mostra o mês corrente; 90 dias junta mais negócios com desfecho, o que deixa a comparação por faixa de ICP mais confiável quando há pouco movimento. #### Por que em negociação e ganhos não mostram porcentagem? Porque são retratos de agora, não etapas contadas sobre os leads novos do período. Por isso aparecem só com o número. #### O que quer dizer a versão em O que a IA aprendeu? É o número da última versão do cliente ideal calculado. Cada novo cálculo, com mais desfechos, gera uma versão nova; a tela mostra sempre a mais recente. ### Guia: Revenue O ciclo comercial de ponta a ponta com a taxa de cada etapa, a prova de que o cliente ideal funciona, por que você perde e o que a IA aprendeu. **Revenue** só existe com o módulo **Revenue AI** ligado ([Configurações → Módulos](https://attendto.com.br/manual/configuracoes)). É uma tela de leitura: junta o que o Funil, o cliente ideal e os desfechos já gravaram e responde, num lugar só, onde o ciclo perde força e se vale insistir em quem parece o seu cliente. Na tela: Tela Revenue com o ciclo em sete etapas (leads novos, avaliados pelo ICP, com ICP alto, qualificados, reunião marcada, em negociação, ganhos) com taxa por etapa; abaixo, a taxa de ganho por faixa de aderência, os perdidos por motivo, o que a IA aprendeu e as ações sugeridas. Trinta ou noventa dias. Cada número vem de um registro: nenhum é estimado. #### A tela por partes - **O ciclo**: Leads novos → avaliados pelo ICP → com ICP alto (70 ou mais) → qualificados (quente) → reunião marcada → em negociação → ganhos. Cada etapa mostra o número e a parcela dos leads novos do período; "em negociação" e "ganhos" são retratos de agora, sem parcela. Em negociação são os cartões da etapa de início da negociação em diante, até antes do ganho (no quadro Imobiliária, Pasta e Aprovação de crédito). Sem essa marca, conta a etapa logo antes do ganho. A marca fica em Configurar quadro → Colunas e etapas, no diálogo da coluna. LDR e Outbound entram aqui quando existirem. - **O ICP funciona?**: Entre os negócios com desfecho no período, a taxa de ganho por faixa de aderência: alta (70+), média (40 a 69), baixa (abaixo de 40) e sem avaliação, com o ticket médio ganho de cada faixa. É a prova, com os seus números, de que vale priorizar quem parece o seu cliente. - **Por que perdemos**: Os perdidos do período agrupados pelo motivo escolhido no Funil (preço, não é agora, concorrente, sem resposta, não era para nós, outro), com o valor somado. Sem motivo marcado não há barra: por isso o motivo é obrigatório ao marcar perdido. - **O que a IA aprendeu**: A última versão do cliente ideal calculado: a frase, os atributos com peso e as diferenças do declarado. Sem versão, o bloco diz o que falta (quantos desfechos e ganhos) em vez de inventar. - **Ações sugeridas**: Até três ações geradas por regra sobre os números da tela, cada uma com o número que a justifica. Não vêm de modelo de linguagem: se a regra não dispara, a ação não aparece. > **Os números batem com o Funil:** Ganhos, perdidos e motivos são os mesmos que a faixa do quadro mostra. Se algo parecer errado aqui, confira primeiro o desfecho e o motivo no cartão: é de lá que tudo sai. Como as pessoas procuram: revenue intelligence; ciclo de vendas inbound; taxa de ganho por icp; motivo de perda de negócio; por que perdemos vendas; cliente ideal funciona; o que a ia aprendeu sobre meus clientes; ações sugeridas de vendas; módulo revenue ai; relatório de ganhos e perdas. ## Investimento → Venda: custo por lead, custo por venda e retorno de cada anúncio URL: https://attendto.com.br/manual/investimento Menu: Inteligência > Investimento O relatório Investimento → Venda é a tela que cruza o gasto dos anúncios, importado por planilha, com os leads e as etapas do quadro, para mostrar quanto custou cada lead, cada venda e qual o retorno de cada campanha, conjunto e anúncio. Quando aparece: O item aparece para dono e administrador; não depende de módulo nem de plano. ### Quem pode usar - Dono: Vê o relatório, importa e desfaz planilhas de gasto e salva a porcentagem de receita do quadro. - Admin: Faz tudo o que o dono faz nesta tela. - Atendente: Não vê o item no menu; quem abre o endereço direto volta para o Painel. ### Telas #### Investimento → Venda A tela Investimento → Venda serve para ver quanto cada anúncio custou e quanto trouxe de venda, da campanha até o ganho, pelas etapas do quadro do Funil. Endereço no painel: `/app/investimento` ![Captura da tela Investimento → Venda. A tela Investimento → Venda serve para ver quanto cada anúncio custou e quanto trouxe de venda, da campanha até o ganho, pelas etapas do quadro do Funil.](https://attendto.com.br/prints-do-manual/investimento--investimento.png) A tela Investimento → Venda na conta de demonstração, com dados fictícios e os valores desfocados. Quem usa: Dono, Admin. ##### Cabeçalho O título do relatório e os dois atalhos da tela. Botões e ações: - **Histórico de importações**: Abre a gaveta com todas as planilhas de gasto já importadas, com a opção de desfazer. - **Importar gasto**: Leva até o cartão de importação, mais abaixo na página, e abre o primeiro passo. Também aparece: - Linha de apoio: Quanto cada anúncio custou e quanto trouxe de venda, da campanha até o ganho, pelas etapas do quadro. ##### Filtros do relatório Quadro, período e campanha. Os filtros ficam no endereço da página, então um link copiado abre o mesmo recorte. Campos e filtros: - **Quadro**: Escolhe qual quadro do Funil dá as etapas do relatório. Só aparece quando há mais de um quadro com o papel das colunas marcado. - **De**: Data inicial do período Personalizado. - **Até**: Data final do período Personalizado; não pode ser antes da inicial nem depois de hoje. - **Campanha de anúncio**: Recorta o relatório para uma campanha; a primeira opção, Todas as campanhas de anúncio, volta para o todo. Trocar o quadro limpa a campanha escolhida. Botões e ações: - **Este mês**: Período do primeiro dia do mês até hoje. É o que a tela abre. - **Mês passado**: O mês anterior inteiro. - **Últimos 90 dias**: Os 90 dias até hoje. - **Personalizado**: Mostra os campos de data De e Até e o botão Aplicar. - **Aplicar**: Aplica o período personalizado. Com datas trocadas, avisa Confira as datas e A data final precisa ser depois da inicial.; com intervalo longo demais, O período pode ter até 366 dias. Também aparece: - Etiqueta à direita: Leads que entraram de ‹período›, lembrando que o período filtra a entrada do lead. ##### Indicadores Os números de topo do período, calculados com o gasto importado. Campos e filtros: - **Quanto do valor ganho é receita da empresa, em porcentagem**: Campo que abre ao clicar em Receita:. Aceita de 0 a 100%, em passos de 0,5% (ex.: 7,5%). Vale para todos os períodos daquele quadro. Botões e ações: - **Receita:**: Mostra a parte do valor ganho que é receita (‹n›% do valor) e abre o campo para editar. Quando o número vem do Segmento da conta, aparece com a observação da comissão. - **Salvar**: Salva a porcentagem de receita do quadro e confirma com o aviso Receita de ‹n›% do valor salva. Também aparece: - Investimento: o gasto dos anúncios no período, com uma linha do gasto por dia. - ‹Ganhos›: quantos negócios chegaram à etapa de ganho do quadro, com o custo por ganho ou Nenhum ganho ainda. - Retorno sobre a receita: quantas vezes a receita estimada cobre o investimento, com ‹valor› de receita estimada ou Informe quanto do valor é receita para ver o retorno. - Leads: quantos leads de anúncio entraram e o custo por lead. - A primeira etapa do quadro e a etapa em destaque, cada uma com o custo e a porcentagem dos leads. - Valor ganho: o valor dos negócios ganhos e a média por ganho. ##### O funil em dinheiro Quantos chegaram a cada etapa do quadro e quanto custou cada um. Botões e ações: - **O que conta em ‹etapa›: ‹definição›**: Ícone de informação ao lado de cada etapa. Passar o mouse, focar ou tocar mostra o que conta naquela etapa; Esc fecha. Também aparece: - Primeira linha: Investimento, 100% do gasto. - Uma linha por etapa com o número, o custo por ‹etapa› (ou sem ‹etapa› ainda) e a porcentagem dos leads ou da etapa anterior. - Nota: As barras usam escala comprimida para as últimas etapas aparecerem. Os números são exatos. - Sem o papel das colunas marcado no quadro, aparece a dica para marcá-lo e o funil fica reduzido. ##### Coluna ao lado do funil Como o relatório conta, quantos leads ganharam nome de campanha e a última importação. Botões e ações: - **Ver o histórico e desfazer**: Abre a gaveta Histórico de importações. Também aparece: - Aviso Conta até hoje, não só no período: conta os leads que entraram no período e tudo o que aconteceu com eles até hoje, em horário de Brasília. - Quantos leads do WhatsApp vindos de anúncio ganharam nome de campanha e conjunto, com um exemplo da trilha. - Última importação: nome do arquivo, período, valor e Por ‹pessoa› em ‹data›. ##### Por campanha de anúncio A tabela em árvore campanha › conjunto › anúncio, com o custo de cada etapa e o retorno. Campos e filtros: - **Investimento**: Gasto importado da linha. - **Leads**: Leads que entraram pela linha. - **‹Ganhos›**: Negócios ganhos, com o nome da etapa de ganho do quadro. - **Custo por lead**: Investimento dividido pelos leads. - **Custo por ‹ganho›**: Investimento dividido pelos ganhos. - **Retorno**: Retorno sobre a receita, usando a porcentagem de receita salva. Botões e ações: - **Campanha**: Agrupa a tabela por campanha de anúncio. - **Conjunto**: Agrupa a tabela por conjunto. - **Anúncio**: Agrupa a tabela por anúncio. - **Abrir tudo**: Abre todas as linhas; com alguma aberta, o botão vira Fechar tudo. Não aparece no agrupamento por anúncio. - **Mostrar ‹o funil e os conjuntos› de ‹nome›**: Seta no começo de cada linha: abre as etapas do quadro, o valor ganho e os itens de baixo; clicar de novo esconde. - **Ordenar por ‹coluna›**: Clicar no título de uma coluna ordena a tabela por ela; clicar de novo inverte a ordem. - **Importar gasto**: Link na linha Leads de anúncio sem gasto importado: leva ao cartão de importação. Também aparece: - Linha aberta: as etapas do quadro com porcentagem dos leads ou da etapa anterior e o Valor ganho, com ‹n› sobre o investimento ou sem ganho ainda. - Subtítulo de cada linha: quantos conjuntos e anúncios ela tem, e o ID do anúncio no nível de anúncio. - Total com gasto importado: a soma de ‹n› campanhas de anúncio. - Fora da conta de custo: Leads de anúncio sem gasto importado, Anúncios que gastaram e não trouxeram lead (já somados nas campanhas) e Sem anúncio (orgânico, indicação e formulário do site). ##### Importar gasto O cartão em três passos (Enviar, Conferir, Pronto) que lê a planilha exportada do Gerenciador de Anúncios. Nada é gravado antes de confirmar. Campos e filtros: - **Campo para a coluna ‹coluna›**: No passo Conferir, cada coluna da planilha tem um seletor: Campanha de anúncio, Conjunto, Anúncio, ID do anúncio, Dia, Início do período, Fim do período, Valor gasto ou Não usar. Cada coluna leva o selo Reconhecida, Sem uso ou Repetida. - **Período da planilha**: Aparece quando a planilha não tem nenhuma coluna de data: informe as datas de início e fim que ela cobre. - **Nesta planilha, a vírgula separa:**: Pergunta que aparece quando os valores são ambíguos: escolha os milhares ou os centavos, com exemplos da coluna. Botões e ações: - **Solte a planilha aqui ou clique para escolher**: Passo Enviar: recebe o arquivo em CSV ou XLSX. Formato errado avisa Formato não aceito; arquivo grande demais pede um período menor. - **Baixar a planilha de exemplo**: Baixa uma planilha modelo com as colunas esperadas. - **Trocar arquivo**: No passo Conferir, volta para escolher outro arquivo. - **Mostrar essas linhas na prévia**: No aviso de ID arredondado, mostra na prévia as linhas afetadas. - **Voltar**: Volta ao passo Enviar sem gravar nada. - **Confirmar importação**: Grava o gasto. Fica apagado enquanto houver bloqueio (falta a coluna do valor, coluna repetida, vírgula sem resposta, período não informado). Mostra Importando… durante a gravação. - **Importar outra planilha**: No passo Pronto, recomeça o envio. - **Ver o relatório**: No passo Pronto, atualiza o relatório e rola a página até o topo. Também aparece: - Como exportar: escolher o período e o detalhamento por dia; incluir ID do anúncio, os nomes da campanha, do conjunto e do anúncio e o valor usado; exportar em CSV sem abrir antes num programa de planilhas. - Leitura da planilha: barra de progresso com Lendo as linhas… e Conferindo as colunas…. - Conferir mostra Período (detectado pela coluna Dia, pelas colunas de início e fim ou informado por você), Valor total em reais, Linhas (com as ignoradas e o motivo), Detalhamento (Por dia ou Por período) e campanhas e anúncios. - Avisos possíveis: IDs de anúncio arredondados, A planilha não traz o ID do anúncio, Sem detalhamento por dia, Falta a coluna do valor gasto, Duas colunas foram para o mesmo campo, Esta planilha substitui parte do que já foi importado, Esta planilha já foi importada e a soma possível com gasto já importado por campanha. - Prévia das 10 primeiras linhas, com Dia, Campanha, Conjunto, Anúncio, ID do anúncio e Valor usado. - Rodapé: Reimportar a mesma planilha nunca soma em dobro. - Pronto: Gasto importado (ou Esta planilha já estava importada), o período, as linhas e quantos leads de anúncio ganharam nome de campanha, que aparece no Inbox, no cartão do Funil e na ficha do lead. ##### Gaveta Histórico de importações Todas as planilhas importadas, da mais nova para a mais antiga. Desfazer apaga o gasto daquela planilha e devolve o que ela tinha substituído; os leads continuam. Botões e ações: - **Desfazer**: Abre a confirmação dentro do item. Quando não é possível desfazer, o botão fica apagado e a dica explica o motivo. - **Desfazer importação**: Confirma: Desfazer apaga ‹valor› de gasto. Os leads continuam, e o gasto que a planilha tinha substituído volta a valer. Avisa Importação desfeita. - **Cancelar**: Fecha a confirmação sem desfazer. Também aparece: - Cada item: nome do arquivo, quem importou e quando, Período, Total e, se houver, Observação. - Selo de situação: Valendo, Substituída, Substituída em parte ou Desfeita. - Vazia: Nenhuma importação ainda.; com erro: Não conseguimos abrir o histórico e o botão Tentar de novo. ##### Estados da tela - Carregando: Montando o relatório: blocos cinza no formato dos indicadores, do funil e da tabela. - Sem nada ainda: Importe o gasto para ver quanto custou cada venda, explicando que os leads já estão ali e falta o investimento, com o botão Enviar a planilha. - Se der erro: Não conseguimos montar o relatório agora, avisando que o gasto importado e os leads continuam salvos, com o botão Tentar de novo. ### Passo a passo #### Como importar a planilha de gasto dos anúncios 1. No Gerenciador de Anúncios, exporte o período com detalhamento **por dia** e as colunas **ID do anúncio**, nomes da campanha, do conjunto e do anúncio e **valor usado**, em CSV. 2. Em **Investimento**, clique em **Importar gasto**. 3. Solte o arquivo em **Solte a planilha aqui ou clique para escolher**. 4. No passo **Conferir**, ajuste o campo de cada coluna e responda aos avisos. 5. Clique em **Confirmar importação** e depois em **Ver o relatório**. #### Como ver o custo por lead e o custo por venda de cada campanha 1. Em **Investimento**, escolha o período (**Este mês**, **Mês passado**, **Últimos 90 dias** ou **Personalizado**). 2. Na tabela **Por campanha de anúncio**, leia as colunas **Custo por lead** e Custo por ‹ganho›. 3. Clique no título da coluna para ordenar e na seta da linha para abrir o funil daquela campanha. #### Como calcular o retorno sobre a receita (ROI) dos anúncios 1. No indicador **Retorno sobre a receita**, clique em **Receita:**. 2. Informe quanto do valor ganho é receita da empresa, em porcentagem. 3. Clique em **Salvar**: o retorno da tela e da tabela passa a usar esse número em todos os períodos do quadro. #### Como desfazer uma importação de gasto 1. Clique em **Histórico de importações** (ou em **Ver o histórico e desfazer**). 2. No item da planilha, clique em **Desfazer**. 3. Leia quanto de gasto sai e clique em **Desfazer importação**. #### Como ver o relatório de um período personalizado 1. Clique em **Personalizado**. 2. Preencha **De** e **Até**. 3. Clique em **Aplicar**; a etiqueta Leads que entraram de ‹período› mostra o intervalo usado. #### Como ver o relatório por conjunto ou por anúncio 1. Na tabela **Por campanha de anúncio**, clique em **Conjunto** ou **Anúncio** no seletor de agrupamento. 2. Use **Abrir tudo** para ver o funil de todas as linhas de uma vez. ### Perguntas frequentes #### Quem pode ver o relatório Investimento → Venda? Só o dono e o administrador. O atendente não vê o item no menu e, pelo endereço direto, volta ao Painel. #### Por que o seletor de Quadro não aparece? Ele só aparece quando a conta tem mais de um quadro com o papel das colunas marcado. Com um quadro só, o relatório usa esse quadro. #### A porcentagem de receita vale só para o período que estou vendo? Não. Ela é salva no quadro e vale para todos os períodos dele, na tela e na tabela. #### Posso mandar o link do relatório filtrado para alguém da equipe? Pode. Quadro, período e campanha ficam no endereço da página; quem abrir o link, sendo dono ou administrador, vê o mesmo recorte. #### O que entra em Fora da conta de custo? Leads de anúncio sem gasto importado, anúncios que gastaram e não trouxeram lead (esses já somam nas campanhas) e os leads sem anúncio, como orgânico, indicação e formulário do site. #### Por que uma campanha antiga ainda ganha vendas no relatório? Porque o relatório conta os leads que entraram no período e tudo o que aconteceu com eles até hoje. Um lead do mês passado que fechou hoje entra como ganho da campanha dele. #### Desfazer uma importação apaga os leads? Não. Desfazer tira só o gasto daquela planilha e devolve o gasto que ela tinha substituído. Os leads e os nomes de campanha continuam. ### Guia: Investimento → Venda Quanto custou cada venda, por campanha #### Exportar a planilha de gasto 1. **Escolha o período e o detalhamento por dia**: No Gerenciador de Anúncios, escolha o período e o detalhamento **por dia**. 2. **Inclua as colunas que o relatório usa**: Inclua as colunas **ID do anúncio**, os nomes da campanha, do conjunto e do anúncio, e o **valor usado**. 3. **Exporte em CSV e envie como veio**: Exporte em CSV e envie o arquivo como veio, sem abrir e salvar num editor de planilhas: isso arredonda os IDs. > **Os nomes das colunas:** A tela reconhece os nomes das colunas em português e em inglês (“Nome da campanha”, “Valor usado (BRL)”, “Ad ID”, “Day”…). Se alguma coluna vier com outro nome, escolha o campo dela no passo Conferir: a prévia mostra cada coluna e o que ela vira. #### Importar e conferir Em **Inteligência → Investimento → Importar gasto**, solte o arquivo. Antes de gravar, a tela mostra as colunas reconhecidas, o período, o total e os avisos. Reimportar a mesma planilha nunca soma em dobro: a planilha nova manda no período que ela cobre, e o gasto antigo fica guardado. Na tela: O cartão Importar gasto no passo Conferir: a ficha do arquivo, o período e o total detectados, as colunas da planilha com o campo de cada uma e a prévia das dez primeiras linhas. Nada é gravado antes do Confirmar importação. Um ID de anúncio arredondado aparece marcado na prévia. #### Como ler cada número Escolha o quadro no topo: as barras e as colunas da tabela seguem as etapas dele, e a coluna de ganho diz o que conta como venda. O número em destaque é o **retorno sobre a receita**: a parte do valor ganho que fica com a empresa (editável, de 0 a 100% em passos de 0,5%; no modelo Imobiliária, a comissão de 5%) dividida pelo investimento. Quando a receita é só uma parte do valor, o retorno sobre o valor ganho aparece embaixo. Na tela: A tela Investimento → Venda do quadro Imobiliária: os sete indicadores do mês, o funil em dinheiro com o custo de cada etapa, a nota dos leads que ganharam nome de campanha e a tabela por campanha de anúncio. Os indicadores do mês, com o retorno sobre a receita em destaque. 1. **Indicadores**: Investimento, vendas, retorno sobre a receita, leads, as duas etapas do quadro e o valor ganho. O botão “Receita” muda quanto do valor conta como receita. 2. **O funil em dinheiro**: Uma barra por etapa do quadro, com quantos chegaram e quanto custou cada um. Passe o mouse no “i” para ver o que conta em cada etapa. 3. **Por campanha de anúncio**: Abra a linha para ver cada etapa e os conjuntos; agrupe por conjunto ou anúncio; clique no título da coluna para ordenar. 4. **Fora da conta de custo**: Leads de anúncio sem gasto importado, anúncios que gastaram sem trazer lead e quem chegou sem anúncio: ficam fora do custo e do retorno. - **Investimento**: O gasto dos anúncios no período, pela planilha importada. Só entra o que foi importado. - **Leads**: Leads criados no período que vieram de um anúncio com gasto importado. Entram na coluna de entrada do quadro. - **Qualificados (pela IA ou pelo time)**: A IA qualificou ou o cartão chegou à coluna com o papel de qualificado — contando tudo o que aconteceu com o lead até hoje. - **Custo por etapa**: O investimento dividido por quantos chegaram à etapa: por lead, por qualificado, por pasta, por venda. - **Valor ganho**: A soma do valor dos negócios marcados como ganho, dos leads que entraram no período e passaram pelo quadro escolhido. A venda de outro quadro não entra na conta deste. #### Por que o número muda sozinho Um negócio pode levar meses para fechar. Os números contam os leads que **entraram** no período e tudo o que aconteceu com eles **até hoje**. Por isso uma campanha antiga ainda pode ganhar vendas. Datas no horário de Brasília. #### Desfazer uma importação No **Histórico de importações**, **Desfazer** apaga o gasto daquela planilha e devolve o que ela tinha substituído. Os leads continuam. Se uma importação mais nova substituiu parte desta, desfaça a mais nova primeiro. A pílula diz **Substituída** quando a planilha nova tomou o lugar da antiga inteira, e **Substituída em parte** quando tomou só um trecho (a observação diz qual): o resto continua valendo. Na tela: A tela Investimento → Venda sem gasto importado: a ilustração da planilha virando gráfico e o botão Enviar a planilha, com o cartão Importar gasto logo abaixo. Sem importação, a tela pede a planilha: os leads já estão lá, falta o quanto foi investido. #### Perguntas frequentes **O que é “Leads de anúncio sem gasto importado”?** São leads que vieram de um anúncio cujo gasto ainda não foi importado. Importe a planilha do período para ver o custo deles. **Os leads do WhatsApp ganham o nome da campanha?** Sim. O lead que chega por um anúncio de WhatsApp já traz o ID do anúncio; com a planilha importada, ele ganha o nome da campanha e do conjunto. **E se o meu quadro não tem papéis marcados?** A tela mostra a dica para marcar o papel das colunas em Configurar quadro → Colunas e etapas e, enquanto isso, o funil fica reduzido a Leads → Qualificados → Atendimento → Ganhos, pelos marcos que não dependem do quadro ([Funil por segmento](https://attendto.com.br/manual/funil)). **E se eu exportei sem o detalhamento por dia?** A planilha entra do mesmo jeito. Com as colunas de início e término dos relatórios, cada linha vale para o intervalo dela; sem nenhuma data, a tela pede o período que a planilha cobre. Nos dois casos o gasto de cada anúncio é distribuído igualmente entre os dias. **Enviei a planilha que tinha ID arredondado. Dá para corrigir?** Dá: envie o arquivo exportado original, do mesmo período. O gasto do mesmo anúncio é substituído, não somado, e os leads passam a casar com o anúncio. **A exportação veio com a linha de total do período. Ela soma?** Não. A linha sem nome de campanha, de conjunto e de anúncio e sem ID, numa planilha em que as outras linhas têm, é o total do período: o passo Conferir mostra ela como ignorada (“linha de total da planilha”) e ela fica fora do investimento. **Reenviei uma planilha que já tinha importado. O que acontece?** Se ela ainda vale inteira, nada é somado: a tela diz que ela já estava importada. Se uma planilha mais nova substituiu parte dela, reenviar faz a antiga voltar a valer no período que ela cobre, e o passo Conferir avisa o que vai ser substituído antes de confirmar. **Qual o maior período que o relatório mostra?** No Personalizado, até 366 dias. Para comparar anos diferentes, veja um de cada vez. **Posso importar uma planilha só com o ID do anúncio?** Pode, mas inclua também os nomes da campanha, do conjunto e do anúncio se o mesmo período já tem gasto importado só por campanha. Sem os nomes, não dá para saber que é o mesmo gasto, e a tela avisa antes de confirmar que ele pode ser somado duas vezes. **A planilha tem dado pessoal?** Não: só campanha, conjunto, anúncio, dia e valor. Nenhum nome ou telefone de lead entra nela nem sai do relatório. No painel: Abrir Investimento → Venda. Como as pessoas procuram: custo por lead; custo por venda; roi de anúncios; retorno sobre investimento em anúncios; importar gasto do gerenciador de anúncios; planilha de gasto de anúncios; quanto custou cada venda; relatório de campanhas de anúncio; desfazer importação de gasto; funil em dinheiro; anúncio que mais vende. ## Pergunte à IA: objeções dos leads, qualificações e perguntas sobre os números da conta URL: https://attendto.com.br/manual/pergunte-a-ia Menu: Inteligência > Pergunte à IA A tela Pergunte à IA serve para fazer perguntas em linguagem natural sobre os números da conta e ver, com a frase do próprio lead como prova, quais objeções mais travam as vendas. ### Quem pode usar - Dono: Vê a tela inteira e faz perguntas na caixa. - Admin: Vê a tela inteira e faz perguntas, como o dono. - Atendente: Também vê o item no menu, lê o relatório e faz perguntas. ### Telas #### Pergunte à IA A tela Pergunte à IA serve para perguntar sobre os números agregados da conta e ler o relatório de objeções, qualificações, transbordos e intenções do período. Endereço no painel: `/app/pergunte` ![Captura da tela Pergunte à IA. A tela Pergunte à IA serve para perguntar sobre os números agregados da conta e ler o relatório de objeções, qualificações, transbordos e intenções do período.](https://attendto.com.br/prints-do-manual/pergunte-a-ia--pergunte.png) A tela Pergunte à IA na conta de demonstração, com dados fictícios e os valores desfocados. ##### Período Os botões do topo escolhem o período do relatório abaixo da caixa de pergunta. Botões e ações: - **Últimos 30 dias**: Mostra o relatório dos últimos 30 dias. É o período que a tela abre. - **Últimos 7 dias**: Encurta o relatório para os últimos 7 dias. - **Hoje**: Mostra só o dia de hoje. Também aparece: - Ao trocar o período, o relatório anterior continua na tela até o novo chegar. ##### Caixa Pergunte à IA Uma pergunta livre respondida com os números reais da conta. Campos e filtros: - **Sua pergunta sobre os últimos 30 dias**: O campo de texto da pergunta, com o exemplo Ex.: qual objeção mais trava as minhas vendas?. Aceita uma frase curta; Enter envia. Botões e ações: - **Perguntar**: Envia a pergunta. Fica apagado com o campo vazio e mostra Analisando… enquanto a resposta é montada. - **Quais são as principais objeções dos meus leads?**: Sugestão pronta: preenche o campo com a pergunta e envia na hora. - **Por que os leads não fecham?**: Sugestão pronta: envia a pergunta na hora. - **Como estão as qualificações deste mês?**: Sugestão pronta: envia a pergunta na hora. - **Por que os leads pedem atendimento humano?**: Sugestão pronta: envia a pergunta na hora. - **Ver os números usados**: Abre, abaixo da resposta, a lista dos números da conta que sustentam a resposta. - **Esconder os números usados**: Fecha a lista dos números usados. - **Tentar de novo**: Aparece quando a resposta falha. Reenvia a mesma pergunta. Também aparece: - Subtítulo: Ela responde com os números reais da sua conta — nunca com achismo. - Selo da resposta: Resposta da IA quando o texto foi redigido pela IA; Resumo dos números quando a resposta é o resumo direto dos agregados. - Antes da primeira pergunta, a dica: Escolha uma sugestão ou escreva a sua pergunta — a resposta usa só os agregados do período, nunca as conversas. - Em conta sem conversas analisadas, a dica muda para: Assim que a IA tiver conversas analisadas, as respostas passam a vir com os seus números. ##### Objeções mais frequentes O ranking dos tipos de objeção do período, cada um com a frase do lead como evidência. Botões e ações: - **‹tipo de objeção›**: Cada linha é um botão: clicar abre as frases reais que sustentam o número; clicar de novo fecha. Passar o mouse no nome mostra o que conta como aquele tipo. - **‹nome do lead›**: Dentro de uma objeção aberta, o nome de quem disse a frase abre a ficha do lead no CRM. Também aparece: - Subtítulo: O que os leads dizem quando travam — com a frase de cada um como prova. - Resumo do topo: ‹n› leads trouxeram objeção no período e ‹n› achados (passe o mouse em achados para ver como se conta). - Cada linha mostra o tipo, quantos leads, a porcentagem e uma barra. - Cada evidência mostra a frase entre aspas, o nome do lead e a data. - Rodapé: As porcentagens somam 100% — a fração de cada objeção entre os leads que objetaram. - Objeção sem frase guardada mostra Sem evidências guardadas. ##### Qualificações do período Leads novos por faixa de qualificação e a evolução semana a semana. Também aparece: - Uma linha por faixa: Quente, Morno, Frio e Sem score, com número, porcentagem e barra na cor da faixa. - Leads novos por semana: barras empilhadas por faixa; passar o mouse mostra a semana, o total e quantos de cada faixa. - O gráfico semanal só aparece quando o período cobre mais de uma semana. ##### Por que a IA chamou um humano Os motivos dos transbordos do período, com quantas vezes cada um aconteceu. Também aparece: - Subtítulo com o total: ‹n› transbordos no período. - Uma linha por motivo com a contagem (‹n›x). ##### O que os leads mais pedem As intenções detectadas pela IA nas conversas do período. Também aparece: - Uma linha por intenção com quantas vezes apareceu, a porcentagem e uma barra. ##### Estados da tela - Carregando: Três blocos cinza no lugar dos cartões; durante uma pergunta, linhas cinza no lugar da resposta. - Sem nada ainda: Sem achados, o ranking diz Ainda não há conversas suficientes analisadas. Sem leads novos, Qualificações diz Sem leads novos no período. Sem transbordos: Nenhum transbordo no período — a IA segurou as conversas sozinha. Sem intenções: Sem intenções detectadas no período. - Se der erro: O relatório que não carrega mostra Não foi possível carregar o relatório. e o botão Tentar novamente. A pergunta que falha mostra a frase do motivo (ou Não consegui responder agora.) e Tentar de novo. ### Passo a passo #### Como descobrir as principais objeções dos leads 1. Abra **Pergunte à IA** no menu, no grupo Inteligência. 2. Leia o cartão **Objeções mais frequentes**: o tipo do topo é o que mais aparece. 3. Clique na linha para abrir as frases dos leads e ver como cada um falou. #### Como fazer uma pergunta para a IA sobre os números da conta 1. Escreva no campo da caixa **Pergunte à IA**, por exemplo qual objeção mais trava as vendas. 2. Clique em **Perguntar** (ou tecle Enter). 3. Para conferir de onde veio a resposta, clique em **Ver os números usados**. #### Como abrir a ficha do lead que fez uma objeção 1. No cartão **Objeções mais frequentes**, clique no tipo de objeção. 2. Na frase que interessa, clique no nome do lead. 3. A ficha do lead abre no CRM, com a conversa e a jornada. #### Como ver por que a IA transfere conversas para a equipe 1. Em **Pergunte à IA**, escolha o período. 2. Leia o cartão **Por que a IA chamou um humano**, com cada motivo e quantas vezes aconteceu. 3. Ou clique na sugestão **Por que os leads pedem atendimento humano?** para receber o resumo por escrito. ### Perguntas frequentes #### Os botões de período mudam a resposta da caixa de pergunta? Não. Os botões mudam o relatório abaixo da caixa. A caixa responde sobre os últimos 30 dias, como diz o rótulo do campo. #### O atendente pode usar a caixa Pergunte à IA? Pode. O item aparece para todos os papéis da equipe e a resposta usa só números agregados, sem nome nem conversa de lead. #### Qual a diferença entre Resposta da IA e Resumo dos números? Os números são os mesmos. Resposta da IA é o texto redigido pela IA; Resumo dos números aparece quando a resposta é o resumo direto dos agregados, sem a redação. #### Posso perguntar sobre um lead específico? A caixa responde sobre o período inteiro, não sobre uma pessoa. Para ver o que um lead disse, abra a frase dele no ranking de objeções e clique no nome para ir à ficha. #### Por que a soma das porcentagens das objeções dá 100%? Porque cada porcentagem é a fatia daquele tipo entre os leads que trouxeram alguma objeção no período, não entre todos os leads. #### As faixas de qualificação usam que régua? A mesma da qualificação dos leads: Quente, Morno e Frio pela nota BANT, e Sem score para quem ainda não foi avaliado. ### Guia: Pergunte à IA As objeções dos últimos 30 dias com a frequência de cada uma, a prova na frase do lead — e uma caixa para perguntar o que quiser sobre os números. Toda semana algum lead diz **“tá caro”**, outro diz **“depois eu vejo”** — e essas frases se perdem no meio das conversas. Esta tela junta todas elas: as objeções dos últimos 30 dias, **quantos leads** trouxeram cada uma, a **porcentagem** de cada tipo e a **frase exata** de quem disse. No topo, a caixa **Pergunte à IA** responde qualquer pergunta sua usando esses números. > **Pode perguntar sem medo:** A tela é só leitura, e a resposta da caixa usa **apenas os números agregados** do período — a IA não relê as suas conversas nem cita o que um lead disse em privado. Perguntar não envia mensagem a ninguém e não gasta o saldo de atendimento. #### A tela por partes Na tela: Tela Pergunte à IA com a caixa de pergunta no topo, o ranking de objeções à esquerda e os cards de qualificações, transbordos e intenções à direita. O relatório dos últimos 30 dias: pergunta livre no topo, objeções com porcentagem e prova embaixo. 1. **A pergunta livre**: Escreva do seu jeito (“qual objeção mais trava as minhas vendas?”) ou clique numa **sugestão pronta**. A resposta vem em segundos, com os números do período — e o selo diz se foi **redigida pela IA** ou se é o **resumo direto dos números**. 2. **O ranking de objeções**: Cada linha é um tipo de objeção, do mais frequente para o menos. A porcentagem é a fatia daquele tipo **entre os leads que objetaram** — as fatias somam 100%. Passe o mouse no nome para ver o que conta como cada tipo. 3. **A prova, na frase do lead**: Clique numa linha e ela abre as **frases reais** que sustentam o número — quem disse, quando, e um atalho para a ficha do lead. É a diferença entre “preço aparece muito” e saber exatamente **como** o lead falou de preço. 4. **Qualificações do período**: Os leads novos por banda — quente, morno, frio e sem nota — e a evolução semana a semana. Banda é a régua de qualificação explicada em [Qualificação](https://attendto.com.br/manual/qualificacao). 5. **Transbordos e pedidos**: Por que a IA chamou uma pessoa no período — e, rolando a tela, o que os leads mais pediram nas conversas. O caminho do transbordo em si está em [Transbordo para humano](https://attendto.com.br/manual/handoff). #### De onde vêm os números Ninguém varre as suas conversas quando você abre a tela. A cada mensagem de lead, a IA que já conversa por você **anota na hora** quando aparece uma objeção — o tipo dela e a frase dita — e o relatório só soma o que foi anotado. Por isso ele abre instantâneo e por isso a evidência é sempre uma frase que existe de verdade na conversa. - **Os sete tipos**: **Preço**, **Tempo e prioridade**, **Confiança**, **Concorrente**, **Adiamento**, **Sem necessidade** e **Outra objeção**. Pergunta de preço não conta: objeção exige resistência (“tá caro”), não curiosidade (“quanto custa?”). - **Como se conta**: Cada lead conta **uma vez** por tipo de objeção — quem repetiu “tá caro” em três mensagens é um lead só no número, e as três frases ficam como evidência. - **A porcentagem**: É a fatia de cada tipo entre os leads que trouxeram objeção. As fatias fecham em **100%** — se preço mostra 28,6%, é porque 28,6% de quem objetou falou de preço. - **Na jornada do lead**: O achado também aparece na ficha de cada lead, na jornada, como decisão do **Detector de Objeções** — o mesmo rastro dos outros agentes, explicado em [O que a IA faz por dentro](https://attendto.com.br/manual/barra-do-topo). #### Como perguntar bem 1. **Comece pelas sugestões**: “Por que os leads não fecham?” já devolve o retrato inteiro: objeções, qualificações e transbordos numa resposta só. 2. **Pergunte sobre o período, não sobre uma pessoa**: A caixa responde com agregados — “qual a maior objeção?” funciona; “o que a Maria disse ontem?” não é papel dela (isso está no [Inbox](https://attendto.com.br/manual/inbox), na conversa). 3. **Use a resposta para agir num lugar só**: Preço no topo? Ajuste a oferta no [Intent & catálogo](https://attendto.com.br/manual/intent-e-catalogo) ou grave uma resposta com a sua voz. Confiança subindo? Alimente a [Base de conhecimento](https://attendto.com.br/manual/base-de-conhecimento) com casos reais. 4. **Volte em sete dias**: A mesma pergunta, uma semana depois, diz se a mudança mexeu no número — é o mesmo hábito de leitura do [Analytics](https://attendto.com.br/manual/analytics). #### Quando a tela parece errada - **“Ainda não há conversas suficientes analisadas”:** é o estado normal de conta nova. Os achados começam a aparecer conforme a IA conversa — nada para configurar. - **Objeção que você ouviu e não está aqui:** a IA só anota o que o lead **escreveu nas conversas dela**. O que foi dito por telefone ou com o atendente humano não entra. - **A resposta veio como “resumo dos números”:** o ambiente está sem o modelo de redação no momento; os números são os mesmos, só muda o texto em volta. - **Número diferente do Analytics:** aqui conta quem **trouxe objeção no período** — inclusive leads mais antigos que seguiram conversando; lá, o funil dos leads novos. São recortes diferentes do mesmo mês. No painel: Abrir Pergunte à IA. Como as pessoas procuram: objeções dos leads; por que os leads não compram; perguntar para a ia sobre vendas; relatório de objeções; o que trava as vendas; motivos de transbordo; intenções dos clientes; qualificação dos leads do mês; ia que analisa conversas; frase do lead como evidência. ## Monitor de sucesso: análise RFV de clientes, importação de pedidos e agentes de reativação URL: https://attendto.com.br/manual/monitor-de-sucesso Menu: Inteligência > Monitor de sucesso O Monitor de sucesso é a tela que separa quem já comprou em grupos RFV (recência, frequência e valor), mostra as vendas e os pedidos em aberto e cria agentes de IA para reengajar cada grupo. ### Quem pode usar - Dono: Vê a tela, importa pedidos, baixa o relatório e é o único que salva e ativa um agente especialista, dispara e pausa ou ativa agentes. - Admin: Vê a tela, importa pedidos, baixa o relatório e pode abrir o rascunho de um agente; salvar e ativar, disparar e pausar ficam com o dono. - Atendente: Vê o item no menu e lê a tela e o relatório; importar pedidos é recusado com o aviso de que a conta não tem permissão. ### Telas #### Monitor de sucesso A tela Monitor de sucesso serve para ver a saúde da base de clientes pelos pedidos reais, achar quem está esfriando e montar uma abordagem de reengajamento para cada grupo. Endereço no painel: `/app/monitor` ![Captura da tela Monitor de sucesso. A tela Monitor de sucesso serve para ver a saúde da base de clientes pelos pedidos reais, achar quem está esfriando e montar uma abordagem de reengajamento para cada grupo.](https://attendto.com.br/prints-do-manual/monitor-de-sucesso--monitor.png) A tela Monitor de sucesso na conta de demonstração, com dados fictícios e os valores desfocados. ##### Cabeçalho A origem dos dados, o tamanho da base, o período das vendas e as ações principais. Botões e ações: - **7 dias**: Mostra no cartão de vendas os últimos 7 dias. - **30 dias**: Mostra no cartão de vendas os últimos 30 dias. É o período que a tela abre. - **90 dias**: Mostra no cartão de vendas os últimos 90 dias. - **Importar pedidos** (Dono, Admin): Abre o diálogo para enviar a planilha CSV de pedidos. - **Baixar relatório**: Baixa uma planilha CSV com cada grupo (clientes, recência, frequência e valor médio) e as vendas do período. Também aparece: - Selo Importação · atualizado há ‹tempo›, quando já houve importação. - Contagem: ‹n› clientes · ‹n› pedidos. - O seletor de dias muda só o cartão de vendas; grupos, gráfico e pedidos em aberto usam todo o histórico. ##### Cartões de saúde da base Três cartões que juntam os grupos por situação. Botões e ações: - **‹grupo› · ‹n›**: Cada etiqueta de grupo dentro do cartão destaca esse grupo no gráfico e na lista; clicar de novo tira o destaque. Também aparece: - Melhores clientes: fidelidade e retenção. - Com potencial: prontos para upsell. - Prioridade de atenção: risco de churn. - Cada cartão mostra o total de clientes e as etiquetas dos grupos que o compõem. ##### AGRUPAMENTOS RFV O gráfico de bolhas Recência × Frequência + Valor, uma bolha por grupo. Botões e ações: - **‹grupo›: ‹n› clientes**: Cada bolha é clicável (ou Enter e espaço no teclado): destaca o grupo na lista; os outros ficam apagados. Também aparece: - Eixo horizontal: ← recente à esquerda, inativo → à direita. - Eixo vertical: Frequência + Valor ↑. - O tamanho da bolha é a quantidade de clientes; o número dentro dela também. - Grupos sem clientes não aparecem no gráfico. ##### Vendas Os números de venda do período escolhido no cabeçalho. Também aparece: - Receita - Ticket médio - Pedidos - Recência média, em dias ##### PEDIDOS EM ABERTO Quantos pedidos ainda não foram pagos e podem ser recuperados. Também aparece: - O total de pedidos em aberto e a linha recuperáveis · ticket médio ‹valor›. ##### GRUPOS A lista dos oito grupos RFV com os números de cada um. Botões e ações: - **Criar agente**: Abre o diálogo do agente especialista daquele grupo, com a abordagem escrita pela IA. Fica apagado em grupo sem clientes. Também aparece: - Cada linha: a cor do grupo, o nome, a quantidade de clientes, ‹dias›d · ‹compras›x (recência e frequência) e o valor médio. - Em telas estreitas, recência, frequência e valor somem e o botão fica só com o ícone. ##### MAIS VENDIDOS Os produtos que mais faturaram, quando os pedidos trazem os itens. Também aparece: - Posição, nome do produto e uma barra proporcional à receita. - Selo catálogo quando o produto está ligado ao catálogo da conta. - À direita: a receita, as unidades (un) e os pedidos (ped). ##### AGENTES ESPECIALISTAS Os agentes já salvos, um por grupo, com o estado e as ações. Aparece só depois do primeiro agente salvo. Botões e ações: - **Disparar** (Dono): Envia agora a primeira mensagem do agente para os leads daquele grupo. Manda mensagem de verdade e debita saldo. Mostra Disparando… enquanto envia e fica apagado com o agente pausado. - **Pausar** (Dono): Botão de ícone (dica Pausar) que pausa o agente; com ele pausado, a dica vira Ativar e o botão o liga de novo. Também aparece: - Nome do agente, o objetivo e quantos disparos já fez. - Selo Ativo ou Pausado. - Depois de disparar, um aviso mostra o resultado do envio. ##### Diálogo Importar pedidos Envia a planilha CSV de pedidos que alimenta o RFV; cada pedido é casado com um contato por telefone ou e-mail. Botões e ações: - **Arraste o CSV ou clique para escolher**: Área de envio: solte o arquivo ou clique para escolher. Mostra Importando… durante o envio. Aceita só arquivo .csv. - **Baixar modelo de CSV**: Baixa uma planilha de exemplo com as colunas na ordem certa. - **Importar outro arquivo**: Depois do resultado, volta para a área de envio. - **Fechar**: Fecha o diálogo; depois de uma importação, o botão diz Concluir. Também aparece: - Colunas esperadas: telefone/e-mail · id do pedido · valor · data · status. - Aviso fixo: Reimportar não duplica (idempotente por id do pedido). - Resultado: Importados, Atualizados e Clientes, e a frase ‹n› pedido(s) no RFV, de ‹n› linha(s). - Se nenhum pedido casar: Nenhum pedido casou com um contato existente. - Linhas ignoradas: a contagem e a lista com o número da linha e o motivo. - Falha: o quadro vermelho A importação não foi concluída, com o motivo. ##### Diálogo Agente especialista · ‹grupo› A IA redige a abordagem para o grupo; você escolhe o objetivo, confere e ativa. Botões e ações: - **Fidelização**: Reescreve a abordagem para manter quem já é bom cliente. - **Upsell e expansão**: Reescreve a abordagem para vender mais a quem já compra. - **Reativação**: Reescreve a abordagem para chamar de volta quem parou. - **Retenção (anti-churn)**: Reescreve a abordagem para segurar quem está prestes a sair. - **Copiar**: Copia a primeira mensagem para a área de transferência. - **Fechar**: Fecha sem salvar. - **Salvar e ativar agente** (Dono): Salva a estratégia e a primeira mensagem e deixa o agente ativo na lista de Agentes especialistas. Mostra Ativando… enquanto salva. Também aparece: - Ao abrir, a IA já escreve com o objetivo sugerido para o grupo, que vem marcado. - Estratégia: o plano da abordagem. - Primeira mensagem: o texto que o lead recebe; {nome} é trocado pelo nome de cada lead no disparo. - Cuidados (guardrail · LGPD): os cuidados que a mensagem respeita. - Enquanto escreve, aparece A IA está redigindo a abordagem…. ##### Estados da tela - Carregando: Dois blocos cinza no lugar do cabeçalho e do gráfico. - Sem nada ainda: Sem nenhum pedido, a tela mostra Traga suas vendas para o Monitor, o botão Importar pedidos, três dicas (Grupos automáticos, Agentes por grupo, Vendas a recuperar) e o atalho Integrações para receber os pedidos do seu sistema automaticamente. - Se der erro: Não foi possível carregar o monitor, avisando que isso não quer dizer que não há clientes em risco e que clientes e pedidos continuam salvos, com o botão Tentar de novo. ### Passo a passo #### Como importar pedidos por planilha CSV 1. Garanta que os clientes já existem como contatos, com telefone ou e-mail iguais aos da planilha. 2. No **Monitor de sucesso**, clique em **Importar pedidos**. 3. Se precisar, clique em **Baixar modelo de CSV** e preencha em cima dele. 4. Arraste o arquivo para **Arraste o CSV ou clique para escolher**. 5. Confira Importados, Atualizados e as linhas ignoradas, e clique em **Concluir**. #### Como criar um agente de reativação para um grupo de clientes 1. Na lista **GRUPOS**, clique em **Criar agente** na linha do grupo. 2. Escolha o objetivo, por exemplo **Reativação**; a IA reescreve a abordagem. 3. Leia a estratégia, a primeira mensagem e os cuidados. 4. Clique em **Salvar e ativar agente** (só o dono). #### Como disparar o agente especialista para um grupo 1. Em **AGENTES ESPECIALISTAS**, confira se o agente está **Ativo**. 2. Clique em **Disparar**: a mensagem sai de verdade e debita o saldo. 3. Leia o aviso com o resultado e acompanhe as respostas no Inbox. #### Como pausar um agente especialista 1. Em **AGENTES ESPECIALISTAS**, ache a linha do agente. 2. Clique no botão de pausa (dica **Pausar**); o selo muda para **Pausado** e **Disparar** fica apagado. 3. Para voltar, clique no mesmo botão, agora com a dica **Ativar**. #### Como exportar os grupos RFV para uma planilha 1. Escolha o período das vendas no cabeçalho. 2. Clique em **Baixar relatório**. 3. Abra o arquivo baixado: uma linha por grupo e, abaixo, as vendas e os pedidos em aberto. ### Perguntas frequentes #### Quem pode salvar e disparar um agente especialista? Só o dono da conta salva e ativa o agente, dispara e pausa. Administradores importam pedidos e podem ver o rascunho da abordagem. #### O que é RFV no Monitor de sucesso? É a combinação de recência (há quanto tempo foi a última compra), frequência (quantas compras) e valor (quanto o cliente gastou). Os grupos saem dessa combinação. #### Abrir o Criar agente já envia mensagem? Não. O diálogo só escreve o rascunho. Nada é enviado até o agente ser salvo e alguém clicar em Disparar. #### Dá para receber os pedidos sem planilha? Sim. Pelo atalho Integrações, o seu sistema de vendas ou loja virtual manda os pedidos sozinho, e o Monitor se atualiza com eles. #### O que o relatório baixado traz? Uma planilha com cada grupo (clientes, recência, frequência e valor médio) e, abaixo, as vendas do período escolhido, o ticket médio, a receita e os pedidos em aberto. #### Por que o botão Criar agente está apagado em alguns grupos? Porque o grupo está sem clientes. Sem ninguém para receber a mensagem, não há agente para criar. #### O que acontece se eu mudar o objetivo no diálogo do agente? A IA escreve de novo a estratégia e a primeira mensagem para o objetivo escolhido. Só a última versão é salva quando você ativa o agente. ### Guia: Monitor de sucesso Quem já comprou, separado em grupos: quem é campeão, quem está sumindo e quem precisa de um empurrão agora. Todas as outras telas olham para quem está chegando. Esta olha para **quem já comprou**. Ela separa a sua base de clientes em grupos por comportamento de compra e diz, para cada grupo, o que fazer: manter, crescer, chamar de volta ou deixar quieto. A decisão daqui é onde colocar a sua atenção de pós-venda nesta semana. Quase sempre a resposta está no card **Prioridade de atenção**: quem gastou bem com você e está esfriando vale mais que dez leads novos. > **Sem pedido, não existe grupo:** Esta tela é alimentada **só por pedidos**. Ou você importa uma planilha aqui, ou o seu sistema manda os pedidos por [Integrações](https://attendto.com.br/manual/integracoes). Enquanto nenhum pedido entrar, tudo aparece zerado — e não é a sua base que está vazia, é a informação de compra que não chegou. #### A tela por partes Na tela: Monitor de sucesso com três cards de saúde no topo, o gráfico de agrupamentos, o card de vendas, os pedidos em aberto e a lista de grupos. Oito clientes e doze pedidos importados. 1. **Este seletor muda um card só**: **7 / 30 / 90 dias** mexe **apenas no card de vendas** (receita, ticket médio, número de pedidos, recência média). Os grupos, o gráfico, a lista de grupos e os pedidos em aberto usam **todo o histórico**, sempre. A tela não avisa isso em lugar nenhum. 2. **Importar pedidos e Baixar relatório**: **Importar pedidos** é de onde vem tudo o que você vê aqui. **Baixar relatório** exporta os grupos e as vendas em planilha, para levar para uma reunião ou para o contador. 3. **Os três cards de saúde**: Eles juntam os oito grupos em três leituras: **Melhores clientes** (Campeões + Leais), **Com potencial** (Potencialmente leais + Recentes) e **Prioridade de atenção** (Precisam de atenção + Não podem ser perdidos + Em risco). Onde a tela escreve `prontos para upsell`, leia **prontos para comprar mais**; onde escreve `risco de churn`, leia **risco de parar de comprar**. O grupo **Perdidos** não entra em card nenhum. 4. **O mapa dos grupos**: Cada bolha é um grupo e o tamanho dela é quanta gente tem dentro. Da esquerda (`recente`) para a direita (`inativo`) é há quanto tempo compraram; para cima é comprar mais vezes. Bolha grande à direita e embaixo é dinheiro indo embora. 5. **Vendas e pedidos em aberto**: **Vendas** é o único bloco que obedece ao seletor de dias: receita, ticket médio (quanto rende um pedido, em média), quantidade de pedidos e recência média (há quantos dias, em média, foi a última compra). **Pedidos em aberto** é dinheiro no meio do caminho: pedido que existe e não foi pago. 6. **Grupos, e o botão que gasta**: Cada grupo com quanta gente tem, há quantos dias compraram e quanto valem. **Criar agente** monta a abordagem para aquele grupo — e disparar dali **envia mensagem de verdade e debita saldo**. É a ação mais cara desta tela. #### Os oito grupos e o que fazer com cada um - **Campeões**: Compram muito, com frequência e faz pouco tempo. Não venda nada: peça indicação e depoimento. É a sua reserva. - **Leais**: Voltam sempre, mesmo gastando menos. Aqui a conta fecha com condição para quem é de casa e com novidade em primeira mão. - **Potencialmente leais**: Compraram há pouco e já repetiram alguma vez. É o grupo com maior retorno por mensagem enviada: falta pouco para virarem Leais. - **Recentes**: Chegaram agora, quase sempre com uma compra só. O que decide o futuro deles é o pós-venda das primeiras semanas, não desconto. - **Precisam de atenção**: Eram bons e estão espaçando as compras. É o momento barato de agir — mais tarde eles viram Em risco. - **Não podem ser perdidos**: Gastaram muito e sumiram. Cada nome aqui vale uma ligação de gente, não uma mensagem automática. - **Em risco**: Compravam com alguma constância e pararam. Vale uma oferta de volta com prazo. - **Perdidos**: Faz muito tempo, valor baixo. Não gaste aqui todo mês. Uma tentativa de reativação por trimestre é honesto; mais que isso é queimar saldo. #### Como o grupo de cada cliente é decidido A tela chama isso de **agrupamentos RFV**, que é o apelido de três perguntas: **R** de recência (há quantos dias foi a última compra), **F** de frequência (quantas compras ao todo) e **V** de valor (quanto essa pessoa já gastou). Cada uma das três vira uma nota de 1 a 5, e é aqui que mora a parte que confunde: a nota sai da **comparação com o resto da sua base**, não de uma faixa fixa. É ranking. > **Um cliente muda de grupo sem ter feito nada:** Como a nota é comparação, quando os outros se mexem ele se mexe junto. Alguém pode sair de **Campeões** sem ter deixado de comprar — só porque chegou gente comprando mais. Ao ver uma mudança de grupo, pergunte primeiro o que mudou na base inteira. - Só **pedido pago** entra na classificação. É ele que forma os grupos, o gráfico e a lista de grupos. - **Pedido em aberto** não classifica ninguém: alimenta apenas o card de pedidos em aberto, que é a sua lista de cobrança. - **Pedido cancelado** é ignorado por completo, como se não existisse. #### O seletor de dias engana Vale repetir fora do print, porque é o erro de leitura mais comum daqui: trocar entre **7, 30 e 90 dias** muda **somente o card de vendas**. Gráfico, lista de grupos e pedidos em aberto continuam calculados sobre todo o histórico de compras. Na prática: você clica em 7 dias, vê a receita despencar e conclui que perdeu clientes. Não perdeu — a receita é da semana e os grupos são de sempre. Compare receita com receita, e olhe os grupos como o retrato da base inteira. #### Importar os seus pedidos 1. **Importe os contatos antes**: Cada pedido é casado com um contato **por telefone ou e-mail**. Se o contato não existir, a linha é descartada em silêncio. Comece pela [Base de contatos](https://attendto.com.br/manual/base-de-contatos) e só depois volte aqui. 2. **Baixe o modelo de CSV**: O botão **Baixar modelo de CSV** entrega o arquivo com as colunas certas na ordem certa. Preencher em cima do modelo evita metade dos problemas. 3. **Confira a coluna de situação do pedido**: É a coluna que decide se o pedido conta como venda. Preencha todas as linhas: pago, em aberto ou cancelado. 4. **Respeite os limites do arquivo**: Só `.csv`, no máximo **5 MB** e **50.000 linhas**. Planilha maior, divida em duas — importar duas vezes não é problema. 5. **Importe e confira o cabeçalho da tela**: No topo aparece a origem dos dados e quantos clientes e pedidos existem. Se o número de pedidos veio muito menor que o do arquivo, foram linhas descartadas por contato inexistente. > **Situação em branco vira pago:** Linha com situação desconhecida ou vazia entra como **pago**. Um arquivo sem a coluna de situação transforma a sua base inteira em vendas pagas, infla a receita e joga gente para os grupos errados. Confira essa coluna antes de subir o arquivo. > **Reimportar não duplica, mas sobrescreve:** Os pedidos são casados pelo número do pedido, então subir o mesmo arquivo duas vezes não cria pedido repetido. Só que a segunda importação **atualiza** o que já existia: um arquivo com valor errado apaga o valor certo, e não há desfazer. Corrija a planilha, não a tela. #### Criar agente para um grupo Na lista de grupos, **Criar agente** abre um diálogo onde a abordagem é escrita para aquele grupo específico. Você escolhe o objetivo, e é o objetivo que muda o tom e o pedido da conversa: - **Fidelização**: Manter quem já é bom. Serve para Campeões e Leais, sem oferta agressiva. - **Upsell e expansão**: Vender mais para quem já compra. Combina com Potencialmente leais e com Campeões que ainda só usam uma parte do que você vende. - **Reativação**: Chamar de volta quem parou. É o caminho de Em risco e de Perdidos. - **Retenção (anti-churn)**: Segurar quem está prestes a sair — churn é quando o cliente para de comprar de vez. É o objetivo de Precisam de atenção e Não podem ser perdidos. > **Disparar aqui gasta dinheiro de verdade:** O botão **Disparar** manda mensagem real e debita o saldo, uma cobrança por pessoa. São no máximo **20 contatos por disparo**, e ficam de fora quem não deu consentimento, quem recebeu algo nos últimos 14 dias e quem está em atendimento humano no momento. Se o saldo ou o limite de gasto não cobrirem, o disparo não sai. > **Comece pelo grupo pequeno e caro:** Vinte contatos de **Não podem ser perdidos** valem mais que vinte de **Perdidos** pelo mesmo preço. Dispare para um grupo, espere dois dias, leia as respostas no [Inbox](https://attendto.com.br/manual/inbox) e só então repita. #### Quando os números não batem - **Importei e continua zerado:** os contatos não existiam. Suba a [Base de contatos](https://attendto.com.br/manual/base-de-contatos) primeiro e reimporte o mesmo arquivo — ele não vai duplicar nada. - **A receita ficou absurda:** procure situação em branco na planilha. Corrija a coluna e reimporte por cima; a importação atualiza os pedidos existentes. - **Faltam clientes que eu sei que compraram:** o telefone ou o e-mail da planilha está diferente do cadastrado no contato. É por esses dois campos que o casamento acontece. - **A receita caiu de repente:** confira o seletor de dias antes de qualquer coisa. Ele é o culpado na maioria das vezes. - **Mudou muita gente de grupo de uma vez:** entrou um lote grande de pedidos e as comparações se refizeram. Olhe o total de clientes e pedidos no topo. Para levar isso para fora da tela, **Baixar relatório** exporta os grupos e as vendas em planilha. Para falar com um grupo grande, sem o teto de 20, o caminho é [Campanhas](https://attendto.com.br/manual/campanhas). No painel: Abrir o Monitor de sucesso. Como as pessoas procuram: análise rfv de clientes; importar pedidos csv; reativar clientes inativos; clientes em risco de churn; pós-venda whatsapp; agente de reativação; grupos de clientes por compra; pedidos em aberto; ticket médio dos clientes; recompra de clientes. ## Personas A/B: teste duas versões da IA de atendimento e promova a que converte mais URL: https://attendto.com.br/manual/personas Menu: Inteligência > Personas A/B Personas A/B é o item do painel que coloca duas versões da IA de atendimento no ar ao mesmo tempo, mede qual converte mais leads em qualificados e permite editar o jeito de cada versão falar. ### Quem pode usar - Dono: Vê tudo e faz tudo: cria a variante B, edita e salva as personas, pausa e retoma a variante B, liga a resposta em voz e promove a vencedora. - Admin: Vê o experimento, os números e o editor com os campos preenchidos. Criar variante, salvar, pausar ou promover volta com um aviso de que a ação é só do dono da conta. - Atendente: Vê o item no menu, o experimento e o editor, como o administrador. As ações que mudam a persona são recusadas com o aviso de que só o dono pode. ### Telas #### Personas A/B A tela Personas A/B serve para acompanhar o teste entre a variante A e a variante B da persona da IA e decidir, com estatística, qual das duas promover. Endereço no painel: `/app/personas` ![Captura da tela Personas A/B. A tela Personas A/B serve para acompanhar o teste entre a variante A e a variante B da persona da IA e decidir, com estatística, qual das duas promover.](https://attendto.com.br/prints-do-manual/personas--experimento.png) A tela Personas A/B na conta de demonstração, com dados fictícios e os valores desfocados. ##### Cabeçalho do experimento Mostra se há teste rodando e leva ao editor das personas. Botões e ações: - **Editar personas**: Abre o Editor de persona, onde ficam nome, tom, ofertas e respostas prontas de cada variante. Também aparece: - Selo de situação: EM ANDAMENTO (as duas versões no ar), PAUSADO (a B está pausada) ou CONCLUÍDO — vencedora A ou B. - Com o teste rodando, a linha `Split 50/50 · atribuição sticky por lead · ‹n› leads no experimento (últimos 30 dias)`: metade dos leads novos vai para cada versão e cada lead fica sempre com a mesma. - O período é fixo nos últimos 30 dias; não há seletor de período nesta tela. ##### Sem teste A/B ativo O cartão que aparece quando não há experimento rodando. Botões e ações: - **Criar variante B (clonar persona ativa)** (Dono): Cria a variante B como cópia exata da persona que está no ar e liga o teste. Enquanto cria, o botão mostra `Criando…`. Também aparece: - Título `Sem teste A/B ativo` com a orientação de criar uma variante B a partir da persona ativa. - Com a B pausada, o cartão diz `Teste pausado — retome no editor` e explica que todo o tráfego novo vai para a A. - Depois de promover, o cartão diz `Teste concluído — vencedora ‹A ou B› promovida`; um novo ciclo começa pelo editor. ##### Cartões das variantes A e B Um cartão por versão, lado a lado, com a persona e os números de cada uma. Também aparece: - Letra da variante (A ou B) e o nome da persona — o rótulo interno, que o lead nunca vê. - Contador `‹n› leads`: quantas pessoas conversaram com aquela versão. - Linhas `Nome IA`, `Tom` (resumido) e `Empresa`, tiradas da persona. - Número grande: a conversão lead→qualificado, em porcentagem, com barra. - Rodapé `1ª resposta ‹tempo› · handoff ‹n›%`: tempo médio até a primeira resposta e a fatia que foi transferida para alguém do time. - Selo VENCEDORA e borda destacada na variante que ganhou com amostra suficiente. ##### Significância estatística A conta que diz se a diferença entre as duas versões é real ou sorte. Botões e ações: - **Promover variante ‹A ou B›** (Dono): Aparece só quando há vencedora com amostra mínima. Pede confirmação (`A vencedora vira a persona única e a outra é pausada. Promover?`) e encerra o teste. Também aparece: - Texto fixo: vencedor só é declarado com teste z de duas proporções, exigindo p < 0,05 e amostra mínima por variante. - Três números: `z = ‹valor›` (estatística do teste), `p = ‹valor›` (fica verde abaixo de 0,05) e a diferença B − A em pontos percentuais (pp). - Régua `IC95% da diferença (B − A), em pontos percentuais`, com a marca do zero e a faixa entre o limite inferior e o superior. - Com vencedora: a frase `A Variante ‹A ou B› converte significativamente mais — pode promovê-la com confiança.` - Sem vencedora: `Coletando dados — ‹n›/‹mínimo› e ‹n›/‹mínimo›`, quantos leads cada lado já tem diante do mínimo. ##### Estados da tela - Carregando: Blocos cinza no lugar do cabeçalho e dos cartões enquanto os números chegam. - Se der erro: Cartão `Não foi possível carregar o teste A/B`, explicando que o teste não parou e as duas variantes continuam rodando, com botão para tentar de novo. - Variante promovida: Aviso `Variante ‹A ou B› promovida — teste concluído`. - Variante B criada: Aviso `Variante B criada — edite e ative o teste no editor`. - Falha ao criar ou promover: Aviso `Não foi possível criar a variante B. Tente novamente.` ou `Não foi possível promover a variante. Tente novamente.` #### Editor de persona O Editor de persona serve para escrever cada versão da IA: o nome que o lead vê, a empresa exibida, as ofertas, o tom de voz e as respostas prontas. Endereço no painel: `/app/personas/editor` ![Captura da tela Editor de persona. O Editor de persona serve para escrever cada versão da IA: o nome que o lead vê, a empresa exibida, as ofertas, o tom de voz e as respostas prontas.](https://attendto.com.br/prints-do-manual/personas--editor.png) A tela Editor de persona na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Pelo botão **Editar personas** na tela Personas A/B. ##### Navegação e escolha da variante Volta para o experimento e alterna entre a variante A e a B. Botões e ações: - **Personas A/B**: Volta para a tela do experimento. - **A · ‹nome da persona›**: Mostra no formulário a persona da variante A. - **B · ‹nome da persona›**: Mostra no formulário a persona da variante B. O editor abre na B quando ela existe. - **Criar variante B (clonar a ativa)** (Dono): Aparece no lugar do botão da B quando ainda não existe variante B. Cria a cópia da persona ativa e já a abre no formulário. - **Ativa** (Dono): Interruptor da variante B. Desligar pausa a B (todo lead novo vai para a A); ligar de novo retoma o teste e reinicia a medição do zero. Mostra `Pausada` quando desligado. ##### Formulário da persona Os campos que definem como esta versão da IA conversa. Campos e filtros: - **Nome da persona**: Rótulo interno para distinguir A de B. O lead nunca vê. - **Nome da IA**: O nome com que a IA se apresenta na conversa. Este o lead lê. - **Empresa exibida**: O nome da empresa que a IA diz representar. - **Ofertas**: O que esta versão pode oferecer, em texto livre. - **Tom de voz**: Como a IA fala, escrito por você. Os atalhos acima da caixa só preenchem um texto de partida. - **FAQ (respostas prontas)**: Perguntas que se repetem, com a resposta exata que deve sair. Botões e ações: - **Direto**: Preenche o tom com um texto objetivo, de uma pergunta por vez. Não salva: mostra `Tom "Direto" aplicado — salve para persistir`. - **Consultivo**: Preenche o tom com um texto acolhedor, de perguntas abertas. Não salva sozinho. - **Descontraído**: Preenche o tom com um texto leve e informal. Não salva sozinho. - **Formal**: Preenche o tom com um texto cordial e institucional. Não salva sozinho. ##### PRÉVIA AO VIVO Uma conversa de demonstração que mostra como a tela do lead se parece. Também aparece: - Selo de demonstração: a troca de mensagens é sempre a mesma e não reflete o tom, o nome nem as ofertas digitados. ##### Responder em voz (TTS) Liga a resposta em áudio quando o lead manda áudio. Botões e ações: - **Responder em voz (TTS)** (Dono): Interruptor que vale na hora, sem precisar salvar: quando o lead manda áudio, a resposta sai em áudio com voz sintética padrão, nunca uma cópia da voz do lead. ##### Salvar Botões e ações: - **Salvar persona** (Dono): Grava todos os campos do formulário. Vale da próxima mensagem em diante. Enquanto grava, mostra `Salvando…`. ##### Estados da tela - Carregando: Blocos cinza no lugar do formulário. - Sem nada ainda: `Nenhuma persona cadastrada.` quando a conta ainda não tem persona. - Se der erro: Cartão `Não foi possível carregar a sua persona`, avisando que ela não foi perdida e continua no ar, com botão para tentar de novo. - Persona salva: Aviso `Persona salva`. - Variante B pausada: Aviso `Teste pausado — 100% do tráfego novo vai para a variante A`. - Variante B retomada: Aviso `Teste retomado — a medição reinicia agora`. - Quem não é dono tenta salvar: Aviso de que só o dono da conta pode editar personas; nada é gravado. ### Passo a passo #### Como começar um teste A/B de persona 1. Abra **Personas A/B** no menu. 2. No cartão `Sem teste A/B ativo`, clique em **Criar variante B (clonar persona ativa)**. 3. Clique em **Editar personas**; o editor abre na variante B. 4. Mude uma única coisa na B (por exemplo, o **Tom de voz** ou as **Ofertas**). 5. Clique em **Salvar persona**. #### Como saber se a variante B está ganhando 1. Abra **Personas A/B** e olhe primeiro o contador de leads de cada cartão. 2. No cartão **Significância estatística**, veja se aparece `Coletando dados` (ainda sem resultado) ou a frase de que uma variante converte significativamente mais. 3. Confira se a faixa do IC95% deixou de cruzar o zero. #### Como promover a persona vencedora 1. Espere aparecer o selo VENCEDORA em uma das variantes. 2. No cartão **Significância estatística**, clique em **Promover variante ‹A ou B›**. 3. Confirme na janela do navegador. A vencedora passa a atender todo o tráfego novo e a outra é pausada. #### Como pausar a variante B sem encerrar o teste 1. Clique em **Editar personas**. 2. Escolha o botão **B · ‹nome›**. 3. Desligue o interruptor **Ativa**; ele passa a mostrar `Pausada`. 4. Para retomar, ligue de novo — a medição recomeça do zero. #### Como mudar o nome e o tom da IA 1. Clique em **Editar personas** e escolha a variante. 2. Altere **Nome da IA** e, se quiser, clique num atalho de tom (**Direto**, **Consultivo**, **Descontraído** ou **Formal**) e ajuste o texto. 3. Clique em **Salvar persona**. #### Como fazer a IA responder em áudio 1. Abra **Editar personas** e escolha a variante. 2. Ligue **Responder em voz (TTS)**. Vale na hora, sem salvar. 3. Para escolher qual voz sai, use a tela Voz & tom. ### Perguntas frequentes #### Por que o botão de promover não aparece? Ele só aparece quando uma variante ganha com significância (p abaixo de 0,05) e as duas já têm a amostra mínima de leads. Antes disso o cartão mostra `Coletando dados`. #### Os números da tela são de que período? Dos últimos 30 dias, sempre. A tela não tem seletor de período. #### Clicar em Direto ou Formal já muda a IA? Não. O atalho só preenche a caixa **Tom de voz** com um texto de partida. A mudança só vale depois de **Salvar persona**. #### O interruptor Responder em voz precisa de Salvar persona? Não. Ele grava sozinho ao ser clicado e mostra o aviso `Resposta em voz ativada` ou `desativada`. #### Administrador pode editar a persona? Não. O administrador vê o editor preenchido, mas salvar, criar variante, pausar e promover são só do dono da conta. #### A conversa da prévia mostra a minha persona? Não. A PRÉVIA AO VIVO é uma demonstração fixa, marcada como tal. Para ver a persona de verdade, abra uma conversa real no Inbox. #### Dá para ter mais de duas variantes ao mesmo tempo? Não. O teste é sempre entre A e B, com divisão de 50% para cada uma. #### Onde escolho qual persona responde por cada número? Em Conexões, no menu de cada conta, pela opção de escolher persona. Esta tela cuida só do teste e da escrita das personas. ### Guia: Personas A/B Duas versões da sua IA conversando ao mesmo tempo para descobrir qual converte mais — e o cuidado de não decidir com número de sorte. Persona é o jeito da sua IA falar: o nome que ela usa, o tom, o que ela oferece, o que ela responde de cor. Aqui você coloca **duas versões no ar ao mesmo tempo** e deixa os leads decidirem qual vende mais — em vez de discutir tom de voz em reunião. A tela diz `atribuição sticky por lead`. Sticky quer dizer **grudada**: cada lead conversa sempre com a mesma versão, do primeiro oi ao fim. Ninguém percebe troca de tom no meio da conversa, e a medição não fica misturada. > **Duas versões custam o mesmo que uma:** O teste não dobra gasto: o lead continua tendo uma conversa só. O que ele cobra é **tempo** — sem gente entrando dos dois lados, não há o que comparar. #### A tela por partes Na tela: Tela de Personas A/B com o cabeçalho do experimento, os cards das variantes A e B lado a lado e o card de significância estatística. Um experimento em andamento, ainda coletando dados. 1. **O que está rodando**: **EM ANDAMENTO** quer dizer que as duas versões estão no ar. `Split 50/50` é a divisão dos leads novos entre elas, `atribuição sticky por lead` é o grude que descrevemos acima, e `12 leads no experimento` é o tamanho da amostra até agora. 2. **Editar personas**: Leva ao editor, onde ficam nome, tom, ofertas e respostas prontas das duas versões. Mexer ali no meio do teste tem consequência — veja a seção sobre o editor. 3. **A variante A**: O título do card (`Atendimento comercial`) é o **rótulo interno**: o lead nunca vê esse nome. Ele vê o **Nome IA** (`Vera`) e a **Empresa**. O número grande é a conversão de lead em qualificado entre quem falou com esta versão. 4. **A variante B, e o contador de leads**: Olhe o contador antes do percentual. Com `0 leads`, o `0,0%` não quer dizer que a B é ruim: quer dizer que ninguém conversou com ela ainda. No rodapé, `1ª resposta` é quanto ela demora para responder e `handoff` é a fatia que virou transbordo para uma pessoa do time. 5. **A conta que impede decisão errada**: `z` e `p` medem uma coisa só: a chance de a diferença entre as duas ser sorte. `p < 0,05` é o limite aceito — abaixo disso a diferença é considerada real. `pp` é a distância entre elas em pontos percentuais. 6. **A faixa e o zero**: O **IC95%** é a faixa onde a diferença de verdade provavelmente está. Enquanto essa faixa **cruzar o zero**, as duas ainda podem estar empatadas e não dá para escolher. `Coletando dados — 12/30 e 0/30` é a tela dizendo quantos leads faltam de cada lado. #### Começar um experimento 1. **Clique em Criar variante B (clonar persona ativa)**: A B nasce como cópia exata da persona que já está no ar e o teste liga na hora. A partir daí, cada lead novo cai em A ou B e fica lá. 2. **Mude uma coisa só na B**: Tom mais direto, **ou** outra oferta em destaque, **ou** outra primeira frase. Se você mudar três coisas e a B ganhar, você não vai saber qual delas ganhou — e não vai conseguir repetir o acerto. 3. **Deixe rodar sem olhar todo dia**: Com o movimento normal da maioria das contas, juntar 30 leads de cada lado leva de duas a quatro semanas. Olhar o placar todo dia só produz ansiedade e decisão precipitada. 4. **Espere o card de significância liberar**: Enquanto ele disser **Coletando dados**, não há resultado — nem a favor, nem contra. Quem está na frente hoje muda de lado com facilidade quando são poucos leads. 5. **Promova a vencedora**: Só quando aparecerem juntos o selo **VENCEDORA** e a frase de que dá para promover com confiança. > **Quem pode mexer:** Criar variante, salvar persona e promover vencedora são ações do dono da conta. O resto do time vê os números normalmente, mas não altera o experimento. Os papéis estão em [Configurações](https://attendto.com.br/manual/configuracoes). #### Ler os dois cards - **conversão lead→qualificado**: O número grande. De cada 100 pessoas que falaram com aquela versão, quantas viraram quente ou morno. É a medida que decide o experimento. - **1ª resposta**: Quanto tempo até a primeira resposta sair. Serve de sanidade: se uma das versões estiver muito mais lenta, compare com cuidado, porque parte da diferença de conversão pode ser espera, não texto. - **handoff**: Transbordo: a fatia das conversas que precisou passar para uma pessoa do time. Nem sempre menos é melhor — em venda cara, mais transbordo com mais fechamento é ótimo. A fila está em [Transbordo para humano](https://attendto.com.br/manual/handoff). - **leads**: Quantas pessoas conversaram com aquela versão. É o primeiro número a olhar: sem gente dos dois lados, o resto é enfeite. #### Significância, em português A tela avisa que **vencedor só é declarado com teste z de duas proporções, exigindo p < 0,05 e amostra mínima de 30 leads por variante**. Isso é uma frase de estatística, e ela quer dizer três coisas simples: - **A conta compara duas taxas**, a da A e a da B, levando em conta quantas pessoas passaram por cada uma. Vinte por cento em 5 pessoas não vale o mesmo que vinte por cento em 500. - **O `p` é a chance de a diferença ser sorte.** `p = 0,03` quer dizer 3% de chance de ser coincidência. Abaixo de 0,05 a tela aceita como diferença de verdade. - **O IC95% é a faixa onde a diferença real deve estar.** Se a faixa vai de -4 a +12 pontos, ela passa pelo zero — e passar pelo zero significa que empate ainda cabe na conta. Nada de promover. > **O erro mais caro é olhar cedo demais:** Com 8 leads de um lado e 5 do outro, uma diferença de 30 pontos aparece por puro acaso. Quem promove nessa hora troca a persona que funcionava por uma que só teve sorte, e perde semanas para descobrir. Enquanto a tela mostrar **Coletando dados**, o placar não é notícia. #### Promover, pausar e retomar Estas três ações têm consequências diferentes, e duas delas são difíceis de desfazer. Vale ler antes de clicar: - **Promover**: Encerra o experimento. A vencedora vira a persona única da conta e a outra é pausada. Na prática não tem volta: para comparar de novo, você começa um experimento novo, do zero. - **Pausar a B**: Manda 100% dos leads novos para a A. Quem já estava conversando com a B continua com ela — o grude vale até o fim daquela conversa. - **Retomar**: Volta a dividir os leads, mas **reinicia a medição do zero**. Tudo o que tinha sido acumulado antes da pausa se perde, inclusive os 20 e poucos leads que já estavam contados. > **Pausar e retomar joga fora o que já foi medido:** Se o seu plano é só dar uma respirada de dois dias, não pause: o custo é recomeçar a contagem inteira. Pause apenas quando a variante B estiver claramente atrapalhando o atendimento e você quiser tirá-la do ar de vez. #### O editor da persona **Editar personas** abre a tela onde cada versão é escrita. Os campos são poucos e cada um muda uma coisa diferente na conversa: - **Nome da persona**: O rótulo interno, para você distinguir A de B na lista. O lead nunca vê este nome. - **Nome da IA**: O nome que aparece para o lead na conversa. Este, sim, ele lê. - **Empresa exibida**: Como a IA se apresenta. Deve bater com o que está escrito nos seus canais. - **Ofertas**: O que ela pode oferecer nesta versão. É o campo que mais muda resultado, mais que o tom. - **Tom de voz**: Como ela fala, escrito por você. Os quatro atalhos — **Direto**, **Consultivo**, **Descontraído** e **Formal** — apenas preenchem a caixa com um texto de partida; eles **não salvam nada**. Depois de clicar, leia, ajuste e salve. - **FAQ (respostas prontas)**: Perguntas que se repetem, com a resposta exata que você quer que saia. Serve para preço, prazo e política — as três em que improviso custa caro. - **Responder em voz (TTS)**: Responder em áudio em vez de texto. Muda bastante a percepção do lead, então teste isso sozinho, num experimento só dele. Detalhes em [Voz](https://attendto.com.br/manual/voz-e-tom). > **A prévia ao vivo não é a sua persona:** A conversa que aparece ao lado do editor é uma demonstração fixa, sempre a mesma. Ela mostra como a tela do lead se parece — **não** reflete o tom, o nome nem as ofertas que você acabou de escrever. Para ver a sua persona de verdade, é preciso uma conversa real. > **Não edite a persona ativa no meio do teste:** Qualquer alteração vale da próxima mensagem em diante, para todo mundo, inclusive para os leads que já estavam contados no experimento. Metade das conversas da A passa a ser de uma A que não existe mais, e a comparação perde o sentido. Se precisar mesmo mudar, promova ou pause primeiro e comece um teste novo. #### Uma persona por conta Se você atende por mais de uma conta — dois números de WhatsApp, uma conta de Instagram, o web chat —, **cada uma pode ter a sua própria persona**. É o que permite duas marcas, ou duas franquias, no mesmo painel: o número da matriz responde como a Sofia e o Instagram da segunda marca responde como a Marina, sem misturar. 1. **Abra Conexões**: Cada conta aparece com uma linha dizendo **Atende como…** — inclusive as que nunca foram configuradas, que dizem `a persona da empresa`. 2. **No menu da conta, escolha “Escolher persona”**: No Instagram o botão fica na própria linha da conta. A lista traz a opção `Persona da empresa (padrão)` e todas as personas **ativas**. 3. **Salve**: Vale da próxima mensagem em diante. As conversas que já estavam abertas continuam com a persona que já vinha atendendo — trocar o tom no meio de um papo é justamente o que a atribuição grudada evita. > **Não escolher nada continua sendo uma escolha:** Sem vínculo, a conta atende com a **persona da empresa** — é o padrão, e é como o produto sempre funcionou. Você só precisa mexer aqui se quiser separar as marcas. - **O teste A/B continua rodando**: Vinculando uma conta a uma variante que está em teste, aquela conta continua sorteando entre A e B — o vínculo escolhe o **par**, não congela o teste. As contas sem vínculo seguem no teste da empresa, como antes. - **Só persona ativa pode ser vinculada**: Uma persona pausada não atende ninguém; deixar vincular criaria uma tela dizendo que a Marina responde por um número onde ela nunca fala. - **Se a persona vinculada for pausada depois**: A conta **não fica muda**: ela volta a atender com a persona da empresa até você escolher outra. - **Se a conta for desconectada**: O vínculo **fica guardado**. Reconectando o mesmo número ou a mesma conta de Instagram, ela volta atendendo com a mesma persona — nada precisa ser refeito. Em Configurações → IA & persona há o mesmo mapa em leitura, no bloco **Quem responde por cada conta** — útil para conferir tudo de uma vez sem abrir Conexões. E a [Base de conhecimento](https://attendto.com.br/manual/base-de-conhecimento) tem o recorte equivalente: cada documento pode valer só para as contas que você marcar. #### O que vale testar - **A primeira frase.** É a que decide se a pessoa responde. Testar só isso costuma render mais que reescrever a persona inteira. - **Perguntar cedo ou tarde.** Uma versão que já pergunta o prazo na segunda mensagem contra uma que conversa antes. - **Uma oferta em destaque contra três.** Menos opção costuma qualificar mais gente, mas isso muda de segmento para segmento — por isso se testa. - **Formal contra descontraído.** É o teste mais pedido e quase sempre o de menor efeito. Deixe para depois dos outros três. Depois de promover, confirme o efeito onde ele aparece em dinheiro: [Analytics](https://attendto.com.br/manual/analytics), mesmo período, mesmos filtros, uma semana antes e uma semana depois. No painel: Abrir Personas A/B. Como as pessoas procuram: teste a/b de persona; como mudar o nome da ia; mudar tom de voz da ia; promover variante vencedora; comparar duas versões do atendimento; significância estatística teste a/b; editar persona da ia; pausar variante b; respostas prontas da ia; ia responder em áudio; qual persona converte mais. ## Intent & catálogo: cadastre ofertas, respostas gravadas e veja a intenção de compra de cada lead URL: https://attendto.com.br/manual/intent-e-catalogo Menu: Inteligência > Intent & catálogo Intent & catálogo é o item do painel onde você cadastra o que vende e as respostas gravadas pelo seu time, e acompanha a intenção que a IA detectou em cada conversa para escolher a oferta certa. ### Quem pode usar - Dono: Vê tudo e faz tudo: cria, edita, pausa e importa ofertas, cadastra cases e grava, edita e remove respostas gravadas. - Admin: Vê as predições, ouve as gravações, abre os cadastros e salta para os leads. Salvar oferta, case ou gravação volta com o aviso de que só o dono pode editar o catálogo. - Atendente: Vê o item no menu e a tela inteira como o administrador: lê, ouve e abre os leads, mas não altera o catálogo. ### Telas #### Intent & catálogo A tela Intent & catálogo serve para manter as ofertas que a IA pode citar, a biblioteca de áudios do time e os cases de sucesso, ao lado das intenções que os leads demonstraram nas conversas. Endereço no painel: `/app/catalogo` ![Captura da tela Intent & catálogo. A tela Intent & catálogo serve para manter as ofertas que a IA pode citar, a biblioteca de áudios do time e os cases de sucesso, ao lado das intenções que os leads demonstraram nas conversas.](https://attendto.com.br/prints-do-manual/intent-e-catalogo--catalogo.png) A tela Intent & catálogo na conta de demonstração, com dados fictícios e os valores desfocados. ##### Predições de intenção Leitura automática: o que cada lead pediu na conversa mais recente. Não se preenche nada aqui. Botões e ações: - **‹nome do lead›**: Cada linha é clicável (também com Enter ou Espaço) e abre a ficha do lead no CRM. Também aparece: - Avatar e nome do lead. - Selo `conf ‹0 a 1›`: a segurança da leitura. Verde a partir de 0,80, na cor da marca a partir de 0,70 e laranja abaixo disso. - `intenção` com o nome da leitura: Dúvida de produto, Preço/proposta, Intenção de compra, Agendamento ou outra intenção não comercial. - `Oferta sugerida: ‹título›` quando alguma oferta ativa casa com a intenção. ##### Respostas gravadas A biblioteca de áudios do seu time que a IA envia quando reconhece uma das perguntas comerciais. Botões e ações: - **+ Nova gravação** (Dono): Abre a janela `Nova resposta gravada`. - **‹título da gravação›**: O título em cada linha abre a janela `Editar resposta gravada`. - **Remover a gravação ‹título›** (Dono): Botão da lixeira (dica `Remover da biblioteca`). Abre a confirmação de remoção. Também aparece: - Cada linha: ícone de áudio, título, `Voz de ‹quem gravou›` (ou `Sem autoria informada`) e a pergunta vinculada (ou `sem vínculo`). - Player de áudio em cada linha para ouvir a gravação. ##### Nova resposta gravada Janela para gravar no navegador ou enviar um arquivo de áudio. Campos e filtros: - **Título** (obrigatório): Como a gravação aparece na lista e no Inbox. - **Quem gravou**: O crédito da voz, mostrado ao time. - **Pergunta que esta gravação responde**: Um dos quatro botões: Dúvida de produto, Preço/proposta, Intenção de compra ou Agendamento. Cada pergunta aceita uma gravação; botão ocupado fica desabilitado com a dica de qual gravação já responde. Sem vínculo, o áudio fica na biblioteca sem ser enviado. - **Áudio** (obrigatório): Escolha entre gravar agora ou enviar um arquivo. - **Arquivo de áudio**: Com **Enviar arquivo**: OGG (Opus), MP3 ou M4A/AAC, até 16 MB. Formato recusado mostra o aviso do WhatsApp. Botões e ações: - **Gravar agora**: Usa o microfone do computador. - **Enviar arquivo**: Troca para o envio de um arquivo gravado no celular. - **Começar a gravar**: Pede permissão ao microfone (mostra `Aguardando permissão…`) e começa a gravar com o relógio correndo. - **Parar**: Encerra a gravação e mostra o player para ouvir antes de salvar. - **Regravar**: Descarta o áudio gravado para começar de novo. - **Salvar gravação** (Dono): Envia o áudio para a biblioteca. Só habilita com título e áudio prontos. Também aparece: - Se o navegador só grava num formato que o WhatsApp não aceita, a janela avisa e orienta usar Enviar arquivo. - Microfone bloqueado mostra `Permissão de microfone negada` com a orientação de liberar nas configurações do navegador. ##### Editar resposta gravada Muda título, autoria e vínculo de uma gravação existente; o áudio em si não se edita. Campos e filtros: - **Título** (obrigatório): Obrigatório para salvar. - **Quem gravou**: O crédito da voz. - **Pergunta que esta gravação responde**: Troca ou retira o vínculo com a pergunta. Botões e ações: - **Remover** (Dono): Abre a confirmação de remoção desta gravação. - **Salvar** (Dono): Grava as mudanças. Também aparece: - Player no topo para ouvir a gravação antes de mexer. ##### Remover a gravação Confirmação obrigatória antes de tirar um áudio da biblioteca. Botões e ações: - **Cancelar**: Fecha sem remover. - **Remover gravação** (Dono): Remove de vez. A IA deixa de enviar o áudio na hora; conversas que já o receberam continuam com ele no histórico. Não pode ser desfeito. ##### Catálogo de ofertas O que você vende, com as palavras que a IA usa. Ativas primeiro, pausadas depois e esmaecidas. Botões e ações: - **Importar planilha**: Abre a janela de importação de ofertas por XLSX ou CSV. - **+ Nova**: Abre a janela `Nova oferta`. - **‹título da oferta›**: Clicar na linha (ou Enter/Espaço) abre a janela `Editar oferta`. Também aparece: - Cada linha: título, descrição, o preço em texto livre e, quando preenchidos, o valor numérico, `‹n› em estoque` e `SKU ‹código›`. - À direita, a primeira tag da oferta ou o selo PAUSADA. ##### Nova oferta / Editar oferta O cadastro de uma oferta. Não existe excluir: tira-se do ar pausando. Campos e filtros: - **Título** (obrigatório): Nome pelo qual a IA chama a oferta. Sem título o Salvar fica desabilitado. - **Descrição**: O que é e para quem serve, em uma ou duas frases. - **Preço (texto livre — o que a IA cita)**: O único preço que sai na conversa: faixa, condição ou vazio (aí a IA não fala valor). - **SKU**: Código interno do item. Opcional, não é falado. - **Preço (R$)**: Valor numérico para vendas e relatório de mais vendidos. Não vira fala da IA. - **Estoque**: Quantidade disponível, se você controla. Vazio significa sem limite. - **Link de pagamento (checkout do seu gateway)**: Endereço onde o lead paga. A IA compartilha quando ele quer comprar; o pagamento acontece no seu meio de cobrança, e a venda vira pedido quando o seu sistema confirmar pela tela Integrações. - **Tags (separadas por vírgula)**: Etiquetas suas; a primeira aparece na lista. - **Intenções que casam com esta oferta**: Botões Dúvida de produto, Preço/proposta, Intenção de compra e Agendamento. Quanto menos marcados, mais a oferta ganha destaque nessas intenções. Botões e ações: - **Pausar oferta** (Dono): Só na edição. Tira a oferta da boca da IA na hora e marca PAUSADA, sem apagar nada. - **Reativar oferta** (Dono): Só na edição de oferta pausada. Devolve a oferta como estava. - **Salvar** (Dono): Cria a oferta (já ativa) ou grava a edição. Mostra `Salvando…`. Também aparece: - Nota abaixo dos números: preço, SKU e estoque alimentam vendas e o relatório de mais vendidos; quem a IA cita é o texto do preço livre. ##### Importar ofertas por planilha Escolher o arquivo, ver a prévia e confirmar. Nada é gravado antes da confirmação. Campos e filtros: - **Linha**: Coluna da prévia: o número da linha na planilha. - **Ação**: Coluna da prévia: Criar, Atualizar ou Erro, com o motivo do erro. - **Título**: Coluna da prévia: o título lido. - **SKU**: Coluna da prévia: o código lido. SKU repetido atualiza a oferta existente. - **Preço**: Coluna da prévia: o valor lido. Botões e ações: - **Escolher planilha**: Abre o seletor de arquivo (.xlsx ou .csv). Depois de escolher, o botão mostra o nome do arquivo e a prévia é montada. - **Baixar modelo**: Baixa um CSV de exemplo com as colunas reconhecidas. - **Importar ‹n› oferta(s)** (Dono): Grava as linhas que vão ser criadas ou atualizadas; as com erro ficam de fora. Mostra `Importando…`. - **Cancelar**: Fecha sem importar. - **Fechar**: Fecha depois de importar. Também aparece: - Colunas reconhecidas pelo nome: Título, Descrição, Preço, SKU, Estoque, Etiquetas e Ativa. Só o título é obrigatório. - Resumo da prévia: `Prévia: ‹n› para criar, ‹n› para atualizar, ‹n› com erro (ficam de fora).` Depois de importar, o resumo começa com `Importado:`. ##### Cases de sucesso O cadastro dos casos que deram certo, com a métrica em destaque. Campos e filtros: - **Título** (obrigatório): Nome do caso. Sem título o Salvar fica desabilitado. - **Descrição**: O que aconteceu. - **Métrica (ex.: −38%)**: O resultado em destaque, mostrado em verde na lista. Botões e ações: - **+ Novo**: Abre a janela `Novo case`. - **‹título do case›**: Clicar no case abre a janela `Editar case`. Também aparece: - Não existe excluir nem pausar case. ##### Estados da tela - Carregando: Três blocos cinza no lugar dos cartões. - Sem nada ainda: Cada cartão tem o seu: `Sem predições ainda — elas aparecem conforme os leads conversam.`, `Nenhuma gravação ainda…`, `Nenhuma oferta cadastrada — as ofertas ativas são citadas pela IA nas conversas.` e `Nenhum case cadastrado ainda.` - Se der erro: Cartão `Não foi possível carregar o seu catálogo`, avisando que nada foi apagado e que não é para recadastrar antes de conseguir ver a lista, com botão para tentar de novo. - Oferta salva: Aviso `Oferta criada` ou `Oferta atualizada`. - Oferta pausada ou reativada: Aviso `Oferta pausada` ou `Oferta reativada`. - Planilha importada: Aviso `‹n› criada(s), ‹n› atualizada(s).` - Planilha ilegível: Aviso `Não foi possível ler a planilha.` ou o motivo devolvido. - Gravação salva: Aviso `Gravação adicionada à biblioteca`. - Gravação removida: Aviso `Gravação removida`. ### Passo a passo #### Como cadastrar um produto ou serviço para a IA oferecer 1. Abra **Intent & catálogo** no menu. 2. No cartão **Catálogo de ofertas**, clique em **+ Nova**. 3. Preencha **Título**, **Descrição** e **Preço (texto livre — o que a IA cita)**. 4. Em **Intenções que casam com esta oferta**, marque só as intenções que ela responde melhor. 5. Clique em **Salvar**. A oferta nasce ativa. #### Como importar a lista de produtos de uma planilha 1. No **Catálogo de ofertas**, clique em **Importar planilha**. 2. Se precisar, clique em **Baixar modelo** e preencha as colunas. 3. Clique em **Escolher planilha** e selecione o arquivo XLSX ou CSV. 4. Confira a prévia linha a linha (Criar, Atualizar ou Erro). 5. Clique em **Importar ‹n› oferta(s)** e depois em **Fechar**. #### Como tirar uma oferta do ar 1. Clique na oferta na lista. 2. Na janela **Editar oferta**, clique em **Pausar oferta**. 3. Para voltar, abra de novo e clique em **Reativar oferta**. #### Como gravar um áudio do vendedor para a IA enviar 1. No cartão **Respostas gravadas**, clique em **+ Nova gravação**. 2. Preencha **Título** e **Quem gravou**. 3. Em **Pergunta que esta gravação responde**, escolha um botão livre. 4. Em **Gravar agora**, clique em **Começar a gravar**, fale e clique em **Parar** — ou use **Enviar arquivo**. 5. Ouça a prévia e clique em **Salvar gravação**. #### Como trocar o áudio de uma pergunta 1. Abra a gravação atual pelo título e desmarque o botão da pergunta; clique em **Salvar**. 2. Crie a nova gravação com **+ Nova gravação** e escolha o botão que ficou livre. 3. Se a antiga não serve mais, use a lixeira e confirme em **Remover gravação**. #### Como ver o que os leads estão pedindo 1. Olhe o cartão **Predições de intenção**: cada linha traz a intenção lida e a confiança. 2. Clique no lead para abrir a ficha dele no CRM. ### Perguntas frequentes #### O campo Preço (R$) aparece na conversa? Não. A IA cita só o texto do campo de preço livre. O valor numérico serve para vendas e para o relatório de mais vendidos. #### Como excluir uma oferta? Não há exclusão. Use **Pausar oferta**: ela sai da conversa e fica guardada para reativar. #### Reimportar a planilha duplica as ofertas? Não, quando a linha tem SKU já cadastrado: ela atualiza a oferta. Sem SKU, título igual também atualiza. #### Por que um botão de pergunta aparece desabilitado na gravação? Porque outra gravação já responde àquela pergunta. Passe o mouse para ver qual e desvincule-a primeiro. #### Quais formatos de áudio posso enviar? OGG (Opus), MP3 ou M4A/AAC, até 16 MB. São os formatos que o WhatsApp aceita. #### Posso editar o áudio de uma gravação depois de salvar? Não. A edição muda título, autoria e pergunta vinculada; para outro áudio, grave de novo e remova o antigo. #### Clicar numa predição faz o quê? Abre a ficha daquele lead no CRM, com a conversa e o histórico. #### Quem pode cadastrar ofertas e gravações? Só o dono da conta. O restante do time vê, ouve e abre os leads. ### Guia: Intent & catálogo O que você vende, escrito do jeito que a IA vai falar; a voz do seu time gravada para as perguntas de sempre — e a regra que decide qual oferta ela põe na frente de cada pedido. Três coisas na mesma tela, e elas conversam. De um lado, o que os seus leads pediram: a IA lê cada mensagem e diz que tipo de pedido era. Do outro, o que você vende — quando os dois casam, a oferta certa vai para o destaque da resposta em vez de a IA despejar o catálogo inteiro em cima de quem só perguntou o preço. E, no meio, a voz do seu time: as **respostas gravadas** que a IA envia quando reconhece uma das perguntas de sempre. #### A tela por partes Na tela: Tela Intent & catálogo com as predições de intenção e as respostas gravadas à esquerda e, à direita, o catálogo de ofertas e os cases de sucesso. À esquerda, o que os leads pediram e a voz do seu time. À direita, cadastro: o que você vende e os seus casos. 1. **O que os leads pediram**: Este card você não preenche: ele se enche sozinho conforme as pessoas escrevem. Clicar em uma linha abre a ficha daquele lead. 2. **Uma leitura, por dentro**: Nome do lead, a intenção lida e `conf` — o quanto a IA está segura daquela leitura, de 0 a 1. **Indefinida** quer dizer que a mensagem não era um pedido comercial. Quando alguma oferta casa, aparece **Oferta sugerida** com o nome dela. 3. **O catálogo de ofertas**: O que você vende, com as palavras que a IA usa. **+ Nova** abre o cadastro; clicar numa oferta que já existe abre a mesma janela para editar. 4. **O cartão de uma oferta**: É este texto que sai na conversa, e não o campo **Preço (R$)**. 5. **A etiqueta, ou o aviso de pausada**: A primeira etiqueta da oferta aparece aqui, para você achar a oferta certa numa lista longa. Se ela estiver fora do ar, este mesmo lugar mostra **PAUSADA**. 6. **Os seus casos**: O cadastro dos casos que deram certo, com o resultado em destaque. É o seu acervo organizado — leia a seção sobre cases antes de contar com ele dentro das conversas. 7. **As respostas gravadas**: A biblioteca com a voz do seu time: cada linha é um áudio, com quem gravou e a pergunta que ele responde. A seção sobre respostas gravadas, mais abaixo, explica a escolha e o passo a passo. #### Como a IA escolhe a oferta Cada mensagem do lead recebe uma leitura de intenção, e só quatro delas podem casar com oferta: **Dúvida de produto**, **Preço/proposta**, **Intenção de compra** e **Agendamento**. São exatamente os quatro marcadores do cadastro. Saudação, suporte e pedido de humano não puxam oferta nenhuma, e isso é de propósito. Quando a leitura casa com uma oferta **ativa** que declara aquela intenção, ela sobe para o destaque da resposta. Daí em diante valem três regras: - **Ganha a oferta que declara menos intenções.** A específica vence a genérica: quem marcou só **Preço/proposta** passa na frente de quem marcou as quatro. - Empatou no número de intenções, vale a mais antiga. - No máximo duas ofertas vão para o destaque da mesma resposta. Vale entender o que o casamento **não** faz: todas as ofertas ativas continuam disponíveis para a conversa o tempo todo. Ele não esconde nada, só decide o que vai por cima. Quem tira uma oferta da boca da IA é **Pausar oferta**, e nada mais. > **Marcar as quatro intenções não amplia nada:** Parece que aumenta o alcance da oferta e faz o contrário: com as quatro marcadas, ela perde o destaque para qualquer oferta mais específica, em qualquer conversa. Marque só as intenções em que aquela oferta é, de verdade, a melhor resposta. #### Cadastrar uma oferta 1. **Abra + Nova**: No card **Catálogo de ofertas**, canto superior direito. Para mexer numa oferta que já existe, clique nela: abre a mesma janela. 2. **Escreva o título e a descrição**: **Título** é obrigatório e é o nome pelo qual a IA chama a oferta. A **Descrição** é o que ela conta: uma ou duas frases que respondam "o que é isso e para quem serve". 3. **Escreva o preço que ela pode falar**: O campo **Preço (texto livre — o que a IA cita)** é o único preço que sai na conversa. 4. **Marque as intenções**: Em **Intenções que casam com esta oferta**, marque só os pedidos que esta oferta responde melhor que as outras. Menos é mais: é assim que ela ganha o destaque. 5. **Salve**: A oferta nasce ativa e já vale para a próxima conversa. Não existe aprovação nem espera. #### Os campos que a IA não fala Metade do cadastro não vira conversa — vira número. Vale preencher assim mesmo, e vale saber por quê: - **Preço (R$)**: O valor em número, para conta. Não é falado: alimenta o relatório de vendas e o card de mais vendidos do [Monitor de sucesso](https://attendto.com.br/manual/monitor-de-sucesso). - **SKU**: O código do item no seu controle interno. Também não é falado; é o que amarra esta oferta aos pedidos quando as suas vendas entram no painel. - **Estoque**: A quantidade, se você controla. Não é falada e não bloqueia nada sozinha. - **Link de pagamento**: O endereço onde a pessoa paga. Quando o lead demonstra intenção de compra e a oferta tem link, a IA compartilha. O pagamento acontece no seu meio de cobrança de sempre — o painel não processa e não fica no meio. - **Tags**: Etiquetas suas, separadas por vírgula. A primeira aparece no cartão da lista e serve para você achar a oferta certa quando a lista crescer. #### Importar por planilha Quem já tem a lista de produtos numa planilha não precisa digitar oferta por oferta. **Importar planilha**, no topo do catálogo, aceita XLSX ou CSV e mostra uma prévia antes de gravar qualquer coisa. 1. **Baixe o modelo ou use a sua planilha**: As colunas são reconhecidas pelo nome, com ou sem acento: **Título** (ou Nome, Produto), **Descrição**, **Preço**, **SKU** (ou Código), **Estoque**, **Etiquetas** e **Ativa**. Só o título é obrigatório. A primeira linha é o cabeçalho; só a primeira aba é lida. 2. **Confira a prévia**: Cada linha aparece com o que vai acontecer: **criar**, **atualizar** ou **erro** (sem título, preço que não é número). Linha com erro é pulada; as outras entram. 3. **Confirme**: Linha com **SKU** já cadastrado atualiza a oferta — é assim que a lista de preços se mantém: reimporte a planilha e os preços mudam sem duplicar nada. Sem SKU, o título igual atualiza e o novo cria. > **Preço em reais, do jeito brasileiro:** Vazio deixa a oferta sem preço, e a IA responde sem citar valor. #### Tirar uma oferta do ar **Não existe excluir oferta.** Existe **Pausar oferta**, dentro da janela de edição. Pausada, ela sai da boca da IA na hora e ganha a marca **PAUSADA** na lista, sem perder nada — descrição, preço, intenções e histórico continuam ali. **Reativar oferta** devolve tudo como estava. > **Pausar é o freio; mexer no preço não é:** Acabou o produto, subiu o custo, mudou a política? Pause enquanto resolve. Trocar o texto do preço por "sob consulta" não impede a IA de oferecer — só deixa a resposta vaga. #### Ler as predições de intenção O card da esquerda é leitura, não cadastro: você não cria nem apaga nada nele. A lista guarda a leitura mais recente de cada contato, até 20 contatos, e é a resposta rápida para "o que as pessoas estão pedindo esta semana". - `conf` é a segurança da leitura, de 0 a 1. Número baixo quer dizer mensagem ambígua — vale abrir a conversa no [Inbox](https://attendto.com.br/manual/inbox) antes de tirar conclusão. - **Indefinida** aparece quando a mensagem não era um pedido comercial: saudação, agradecimento, desabafo. - **Oferta sugerida** mostra qual oferta casou. Um lead pedindo preço sem oferta sugerida significa uma de duas coisas: nenhuma oferta ativa declara **Preço/proposta**, ou a que declarava está pausada. #### Respostas gravadas: a voz do seu time Tem pergunta que todo lead faz — quanto custa, quanto tempo leva — e que ninguém responde melhor do que alguém do seu time, com a própria voz. O cartão **Respostas gravadas** guarda esses áudios: você grava (ou envia o arquivo), diz quem gravou e liga a gravação a uma das quatro perguntas — as mesmas do cadastro de ofertas. Quando a IA tem certeza de que o lead fez aquela pergunta, ela envia o áudio **antes** da resposta em texto, como o vendedor que manda o áudio e emenda a pergunta seguinte. A escolha que importa acontece antes de apertar o botão de gravar: **que pergunta merece voz de verdade?** A boa candidata é a que pede confiança, não informação — o preço explicado com calma por quem entende, o prazo dito por quem instala. Pergunta cuja resposta muda toda semana é má candidata: áudio não se edita, se regrava. 1. **Abra + Nova gravação**: No cartão **Respostas gravadas**, canto superior direito. 2. **Grave agora, ou envie um arquivo**: **Gravar agora** usa o microfone, com prévia para ouvir e regravar antes de salvar. Se o seu navegador só gravar num formato que o WhatsApp não aceita, a tela avisa — o caminho então é **Enviar arquivo**: o vendedor grava o áudio no WhatsApp do próprio celular e encaminha o arquivo para você (OGG, MP3 ou M4A/AAC, até 16 MB). 3. **Diga o título e quem gravou**: O título é como a gravação aparece na lista e no Inbox ("Quanto custa — resposta da Marina"). **Quem gravou** é o crédito da voz: é o que o seu time vê ao passar o mouse na bolha, para entender de quem é o áudio que a IA mandou. 4. **Ligue à pergunta que ela responde**: Os mesmos quatro marcadores das ofertas. **Cada pergunta aceita uma gravação só** — se o marcador aparecer desabilitado, outra gravação já responde por ela; desvincule aquela primeiro. Sem vínculo, o áudio fica guardado na biblioteca e não é enviado. Na tela: Conversa no Inbox em que a IA enviou uma resposta gravada: a bolha de áudio com player e o rótulo "Resposta gravada", seguida da resposta em texto. A conversa como o seu time vê no Inbox: o áudio gravado sai primeiro, o texto segue normal. 1. **O áudio, antes do texto**: A gravação sai numa bolha própria, primeiro — respondendo a pergunta que o lead acabou de fazer. Qualquer pessoa do time pode ouvir aqui o mesmo áudio que o lead recebeu. 2. **O rótulo que explica a bolha**: **Resposta gravada · título** diz ao seu time que este áudio saiu da biblioteca, e passar o mouse mostra de quem é a voz. O lead não vê rótulo nenhum — para ele chega um áudio comum no WhatsApp. 3. **A conversa continua em texto**: O áudio complementa, não substitui: a IA segue com a resposta escrita e as perguntas dela, como em qualquer conversa. 4. **A leitura que disparou o áudio**: O dossiê da conversa mostra a pergunta reconhecida — a mesma leitura que casa ofertas. Foi por ela, e pela certeza da IA naquela leitura, que a gravação saiu. **Na dúvida, só texto.** Se a IA não tiver certeza do que o lead quis dizer, ou se a pergunta reconhecida não tiver gravação vinculada, a resposta sai escrita, como sempre — o áudio nunca atrasa nem substitui o atendimento. - **Vale para as conversas de WhatsApp.** Nos outros canais a resposta segue em texto. - **Fora da janela de 24 horas não vai áudio**: é a regra do WhatsApp para mensagem livre. A conversa segue por texto ou por um [modelo aprovado](https://attendto.com.br/manual/modelos-de-mensagem), e a gravação volta a sair quando o lead responder. - **Remover tira a gravação da boca da IA na hora** — sempre com confirmação —, mas as conversas que já a receberam continuam com o áudio no histórico. > **O que a gravação diz é por sua conta:** A conferência que segura as respostas escritas da IA não escuta áudio: gravação é conteúdo seu, e quem gravou responde pelo que disse. Se o preço mudou e a gravação ficou velha, ela continua saindo com o preço antigo — regrave, ou desvincule enquanto isso. #### Cases de sucesso É a sua prova social organizada num lugar só — a que você copia para uma proposta, um anúncio ou uma resposta escrita por você. > **O que a IA conta não sai daqui:** Hoje os cases são um cadastro seu e não entram nas conversas. O que ela fala vem da [base de conhecimento](https://attendto.com.br/manual/base-de-conhecimento) e das ofertas ativas. Se um caso precisa ser contado ao lead, escreva-o como conteúdo na base — lá ele é usado. #### Quando ela não ofereceu o que devia Confira nesta ordem — o problema quase sempre está nos dois primeiros passos: 1. **A oferta está ativa?**: Marca **PAUSADA** no cartão? Abra e clique em **Reativar oferta**. 2. **Ela declara a intenção certa?**: Uma pergunta de preço não casa com oferta que marcou só **Agendamento**. Abra a oferta e confira os marcadores. 3. **Existe outra mais específica ganhando?**: Se uma segunda oferta cobre o mesmo assunto declarando menos intenções, é ela que aparece. Reduza as intenções da que você quer na frente. 4. **O preço existe?**: Sem texto no campo de preço livre, a IA não tem valor para citar e a resposta sai sem número. 5. **Leia a conversa**: No [Inbox](https://attendto.com.br/manual/inbox) você vê o que o lead escreveu de fato. Muita "pergunta de preço" é, na leitura, uma dúvida de produto — e a oferta que responde a isso é outra. #### Quem pode mexer - Criar e editar oferta, case e resposta gravada: **só o dono da conta**. - Abrir a tela, ler as predições, ouvir as gravações e saltar para os leads: qualquer pessoa do time. No painel: Abrir Intent & catálogo. Como as pessoas procuram: cadastrar produtos para a ia; catálogo de ofertas whatsapp; importar produtos por planilha; preço que a ia fala; link de pagamento no atendimento; pausar oferta; áudio gravado do vendedor; resposta em áudio para pergunta de preço; intenção de compra do lead; cases de sucesso; predição de intenção. ## Qualificação de leads com IA: públicos, perguntas BANT e nota de 0 a 100 URL: https://attendto.com.br/manual/qualificacao Menu: Inteligência > Qualificação Qualificação é o item do painel onde você define com quais públicos a IA conversa e o que ela precisa descobrir em cada um (necessidade, orçamento, quem decide e prazo) para dar a nota de 0 a 100 ao lead. ### Quem pode usar - Dono: Vê e edita tudo: usa o modelo do segmento, pede o ajuste ao negócio, adiciona, edita, torna padrão e remove públicos. - Admin: Mesmo acesso do dono nesta tela. - Atendente: Vê o item no menu, os públicos, as perguntas e como a nota é calculada, com os campos travados. Não vê os botões do cabeçalho nem os de tornar padrão, remover, desfazer e salvar. ### Telas #### Qualificação A tela Qualificação serve para declarar os públicos que a empresa atende e, em cada um, os sinais e as perguntas que a IA usa para qualificar o lead como Quente, Morno ou Frio. Endereço no painel: `/app/qualificacao` ![Captura da tela Qualificação. A tela Qualificação serve para declarar os públicos que a empresa atende e, em cada um, os sinais e as perguntas que a IA usa para qualificar o lead como Quente, Morno ou Frio.](https://attendto.com.br/prints-do-manual/qualificacao--qualificacao.png) A tela Qualificação na conta de demonstração, com dados fictícios e os valores desfocados. ##### Com quem a sua IA fala Cabeçalho com a explicação da tela, o segmento da conta e as ações principais. Botões e ações: - **Usar modelo do segmento** (Dono, Admin): Abre a janela do modelo pronto do segmento, com os sinais e perguntas já escritos. Fica travado, com dica, enquanto os públicos carregam ou se eles não carregaram. - **Ajustar ao meu negócio** (Dono, Admin): Abre a janela em que a IA reescreve as perguntas de um público com base na base de conhecimento e na persona. O botão mostra ao lado o valor do ajuste, cobrado do saldo. Fica travado se não houver público. - **Adicionar público** (Dono, Admin): Abre a janela com os modelos prontos de público e a opção em branco. - **Escolher em Configurações → Seu segmento**: Aparece quando a conta ainda não tem segmento escolhido e leva à seção Seu segmento das Configurações. Também aparece: - Linha `Segmento da sua conta: ‹nome›`, ou `não escolhido`. ##### Cartão do público Um cartão recolhível por público. O primeiro abre sozinho. Campos e filtros: - **Nome do público**: Como você chama este público (até 120 caracteres). - **Como reconhecer este público**: Como a IA percebe, pelo jeito que o lead escreve, que está falando com este público. Botões e ações: - **‹nome do público›**: Clicar no título abre ou recolhe o cartão. - **Tornar padrão** (Dono, Admin): Faz deste o público usado quando a IA ainda não tem certeza de com quem está falando. Não aparece no público que já é padrão. - **Remover o público ‹nome›** (Dono, Admin): Botão da lixeira. Abre a confirmação de remoção. Também aparece: - Selo PADRÃO no público padrão e selo Novo no público que o modelo acabou de criar. - Linha `‹n› sinais que a IA procura nesta conversa`. - Ao mudar nome ou como reconhecer, aparecem **Salvar** e **Descartar** logo abaixo. ##### Sinais do público (Necessidade, Orçamento, Quem decide e Prazo) Um bloco por sinal, com o nome, o objetivo, as perguntas e o interruptor que diz se ele vale. Campos e filtros: - **Como chamar**: O nome do sinal neste público (por exemplo, trocar Orçamento por Investimento). - **O que a IA precisa descobrir**: O objetivo do sinal, em uma frase. - **Perguntas que a IA pode usar**: Até 12 perguntas prontas. Sem nenhuma, a IA formula sozinha a partir do objetivo. Botões e ações: - **Aplicar** (Dono, Admin): Interruptor que liga ou desliga o sinal neste público; muda a régua da nota na hora. Necessidade não desliga, e um público precisa de pelo menos 3 sinais ligados — a dica explica quando está travado. - **Tirar a pergunta ‹n› da lista** (Dono, Admin): Botão X ao lado de cada pergunta; tira do rascunho até você salvar. - **Adicionar pergunta** (Dono, Admin): Acrescenta uma linha em branco. Trava ao chegar a 12 perguntas. - **Salvar** (Dono, Admin): Aparece quando há mudança no sinal e grava nome, objetivo e perguntas. Vale a partir da próxima mensagem de cada lead. - **Descartar** (Dono, Admin): Volta o sinal ao que estava salvo. Também aparece: - Ao lado do nome: `peso ‹n› na nota` ou `não se aplica a este público`. - Campos trocados por um ajuste recente ficam realçados. ##### Como a nota é calculada O peso de cada sinal ligado e as faixas da nota. Também aparece: - Uma barra por sinal ligado, com o peso. - Faixas: 75 a 100 — Quente; 50 a 74 — Morno; 1 a 49 — Frio. - Aviso: mudar a configuração não reescreve a nota de lead nenhum; vale a partir da próxima mensagem. ##### Como a IA vai perguntar Exemplo montado com a primeira pergunta de cada sinal ligado, sem chamar a IA. Também aparece: - Balões com uma pergunta por sinal, lembrando que a IA pergunta uma coisa por vez ao longo da conversa. ##### Faixa de mudança recente Aparece no cartão logo depois do modelo do segmento ou do ajuste, e some quando alguém edita o público. Botões e ações: - **Desfazer** (Dono, Admin): Volta o público ao que era antes. Se o modelo tinha criado o público, ele é removido; os outros públicos ficam como estavam. - **Ajustar ao meu negócio** (Dono, Admin): Só depois do modelo do segmento: abre o ajuste já com este público. Também aparece: - Textos possíveis: `Criado agora pelo modelo ‹segmento›.`, `Perguntas trocadas agora pelo modelo ‹segmento›.` ou `Ajustado agora ao seu negócio.` com o número de trocas. ##### Aviso de dado de saúde Aparece em público antigo de paciente que pergunta o que a pessoa está sentindo. Botões e ações: - **Usar modelo Clínica** (Dono, Admin): Abre o modelo do segmento Clínica já em Substituir o público atual, apontando para este público. Também aparece: - Texto de alerta: dado de saúde, só o necessário para marcar (LGPD, art. 11). ##### Remover o público Confirmação antes de apagar um público. Botões e ações: - **Cancelar**: Fecha sem remover. - **Remover público** (Dono, Admin): Apaga o público. Leads já marcados com ele mantêm a nota e passam a usar o público padrão na próxima mensagem. Não pode ser desfeito. ##### Adicionar público Janela com os modelos prontos de público e a opção Em branco. Botões e ações: - **‹modelo de público›**: Seleciona o modelo. Mostra `‹n› sinais` ou `já cadastrado` (modelo já usado fica desabilitado). - **Cancelar**: Fecha sem criar. - **Adicionar público** (Dono, Admin): Cria o público com o roteiro do modelo escolhido. Mostra `Criando…`. Também aparece: - Se os modelos não carregam: `Não foi possível carregar os modelos.` com **Tentar de novo**. ##### Usar modelo do segmento Janela que mostra o modelo pronto de um segmento e aplica como público novo ou no lugar das perguntas de um existente. Nada muda até aplicar. Campos e filtros: - **Segmento do modelo**: Lista dos segmentos com etiqueta (`Segmento da sua conta`, `Segmento regulado` ou `‹n› itens de qualificação`). Navega com setas, Home, End, Enter e pela primeira letra; Esc fecha a lista. - **Nome do novo público** (obrigatório): Em Criar como novo público. Não pode ficar vazio nem repetir o nome de outro público. - **Como reconhecer este público**: Vem preenchido pelo modelo; pode reescrever. - **Qual público**: Em Substituir o público atual: o público que terá as perguntas trocadas. Botões e ações: - **Trocar**: Abre a lista de segmentos. - **Ver os ‹n› cuidados**: Expande os cuidados que o modelo já traz (com selo Segmento regulado quando for o caso). - **Criar como novo público**: Opção recomendada: cria um público novo e não mexe nos que já existem. - **Substituir o público atual**: Troca as perguntas de um público existente, mostrando o que sai e o que entra. Desabilitada quando não há público. - **Tornar este o público padrão**: Interruptor do público novo. Na conta sem público fica ligado e travado, porque o primeiro público é sempre o padrão. - **Ver as perguntas**: Em Substituir, expande, por sinal, as perguntas que saem e as que entram. - **Cancelar**: Fecha sem aplicar. - **Criar o público** (Dono, Admin): Aplica o modelo como público novo. Mostra `Aplicando…` e depois um aviso com **Desfazer**. - **Substituir as perguntas** (Dono, Admin): Aplica o modelo no público escolhido, mantendo nome, como reconhecer, se é padrão e as notas já dadas. Também aparece: - Bloco `O que a IA vai descobrir`: os 4 sinais com peso, os itens do segmento dentro de cada um e as perguntas prontas; sinal sem item aparece como `desligado`. - Dica quando o segmento escolhido não é o da conta: o modelo mexe só na qualificação; quadro, campos e persona continuam como estão. - Em Substituir: `O que sai e o que entra`, com resumo como `‹n› perguntas saem e ‹n› entram.` e o bloco `O que continua como está`. - Se o modelo não carrega: `Não conseguimos carregar o modelo` com **Tentar de novo**. ##### Ajustar ao meu negócio Janela em quatro momentos: confirmar, ler, revisar as trocas e concluir. Nada muda no público até você aplicar. Campos e filtros: - **Público que a IA vai ajustar**: O público cujas perguntas serão reescritas; o padrão aparece com `(padrão)`. Botões e ações: - **Ver**: Ao lado de Base de conhecimento e de Persona da IA, abre a tela correspondente em outra aba. - **Ajustar por ‹valor›** (Dono, Admin): Pede o ajuste. O valor aparece no botão e no quadro de custo antes de confirmar, e é descontado do saldo só se o ajuste terminar. - **Recarregar saldo** (Dono, Admin): Aparece quando o saldo não cobre o ajuste e leva à Carteira. - **Cancelar**: Antes de pedir, fecha a janela. Durante a leitura, cancela o ajuste sem cobrar nada. - **Aplicar**: Em cada troca sugerida, aceita a troca; o cartão do público atrás já mostra a mudança. - **Manter a de hoje**: Em cada troca, recusa a sugestão e mantém o texto atual. - **Desfazer**: Volta uma troca aplicada para pendente. - **Voltar atrás**: Volta uma troca mantida para pendente. - **Aplicar tudo**: Aceita todas as trocas pendentes e grava. - **Aplicar as ‹n› que faltam**: Depois de decidir algumas, aceita as pendentes restantes e grava (no singular, `Aplicar a que falta`). - **Descartar o resto**: Pede confirmação para descartar as trocas ainda pendentes (antes de decidir qualquer uma, o botão diz `Descartar`). - **Voltar às trocas**: Na confirmação de descarte, volta à revisão. - **Descartar**: Confirma o descarte. O ajuste já foi cobrado; para ver as sugestões de novo é preciso ajustar outra vez. - **Concluir**: Com todas as trocas decididas, grava as aplicadas e fecha. - **Fechar**: Fecha quando não houve troca a fazer ou quando o ajuste falhou. - **Tentar de novo**: Depois de uma falha, pede o ajuste outra vez. Também aparece: - Confirmação: `O que a IA vai ler` (Base de conhecimento com itens e data, Persona da IA com nome e tom, e as perguntas de hoje do público) e o aviso de que nenhuma conversa de lead entra no ajuste. - `O que ela não mexe`: não liga nem desliga sinal nem muda pesos; não tira a marcação de sensível nem acrescenta pergunta de saúde; não cria promessa de resultado nem pede documento, renda ou CPF. - Quadro de custo com o saldo atual; avisos `Seu saldo não cobre este ajuste`, `Já tem um ajuste em andamento` ou `O ajuste não está disponível agora` quando não dá para pedir. - Leitura: passos `Lendo a base de conhecimento`, `Lendo a persona da ‹nome›` e `Reescrevendo as perguntas de ‹público›`. - Resultado: `‹n› trocas sugeridas para ‹público›`, agrupadas por sinal, com Hoje ao lado de Com o ajuste, a diferença palavra a palavra, o selo Entra, Sai ou Reescrita e o motivo de cada troca. - Sinal desligado no público aparece com a nota de que o ajuste não liga nem desliga sinal. - Quando a IA não vê o que trocar: `Nada para trocar em ‹público›`. ##### Estados da tela - Carregando: Dois blocos cinza no lugar dos cartões; os botões do cabeçalho ficam travados com a dica `Espere os públicos carregarem.` - Sem nada ainda: `Nenhum público configurado`: enquanto isso a IA usa a régua padrão (necessidade, orçamento, quem decide e prazo). Para dono e administrador, botões **Usar modelo ‹segmento›** e **Adicionar público**. - Se der erro: `Não foi possível carregar os seus públicos`, avisando que a régua continua salva e valendo, com **Tentar de novo**. - Público criado pelo modelo: Aviso `Público "‹nome›" criado` com o número de perguntas e o botão **Desfazer**. - Trocas do ajuste aplicadas: Aviso `‹n› trocas aplicadas em ‹público›` com o botão **Desfazer**. - Ajuste cancelado: Aviso `Ajuste cancelado` — nada foi alterado nem cobrado. - Ajuste falhou: `Não deu para ajustar agora`, com a garantia de que nada foi alterado nem cobrado. ### Passo a passo #### Como configurar a qualificação pelo modelo do meu segmento 1. Abra **Qualificação** no menu. 2. Clique em **Usar modelo do segmento**. 3. Confira o segmento em **Segmento do modelo** (use **Trocar** se quiser outro) e leia o bloco do que a IA vai descobrir. 4. Deixe **Criar como novo público** marcado, revise **Nome do novo público** e clique em **Criar o público**. 5. Se não gostar, clique em **Desfazer** no aviso ou na faixa do cartão. #### Como adaptar as perguntas de qualificação ao meu negócio 1. Clique em **Ajustar ao meu negócio**. 2. Escolha o público em **Público que a IA vai ajustar** e confira o que a IA vai ler e o custo. 3. Clique em **Ajustar por ‹valor›** e espere a leitura. 4. Em cada troca, clique em **Aplicar** ou **Manter a de hoje** — ou use **Aplicar tudo**. 5. Clique em **Concluir**. #### Como editar as perguntas que a IA faz ao lead 1. Abra o cartão do público clicando no nome dele. 2. No sinal desejado, edite as linhas de **Perguntas que a IA pode usar** ou clique em **Adicionar pergunta**. 3. Clique em **Salvar** no próprio sinal. #### Como desligar o orçamento para um público 1. Abra o cartão do público. 2. No sinal de orçamento, desligue o interruptor **Aplicar**. 3. Se ele estiver travado, passe o mouse para ler o motivo (Necessidade não desliga e o público precisa de pelo menos 3 sinais). #### Como criar um segundo público 1. Clique em **Adicionar público**. 2. Escolha um dos modelos ou Em branco. 3. Clique em **Adicionar público** na janela. 4. Preencha **Como reconhecer este público** para a IA saber quando usá-lo e clique em **Salvar**. #### Como trocar o público padrão 1. No cartão do público desejado, clique em **Tornar padrão**. 2. O selo PADRÃO passa para ele. ### Perguntas frequentes #### O que é BANT na qualificação? São os quatro sinais da nota: necessidade, orçamento, quem decide e prazo. Na tela, cada um pode ganhar o nome que faz sentido para o seu público em **Como chamar**. #### Por que não consigo desligar a Necessidade? É o sinal que separa lead de curioso. Dá para renomear, mas não desligar. #### Quantas perguntas cabem em um sinal? Até 12. Sem nenhuma, a IA formula a pergunta sozinha a partir do objetivo. #### O ajuste ao meu negócio lê as conversas dos leads? Não. Ele lê a base de conhecimento, a persona e as perguntas de hoje do público. #### Cancelar o ajuste no meio cobra alguma coisa? Não. Cancelar durante a leitura não cobra. Se o ajuste terminar antes do cancelamento chegar, a tela avisa e mostra o resultado. #### Usar o modelo de outro segmento muda meu funil ou minha persona? Não. O modelo mexe só na qualificação; quadro, campos e persona continuam como estão. #### O atendente pode mudar a qualificação? Não. Ele vê os públicos e as perguntas com os campos travados; editar é do dono e do administrador. #### Remover um público muda a nota dos leads? Não. Quem já tinha nota mantém. Da próxima mensagem em diante, esses leads passam a usar o público padrão. ### Guia: Qualificação O que a sua IA precisa descobrir em cada conversa, e como isso vira uma nota que diz para quem você deve ligar primeiro. Cem conversas por semana não valem nada se você não sabe em quais três vale a pena gastar a sua manhã. Qualificar é isso: descobrir, conversando, quem está pronto para comprar. A sua IA faz isso sozinha, no meio da conversa, sem soar interrogatório. Esta tela é onde você decide **o que** ela precisa descobrir e **de quem**. Em venda direta — farmácia, loja, delivery —, quem chama já quer comprar, e o que a Qualificação pede é o próprio pedido: o que o cliente quer, entrega, pagamento. Para esse caso existe o **Modo atendimento**, em [Configurações](https://attendto.com.br/manual/configuracoes) → IA & persona: a nota continua sendo calculada (é por ela que a IA sabe o que falta e que o pedido completo chama a equipe), mas lead quente e morno não são cobrados. #### As quatro coisas que ela procura - **Necessidade**: Qual é o problema, com as palavras da pessoa. "Minha conta de luz veio 900 reais" vale mais que "quero orçamento". - **Orçamento**: Quanto ela pode gastar, ou pelo menos se já tem ideia de faixa de preço. - **Quem decide**: Se é ela quem assina. Um lead perfeito que precisa convencer o sócio é um lead com uma etapa a mais. - **Prazo**: Para quando. "Este mês" e "ano que vem" não merecem a mesma atenção hoje. Cada resposta encontrada soma pontos. O total é uma **nota de 0 a 100** e uma cor. É a cor que aparece na lista do Inbox, no cartão do funil e na busca: - **Quente**: Sabe o que quer, tem verba, decide e é para agora. Ligue hoje. - **Morno**: Interesse real, falta uma peça. Vale acompanhar de perto. - **Frio**: Ainda pesquisando. Deixe a IA cuidar e volte quando esquentar. - **Sem nota**: A conversa é curta demais para concluir qualquer coisa. Não é ruim, é cedo. > **A nota muda enquanto a conversa anda:** Ela não é dada uma vez e congelada. A cada resposta nova do lead a IA recalcula. Um frio da segunda-feira pode ser o quente da quinta. #### Públicos: nem todo cliente é igual Perguntar sobre orçamento anual para uma pessoa física é estranho. Perguntar se "você mora sozinho" para uma empresa é pior ainda. Por isso a qualificação é organizada em **públicos**. Na tela: Tela de Qualificação com os públicos cadastrados e as perguntas de cada dimensão. Cada público tem as suas próprias perguntas e o seu próprio peso. 1. **Os seus públicos**: Um por tipo de cliente. Comece com dois — pessoa física e empresa — e só crie mais quando a diferença nas perguntas justificar. 2. **Como a IA reconhece este público**: Você descreve o jeito de escrever de quem é desse grupo. É por aí que ela decide, sozinha, qual conjunto de perguntas usar. 3. **O que descobrir, e como perguntar**: Para cada sinal você escreve o objetivo e as perguntas que ela pode usar. O botão **Aplicar** desliga o sinal que não faz sentido — repare que aqui não há "quem decide": quem compra para a própria casa é quem decide. 4. **Como a nota é calculada**: O peso de cada sinal e as três faixas. Se para o seu negócio prazo importa mais que orçamento, é aqui que se ajusta. A IA identifica sozinha em qual público o lead se encaixa e usa as perguntas certas. Se ela errar, você corrige na ficha do contato e a correção manual vence. > **Mexer no peso não reescreve o passado:** A nota de quem já está na base continua a mesma. O ajuste vale a partir da próxima mensagem de cada lead — o histórico não muda de cor da noite para o dia. #### Começar pelo modelo do seu segmento **Usar modelo do segmento** abre a prévia do modelo: os cuidados que ele já traz, os quatro sinais da nota com o peso de cada um e, dentro deles, os itens do segmento com as perguntas prontas. O segmento da conta vem escolhido; **Trocar** abre a lista dos outros (pelo teclado: setas, Enter e a primeira letra do nome). Na tela: Diálogo Usar modelo do segmento: o segmento Imobiliária marcado como segmento da sua conta, os cuidados que vêm no modelo e os sinais da nota com os itens e as perguntas prontas. O modelo Imobiliária antes de aplicar: os cuidados, os sinais com o peso e as perguntas de cada item. - **Criar como novo público (recomendado)**: Os públicos que você já tem ficam como estão, e a IA passa a reconhecer o novo pelo jeito que o lead escreve. Dê um nome e diga se ele vira o público padrão. - **Substituir o público atual**: Troca as perguntas de um público que já existe. A tela mostra, sinal por sinal, o que sai e o que entra; o nome, o texto de como reconhecer e as notas que os leads já têm continuam como estavam. Depois de aplicar, o cartão do público ganha uma faixa com **Desfazer**, que devolve exatamente o que havia antes. Editar o público tira a faixa: a partir dali, o que vale é o que você escreveu. #### Ajustar ao meu negócio **Ajustar ao meu negócio** pede à IA que leia a sua [Base de conhecimento](https://attendto.com.br/manual/base-de-conhecimento), a persona e as perguntas de hoje de um público, e reescreva nomes, objetivos e perguntas no jeito do seu negócio. Nenhuma conversa de lead entra no ajuste. Na tela: Antes do clique que cobra: o que a IA lê, o que ela não mexe e quanto custa. - Sim: Cada troca vem com o motivo, lado a lado com a pergunta de hoje; você aplica uma a uma, tudo ou nada. - Não: Não liga nem desliga sinal, e o peso de cada um na nota continua o mesmo. - Não: Não tira a marcação de sensível e não acrescenta pergunta de saúde. - Não: Não cria promessa de resultado e não pede documento, renda ou CPF. > **por ajuste:** O ajuste é cobrado do saldo quando termina, inclusive quando a IA não vê o que trocar. Erro ou cancelamento não cobram, e sem saldo o botão fica travado — nada é chamado. Se o ajuste terminar antes de o cancelamento chegar, a tela mostra o resultado, já cobrado, para você revisar. Cada conta pede até 10 ajustes por hora. Depois de aplicar, o **Desfazer** da faixa do público devolve as perguntas de antes do ajuste. > **Público “Paciente” antigo:** A cópia antiga do modelo Paciente perguntava o que a pessoa estava sentindo. O cartão dela mostra um aviso com **Usar modelo Clínica**, que abre o Substituir com o modelo Clínica já escolhido: dado de saúde, só o necessário para marcar. #### Como ajustar sem quebrar nada 1. **Leia dez conversas reais primeiro**: Antes de mexer em peso nenhum, veja no [Inbox](https://attendto.com.br/manual/inbox) o que os seus leads de verdade falam. Quase sempre a pergunta que falta aparece sozinha. 2. **Mexa numa coisa de cada vez**: Mudou o peso de orçamento? Espere uma semana antes de mexer em outra. Duas mudanças juntas não deixam você saber qual funcionou. 3. **Confira o efeito**: Em [Analytics](https://attendto.com.br/manual/analytics#analytics) dá para ver quantos leads ficaram quentes antes e depois. É a única prova que vale. > **Se a IA conduz até o pedido completo:** Com **Conduzir até o pedido completo** ligado (o padrão das contas novas), em [Configurações](https://attendto.com.br/manual/configuracoes) → IA & persona, o pedido está completo quando tudo o que esta tela pede foi respondido. Escreva cada item como um pedaço do pedido: produto e preço, forma de pagamento, endereço e dia da entrega. Com até três itens ligados, o lead só fica Quente com todos respondidos. Com os quatro ligados, três bastam, desde que o que falta não seja a **Necessidade**, o item que vale mais pontos — e aí o cartão pode andar no Funil antes do último. #### Quando a nota não parece certa - **Todo mundo fica Morno**: Sinal de que os pesos estão parecidos demais entre si. Escolha o sinal que de fato decide a sua venda e dê a ele um peso claramente maior — a nota volta a separar gente. - **Aparece Quente quem não compra**: Falta um sinal eliminatório no seu público. Se atender fora da sua região é impossível, isso precisa ser um sinal com peso alto e não uma observação na conversa. - **Um sinal fica sempre em branco**: A pergunta que o descobre não está sendo feita, ou está sendo feita cedo demais. Olhe a evidência na ficha do contato: ela mostra a frase exata que sustentou cada sinal, e o vazio mostra o que nunca foi perguntado. - **O contato caiu no público errado**: Dá para fixar o público à mão na ficha dele, em [CRM & Graph](https://attendto.com.br/manual/crm). Fixado, a reavaliação automática para para aquele contato — a nota atual fica como está e o roteiro novo vale da próxima mensagem. > **Mexeu nos pesos? Olhe daqui a uma semana:** A nota nova vale para as conversas seguintes, não recalcula o passado. O lugar de conferir se a mudança melhorou alguma coisa é [Analytics](https://attendto.com.br/manual/analytics), comparando duas semanas. No painel: Abrir Qualificação. Como as pessoas procuram: qualificação de leads com ia; bant whatsapp; perguntas de qualificação; lead quente morno frio; nota do lead 0 a 100; públicos de atendimento; modelo de qualificação por segmento; ajustar perguntas ao meu negócio; como a ia qualifica o lead; orçamento prazo quem decide; lead scoring. ## Base de conhecimento da IA: ensine sua empresa com texto, FAQ, site e arquivos URL: https://attendto.com.br/manual/base-de-conhecimento Menu: Inteligência > Base de conhecimento Base de conhecimento é o item do painel onde você ensina a IA sobre a sua empresa: tudo o que é cadastrado ali vira a fonte da verdade das respostas, e o que não está na base ela passa para a equipe em vez de inventar. ### Quem pode usar - Dono: Vê tudo e faz tudo: adiciona, edita, pausa, ativa e exclui fontes, preenche o roteiro e testa a base. - Admin: Mesmo acesso do dono nesta tela. - Atendente: Vê o item no menu, a lista de fontes e o roteiro, e pode usar o **Teste a base**. Adicionar, editar, pausar ou excluir volta com um aviso de recusa. ### Telas #### Base de conhecimento A tela Base de conhecimento serve para cadastrar, testar e organizar as fontes de informação que a IA usa para responder aos leads. Endereço no painel: `/app/conhecimento` ![Captura da tela Base de conhecimento. A tela Base de conhecimento serve para cadastrar, testar e organizar as fontes de informação que a IA usa para responder aos leads.](https://attendto.com.br/prints-do-manual/base-de-conhecimento--conhecimento.png) A tela Base de conhecimento na conta de demonstração, com dados fictícios e os valores desfocados. ##### O que a sua IA sabe Resumo da base no topo da tela. Também aparece: - Texto fixo: o que é adicionado vira a fonte da verdade; quando não souber, a IA encaminha para um especialista e nunca inventa. - Indicador `fontes ativas`: quantas fontes a IA está usando. - Indicador `trechos indexados`: em quantos pedaços o conteúdo foi dividido para a busca. ##### Aviso da planilha importada Aparece para dono e administrador quando a Base avançada está disponível e há uma planilha importada que uma sincronização pode substituir. Botões e ações: - **Ver a comparação** (Dono, Admin): Com o módulo Base avançada ligado, abre a criação da sincronização já com esta planilha. - **Conhecer o módulo** (Dono, Admin): Sem o módulo ligado, abre a página do módulo Base avançada. Também aparece: - Título `Você importou ‹arquivo› em ‹data›. Trocar pela sincronização?`. ##### Roteiro da base Os tópicos que o segmento da conta pede na base. Contas sem segmento não veem este cartão. Botões e ações: - **Preencher**: Em tópico ainda vazio, abre o formulário de texto já com o tópico no título e o cursor no conteúdo. Nenhuma fonte vazia é criada antes de você salvar. Também aparece: - Selo geral `‹n› a preencher` ou `Tudo preenchido`. - Cada tópico com o selo `Preenchido` ou `A preencher`. ##### Adicionar conhecimento / Editar fonte O formulário de uma fonte. Ao clicar em Editar na lista, ele sobe com a fonte carregada. Campos e filtros: - **Título da fonte** (obrigatório): Nome da fonte na lista. - **Conteúdo** (obrigatório): Nos tipos Texto e FAQ, o conteúdo em si. No FAQ, cada pergunta começa com P: e cada resposta com R:. - **Endereço da página**: No tipo Página do site. Na edição, deixar em branco mantém o texto já importado (a tela mostra quantos caracteres); colar o endereço reimporta do zero. - **Arquivo**: No tipo Arquivo, ao criar. Se o arquivo não couber numa fonte só, o aviso explica o que fazer. - **Onde esta fonte vale**: Aparece com mais de uma conta conectada (ou quando a fonte já tem recorte). Sem marcar nenhuma, vale para todas as contas; marcando, só as escolhidas a enxergam. Conta desconectada aparece com `(desconectada)` e a marcação fica guardada. Botões e ações: - **Texto**: Tipo para colar qualquer conteúdo: sobre a empresa, políticas, catálogo. - **FAQ**: Tipo para perguntas e respostas prontas, no formato P: e R:. - **Página do site**: Tipo que importa o texto de um endereço da internet na hora. - **Arquivo**: Tipo para enviar PDF, DOCX, MD, TXT, XLSX ou CSV, de até 10MB. - **Adicionar à base** (Dono, Admin): Salva a fonte nova e a divide em trechos. Mostra `Indexando…` e depois quantos trechos foram indexados. - **Salvar e reindexar** (Dono, Admin): Na edição, grava as mudanças e refaz os trechos. - **Cancelar**: Na edição, limpa o formulário sem salvar. Também aparece: - Ao vir de **Preencher**, a frase `Preenchendo o tópico do roteiro da base: escreva o que a IA precisa saber sobre isso.` ##### Fontes A lista de tudo o que está cadastrado. Botões e ações: - **Pausar** (Dono, Admin): Tira a fonte das respostas da IA sem apagar. Na fonte pausada o botão vira **Ativar**. - **Ativar** (Dono, Admin): Volta a fonte pausada para as respostas. - **Editar** (Dono, Admin): Carrega a fonte no formulário do topo. - **Excluir** (Dono, Admin): Remove a fonte da base na hora, sem janela de confirmação. Também aparece: - Etiqueta colorida do tipo: Texto, FAQ, Página ou Arquivo. - Linha `‹n› trecho(s) · atualizada ‹data› · ‹contas›`, em que as contas são `todas as contas`, os nomes das contas marcadas ou `conta removida`. - Selo de situação: `Ativa`, `Pausada` ou `Erro`. ##### Teste a base Painel lateral que mostra os trechos que a IA usaria para responder a uma pergunta. Campos e filtros: - **Pergunta de teste**: Escreva como um cliente escreveria. - **Testar como**: Aparece com mais de uma conta conectada. `Base inteira (todas as contas)` ou uma conta específica, para conferir o recorte que ela enxerga. Botões e ações: - **Testar**: Busca os trechos mais relevantes. Enquanto busca, mostra `…`. Também aparece: - Resultados em cartões: o primeiro marcado MAIS RELEVANTE e os seguintes `TRECHO ‹n›`. - Sem resultado: a IA usaria só a persona e as ofertas do catálogo; a orientação é adicionar o conteúdo à base. ##### Estados da tela - Carregando: Bloco cinza no lugar da lista de fontes e do roteiro. - Sem nada ainda: `Nenhuma fonte ainda — adicione acima o que a sua IA precisa saber (quem vocês são, o que vendem, políticas, dúvidas frequentes).` - Se der erro: `Não foi possível carregar as suas fontes`, avisando que nenhuma foi apagada, com botão para tentar de novo. Os indicadores mostram `—`. - Roteiro não carregou: `Não foi possível carregar o roteiro da base` — as fontes continuam valendo, com botão para tentar de novo. - Fonte pausada: Aviso `Fonte pausada — a IA deixa de usá-la`. - Fonte excluída: Aviso `Fonte removida da base`. - Arquivo sem tipo aceito: Aviso `Escolha um arquivo PDF, DOCX, MD, TXT, XLSX ou CSV`. - Falha ao salvar: O motivo devolvido em português, ou `Não foi possível salvar a fonte. Confira o conteúdo.` ### Passo a passo #### Como ensinar a IA sobre a minha empresa 1. Abra **Base de conhecimento** no menu. 2. Em **Adicionar conhecimento**, deixe o tipo **Texto** escolhido. 3. Preencha **Título da fonte** e cole o texto em **Conteúdo**. 4. Clique em **Adicionar à base**. #### Como cadastrar perguntas frequentes para a IA 1. Escolha o tipo **FAQ**. 2. Dê um **Título da fonte** e escreva no **Conteúdo** cada pergunta começando com P: e cada resposta com R:, separadas por linha em branco. 3. Clique em **Adicionar à base**. #### Como importar o conteúdo do site para a IA 1. Escolha o tipo **Página do site**. 2. Preencha **Título da fonte** e cole o link em **Endereço da página**. 3. Clique em **Adicionar à base** e confira na lista quantos trechos vieram. 4. Se vier pouco texto, cole o conteúdo como **Texto**. #### Como enviar um PDF ou planilha para a base 1. Escolha o tipo **Arquivo**. 2. Selecione o arquivo em **Arquivo** (PDF, DOCX, MD, TXT, XLSX ou CSV, até 10MB). 3. Clique em **Adicionar à base**. #### Como testar se a IA sabe responder uma pergunta 1. No painel **Teste a base**, escreva a pergunta em **Pergunta de teste**. 2. Com várias contas, escolha em **Testar como** qual conta simular. 3. Clique em **Testar** e leia o trecho MAIS RELEVANTE. #### Como fazer um documento valer só para um número 1. Abra a fonte com **Editar** (ou crie uma nova). 2. Em **Onde esta fonte vale**, marque só as contas desejadas. 3. Clique em **Salvar e reindexar** e confira com **Testar como**. #### Como preencher o roteiro da base do meu segmento 1. No cartão **Roteiro da base**, clique em **Preencher** no tópico `A preencher`. 2. Escreva o conteúdo e clique em **Adicionar à base**. O tópico passa a `Preenchido`. ### Perguntas frequentes #### Excluir uma fonte pede confirmação? Não. **Excluir** remove na hora. Se a dúvida for temporária, use **Pausar**. #### Quais arquivos a base aceita? PDF, DOCX, MD, TXT, XLSX e CSV, de até 10MB por arquivo. #### Se o site mudar, a base atualiza sozinha? Não. O texto é importado no momento do cadastro. Edite a fonte e cole o endereço de novo para reimportar. #### Para que serve o número de trechos indexados? Mostra em quantos pedaços o conteúdo foi dividido para a busca. Fonte com zero trechos não tem texto que a IA consiga usar. #### Por que não vejo o campo Onde esta fonte vale? Ele só aparece quando há mais de uma conta conectada ou quando a fonte já tem um recorte salvo. #### O atendente pode testar a base? Sim. Testar é liberado para toda a equipe; cadastrar e mudar fontes é do dono e do administrador. #### Por que o cartão Roteiro da base não aparece? Ele só existe quando a conta tem um segmento escolhido em Configurações. #### O que significa o selo Erro numa fonte? Que o conteúdo não pôde ser lido ou dividido em trechos. Edite a fonte ou envie o conteúdo de outro jeito. ### Guia: Base de conhecimento Tudo o que a sua IA sabe. O que está aqui ela responde; o que não está, ela não inventa — passa para um especialista. Esta é a fonte da verdade da sua IA. Prazo de entrega, área de atendimento, política de troca, o que está incluso: tudo o que ela responde sai daqui. E o contrário também vale, que é o mais importante — sobre o que não está aqui, ela não arrisca um palpite: encaminha para um especialista. Base curta não deixa a IA burra, deixa ela calada. > **É o melhor investimento de tempo do painel:** Uma hora escrevendo aqui melhora mais o atendimento do que qualquer outro ajuste. Comece pelas cinco perguntas que você mais responde no dia — não pelo manual inteiro. #### A tela por partes Na tela: Tela da Base de conhecimento com o resumo, o formulário de adicionar conteúdo e, à direita, o painel Teste a base. À esquerda você ensina; à direita você confere se ela aprendeu. As duas metades trabalham juntas. 1. **A regra da tela, e os dois números**: **fontes ativas** é quanto conteúdo está no ar agora. **trechos indexados** é em quantos pedaços o seu texto foi partido para ela achar a parte certa depressa — texto grande vira muitos trechos, e isso é bom. 2. **De onde vem o conteúdo**: **Texto**, **FAQ**, **Página do site** e **Arquivo**. O tipo escolhido muda o campo logo abaixo: colar o conteúdo, escrever no formato `P:` / `R:`, informar um endereço ou anexar um documento. 3. **Título e conteúdo**: O título é obrigatório e é como a fonte aparece na lista: **Política de troca** ajuda, **Documento 2** não. No conteúdo cabem cerca de 200 mil caracteres por fonte — umas 50 páginas. 4. **Adicionar à base**: Salva e põe a fonte no ar na hora. Editando uma que já existe, o botão vira **Salvar e reindexar** — ou seja, ela reaprende o texto novo em vez de somar ao antigo. 5. **Teste a base**: A ferramenta de trabalho desta tela. Pergunte como um cliente perguntaria e veja os trechos que ela usaria para responder. Nada aqui é enviado para ninguém. 6. **A lista de fontes**: Tudo o que já está no ar, com o tipo, quantos trechos gerou e quando mudou. É aqui que ficam **Pausar**, **Editar** e **Excluir** — e é aqui que mora o risco da tela. #### O roteiro da base do seu segmento Com o segmento da conta escolhido, o cartão **Roteiro da base** lista os tópicos que o seu segmento pede (os serviços e preços, os horários, o que levar no dia…). Cada tópico aparece como **A preencher** até virar uma fonte. **Preencher** abre o formulário de fonte com o tópico no título: escreva o que a IA precisa saber e salve. O tópico passa a **Preenchido**; se você excluir a fonte, ele volta a A preencher. Na tela: Cartão Roteiro da base: os tópicos do segmento Imobiliária, uns preenchidos e outros a preencher, cada um com o botão Preencher. O roteiro do segmento Imobiliária: o que já virou fonte e o que ainda falta preencher. > **Nenhuma fonte vazia é criada:** O roteiro só lembra o que falta: nenhuma fonte em branco entra na base. Enquanto um tópico não é preenchido, a IA passa para a equipe o que não souber responder. Ver [Conta pronta para o seu segmento](https://attendto.com.br/manual/configuracoes). #### Os quatro jeitos de ensinar Os quatro funcionam de verdade e podem conviver na mesma base. A escolha é sobre onde o conteúdo já está hoje: - **Texto**: Cole qualquer coisa: quem vocês são, o que vendem, políticas, condições. É o formato mais flexível e o que mais funciona quando você escreve com as suas palavras. - **FAQ**: Perguntas e respostas prontas, no formato `P:` na primeira linha e `R:` na seguinte, com uma linha em branco entre os pares. Bom quando você já tem as dúvidas mapeadas. - **Página do site**: Informe um endereço público em `https` e o conteúdo é copiado na hora. O que fica guardado é o texto de hoje, não a página: se ela mudar, edite a fonte e cole o endereço de novo para reimportar. - **Arquivo**: PDF, DOCX, MD, TXT, XLSX ou CSV, até 10MB. Ideal para catálogo, tabela de condições e manual que já existem em documento. Planilha entra uma linha por frase ("Produto: Losartana 50mg · Preço: 12,90"), com a primeira linha como cabeçalho — é assim que a pergunta do cliente encontra a linha certa. **Cabe cerca de mil linhas por arquivo** (depende do tamanho de cada linha): lista maior se divide por grupo, um arquivo por grupo, e a tela diz na hora quantas cabem. Tirar colunas que a IA não usa para responder — código de barras, mensagens internas — faz caber bem mais. **Dê à coluna o nome do que ela guarda**: "Desconto: 20%" a IA entende na hora, "Obs.: 20%" fica ambíguo. Só a lista de preços? O lugar dela é o catálogo, que também importa planilha. > **Site moderno costuma vir vazio:** Muita página monta o conteúdo no navegador, e nesse caso a importação não encontra texto nenhum. A tela avisa e sugere colar o conteúdo no cartão **Texto** — é o caminho certo, não um remendo. Abra a página, selecione o que interessa, cole. Leva um minuto e fica melhor do que a importação faria. #### Testar antes de o cliente testar O painel **Teste a base** é o que transforma esta tela de cadastro em ferramenta. Use-o toda vez que adicionar conteúdo — leva dez segundos e é a única prova de que ela aprendeu o que você quis ensinar. 1. **Pergunte como um cliente perguntaria**: "vcs entregam em curitiba?", e não "área de cobertura logística". A pergunta torta é justamente a que chega no WhatsApp. 2. **Leia o que voltou**: Os trechos aparecem em ordem, com **MAIS RELEVANTE** no topo. Se o primeiro trecho responde a pergunta, a IA responde também. 3. **Se vier "Nenhum trecho relevante", falta conteúdo**: Para aquela pergunta ela não tem o que dizer e vai encaminhar para um humano. Escreva o pedaço que falta e teste de novo — a lacuna você acabou de descobrir qual é. 4. **Repita com as cinco perguntas do dia**: Prazo, preço, forma de pagamento, garantia, região de atendimento. Cobrindo essas cinco, você tira a maior parte do transbordo bobo do time. > **Não existe lista de perguntas sem resposta:** O painel não guarda um relatório do que ela não soube responder. O parente mais próximo é o **Teste a base**, que responde a uma pergunta que **você** digitou. Para achar as lacunas de verdade, leia as conversas no [Inbox](https://attendto.com.br/manual/inbox) e o que cai em [Transbordo para humano](https://attendto.com.br/manual/handoff): o assunto que mais chama humano é o buraco da sua base. #### Documento que vale só para uma conta Se você atende por mais de uma conta, cada documento pode valer **só para as contas que você marcar**. É o caso de quem tem duas marcas ou duas franquias no mesmo painel: a política de trocas vale para todo mundo, mas o cardápio da filial só a filial deve responder. A escolha fica no formulário, em **Onde esta fonte vale**, e aparece quando existe mais de uma conta conectada — com uma conta só não há o que separar. Editando uma fonte que **já tem** recorte, a escolha aparece de qualquer jeito, para você poder desfazê-lo. Cada fonte da lista mostra o seu recorte: `todas as contas` ou o nome das contas marcadas. > **Sem marcar nada, vale para todas:** É o padrão, e é como toda a sua base está hoje — nada muda sozinho. Marcar contas é o que **restringe**; deixar em branco é o que abre para todo mundo. - **Testar como uma conta**: No painel **Teste a base**, o campo `Testar como` faz a pergunta pelos olhos de uma conta específica — é assim que você confere o recorte antes de o cliente conferir por você. `Base inteira` mostra tudo. - **O simulador e as campanhas enxergam tudo**: Eles não saem por uma conta específica, então não há o que recortar. O recorte vale onde ele importa: na resposta ao lead, que chega sempre por uma conta. - **Se a conta for desconectada**: A fonte **não é apagada** e a marcação continua guardada — a lista mostra a conta com a observação `(desconectada)`. Reconectando a mesma conta, o recorte volta a valer sozinho. O mesmo raciocínio existe para a voz da IA: cada conta pode ter a sua própria persona. Está em [Personas A/B](https://attendto.com.br/manual/personas). #### Pausar e excluir > **Excluir não pergunta nada:** Um clique em **Excluir** e a fonte some junto com tudo o que ela ensinou. Sem confirmação, sem lixeira, sem desfazer. Se o texto original não estiver salvo em outro lugar, ele acabou. Quando a intenção é só tirar de circulação — a promoção acabou, a política está sendo reescrita, o documento venceu — use **Pausar**. A fonte ganha a marca **Pausada**, é ignorada por completo enquanto estiver assim, e **Ativar** devolve tudo. É reversível, e resolve quase todos os casos em que a pessoa clicaria em Excluir. - **Pausar**: sai do ar, volta quando você quiser, nada se perde. - **Editar**: corrige o conteúdo e reaprende no lugar da versão antiga. - **Excluir**: apaga de vez. Guarde antes o texto se ele não existir em outro lugar. #### Quando não salva A tela mostra sempre a mesma mensagem genérica quando algo dá errado, então a causa você descobre eliminando. Nesta ordem: - **Arquivo em formato não aceito.** Entram PDF, DOCX, MD, TXT, XLSX e CSV. Imagem e apresentação ficam de fora — copie o texto e cole em **Texto**. Planilha em `.xls` antigo (ou do Google) não abre: salve como `.xlsx` ou `.csv` e envie de novo. - **Arquivo acima de 10MB.** PDF cheio de imagem estoura fácil. Exporte só as páginas que importam. - **PDF que é foto de papel.** Documento escaneado não tem texto para ler; digite ou cole o conteúdo à mão. - **Texto acima do limite.** Passou de cerca de 200 mil caracteres, quebre em duas fontes por assunto — funciona melhor, inclusive. - **Endereço que não responde**, ou página sem texto legível. Confira se o endereço abre no navegador em `https`, sem senha e sem aviso de cookies cobrindo a página. #### Quem pode mexer - Adicionar, editar, pausar e excluir: administrador ou dono da conta. - Ler as fontes e usar o **Teste a base**: qualquer pessoa do time — e vale incentivar, porque quem atende é quem sabe o que falta. No painel: Abrir a Base de conhecimento. Como as pessoas procuram: base de conhecimento da ia; treinar ia com informações da empresa; ensinar a ia; faq para chatbot; importar site para a ia; enviar pdf para a ia; ia responder com base em documentos; testar resposta da ia; documento só para um número de whatsapp; fonte da verdade da ia; roteiro da base. ## Base avançada: memória da empresa, consultas ao seu sistema, webhooks de entrada e fluxos da IA URL: https://attendto.com.br/manual/base-avancada Menu: Inteligência > Base avançada A Base avançada é o módulo que faz a IA aprender com as conversas (com a sua aprovação), consultar o seu sistema durante o atendimento, manter o catálogo em dia sozinho, agir quando o seu sistema manda um aviso e seguir fluxos desenhados nó a nó. Quando aparece: O item aparece no menu só quando o módulo Base de conhecimento avançada está ativo na conta. Sem o módulo ligado, abrir qualquer tela dele leva à página do módulo, em Módulos, onde ele é ativado. ### Quem pode usar - Dono: Vê e usa tudo. Só o dono (responsável pela conta) liga uma sincronização, publica ações e fluxos (inclusive com avaliação falhando), volta para uma versão antiga, tira um fluxo do ar, decide “Aplicar mesmo assim” no freio de segurança, troca ou mantém a planilha, volta a planilha, testa uma ação que grava, troca o segredo do webhook, invalida o segredo antigo, cria um endereço novo, exclui regras e arquiva o que já tem histórico. - Admin: Vê o item e todas as telas. Aprova, edita, recusa e arquiva fatos; cria e edita ações, sincronizações, fluxos, eventos e regras; testa ações que só consultam; pausa, retoma e roda a sincronização na hora; ignora uma rodada freada; mostra o segredo do webhook; vê a entrada mascarada nas Execuções (fica registrado) e apaga de vez o que nunca rodou. Não publica: o diálogo avisa que só o responsável pela conta publica. - Atendente: Não vê o item Base avançada no menu. Se abrir o endereço de uma das telas, volta para o início do painel. ### Telas #### Visão geral A tela Visão geral da Base avançada serve para ver de uma vez o que o módulo aprendeu e fez: fatos aprovados, consultas ao seu sistema, taxa de sucesso, o que pede a sua atenção e a saúde das conexões. Endereço no painel: `/app/base-avancada` ![Captura da tela Visão geral. A tela Visão geral da Base avançada serve para ver de uma vez o que o módulo aprendeu e fez: fatos aprovados, consultas ao seu sistema, taxa de sucesso, o que pede a sua atenção e a saúde das conexões.](https://attendto.com.br/prints-do-manual/base-avancada--visao-geral.png) A tela Visão geral na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Menu Base avançada → Visão geral, ou o botão Abrir no cartão do módulo em Módulos. ##### Cabeçalho do módulo (em todas as telas da Base avançada) O nome do módulo, a situação dele e as abas que levam a cada parte. Botões e ações: - **Plano e preço**: Abre a página do módulo em Módulos, com o plano, o que está incluído e o botão de desligar. - **Nova ação**: Abre a escolha do tipo de ação: Consultar na hora ou Sincronizar com a base. - **Visão geral**: Aba com os números e o que o módulo fez nas últimas horas. - **Memória da empresa**: Aba da fila de fatos propostos; mostra quantos estão para revisar. - **Ações**: Aba com as consultas e sincronizações; mostra quantas existem. - **Fluxos**: Aba com os fluxos da IA; mostra quantos existem. - **Webhooks**: Aba dos avisos que o seu sistema manda; mostra quantos eventos existem. - **Execuções**: Aba com cada chamada que a IA fez ao seu sistema e os avisos recebidos. Também aparece: - Selo “Ativo” ou, no período de teste, os dias que restam. - Nome da conta e o Segmento dela ao lado do título. - No celular, a faixa de abas rola de lado e traz a aba aberta para a vista. ##### Avisos do plano Aparecem no topo quando algo do plano do módulo pede ação. Botões e ações: - **Recarregar**: Leva à Carteira para recarregar o saldo quando falta saldo para a mensalidade do módulo. - **Assinar agora** (Dono): No período de teste, quando as consultas incluídas acabam, confirma a assinatura e as sincronizações voltam a rodar. Também aparece: - “Saldo insuficiente para a mensalidade”: o módulo segue ligado até a data mostrada. - Aviso de que o teste chegou ao total de consultas incluídas e as sincronizações pausaram. ##### Números do módulo Cinco indicadores no topo da tela. Também aparece: - Fatos aprovados: total, quantos neste mês e quantos vencidos. - A IA passou a responder: perguntas que antes iam para a equipe. - Ações publicadas: com a contagem de rascunhos e de fluxos. - Consultas no mês: as consultas usadas e, quando o plano tem franquia, a barra de quanto já foi usado das incluídas. - Taxa de sucesso: falhas e tempo médio de resposta do seu sistema. ##### Respostas com o que a IA aprendeu Gráfico por semana: o que a IA respondeu com fato aprovado ou consulta e o que foi para a equipe. Botões e ações: - **Ir para a Memória**: No gráfico vazio, abre a Memória da empresa para aprovar os primeiros fatos. - **Nova ação**: No gráfico vazio, abre a criação de uma ação. Também aparece: - Legenda: Respondidas pela IA e Foram para a equipe. - A data em que o módulo foi ligado aparece no canto da legenda. ##### Agora O que o módulo fez nas últimas horas, do mais recente para o mais antigo. Botões e ações: - **Revisar**: Quando o Curador propôs fatos novos, abre a fila da Memória da empresa. Também aparece: - Rodadas de sincronização: sincronizada, falhou, pausada pelo freio de segurança, recusada pelo limite do plano ou sincronizando; o horário leva à sincronização. - Consultas ao seu sistema na conversa; quando o sistema não respondeu, a linha diz que a conversa passou para a equipe. O horário leva às Execuções. - Avisos recebidos do seu sistema, com quantos leads foram avisados; o horário leva aos Webhooks. - Leituras do Curador: quantos fatos novos propôs e de quantas conversas. ##### Para fazer Atalhos para o que pede a sua atenção. Botões e ações: - **Revisar ‹n› fatos propostos**: Abre a fila da Memória; diz quantos contradizem fatos que já existem. - **Ver “‹sincronização›”**: Abre a sincronização que falhou ou está pausada (freio, teto de gasto, teste ou módulo desligado). - **Terminar “‹rascunho›”**: Abre o rascunho de uma sincronização ou de uma ação para terminar os passos. - **Publicar alterações do fluxo**: Abre o editor do fluxo que tem alterações ainda não publicadas. - **‹n› fatos chegaram à data de revisão**: Abre os Aprovados: a IA segue usando, confirme se ainda vale. - **‹n› fatos venceram**: Abre os Vencidos para renovar ou arquivar. Também aparece: - Sem pendências, o cartão diz “Tudo em dia.” ##### Saúde das conexões Cada conexão com o seu sistema, com a taxa de chamadas boas e o tempo médio. Botões e ações: - **Mais ações de ‹conexão›**: Abre o menu da conexão. - **Excluir conexão**: Abre o diálogo de exclusão; uma conexão usada por ação ou sincronização não sai até você excluir ou arquivar quem a usa. Também aparece: - Webhook de entrada: ponto aceso quando está recebendo e a hora do último aviso. - Sem conexões: “Nenhuma conexão ainda.” ##### Estados da tela - Carregando: Esqueletos dos cinco números e do gráfico. - Sem nada ainda: Gráfico com “Os números aparecem com o uso” e os atalhos Ir para a Memória e Nova ação; Agora diz que nada aconteceu nas últimas horas. - Se der erro: “Não foi possível carregar a Visão geral”, com a garantia de que fatos, sincronizações e consultas seguem funcionando e o botão de tentar de novo. - Falha ao abrir o módulo: “Não foi possível abrir a Base avançada”, dizendo que nada mudou na conta, com o botão de tentar de novo. #### Memória da empresa A tela Memória da empresa serve para aprovar, editar ou recusar os fatos que o Curador de conhecimento aprendeu nas conversas e para cuidar dos fatos aprovados e vencidos. Endereço no painel: `/app/base-avancada/memoria` ![Captura da tela Memória da empresa. A tela Memória da empresa serve para aprovar, editar ou recusar os fatos que o Curador de conhecimento aprendeu nas conversas e para cuidar dos fatos aprovados e vencidos.](https://attendto.com.br/prints-do-manual/base-avancada--memoria.png) A tela Memória da empresa na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Menu Base avançada → Memória da empresa (o número ao lado conta os fatos para revisar). ##### Abas da memória Botões e ações: - **Para revisar**: Mostra a fila de fatos propostos, com a contagem. - **Aprovados**: Mostra a tabela dos fatos que a IA usa, com a contagem. - **Vencidos**: Mostra os fatos cuja validade passou, para renovar. Também aparece: - Atalhos de teclado na fila: A aprovar, E editar, R recusar, J e K navegar entre os cartões (não valem dentro de um campo). ##### Cartão do fato proposto Cada fato proposto, com a origem, a confiança do Curador e as ações. Campos e filtros: - **Categoria**: As do seu Segmento, mais Outros. O Curador escolhe; você troca aqui (aparece no cartão em foco). - **Validade**: Sem validade, Até uma data ou Revisar em 90 dias. - **Vale até**: A data em que o fato sai de uso, quando a validade é Até uma data. Botões e ações: - **Aprovar**: A IA e o Auditor passam a usar o fato a partir da próxima mensagem. - **Aprovar e substituir**: Aparece quando o fato contradiz um aprovado: aprova este e arquiva o antigo. - **Editar**: Deixa o texto do fato editável no próprio cartão. - **Pronto**: Termina a edição e salva o texto ajustado; depois é só aprovar. - **Recusar**: Tira o fato da fila; o Curador não propõe de novo a mesma frase. - **A mesma pergunta em mais ‹n› conversas**: Abre a gaveta do fato com todas as conversas de origem. Também aparece: - Selo da origem: pergunta sem resposta, resposta do atendente, barrada pelo Auditor ou planilha. - A conversa de origem: o que o lead perguntou, o que a IA ia dizer e o que a equipe respondeu. - Aviso “Contradiz um fato aprovado” com o texto antigo, ou “Vence sozinho em” quando o Curador achou a data na frase. - Medidor de confiança do Curador, em porcentagem. ##### Como a memória funciona e De onde vieram A lateral da fila. Também aparece: - As regras: o Curador propõe e só você ou um gestor aprova; o Auditor confere cada resposta; fato com validade sai de uso no dia seguinte ao vencimento; dados pessoais do lead nunca viram fato. - De onde vieram os fatos propostos nos últimos 30 dias, por origem, e a proporção de aprovados e recusados. ##### Aprovados A tabela dos fatos que a IA usa. Campos e filtros: - **Buscar fato**: Busca no texto dos fatos aprovados. - **Fato**: O texto e a origem (conversas e quem aprovou). - **Categoria**: A categoria do fato. - **Validade**: Sem validade, Vence em ou Revisar em, com a data. - **Usado**: Quantas vezes a IA usou o fato. - **Aprovado**: A data da aprovação. Botões e ações: - **Todas**: Mostra os fatos de todas as categorias; ao lado, um botão por categoria filtra a tabela. - **Ver mais**: Carrega mais fatos aprovados. Também aparece: - Clicar numa linha (ou Enter) abre a gaveta do fato. ##### Vencidos Os fatos cuja validade passou e que a IA parou de usar. Campos e filtros: - **Validade**: A nova validade do fato renovado. - **Vale até**: Obrigatória quando a validade é Até uma data. Botões e ações: - **Renovar**: Abre a caixa Renovar o fato, com a validade nova; confirmar faz a IA voltar a usar a partir da próxima mensagem. - **Cancelar**: Fecha a caixa sem renovar. ##### Gaveta do fato Abre pela tabela ou pelo link das conversas; mostra tudo sobre um fato. Campos e filtros: - **Texto do fato** (obrigatório): O texto que a IA usa. - **Categoria**: A categoria do fato. - **Validade**: Sem validade, Até uma data ou Revisar em 90 dias. - **Vale até**: A data final, quando a validade é Até uma data. Botões e ações: - **Editar**: Abre o formulário do fato; o texto novo vale na hora e entra no histórico. - **Arquivar**: Pergunta “Arquivar o fato?”; confirmado, a IA para de usar e o fato sai da tabela, mas fica na trilha. - **Abrir**: Abre a conversa de origem no Inbox. - **Salvar**: Salva o texto, a categoria e a validade editados. - **Cancelar**: Sai da edição sem salvar. Também aparece: - Validade, Aprovado por, Proposto pelo Curador de conhecimento (com a confiança) e Usado (respostas da IA e conferências do Auditor). - Conversas de origem e o Histórico do fato, do mais novo para o mais antigo. ##### Estados da tela - Carregando: Esqueletos dos cartões de fato. - Sem nada ainda: Na fila: “Tudo revisado”, com o botão para ver os aprovados. Nos Aprovados: “Nenhum fato aprovado ainda” ou “Nenhum fato com essa busca”. Nos Vencidos: “Nenhum fato vencido”. - Se der erro: “Não foi possível carregar os fatos para revisar” (os aprovados seguem valendo), com o botão de tentar de novo. #### Ações no seu sistema A tela Ações serve para ver e criar o que a IA consulta no seu sistema durante a conversa ou sincroniza com a base, começando do zero ou de um modelo pronto do seu Segmento. Endereço no painel: `/app/base-avancada/acoes` ![Captura da tela Ações no seu sistema. A tela Ações serve para ver e criar o que a IA consulta no seu sistema durante a conversa ou sincroniza com a base, começando do zero ou de um modelo pronto do seu Segmento.](https://attendto.com.br/prints-do-manual/base-avancada--acoes.png) A tela Ações no seu sistema na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Menu Base avançada → Ações. ##### Suas ações Botões e ações: - **Nova ação**: Abre a escolha do tipo de ação. - **Criar consulta**: Cartão Consultar na hora: abre a escolha do tipo já com a consulta marcada. - **Criar sincronização**: Cartão Sincronizar com a base: abre direto a criação da sincronização. - **Excluir ação**: No menu do cartão da consulta, abre o diálogo de excluir ou arquivar. Também aparece: - Cartão de cada sincronização: situação (Rascunho, Sincronizando a cada tantas horas, Pausada, Última rodada falhou), quantos itens puxou e para onde, e quando rodou por último. Rascunho abre a edição; ligada abre a sincronização. - Cartão de cada consulta: Publicada com a versão ou Rascunho, se só lê ou grava (o lead confirma) e as chamadas do mês com a taxa de sucesso. Clicar abre o editor. ##### Comece de um modelo Ações prontas por Segmento: você só aponta para o endereço do seu sistema. Botões e ações: - **Todos**: Mostra os modelos de todos os Segmentos; ao lado, um botão por Segmento filtra. - **Usar**: Cria o rascunho da ação preenchido pelo modelo e abre o editor. - **Criar**: No cartão Do zero, cria uma ação vazia (qualquer API que responda em JSON) e abre o editor. Também aparece: - Cada modelo mostra para quem serve e se só consulta ou grava. ##### Estados da tela - Carregando: Esqueletos dos cartões. - Sem nada ainda: “Nenhuma ação ainda”, sugerindo começar de um modelo ou sincronizar uma lista do seu sistema. - Se der erro: “Não foi possível carregar as suas ações” (consultas e sincronizações seguem funcionando). Se só os modelos falharem: “Não foi possível carregar os modelos”, e ainda dá para criar do zero. #### Nova ação A tela Nova ação serve para decidir o tipo da ação: consultar o seu sistema na hora, durante a conversa, ou sincronizar uma lista inteira com a base de tempos em tempos. Endereço no painel: `/app/base-avancada/acoes/nova` ![Captura da tela Nova ação. A tela Nova ação serve para decidir o tipo da ação: consultar o seu sistema na hora, durante a conversa, ou sincronizar uma lista inteira com a base de tempos em tempos.](https://attendto.com.br/prints-do-manual/base-avancada--nova-acao.png) A tela Nova ação na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Botão Nova ação no cabeçalho do módulo, na Visão geral ou em Ações; ou Trocar o tipo, dentro de um editor. ##### O que esta ação vai fazer? Botões e ações: - **Consultar na hora**: Escolhe a consulta: a IA pergunta ao seu sistema enquanto fala com o lead (roda a cada pergunta, conta 1 consulta por chamada). - **Sincronizar com a base**: Escolhe a sincronização: a lista inteira é puxada a cada 1, 6 ou 12 horas, ou 1 vez por dia, e substitui a planilha que você sobe à mão. - **Cancelar**: Volta para Ações. - **Continuar com “‹tipo›”**: Na consulta, cria o rascunho e abre o editor; na sincronização, abre a criação da sincronização. Também aparece: - Dica fixa: dá para usar os dois juntos, sincronizar o catálogo e consultar na hora só o estoque da loja. #### Nova sincronização A tela Nova sincronização serve para ligar uma lista do seu sistema (catálogo, preços, tabela de serviços) à base, em seis passos, com teste da lista e prévia de como a IA vai ler cada item. Endereço no painel: `/app/base-avancada/sincronizacoes/nova` ![Captura da tela Nova sincronização. A tela Nova sincronização serve para ligar uma lista do seu sistema (catálogo, preços, tabela de serviços) à base, em seis passos, com teste da lista e prévia de como a IA vai ler cada item.](https://attendto.com.br/prints-do-manual/base-avancada--nova-sincronizacao.png) A tela Nova sincronização na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Ações → Criar sincronização, ou Nova ação → Sincronizar com a base → Continuar. O aviso de planilha da Base de conhecimento também abre esta tela, com a comparação. ##### Cabeçalho Campos e filtros: - **Nome da sincronização** (obrigatório): O título editável no topo; não pode ficar vazio. Botões e ações: - **Trocar o tipo**: Volta à escolha do tipo de ação. - **Ligar e sincronizar agora** (Dono): Salva, liga a sincronização e roda a primeira rodada; com uma planilha para trocar, leva antes à comparação. Fica bloqueado se a lista passou do limite do plano. Também aparece: - Selos Sincronizar com a base e Rascunho, e o “salvo há” do salvamento automático (ou o motivo de não ter salvo). - Para quem não é dono, no lugar do botão: “Só o responsável pela conta liga a sincronização.” ##### Aviso da planilha Aparece quando você importou uma planilha na Base de conhecimento. Botões e ações: - **Ver a comparação**: Testa a lista e abre a tela Trocar a planilha com a comparação coluna por coluna. ##### Passos A faixa com os seis passos; o feito ganha marca e clicar rola até ele. Botões e ações: - **Conexão**: Vai ao passo 1. - **Lista**: Vai ao passo 2. - **Campos**: Vai ao passo 3. - **Destino**: Vai ao passo 4. - **Frequência**: Vai ao passo 5. - **Itens que somem**: Vai ao passo 6. ##### 1 · Conexão O mesmo cofre das outras ações; o token nunca aparece de novo. Campos e filtros: - **Nome da conexão**: Aparece nos avisos, como “Sistema da loja não respondeu”. - **Cabeçalho do token**: O cabeçalho em que o token vai (já vem Authorization). - **Token**: Vai para o cofre e nunca aparece de novo. Botões e ações: - **Guardar no cofre**: Guarda o token cifrado; o selo do passo vira Conectado. - **Trocar**: Com o token já guardado, abre os campos para guardar outro. - **Cancelar**: Desiste de trocar o token. - **Usar “‹conexão›”**: Quando o endereço já tem uma conexão na conta, passa a usar a mesma, sem criar outra igual. ##### 2 · Endereço da lista De onde vem a lista inteira; se vier em páginas, a leitura segue até a última. Campos e filtros: - **Método**: Sempre GET: a sincronização só lê. - **Endereço** (obrigatório): O endereço da lista no seu sistema. - **Paginação**: Automática (mostra o que o teste detectou), Cursor (campo next) ou Sem paginação. - **Onde está a lista na resposta**: O caminho até a lista dentro da resposta, como dados.produtos. Botões e ações: - **Testar a lista**: Lê todas as páginas, mostra o andamento página a página e, no fim, quantas páginas e itens vieram e em quanto tempo. Testar não conta consulta. Também aparece: - Se a lista tiver mais itens que o plano sincroniza, o aviso “A lista passou do limite do plano” sugere filtrar o endereço. ##### 3 · Campos · o que a IA lê As colunas do seu sistema, com uma sugestão de nome em português. Campos e filtros: - **Coluna no seu sistema**: O nome da coluna como vem do sistema. - **Exemplo**: Um valor de exemplo lido no teste. - **Nome que a IA lê**: O nome em português daquela coluna; a coluna Chave aparece como código interno. - **Papel**: Nome, Preço, Estoque, Chave ou Outro. Uma coluna precisa ser a Chave de cada item e outra o Nome. - **Usar**: Interruptor: o que ficar oculto não chega à IA nem aparece para o lead. ##### 4 · Destino Campos e filtros: - **Coleção**: No catálogo, a coleção em que os itens entram. Botões e ações: - **Catálogo de produtos**: Um item por produto, com preço e estoque; a IA monta o pedido com ele. - **Base de conhecimento**: Um trecho por linha, como na importação de planilha. ##### 5 · Frequência Botões e ações: - **A cada ‹n› h**: Busca a lista a cada 1, 6 ou 12 horas. - **1 vez por dia**: Busca a lista uma vez por dia. Também aparece: - As próximas rodadas, as consultas por dia e a previsão de consultas do mês (sem cobrança quando o módulo está incluído no plano). ##### 6 · Item que sumiu do seu sistema Botões e ações: - **Marcar como indisponível**: A IA diz que está em falta e oferece avisar quando voltar. - **Tirar da base**: O item some de vez e a IA passa a dizer que não trabalha com ele. - **Freio de segurança**: Interruptor: se mais de 20% dos itens sumirem numa rodada, a sincronização pausa e avisa antes de mudar a base. ##### Como a IA vai ler A lateral fixa, com a prévia dos primeiros itens e o resumo. Também aparece: - Os primeiros itens com os nomes escolhidos; avisa quando os nomes vêm em maiúsculas e a IA lê em letra normal. - Itens (do total que o plano permite), Por rodada (páginas e consultas) e Agente: Operador de ações (no modelo da sua empresa, quando a conta usa IA própria). ##### Estados da tela - Carregando: Esqueletos do título e dos passos, quando abre um rascunho já salvo. - Se der erro: “Não foi possível abrir a sincronização”, dizendo que nada mudou nela. Falha ao salvar aparece ao lado do título, e o que você escreveu continua na tela. - Antes do teste: O passo 3 diz para testar a lista no passo 2, e a prévia pede o teste. - Falta a coluna Chave: “Escolha a coluna que é a chave de cada item (o papel “Chave”).” #### Sincronização A tela Sincronização serve para acompanhar uma sincronização ligada: a última e a próxima rodada, o que mudou item a item, o histórico de rodadas e as decisões quando algo dá errado. Endereço no painel: `/app/base-avancada/sincronizacoes/‹…›` Como chegar: Clique no cartão de uma sincronização ligada em Ações, ou no horário de uma rodada na Visão geral. ##### Cabeçalho Botões e ações: - **Editar**: Abre a edição da sincronização nos seis passos. - **Pausar**: Para as rodadas; a IA segue com a última versão boa. - **Retomar**: Volta a rodar no horário. - **Sincronizar agora**: Roda uma rodada fora do horário; o botão mostra “Sincronizando… página ‹n› de ‹total›”. Fica bloqueado com a sincronização pausada ou freada. Também aparece: - Selo da situação e o caminho “sistema → destino” (Base de conhecimento ou Catálogo com a coleção). ##### Avisos da rodada Botões e ações: - **Aplicar mesmo assim** (Dono): No freio de segurança, aplica a rodada que tirou muitos itens de uma vez. - **Ignorar esta rodada**: No freio de segurança, descarta a rodada; nada muda na base e a próxima sai no horário. - **Tentar agora**: Depois de uma falha, roda de novo na hora. - **Ajustar o teto**: Com a sincronização pausada pelo teto de gasto, abre Configurações na parte de cobrança. Também aparece: - Rodada pausada pelo freio: diz quantos por cento dos itens sumiram de uma vez e que nada mudou na base. - Rodada recusada: a lista passou do limite do plano; nada mudou. - Rodada que falhou: a IA segue com a última versão boa, a plataforma tenta de novo em 15 minutos e, na terceira falha, você recebe e-mail. - Os avisos do plano (saldo para a mensalidade, consultas do teste) também aparecem aqui. ##### Números da última rodada Também aparece: - Última sincronização (hora, dia, duração, páginas), Próxima (ou “pausada”), Adicionados, Alterados (preços e estoques zerados) e Indisponíveis (sumiram do sistema). ##### O que mudou na última rodada Campos e filtros: - **Produto**: O nome do item (Item, quando o destino é a Base de conhecimento). - **Mudança**: O tipo: novo, preço, estoque, alterado, estoque zerado, indisponível ou removido. - **Antes**: O valor anterior. - **Agora**: O valor novo; no indisponível, que a IA oferece avisar. Botões e ações: - **Tudo**: Mostra todas as mudanças. - **Preço**: Só os itens que mudaram de preço. - **Novos**: Só os itens que entraram. - **Indisponíveis**: Só os itens que não vieram na lista. ##### Rodadas Botões e ações: - **Ver**: Na rodada pausada pelo freio, rola até o aviso com a decisão. Também aparece: - Cada rodada com dia e hora, se foi manual, aplicada mesmo assim, ignorada, falhou ou foi recusada, e a duração. ##### Resumo Botões e ações: - **Voltar a planilha** (Dono): Pergunta “Voltar a planilha?”; confirmado, a planilha volta para a base e a sincronização pausa. - **Cancelar**: Fecha a confirmação sem voltar a planilha. Também aparece: - No catálogo (ou Na base): itens e indisponíveis, e quantos itens aguardam revisão do texto. - Neste mês: rodadas e consultas. - Planilha: quando saiu e até quando fica guardada. ##### Estados da tela - Carregando: Esqueletos do título e dos cartões. - Sem nada ainda: “A primeira rodada mostra aqui cada item que entrou, mudou de preço ou sumiu.” e “A primeira rodada aparece aqui assim que terminar.” - Se der erro: “Não foi possível abrir a sincronização” (ela segue rodando no horário), com o botão de tentar de novo. #### Editar sincronização A tela Editar sincronização serve para mudar a conexão, a lista, os campos, o destino, a frequência ou o que fazer com itens que somem, ou para terminar um rascunho. Endereço no painel: `/app/base-avancada/sincronizacoes/‹…›/editar` Como chegar: Botão Editar na sincronização, o cartão de um rascunho em Ações, ou Terminar na Visão geral. ##### Os seis passos Os mesmos passos e campos da Nova sincronização, já preenchidos e salvos automaticamente. Botões e ações: - **Ver a sincronização**: Com a sincronização já ligada, volta à tela dela. - **Ligar e sincronizar agora** (Dono): No rascunho, liga e roda a primeira rodada. - **Trocar o tipo**: Volta à escolha do tipo de ação. - **Testar a lista**: Lê a lista de novo e atualiza as colunas e a prévia. Também aparece: - O selo mostra Ligada ou Rascunho; o caminho no topo diz Editar sincronização ou Nova sincronização. ##### Estados da tela - Carregando: Esqueletos do título e dos passos. - Se der erro: “Não foi possível abrir a sincronização”, dizendo que nada mudou nela. #### Trocar a planilha A tela Trocar a planilha serve para comparar a planilha que você importou na Base de conhecimento com a lista do seu sistema e decidir trocar pela sincronização ou manter a planilha por enquanto. Endereço no painel: `/app/base-avancada/sincronizacoes/‹…›/trocar-planilha` Como chegar: Ver a comparação, no aviso da planilha; ou Ligar e sincronizar agora numa sincronização que veio de uma planilha. ##### A troca Também aparece: - A planilha (quando e por quem foi importada, linhas e há quantos dias são os preços) ao lado da sincronização (itens agora e frequência). - A planilha continua valendo até a primeira sincronização terminar bem; só então sai e fica guardada 30 dias. ##### Comparação das colunas Campos e filtros: - **Na planilha**: A coluna da planilha (ou “não tinha”, para coluna nova). - **No sistema**: A coluna correspondente no sistema, ou “não existe no sistema”. - **Nome que a IA lê**: O nome em português do campo. - **Situação**: bate, bate com preços que mudaram, vira fato, vazia ou novo. Também aparece: - Coluna com texto que não existe no sistema vira fatos na Memória da empresa, para você aprovar. ##### Como a troca acontece Botões e ações: - **Trocar pela sincronização** (Dono): Liga a sincronização e espera a primeira rodada: terminou bem, abre a sincronização; deu erro, nada muda e aparece o aviso. - **Manter a planilha por enquanto** (Dono): Deixa a sincronização em rascunho e volta para Ações. - **Nova sincronização**: No caminho do topo, volta à criação da sincronização. Também aparece: - Para quem não é dono: “Só o responsável pela conta troca a planilha pela sincronização ou decide manter.” ##### Estados da tela - Carregando: Esqueletos; durante o teste, “Comparando as colunas da planilha com a lista do sistema…”. - Se der erro: “Não foi possível carregar a comparação” (a planilha segue valendo). - A primeira rodada falhou: “A primeira sincronização não terminou bem”: nada mudou e a planilha segue valendo. - Sem teste da lista: Pede para testar a lista na criação da sincronização. #### Editar ação A tela Editar ação serve para configurar uma consulta ao seu sistema em passos: a conexão, o que a IA coleta com o lead, o que ela pode usar da resposta e quando chamar, com salvamento automático e versões. Endereço no painel: `/app/base-avancada/acoes/consultas/‹…›` Como chegar: Clique no cartão de uma consulta em Ações, use um modelo, Do zero, ou Abrir a ação no inspetor de um fluxo. ##### Cabeçalho Campos e filtros: - **Nome da ação** (obrigatório): O título editável; não pode ficar vazio. Botões e ações: - **v‹n› publicada**: Selo da versão no ar; clicar abre a gaveta Versões. - **Testar**: Salva e abre o teste da ação. - **Publicar v‹n›**: Salva e abre o diálogo de publicação; fica desabilitado quando nada mudou desde a versão publicada. Também aparece: - Selos Rascunho e Alterações não publicadas, e o “salvo há” do salvamento automático. ##### Passos da ação Botões e ações: - **Conexão**: Vai ao passo 1. - **Entrada**: Vai ao passo 2. - **Resposta**: Vai ao passo 3. - **Quando usar**: Vai ao passo 4 e, se as intenções estiverem vazias, pede ao Operador de ações uma sugestão. - **Testar**: Abre o teste. - **Publicar**: Abre o diálogo de publicação. ##### Conexão com o seu sistema Campos e filtros: - **Método**: GET para consultar, POST para gravar (POST marca a ação como “grava”). - **Endereço**: O endereço do seu sistema, com os campos entre chaves, como {cep}. Abaixo, “Vai chamar” mostra o endereço com valores de exemplo. - **Corpo da chamada (JSON)**: Só no POST; precisa ser um objeto JSON e aceita {campo} para o que a IA coleta. - **Cabeçalho**: O cabeçalho do token. - **Token**: Vai cifrado para o cofre; ninguém da equipe vê de novo, nem a IA. - **Tempo limite**: 5 segundos, 8 segundos ou 15 segundos; passou disso, a IA diz que vai confirmar e chama a equipe. Botões e ações: - **Trocar o tipo**: Volta à escolha do tipo de ação. - **Guardar token**: Abre os campos do token quando ainda não há um. - **Trocar**: Abre os campos para trocar o token guardado. - **Guardar no cofre**: Guarda o token. - **Cancelar**: Desiste de guardar o token. - **Só consulta**: A ação só lê do seu sistema. - **Grava no meu sistema**: A ação grava; a IA pede a confirmação do lead antes de cada chamada. Também aparece: - Quando o endereço já tem uma conexão na conta, o aviso diz que esta ação usa a mesma, com o token dela. ##### Entrada · o que a IA coleta com o lead Campos e filtros: - **Campo**: O nome técnico do campo e, abaixo, o rótulo em português. - **Formato**: CEP, número, CPF, CNPJ, data, e-mail, telefone ou texto. - **Como a IA pede**: A frase com que a IA pede o dado; vazio, ela não pergunta e usa se o lead disser. - **Obrigatório**: Interruptor: a IA nunca chama com um obrigatório vazio, pergunta antes. Botões e ações: - **Campo**: Acrescenta um campo de entrada. - **Tirar o campo ‹campo›**: Remove o campo da entrada. Também aparece: - Aviso em vermelho quando a ação consulta por CPF sem mandar o telefone do lead: qualquer pessoa que digitar um CPF veria os dados do dono dele. ##### Resposta · o que a IA pode usar Botões e ações: - **usa**: Clicar oculta o campo da resposta: a IA nunca vê o que está oculto. - **oculto**: Clicar libera o campo para a IA usar. - **Editar o rótulo de ‹campo›**: Abre o nome em português do campo para editar. - **Testar**: Com a resposta ainda vazia, abre o teste para ler a resposta real. Também aparece: - Diz em que dia a resposta foi lida num teste real. ##### Quando usar Campos e filtros: - **Descrição**: Como você explicaria a um atendente novo quando chamar a ação. - **A IA consulta quando o lead…**: As intenções: pergunta sobre um produto ou serviço, pergunta preço, quer comprar ou contratar, quer marcar um horário, já é cliente e pede ajuda. Fora delas, a IA nem pensa na ação. - **Frases de exemplo · deve chamar**: Frases que devem disparar a ação. - **Frases de exemplo · não deve chamar**: Frases que não devem disparar. Botões e ações: - **Frase**: Acrescenta uma frase de exemplo (Enter guarda, Esc desiste). ##### Como a IA vai usar e Avaliações A lateral com o resumo do que está configurado. Também aparece: - Chama, Pede ao lead, Pode dizer, Nunca vê (os campos ocultos e o token), Antes de chamar (na ação que grava), Se falhar e Modelo (no Enterprise, definido em Roteamento → Operador de ações na conversa). - Avaliações: as conversas de exemplo, cada uma com passou, revisar, falhou ou a rodar. ##### Fim da página e gaveta Versões Botões e ações: - **Excluir ação**: Abre o diálogo de excluir ou arquivar; depois volta para Ações. - **Ver**: Na gaveta Versões, mostra a configuração daquela versão. - **Voltar para esta** (Dono): Pergunta se quer voltar; a versão antiga vira a próxima e a IA passa a usar na próxima mensagem. Ação que grava pede o código de duas etapas. Também aparece: - Cada versão com quem publicou e quando, o selo em uso e o aviso de publicada com falha. ##### Diálogo Publicar a versão Roda as avaliações contra o seu sistema (só leitura) e mostra o que muda desde a versão anterior. Campos e filtros: - **Código de verificação**: Na ação que grava, o código do aplicativo de verificação em duas etapas do dono. Botões e ações: - **Corrigir antes**: Fecha o diálogo sem publicar. - **Publicar** (Dono): Publica a nova versão; a IA usa a partir da próxima mensagem. - **Publicar assim mesmo** (Dono): Com avaliação falhando, publica mesmo assim e fica registrado. Também aparece: - “Rodando as avaliações no seu sistema… ‹n› de ‹total›” enquanto rodam. - Sem duas etapas ligadas, o aviso manda ligar em Configurações → Segurança para publicar uma ação que grava. - Para quem não é dono: “Só o responsável pela conta publica. Você pode testar e deixar tudo pronto.” ##### Estados da tela - Carregando: Esqueletos do título e do editor. - Se der erro: “Não foi possível abrir esta ação” (ela pode ter sido excluída ou a conexão caiu). Falha ao salvar aparece ao lado do título, e o que você escreveu continua na tela. #### Testar ação A tela Testar ação serve para chamar o seu sistema de verdade com dados de exemplo e ver a requisição, a resposta e o que a IA diria numa conversa simulada, sem enviar nada a nenhum lead. Endereço no painel: `/app/base-avancada/acoes/consultas/‹…›/testar` Como chegar: Botão Testar no editor da ação, o passo 5, ou Testar só este nó no inspetor de um fluxo. ##### Cabeçalho Botões e ações: - **Voltar a editar**: Volta ao editor da ação. - **Publicar v‹n›**: Abre o diálogo de publicação (o mesmo do editor). ##### Entrada do teste Campos e filtros: - **‹campo›**: Um campo para cada dado da entrada, com valores de exemplo. - **‹variável› (teste)**: O telefone ou o nome do lead usados no teste; na conversa, vêm do lead de verdade. - **Fala do lead**: O que o lead diria; mudar a fala ou um campo passa o cenário para Entrada digitada. Botões e ações: - **Entrada digitada**: Usa os valores digitados. - **‹avaliação›**: Em Cenário de exemplo, carrega a entrada e a fala de uma avaliação salva. - **Executar teste**: Chama o seu sistema e monta a conversa simulada. - **Entendo que este teste grava de verdade no meu sistema** (Dono): Na ação que grava, a confirmação obrigatória, junto com o código de duas etapas. Também aparece: - Na ação que grava, quem não é dono vê: “só o responsável pela conta testa, com o código de 2 etapas.” ##### Requisição, Resposta e O que a IA diria Campos e filtros: - **Código de verificação**: Na ação que grava, o código do aplicativo de verificação. Botões e ações: - **Conferir também os valores que voltaram**: Faz a avaliação salva conferir também os valores da resposta, não só a decisão. - **Salvar como avaliação**: Guarda a conversa como exemplo; ela roda de novo a cada publicação. Também aparece: - Requisição com o token oculto. - Resposta com o código e o tempo; tempo esgotado ou erro dizem que a chamada não conta na franquia. - Conversa simulada com o nome da IA, a linha da ação e a nota de como a IA decidiu. ##### Estados da tela - Carregando: Esqueletos do título e dos painéis. - Sem nada ainda: Antes do teste: “A requisição aparece aqui” e “A conversa aparece aqui depois do teste.” - Se der erro: “Não foi possível abrir o teste desta ação”, com o botão de tentar de novo. #### Execuções A tela Execuções serve para ver cada chamada que a IA fez ao seu sistema nas conversas, com a ação, a entrada mascarada, o resultado e o tempo, e os avisos que o seu sistema mandou. Endereço no painel: `/app/base-avancada/execucoes` ![Captura da tela Execuções. A tela Execuções serve para ver cada chamada que a IA fez ao seu sistema nas conversas, com a ação, a entrada mascarada, o resultado e o tempo, e os avisos que o seu sistema mandou.](https://attendto.com.br/prints-do-manual/base-avancada--execucoes.png) A tela Execuções na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Aba Execuções no cabeçalho da Base avançada, ou o horário de uma consulta na Visão geral. ##### Filtros Botões e ações: - **Todas**: Mostra todas as chamadas, com a contagem. - **Com falha**: Só as chamadas que falharam. - **Avisos recebidos**: Troca a tabela pela lista de avisos do seu sistema, com quantas mensagens saíram. - **‹ação›**: Um botão por ação filtra as chamadas dela. - **Exportar**: Baixa a planilha das execuções com o filtro escolhido. ##### Tabela de execuções Campos e filtros: - **Quando**: Dia e hora da chamada. - **Ação**: O nome e a versão da ação. - **Conversa**: O lead da conversa, ou “conversa excluída”. - **Entrada**: O que foi mandado, com os dados pessoais mascarados; o gestor clica para ver, e isso fica registrado. - **Resultado**: O código e o resumo da resposta, ou o motivo de não ter rodado. - **Tempo**: Em milissegundos. - **Custo**: O que a chamada consumiu do plano. Botões e ações: - **Ver a entrada de ‹ação› (fica registrado)** (Dono, Admin): Mostra a entrada sem máscara enquanto o mouse está em cima. - **Mostrar mais**: Carrega mais execuções. Também aparece: - Nota fixa: falhas não contam na franquia. ##### Estados da tela - Carregando: Linhas em esqueleto. - Sem nada ainda: “Nenhuma execução ainda” (cada chamada aparece ao vivo), “Nenhuma falha” no filtro de falhas e “Nenhum aviso recebido” nos avisos. - Se der erro: “Não foi possível carregar as execuções” (as consultas seguem rodando nas conversas). #### Fluxos A tela Fluxos serve para ver e criar os caminhos que a IA segue quando algo acontece: uma mensagem do lead, um aviso do seu sistema, um horário ou um evento do atendimento. Endereço no painel: `/app/base-avancada/fluxos` ![Captura da tela Fluxos. A tela Fluxos serve para ver e criar os caminhos que a IA segue quando algo acontece: uma mensagem do lead, um aviso do seu sistema, um horário ou um evento do atendimento.](https://attendto.com.br/prints-do-manual/base-avancada--fluxos.png) A tela Fluxos na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Menu Base avançada → Fluxos. ##### Seus fluxos Botões e ações: - **Novo fluxo**: Abre o diálogo para dar nome e escolher o gatilho. - **Mais ações de ‹fluxo›**: Abre o menu do cartão. - **Excluir fluxo**: Abre o diálogo de excluir ou arquivar o fluxo. Também aparece: - Cartão de cada fluxo: Publicado com a versão, Alterações não publicadas, Rascunho ou Fora do ar; o gatilho; o resumo e as conversas (e erros) das últimas 24 h ou quando foi editado. Clicar abre o editor. ##### Diálogo Novo fluxo Campos e filtros: - **Nome**: O nome do fluxo; vazio, ele nasce como Novo fluxo. Botões e ações: - **Mensagem do lead**: Gatilho que roda antes do atendimento normal da IA. - **Aviso do seu sistema**: Gatilho que roda quando chega um webhook do seu sistema. - **Agenda**: Gatilho num horário que se repete. - **Evento no atendimento**: Gatilho quando o lead muda de etapa ou fica quente. - **Cancelar**: Fecha sem criar. - **Criar e abrir o editor**: Cria o fluxo e abre o editor. Também aparece: - Se o gatilho já tem um fluxo publicado, o aviso diz qual: só um vale por vez. ##### Estados da tela - Carregando: Blocos em esqueleto. - Sem nada ainda: “Nenhum fluxo ainda”, com o botão Novo fluxo. - Se der erro: “Não foi possível carregar os fluxos”, com o botão de tentar de novo. #### Editor de fluxo A tela Editor de fluxo serve para desenhar nó a nó o que a IA faz, em tela cheia: a lista de nós à esquerda, o canvas no meio e o inspetor do nó selecionado à direita, com teste, avaliações, execuções e versões. Endereço no painel: `/app/base-avancada/fluxos/‹…›` Como chegar: Clique num cartão em Fluxos, Criar e abrir o editor no Novo fluxo, ou Publicar alterações do fluxo na Visão geral. ##### Barra do topo Campos e filtros: - **Nome do fluxo**: Editável; salva ao sair do campo ou com Enter. Botões e ações: - **Voltar**: Volta para a lista de fluxos. - **Editor**: Modo de edição no canvas. - **Execuções**: Modo com as conversas que passaram pelo fluxo nas últimas 24 h. - **Avaliações**: Modo com as conversas de exemplo que rodam a cada publicação. - **Versão**: Seletor de versões: escolher uma antiga pergunta se quer voltar para ela; escolher a que está no ar oferece tirá-la do ar. - **Publicar** (Dono): Abre o diálogo de publicação. - **Mais ações do fluxo**: Abre o menu do fluxo. - **Excluir fluxo**: Abre o diálogo de excluir ou arquivar; depois volta para Fluxos. Também aparece: - Caminho com a versão (ou Rascunho e o número) e o nó selecionado. - Selo Alterações não publicadas ou Publicado com a versão. ##### Lista de nós Campos e filtros: - **Buscar nó**: Busca pelo nome ou pela descrição; abre todos os grupos. Botões e ações: - **Favoritar**: Estrela de cada nó: põe ou tira do grupo Favoritos. - **Favoritos**: Grupo com os nós favoritados (só aparece com algum). - **Gatilhos**: Grupo: Mensagem do lead, Aviso do seu sistema, Agenda e Evento no atendimento. O gatilho do fluxo já está no canvas. - **IA**: Grupo: Classificar intenção, Extrair campos, Gerar resposta e Resumir. - **Lógica**: Grupo: Condição, Esperar e Dividir. - **Ações**: Grupo: Chamar ação e Marcar no CRM. - **Equipe**: Grupo: Passar para a equipe e Avisar a equipe. Também aparece: - Arraste um nó para o canvas, dê dois cliques ou pressione Enter para adicionar. ##### Canvas Também aparece: - Os nós arrastáveis e os fios curvos com rótulo de saída (sim, não, erro, A, B) e as contagens das últimas 24 h. - Ligue uma saída a outro nó puxando o fio; cada saída tem um fio só. - Delete ou Backspace removem o nó selecionado (o Início e o gatilho não saem). - No rodapé do canvas: quantos nós, quem editou e quando, e o “salvo há” do salvamento automático. ##### Barra do canvas e teste Campos e filtros: - **Mensagem do lead para o teste**: O que o lead diria; Enter roda. A última mensagem fica lembrada. Botões e ações: - **Enquadrar**: Ajusta o zoom para caber o fluxo inteiro. - **Aproximar**: Aumenta o zoom. - **Afastar**: Diminui o zoom. - **Desfazer**: Desfaz a última mudança no canvas. - **Testar com uma conversa**: Abre a caixa do teste; durante o teste, vira “Rodando a conversa de teste…”. - **Rodar o teste**: Roda o rascunho em simulação: cada nó acende por onde passou e, no fim, um aviso resume nós, tempo e resposta. Nada é enviado, gravado ou cobrado. - **Cancelar**: Fecha a caixa do teste. ##### Inspetor do nó Abre ao selecionar um nó; os campos mudam com o tipo. Campos e filtros: - **Título do nó**: O nome do nó no canvas. - **Linha do canvas**: A descrição curta que aparece no nó. - **Intenções**: Classificar intenção: as intenções possíveis (Enter acrescenta); abaixo da confiança vira “outro”. - **Confiança mínima**: Classificar e Extrair: o limite de confiança da IA. - **Campos**: Extrair campos: cada campo, o formato e se é obrigatório. - **Se faltar, a IA pergunta**: Extrair campos: a pergunta ao lead quando falta um dado; o fluxo espera a resposta. - **Instrução**: Gerar resposta: o que a resposta deve dizer; usa a persona e os fatos aprovados. - **Para quem**: Resumir: a equipe (vai com o transbordo) ou o CRM (anotação na ficha). - **Condição**: As regras sobre intenção, confiança, campos extraídos, resposta da ação, aviso do sistema e lead; saídas sim e não. - **Combinar**: Com mais de uma regra: todas valem (e) ou qualquer uma vale (ou). - **Esperar por**: Um tempo ou só a resposta do lead. - **ou a resposta do lead, o que vier primeiro**: Esperar: segue quando o lead responde, mesmo antes do tempo. - **Caminho A recebe**: Dividir: o percentual do caminho A; o mesmo lead cai sempre no mesmo lado. - **Ação**: Chamar ação: uma ação publicada; se o sistema não responder, segue pelo fio “erro”. - **O que fazer**: Marcar no CRM: Pôr a etiqueta, Tirar a etiqueta ou Mover para a etapa. - **Etiqueta**: Marcar no CRM: a etiqueta (ou a Etapa do Funil, ao mover). - **Fila**: Passar para a equipe: a fila; leva o resumo e os campos, e o lead vê o nome do atendente. - **Aviso no sino**: Avisar a equipe: a mensagem no sino, sem tirar a conversa da IA. - **Evento do seu sistema**: Gatilho Aviso do seu sistema: o evento da aba Webhooks. - **Dias**: Gatilho Agenda: os dias da semana. - **Hora (no fuso da conta)**: Gatilho Agenda: a hora. - **Para os leads da etiqueta**: Gatilho Agenda: quem recebe. - **Quando**: Gatilho Evento no atendimento: O lead mudou de etapa no Funil ou O lead ficou quente. - **Trocar gatilho**: No gatilho: troca o tipo no lugar; o fio de saída continua ligado. Botões e ações: - **Fechar**: Fecha o inspetor. - **Regra**: Na Condição, acrescenta uma regra. - **Tirar esta regra**: Na Condição, remove a regra. - **Abrir a ação**: Em Chamar ação, abre o editor da ação escolhida. - **Testar só este nó**: Em Chamar ação, abre o teste da ação. - **Excluir nó**: Remove o nó e os fios dele (não aparece no Início nem no gatilho). Também aparece: - Modelo: nos nós de IA, a IA da conta ou, no Enterprise, o modelo da empresa definido em Roteamento → Construtor de fluxo. - Últimas 24 h: as entradas no nó e, na Condição, quantos foram para sim e para não. - Aviso com o que falta para publicar. ##### Modo Execuções Botões e ações: - **Todas**: Mostra todas as conversas das últimas 24 h. - **Com erro**: Só as que terminaram com erro. Também aparece: - Cada conversa com o lead, o desfecho, o caminho nó a nó e a duração; clicar volta ao editor com o caminho aceso no canvas. ##### Modo Avaliações Campos e filtros: - **Nome curto** (obrigatório): O nome da conversa de exemplo. - **Conversa de exemplo** (obrigatório): O que o lead diz. - **Esperado (na ordem)** (obrigatório): Os nós por onde o fluxo tem de passar, nesta ordem; pode passar por outros no meio. Botões e ações: - **Conversa de exemplo**: Abre o diálogo de nova conversa de exemplo. - **Rodar de novo**: Roda todas as avaliações; cada resultado aparece ao terminar. - **Editar**: Edita a conversa de exemplo. - **Excluir ‹nome›**: Pergunta e apaga de vez a conversa de exemplo. - **Salvar**: Salva a conversa de exemplo. - **Excluir**: Confirma a exclusão da conversa de exemplo. Também aparece: - Tabela: Conversa de exemplo, Esperado, Obtido e Resultado (passou, falhou ou ainda não rodou). Uma falha bloqueia o botão Publicar. ##### Diálogos de publicação e de versão Campos e filtros: - **Código de verificação**: Quando o fluxo chama uma ação que grava. Botões e ações: - **Publicar** (Dono): Publica a versão; a IA usa a partir da próxima mensagem. - **Publicar assim mesmo** (Dono): Com avaliação falhando, publica e fica registrado. - **Corrigir antes**: Fecha para corrigir (com avaliação falhando). - **Tirar do ar** (Dono): Na versão em uso, tira o fluxo do ar e libera o gatilho para outro fluxo. - **Voltar para esta** (Dono): A versão antiga vira a próxima, publicada agora, e substitui o rascunho. Também aparece: - O diálogo roda as avaliações ao abrir (“Rodando as avaliações: ‹n› de ‹total›…”) e mostra o que mudou. - Se o gatilho já tem outro fluxo publicado, avisa qual: tire aquele do ar para publicar este. ##### Estados da tela - Carregando: Esqueletos do topo e do canvas. - Sem nada ainda: Execuções: “Nenhuma conversa passou por aqui ainda”. Avaliações: “Nenhuma conversa de exemplo”. - Se der erro: “Não foi possível abrir este fluxo” (pode ter sido excluído ou a conexão caiu). Falha ao salvar aparece no rodapé do canvas, que tenta de novo. - No celular: “Para editar, use o computador.” Dá para ver o fluxo, as execuções e testar com uma conversa. #### Webhooks de entrada A tela Webhooks de entrada serve para dar ao seu sistema um endereço assinado para avisar a plataforma, nomear cada evento que chega e montar regras do tipo “quando chegar X, para os leads certos, faça Y”. Endereço no painel: `/app/base-avancada/webhooks` ![Captura da tela Webhooks de entrada. A tela Webhooks de entrada serve para dar ao seu sistema um endereço assinado para avisar a plataforma, nomear cada evento que chega e montar regras do tipo “quando chegar X, para os leads certos, faça Y”.](https://attendto.com.br/prints-do-manual/base-avancada--webhooks.png) A tela Webhooks de entrada na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Menu Base avançada → Webhooks, ou o atalho “Webhooks de entrada · na Base avançada” na tela de Integrações. ##### Endereço para o seu sistema avisar Botões e ações: - **Copiar o endereço**: Copia o endereço para cadastrar no seu sistema. - **Mostrar**: Revela o segredo da assinatura para copiar (fica registrado). - **Ocultar**: Volta a mascarar o segredo. - **Copiar o segredo**: Copia o segredo revelado. - **Trocar** (Dono): Pergunta “Trocar o segredo?”: o novo vale já e o atual continua valendo por 24 horas. - **Trocar agora**: Confirma a troca e mostra o segredo novo. - **Invalidar o antigo agora** (Dono): Com o segredo anterior ainda valendo, pergunta e corta na hora (use se ele vazou). - **Invalidar agora**: Confirma: avisos assinados com o segredo antigo passam a ser recusados. - **Mais ações do endereço**: Abre o menu do endereço. - **Excluir endereço**: Abre o diálogo de excluir ou arquivar o endereço. - **Criar endereço novo** (Dono): Com o endereço arquivado, gera outro endereço e outro segredo. Também aparece: - Situação: Recebendo, Último há tanto tempo, Sem avisos ainda ou Arquivado. - Dica com os cabeçalhos da assinatura: X-Webhook-Assinatura (HMAC SHA-256 de “timestamp.id.corpo”), X-Webhook-Timestamp e X-Webhook-Id. - Em conta com marca própria sem domínio configurado, o endereço só aparece depois que o domínio do painel estiver pronto. ##### Eventos O que o seu sistema já mandou, cada um com nome em português. Campos e filtros: - **Chave do evento** (obrigatório): O que vai no campo “evento” do corpo (letras, números, ponto, traço ou sublinhado). - **Nome em português** (obrigatório): Como o evento aparece na tela. - **Ícone**: Cobertura, Agenda, Pagamento, Informação, Pedido, Cliente, Aviso, Etiqueta ou Documento. Botões e ações: - **Regra**: Abre uma regra nova (precisa de pelo menos um evento). - **Evento**: Abre Cadastrar um evento, para registrar a chave antes de o sistema mandar. - **nomear**: No evento “Sem nome ainda”, abre Nomear o evento. - **Salvar**: Salva o evento. - **Cancelar**: Fecha sem salvar. Também aparece: - Clicar num evento mostra a regra dele à direita; cada um mostra quantos chegaram no mês. ##### Últimas entregas Também aparece: - Cada chamada ao endereço: aceita (com o que a regra fez), recusada (assinatura inválida, fora da janela, rajada) ou repetida, com a hora. ##### Regra do evento Quando o evento chegar, Para os leads de uma etiqueta, Faça os passos. Campos e filtros: - **Etiqueta do CRM**: Os leads com esta etiqueta na Base de Contatos recebem o aviso. - **Campo do lead**: O campo do lead usado no filtro. - **Comparação**: dentro de, igual a ou existe. - **Campo do aviso**: O campo do corpo do aviso, com sugestões do último recebido; lista termina em “[]”. - **Frase do fato**: No passo Propor fato para aprovar, a frase com os campos do aviso entre chaves; entra na fila da Memória. - **Modelo aprovado da Meta**: Fora das 24 h, o modelo usado; sem modelo, o aviso não é enviado fora da janela. O custo do modelo aparece na opção e sai do saldo. - **De onde vem a variável ‹n›**: Primeiro nome do lead ou um campo do aviso; se o aviso não trouxer o dado, o modelo não sai para aquele lead. - **No máximo 1 aviso por lead a cada**: 7, 14 ou 30 dias. - **Só das**: A hora inicial em que os avisos saem. - **às**: A hora final; o aviso que chega fora do horário espera a próxima abertura. Botões e ações: - **Editar**: Abre a regra para edição. - **Excluir regra** (Dono): Pergunta “Excluir esta regra?”; os avisos já enviados ficam registrados. - **Regra ativa**: Interruptor que liga ou desliga a regra; a regra nasce desligada. - **Escolha o evento**: Em Quando, escolhe o evento que dispara a regra. - **Escolha a lista**: Em Para, abre a etiqueta da Base de Contatos que recebe o aviso. - **sem filtro**: Abre o filtro opcional por campo do lead. - **Usar o filtro**: Aplica o filtro. - **Tirar o filtro**: Remove o filtro. - **Adicione o que fazer**: Abre os passos: Propor fato para aprovar, Mandar mensagem ao lead, Tirar da lista, Marcar campo do lead. - **Tirar este passo**: Remove o passo. - **Editar limites**: Abre os limites de frequência e horário da regra. - **Pronto**: Fecha a caixa aberta. - **Salvar**: Salva a regra; a regra nova nasce desligada. - **Cancelar**: Descarta a edição. Também aparece: - Dentro das 24 h, a IA escreve com a persona da conta; fora, usa o modelo aprovado. - Quem já recebeu (‹n›): abre a lista dos leads avisados, com a data e se foi mensagem da IA ou modelo. ##### Testar a regra Campos e filtros: - **Corpo de exemplo**: O JSON do aviso simulado, preenchido com o último aviso recebido. Botões e ações: - **Enviar evento de teste**: Simula o aviso: mostra se a assinatura é válida, quantos leads receberiam dentro e fora das 24 h, quantos foram pulados pelo limite e o fato proposto. Nada é enviado. ##### Estados da tela - Carregando: Esqueletos do endereço, dos eventos e da regra. - Sem nada ainda: “Nenhum evento recebido” (cadastre o endereço no seu sistema ou a chave antes), “Nenhuma entrega ainda.” e “Nenhuma regra ainda”. - Se der erro: “Não foi possível abrir os webhooks”, dizendo que nada mudou, com o botão de tentar de novo. - Endereço arquivado: O sistema não consegue mais avisar e as regras estão desligadas; as entregas antigas ficam na lista. ### Passo a passo #### Como aprovar os fatos que a IA aprendeu com as conversas 1. Abra **Base avançada → Memória da empresa**; a aba **Para revisar** traz os fatos propostos pelo Curador. 2. Leia a origem do fato no cartão (a pergunta do lead e a resposta da equipe) e confira a confiança. 3. Ajuste a **Categoria** e a **Validade** se precisar; para corrigir o texto, use **Editar** e depois **Pronto**. 4. Clique em **Aprovar** (ou tecle A). Se o fato contradiz outro, o botão vira **Aprovar e substituir**. 5. Para descartar, use **Recusar** (ou tecle R). Navegue entre os cartões com J e K. #### Como sincronizar o catálogo do seu sistema com a base 1. Em **Base avançada → Ações**, clique em **Criar sincronização**. 2. No passo 1, dê o **Nome da conexão**, informe o **Token** e clique em **Guardar no cofre**. 3. No passo 2, cole o **Endereço** da lista e clique em **Testar a lista**. 4. No passo 3, dê a cada coluna o **Nome que a IA lê** e o **Papel** (uma Chave e um Nome, ao menos). 5. Escolha o destino (**Catálogo de produtos** ou **Base de conhecimento**), a frequência e o que fazer com o item que sumiu. 6. O dono clica em **Ligar e sincronizar agora** e acompanha a primeira rodada na tela da sincronização. #### Como criar uma ação que consulta o seu sistema durante a conversa 1. Em **Ações**, use **Usar** num modelo do seu Segmento ou **Criar** no cartão Do zero. 2. Em **Conexão com o seu sistema**, escolha o **Método**, preencha o **Endereço** com os campos entre chaves e guarde o token. 3. Em **Entrada**, use **Campo** para cada dado que o sistema precisa e marque o que é **Obrigatório**. 4. Clique em **Testar** para ler a resposta real e marque, em **Resposta**, o que a IA **usa** e o que fica **oculto**. 5. Em **Quando usar**, escreva a **Descrição**, escolha as intenções e acrescente frases que devem e que não devem chamar. #### Como testar e publicar uma ação 1. No editor da ação, clique em **Testar**. 2. Preencha os campos e a **Fala do lead** e clique em **Executar teste**. 3. Confira a requisição, a resposta e **O que a IA diria**; se estiver certo, clique em **Salvar como avaliação**. 4. O dono clica em **Publicar v‹n›**: as avaliações rodam e o diálogo mostra o que muda. 5. Clique em **Publicar** (ou **Publicar assim mesmo**, se uma avaliação falhou). Ação que grava pede o **Código de verificação**. #### Como avisar os leads quando o seu sistema mandar um webhook 1. Em **Base avançada → Webhooks**, clique em **Copiar o endereço** e cadastre no seu sistema; use **Mostrar** para copiar o segredo da assinatura. 2. Quando o primeiro aviso chegar, clique em **nomear** no evento e dê o **Nome em português**. 3. Clique em **Regra**, escolha o evento, a lista em **Escolha a lista** e, em **Adicione o que fazer**, os passos. 4. Escolha o **Modelo aprovado da Meta** para quem está fora das 24 h e ajuste em **Editar limites**. 5. Clique em **Salvar**, teste com **Enviar evento de teste** e ligue o interruptor **Regra ativa**. #### Como montar um fluxo da IA e testar com uma conversa 1. Em **Base avançada → Fluxos**, clique em **Novo fluxo**, dê o **Nome**, escolha o gatilho e clique em **Criar e abrir o editor**. 2. Arraste os nós da lista para o canvas e ligue as saídas aos próximos nós. 3. Selecione cada nó e preencha o inspetor (intenções, campos, instrução, ação, condição). 4. Clique em **Testar com uma conversa**, escreva a mensagem e clique em **Rodar o teste**; veja os nós acenderem. 5. Em **Avaliações**, crie conversas de exemplo; depois o dono clica em **Publicar**. #### Como trocar a planilha pela sincronização 1. No aviso da planilha (na Base de conhecimento ou na criação da sincronização), clique em **Ver a comparação**. 2. Confira a **Comparação das colunas**: o que bate, os preços que mudaram e as colunas que viram fato. 3. O dono clica em **Trocar pela sincronização**; a planilha só sai se a primeira rodada terminar bem. 4. Para adiar, use **Manter a planilha por enquanto**: a sincronização fica em rascunho. 5. Se precisar desfazer depois, use **Voltar a planilha** no resumo da sincronização, enquanto ela estiver guardada. #### Como excluir ou arquivar uma ação, um fluxo ou uma conexão 1. Abra o menu do cartão (Mais ações) e escolha **Excluir ação**, **Excluir fluxo** ou **Excluir conexão**; no editor, o botão fica no fim da página ou no menu do topo. 2. Leia o diálogo: o que nunca rodou é apagado de vez; o que tem histórico vai para o arquivo. 3. Se algo ainda usa o item (um fluxo publicado, uma ação), tire do ar ou exclua antes. 4. Confirme em **Excluir** ou **Arquivar**. Arquivar o que já rodou é só do dono. ### Perguntas frequentes #### Quem pode publicar uma ação ou um fluxo? Só o dono da conta (o responsável). O admin cria, edita e testa tudo e deixa pronto; no diálogo de publicação ele vê que só o responsável pela conta publica. #### Editar uma ação publicada muda o que a IA está usando? Não. As mudanças ficam como “Alterações não publicadas” e a IA segue com a versão publicada até a próxima publicação. #### Por que o botão Publicar está desabilitado? Porque nada mudou desde a versão publicada, ainda há algo faltando, as avaliações estão rodando, outro fluxo já usa o mesmo gatilho ou, numa ação que grava, a verificação em duas etapas não está ligada. #### O teste de uma ação ou de um fluxo manda mensagem para o lead? Não. O teste da ação chama o seu sistema de verdade, mas nada vai a nenhum lead. O teste do fluxo roda em simulação: nada é enviado, gravado ou cobrado. #### A sincronização pode alterar dados no meu sistema? Não. A sincronização só lê a lista (sempre GET); o token fica no cofre e nunca aparece de novo. #### Posso ter dois fluxos publicados com o mesmo gatilho? Não. Só um fluxo por gatilho fica no ar. Para publicar outro, tire o atual do ar pelo seletor de versão, em Tirar do ar. #### Dá para editar um fluxo pelo celular? Não. No celular você vê o fluxo, as execuções e testa com uma conversa; para editar, use o computador. #### Onde vejo cada vez que a IA consultou o meu sistema? Na aba Execuções: cada chamada com a ação, a versão, a conversa, a entrada mascarada, o resultado e o tempo. Use Exportar para baixar a planilha. #### Quem pode ver os dados pessoais mascarados nas Execuções? O dono e o admin clicam na entrada para ver o valor completo, e cada visualização fica registrada. ### Guia: Base de conhecimento avançada O módulo que aprende com as conversas (Memória da empresa, com a sua aprovação), mantém a base em dia puxando a lista do seu sistema sozinho, consulta o seu sistema na hora, recebe os avisos dele por webhook e segue fluxos que você desenha nó a nó. A Base de conhecimento que você já tem responde com o que você escreveu. A **Base de conhecimento avançada** vai além: aprende com o dia a dia da sua equipe e busca no seu sistema a lista que muda o tempo todo (catálogo, preços, tabela de serviços). Ela é um módulo: você liga em **Módulos**, no menu, e desliga quando quiser. O que você ensinou fica guardado. #### Ativar 1. **Abra Módulos**: No menu, em Conta. O cartão em destaque é a Base de conhecimento avançada. 2. **Ative**: Na página do módulo, **Ativar**. A Base avançada é incluída no seu plano: não há teste nem mensalidade. Só o responsável pela conta ativa; o gestor vê a explicação no lugar do botão. 3. **Comece pela Memória**: O Curador de conhecimento já começa a ler as conversas. Em até uma hora aparecem os primeiros fatos para você aprovar. #### O que está incluído - **Mensalidade**: Não tem. A Base avançada é incluída no seu plano. - **Consultas**: Sem cobrança e sem franquia por ciclo. Os limites de segurança das ações continuam (veja Consultar na hora). - **Itens por sincronização**: Até 100 mil. - **Mensagens fora das 24 h**: O aviso usa um modelo aprovado pela Meta e tem o custo da Meta, como hoje, do saldo. - **Desligar**: Desliga na hora. Nada é cobrado e o que você ensinou fica guardado. #### Memória da empresa O agente **Curador de conhecimento** lê as conversas a cada hora e propõe fatos com a origem: a pergunta que a IA não soube e foi para a equipe, a resposta do atendente e o que o Auditor barrou por falta de fonte. Nada entra sem você ou um gestor aprovar. O fato aprovado vale a partir da próxima mensagem, para a IA responder e para o Auditor conferir. - **Aprovar com o teclado**: Na fila, **A** aprova, **E** edita, **R** recusa, **J** e **K** passam de um cartão a outro. - **Categoria**: As do seu segmento, mais Outros. O Curador escolhe; você troca no cartão. - **Validade**: Sem validade; Até uma data (o fato sai de uso sozinho no dia seguinte); ou Revisar em 90 dias (ele segue valendo e aparece em Para fazer na data). - **Renovar**: Na aba Vencidos, escolha a validade nova e o fato volta a valer na hora. - **Editar o aprovado**: Na gaveta do fato, **Editar**: o texto novo vale na hora e fica no histórico. - **Contradição**: Quando o fato novo contradiz um aprovado, o botão vira **Aprovar e substituir**: o antigo é arquivado. > **Dica:** Dados pessoais do lead nunca viram fato: o Curador descarta frases com nome, telefone, documento ou endereço do lead. #### Sincronizar com a base Em **Ações**, **Nova ação** e **Sincronizar com a base**. A lista inteira do seu sistema é puxada a cada tantas horas e o catálogo ou a base se atualiza sozinho. Use para listas que a IA consulta o tempo todo: catálogo de produtos, preços, tabela de serviços. 1. **Conexão**: Dê um nome à conexão (ele aparece nos avisos, como “Sistema da loja não respondeu”) e guarde o token no cofre. Ele nunca aparece de novo. 2. **Lista**: O endereço da lista e, se precisar, onde ela está na resposta. **Testar a lista** lê todas as páginas e mostra quantos itens vieram. 3. **Campos**: Dê a cada coluna um nome em português e o papel dela: Nome, Preço, Estoque, Chave ou Outro. O que ficar oculto não chega à IA. 4. **Destino**: Catálogo de produtos (com a coleção) ou Base de conhecimento. 5. **Frequência**: A cada 1, 6 ou 12 horas, ou uma vez por dia. A tela mostra as próximas rodadas e a previsão de consultas do mês. 6. **Itens que somem**: Marcar como indisponível ou tirar da base, e o freio de segurança. - **Como a IA vai ler**: O agente Operador de ações reescreve cada item novo ou alterado em letra normal, uma vez só, e a prévia mostra os três primeiros. Códigos dentro do texto (como L12, CX30 ou 50MG) ficam iguais. - **Aguardando revisão do texto**: A rodada não espera a reescrita: os itens entram na hora com o texto do seu sistema, e a IA já consegue achá-los. A revisão do texto vem logo depois, até 1.000 itens por rodada; o resto fica para a próxima. A tela mostra quantos ainda aguardam. - **Uma lista, uma sincronização**: A mesma lista só pode estar ligada em uma sincronização, para o catálogo não ficar em dobro. Para trocar, arquive a antiga antes de ligar a nova. - **Freio de segurança**: Se mais de 20% dos itens sumirem numa rodada, nada muda na base e você decide: **Aplicar mesmo assim** ou **Ignorar esta rodada**. - **Sistema fora do ar**: A rodada falha, a IA segue com a última versão boa e tentamos de novo em 15 minutos; na terceira falha você recebe e-mail. **Tentar agora** roda na hora. - **Sincronizar agora**: Roda uma rodada fora do horário, com o andamento página a página no botão. Entre uma rodada e outra, espere 5 minutos: a tela avisa a hora em que libera. - **Limite de itens**: 100 mil itens por sincronização. Acima disso a rodada é recusada e a base fica como estava. #### Trocar e voltar a planilha Se você importou uma planilha na Base de conhecimento, o aviso “Trocar pela sincronização?” aparece ao lado dela, na criação da sincronização e no Painel (quando o arquivo passa de 15 dias). **Ver a comparação** mostra coluna por coluna o que bate, os preços que mudaram, as colunas novas e as que viram fato para você aprovar. - Sim: A planilha segue valendo até a primeira sincronização terminar bem; só então sai e fica guardada 30 dias. - Sim: Deu erro na primeira rodada: nada muda e você recebe o aviso. - Sim: **Manter a planilha por enquanto** (só o responsável pela conta) deixa a sincronização em rascunho. - Sim: **Voltar a planilha**, na sincronização, devolve o arquivo à base e pausa a sincronização, enquanto ele estiver guardado: os itens e as ofertas dela saem da busca e do catálogo. **Retomar** devolve os dois. #### Consultar na hora Em **Ações**, **Nova ação** e **Consultar na hora**. A IA pergunta ao seu sistema durante a conversa: cobertura no endereço, status do pedido, 2ª via do boleto. Comece de um modelo do seu segmento (você só aponta o endereço do seu sistema) ou do zero, com qualquer API que responda em JSON. 1. **Conexão**: Método (GET para consultar, POST para gravar), o endereço com os campos entre chaves, como `?cep={cep}&numero={numero}`, e o token, que vai cifrado para o cofre. **Vai chamar** mostra o endereço com valores de exemplo. Tempo limite de 5, 8 ou 15 segundos. 2. **Entrada**: O que a IA coleta com o lead: o campo, o formato (CEP, número, CPF, data…), a frase com que ela pede e se é obrigatório. Ela nunca chama com um obrigatório vazio: pergunta antes. Além disso, `{telefone_do_lead}` e `{nome_do_lead}` são preenchidos sozinhos com o lead da conversa, nunca com o que alguém digita. 3. **Resposta**: Aparece depois do primeiro teste. Para cada campo que o seu sistema devolve, **usa** ou **oculto**. O que está oculto a IA nunca vê, nem o token. 4. **Quando usar**: A descrição, as frases que devem e as que não devem chamar a ação, e as intenções do lead (pergunta sobre produto, preço, compra, horário, suporte). Fora dessas intenções a IA nem pensa na ação. 5. **Testar**: A chamada é real, no seu sistema, e nada vai a nenhum lead nem conta consulta. Você vê a requisição (com o token oculto), a resposta e **O que a IA diria**, numa conversa simulada. **Salvar como avaliação** guarda a conversa como exemplo. Uma ação que grava grava de verdade também no teste: só o responsável testa, marcando que entende isso e com o código de 2 etapas. 6. **Publicar**: Só o responsável pela conta publica. As avaliações rodam de novo contra o seu sistema (só leitura) e o diálogo mostra o que mudou desde a versão anterior. - **Versões**: Cada publicação vira uma versão; a IA usa a publicada até a próxima. Editar não muda o que está no ar (“Alterações não publicadas”). Em **Versões**, **Voltar para esta** publica uma cópia da versão antiga como a próxima. - **Avaliações**: Conversas de exemplo com a resposta esperada: chama, não chama ou pede um campo. Com uma falhando, só o responsável publica, com **Publicar assim mesmo**, e fica registrado. - **Ação que grava**: Antes de cada chamada a IA pede a confirmação do lead com os dados que vai usar; só chama depois do sim. Publicar pede o código da verificação em duas etapas do responsável (cada código vale uma vez; 5 tentativas a cada 15 minutos). Avaliação só chama ações GET. Cada gravação leva o cabeçalho `Idempotency-Key`, o mesmo para a mesma confirmação: se a mensagem do lead chegar de novo, o seu sistema reconhece a chave e não grava duas vezes. - **Dados pessoais pelo documento**: Uma ação que mostra dados de quem é dono de um CPF ou CNPJ precisa de mais que o documento: qualquer pessoa pode digitar o CPF de outra. Mande `{telefone_do_lead}` junto (os modelos já mandam) e faça o seu sistema CONFERIR que o telefone é do titular antes de responder. Na mesma conversa, a IA consulta no máximo 2 documentos diferentes em 24 horas; no terceiro, passa para a equipe. - **Limites**: 20 chamadas por minuto por lead e 200 por minuto no total em cada ação, e 10 mil por mês. Acima disso a ação não roda e a conversa segue como se o seu sistema estivesse fora do ar; a chamada recusada aparece em Execuções. - **Lead pronto para comprar**: Quando o lead quer comprar e já deu tudo o que a ação pede, a IA consulta primeiro, responde com o resultado e passa a conversa para a equipe na mesma mensagem. Na ação que grava, ela pede a confirmação antes. Pedido para falar com uma pessoa transfere na hora. - **Execuções**: Cada chamada, com a ação e a versão, a conversa, a entrada, o resultado, o tempo e o custo. Os dados pessoais aparecem mascarados (texto livre mostra só as 3 primeiras letras); quem é gestor clica para ver, e isso fica registrado. **Exportar** baixa a planilha com o mesmo filtro. Guardadas por 90 dias; excluir a conversa ou esquecer o lead apaga as execuções dele. - **Consulta**: Cada chamada com resposta conta 1 consulta, sem cobrança no seu plano. Falha e tempo esgotado não contam. - **Se o seu sistema cair**: A IA não inventa: diz que vai confirmar e passa a conversa para a equipe, com o motivo. O mesmo vale quando a ação não roda por limite. O alerta aparece em Visão geral. #### Webhooks de entrada: os avisos do seu sistema Em **Webhooks**, a sua conta ganha um endereço só dela e um segredo; com domínio próprio no painel, o endereço usa esse domínio. O seu sistema manda um aviso (um JSON) para esse endereço quando algo acontece: a fibra chegou a um bairro, um pagamento foi confirmado, uma instalação foi agendada. Cada aviso vira um **evento**, que você nomeia em português, e cada evento pode ter uma **regra**: quando chegar, para os leads certos, faça. 1. **Cadastre o endereço no seu sistema**: **Copiar** ao lado do endereço. O segredo fica mascarado: **Mostrar** revela para copiar (fica registrado) e **Trocar** gera outro. O segredo anterior ainda vale por 24 horas, para o seu sistema trocar sem parar; **Invalidar o antigo agora** corta na hora, se ele vazou. 2. **Assine cada aviso**: Três cabeçalhos: `X-Webhook-Timestamp` (a hora em segundos, janela de 5 minutos), `X-Webhook-Id` (um id por aviso; o mesmo id em 24 horas é ignorado) e `X-Webhook-Assinatura`, o HMAC SHA-256 do segredo sobre `timestamp.id.corpo`. Em três linhas: `ts = agora()`, `assinatura = hmac_sha256(segredo, ts + "." + id + "." + corpo)`, mande os três cabeçalhos com o JSON. Corpo até 256 KB, 60 avisos por minuto. 3. **Dê nome aos eventos**: O primeiro aviso de cada chave (`cobertura.disponivel`) aparece em **Eventos** como “Sem nome ainda”. **nomear** dá o nome em português e o ícone; **+ Evento** cadastra a chave antes de o sistema mandar. 4. **Monte a regra**: **Quando** o evento chegar, **Para** os leads de uma etiqueta da Base de Contatos (com um filtro opcional: um campo do lead igual a, dentro de ou existente no aviso), **Faça**: propor um fato para a Memória, mandar mensagem ao lead, tirar da lista, marcar um campo. A regra nasce desligada; o interruptor liga. 5. **Teste antes de ligar**: **Enviar evento de teste** simula com o corpo de exemplo: quantos leads receberiam, quantos dentro e fora das 24 horas, quantos pulados pelo freio. Nada é enviado. - **Dentro e fora das 24 h**: Lead que falou nas últimas 24 horas recebe uma mensagem escrita pela IA com a persona da conta e o aviso como fato (o Auditor confere antes). Fora da janela, o WhatsApp só aceita modelo aprovado da Meta: escolha o modelo na regra e diga de onde vem cada variável (um campo do aviso ou o primeiro nome do lead): o preenchimento é direto, sem IA, e se o aviso não trouxer o dado o modelo não sai para aquele lead. Sem modelo, o lead fora das 24 h não recebe. Antes de cada lote, o custo previsto é conferido contra o saldo e o teto de gasto. O custo do modelo é cobrado pela categoria, do saldo. - **Freio e horário**: No máximo 1 aviso por lead a cada 7 dias (ou 14, ou 30) e só entre 8h e 20h, no fuso da conta; o aviso que chega à noite espera a próxima abertura. 500 leads por aviso e 2.000 avisos por dia na conta. Quem saiu, foi anonimizado, está fora das campanhas, não tem amparo legal ou está com um atendente não recebe. Em cada regra, **Quem já recebeu** lista os avisados. - **Propor fato para aprovar**: A frase da regra (“Atendemos o bairro {bairro} desde {data}.”) entra na fila da Memória com a origem “Aviso do seu sistema”, para você aprovar. Nada vira resposta da IA sem a aprovação. - **Últimas entregas**: Cada chamada ao endereço: aceita (com o que a regra fez), recusada (assinatura inválida, fora da janela, corpo grande, rajada) ou repetida. Assinatura errada em excesso recebe 429 e não tira do ar o aviso certo. O exemplo do teste da regra usa só os avisos aceitos. O corpo do aviso fica cifrado e só é lido pela regra. - **O aviso é dado, não instrução**: O que vem no JSON nunca manda na IA: ela só usa preço e condição que estejam em número no aviso, e o Auditor barra o resto. #### Fluxos: o caminho que a IA segue Em **Fluxos**, você desenha nó a nó o que a IA faz quando algo acontece. **Novo fluxo** pede um nome e o gatilho: a mensagem do lead (roda antes do atendimento normal), um aviso do seu sistema, um horário que se repete ou um evento do atendimento (lead mudou de etapa, ficou quente). O editor abre em tela cheia: a lista de nós à esquerda, o canvas no meio e o inspetor do nó selecionado à direita. - **Nós de IA**: **Classificar intenção** (você lista as intenções; abaixo da confiança mínima vira “outro”), **Extrair campos** (CEP, número, CPF…; se faltar, a IA pergunta ao lead e o fluxo espera a resposta), **Gerar resposta** (com a instrução, a persona e os fatos) e **Resumir** (para a equipe ou para a ficha do CRM). - **Lógica**: **Condição** (regras sobre a intenção, os campos extraídos, a resposta da ação, o aviso do sistema e o lead; saídas sim e não), **Esperar** (um tempo, a resposta do lead ou o que vier primeiro; num laço, a espera tem de ser de pelo menos 60 minutos) e **Dividir** (A/B por percentual; o mesmo lead cai sempre no mesmo lado). - **Ações e equipe**: **Chamar ação** usa uma ação publicada; se o seu sistema não responder, o fluxo segue pelo fio “erro”. Ação que grava pergunta antes ao lead com os dados e só chama depois do “sim” (sem o sim, nada é gravado e a conversa volta ao atendimento normal); por isso ela não entra no gatilho “Aviso do seu sistema”, que não tem lead. **Marcar no CRM** (etiqueta, etapa do Funil, campo), **Passar para a equipe** (com o resumo) e **Avisar a equipe** (no sino, sem tirar da IA). **Segue o atendimento** devolve a conversa à IA de sempre: se o fluxo já respondeu, a resposta dele sai e a IA de sempre só volta na próxima mensagem. - **LGPD e segurança**: Antes de o fluxo responder, a IA confere a intenção da mensagem: quem pede para sair vira opt-out na hora, e o aviso de consentimento do primeiro contato vai junto com a resposta do fluxo. Se um nó falhar, a mensagem segue pelo atendimento normal e a execução fica com o erro. Agenda, Evento e retomadas não falam com quem saiu, está sem amparo legal ou com um atendente, e mandam no máximo 6 mensagens por lead em 24 horas. - **Um gatilho por fluxo**: Todo fluxo começa por um gatilho. Para mudar, troque o gatilho no inspetor (o fio de saída continua ligado). Os outros nós saem com Delete, Backspace ou **Excluir nó**, com os fios junto. - **Testar com uma conversa**: O botão do canvas roda o rascunho em simulação com a mensagem que você digitar: cada nó acende por onde passou e, no fim, um aviso resume (nós, tempo e a resposta). Nada é enviado, gravado ou cobrado; a consulta ao seu sistema é só leitura e a ação que grava não é chamada. - **Publicar e versões**: Só o responsável publica, e só um fluxo por gatilho fica no ar. As conversas de exemplo (**Avaliações**) rodam ao abrir o diálogo; uma falhando bloqueia, salvo **Publicar assim mesmo** do responsável, que fica registrado. Ação que grava no fluxo pede o código de 2 etapas. O seletor de versão volta para uma versão antiga (vira a próxima) e **Tirar do ar** libera o gatilho. - **Execuções**: O modo **Execuções** do editor lista as conversas que passaram pelo fluxo nas últimas 24 horas, com o caminho nó a nó; clicar acende o caminho no canvas. Nos fios do canvas, as contagens das últimas 24 h. - **No celular**: Para editar, use o computador. No celular você vê o fluxo, as execuções e testa com uma conversa. #### Excluir e arquivar Tudo o que você cria sai pela tela: o menu **⋯** do cartão ou o botão no fim da página de edição, para ação, fluxo, endereço do webhook, regra, conversa de exemplo e conexão. O modal diz antes o que vai acontecer: - Sim: **Apagado de vez**: o que nunca rodou (rascunho sem execução, conversa de exemplo, regra). O gestor pode. - Sim: **Arquivado**: o que tem histórico (ação publicada ou com execuções, fluxo com versões ou execuções, endereço com entregas). Some da lista e para de rodar: a ação sai do Operador, o fluxo libera o gatilho, o endereço deixa de receber e as regras desligam. Execuções, cobranças, versões e trilha ficam. Só o responsável pela conta. - Sim: Ação usada por um fluxo publicado não sai: o modal lista os fluxos e você tira do ar antes. Conexão usada por ação ou sincronização idem. - Sim: Endereço do webhook arquivado: **Criar endereço novo** gera outro identificador e outro segredo; os eventos e as regras antigos saem, as entregas ficam. **Em conta com IA própria:** #### No modelo da sua empresa Os agentes rodam no modelo da sua empresa, escolhido em **IA própria → Roteamento**: o Curador de conhecimento e o Operador de ações nas tarefas de bastidor, o **Operador de ações na conversa**, que decide a consulta e entende a confirmação do lead, o **Mensageiro de avisos**, que escreve a mensagem do aviso do seu sistema, e o **Construtor de fluxo**, que roda os nós de IA do editor. Como as pessoas procuram: memória da empresa ia; aprovar fatos da ia; ia consultar meu sistema; integrar api com whatsapp ia; sincronizar catálogo automático; trocar planilha por sincronização; webhook de entrada; avisar leads quando sistema mandar webhook; editor de fluxo ia; fluxo de atendimento nó a nó; testar ação antes de publicar; execuções das consultas; freio de segurança sincronização; versões da ação. ## Voz & tom: transcrição de áudios do WhatsApp e voz da IA para responder em áudio URL: https://attendto.com.br/manual/voz-e-tom Menu: Inteligência > Voz & tom Voz & tom é o item do painel que mostra os áudios recebidos dos leads com transcrição e registro de fala, e onde se escolhe a voz sintética com que a IA responde em áudio no WhatsApp. ### Quem pode usar - Dono: Vê tudo e faz tudo: ouve os áudios, troca a voz da IA, ouve prévias, testa frases e liga ou desliga a resposta em voz. - Admin: Ouve os áudios, lê transcrições, ouve as prévias das vozes e testa frases. Trocar a voz e ligar a resposta em voz voltam com aviso de erro: são ações só do dono. - Atendente: Vê o item no menu, os áudios recebidos, a transcrição e o registro de fala. As prévias de voz e o teste de frase não tocam (são de administrador para cima) e não pode trocar a voz. ### Telas #### Voz & tom A tela Voz & tom serve para acompanhar o caminho do áudio do lead (recebido, transcrito e analisado) e definir como a voz da IA soa quando ela responde em áudio. Endereço no painel: `/app/voz` ![Captura da tela Voz & tom. A tela Voz & tom serve para acompanhar o caminho do áudio do lead (recebido, transcrito e analisado) e definir como a voz da IA soa quando ela responde em áudio.](https://attendto.com.br/prints-do-manual/voz-e-tom--voz.png) A tela Voz & tom na conta de demonstração, com dados fictícios e os valores desfocados. ##### 1 · ÁUDIOS RECEBIDOS Os áudios que os leads mandaram no WhatsApp, cinco por página, do mais recente para o mais antigo. Botões e ações: - **‹nome do lead›**: Clicar no cartão do áudio (ou Enter/Espaço) seleciona-o e mostra a transcrição e o registro de fala dele ao lado. - **Página anterior**: Volta para os cinco áudios anteriores. - **Próxima página**: Avança para os próximos cinco áudios. Também aparece: - Cada cartão: avatar, nome do lead, data e hora e o player do áudio (ou `Áudio indisponível`). - O áudio selecionado fica com a borda da marca. - Rodapé `Página ‹n› de ‹total› · ‹n› áudios` quando há mais de uma página. ##### 2 · TRANSCRIÇÃO O texto do áudio selecionado, transcrito automaticamente. Também aparece: - Selo `STT automático`. - A fala do lead entre aspas, em itálico. - Sem texto: `Sem transcrição` — o áudio chegou antes da transcrição ou ela falhou. ##### 3 · REGISTRO DE FALA O jeito de falar do lead, extraído de cada áudio transcrito. Também aparece: - Selo com o registro (por exemplo, informal) e etiquetas com as marcas de fala percebidas. - Balão com o tom sugerido para responder àquele lead. - Sem análise: `Sem registro de fala ainda — é extraído automaticamente de cada áudio transcrito.` ##### Voz da IA Galeria das vozes sintéticas de catálogo, em três grupos: Femininas, Masculinas e Neutra. Botões e ações: - **Voz ‹nome›, ‹gênero›, ‹timbre›** (Dono): Clicar na linha da voz (ou Enter/Espaço) passa a usá-la na persona ativa; aparece o selo `Voz atual` e o aviso `Voz da IA atualizada`. - **Ouvir prévia da voz ‹nome›** (Dono, Admin): Botão redondo de tocar: sintetiza uma frase de boas-vindas com o nome da IA e toca. Clicar de novo pausa (`Pausar prévia da voz ‹nome›`). Também aparece: - Femininas: Nova (clara e enérgica), Shimmer (suave e acolhedora), Coral (calorosa e próxima) e Sage (serena e confiante). - Masculinas: Onyx (grave e encorpada), Echo (firme e direta), Ash (jovem e amigável) e Ballad (calma e narrativa). - Neutra: Alloy (equilibrada e versátil), a voz usada quando nenhuma foi escolhida. - Cada voz tem um círculo colorido que pulsa enquanto a prévia toca (parado com movimento reduzido). - Nota de rodapé: vozes sintéticas de catálogo; a voz do lead nunca é clonada nem imitada (LGPD). ##### Teste com a sua frase Ouve qualquer frase na voz atual, do mesmo jeito que sai no WhatsApp. Campos e filtros: - **Frase de teste da voz**: Até 240 caracteres, com contador `‹n›/240`. Vazio, toca a frase de boas-vindas com o nome da IA. Também aparece: - Player que sintetiza a frase na voz atual; trocar a voz ou a frase prepara um áudio novo. ##### Responder em voz (TTS) Decide se a IA responde em áudio quando o lead manda áudio. Botões e ações: - **Responder em voz (TTS)** (Dono): Interruptor que vale na hora: ligado, a resposta a um áudio sai em áudio, na voz escolhida acima. Fica desabilitado quando não há persona ativa. ##### Estados da tela - Carregando: Blocos cinza no lugar dos cartões. - Sem nada ainda: `Nenhum áudio recebido ainda — os áudios dos leads no WhatsApp aparecem aqui.` - Se der erro: `Não foi possível carregar as amostras de voz`, avisando que as respostas continuam gravadas, com botão para tentar de novo. - Prévia não carregou: Aviso `Não foi possível carregar a prévia da voz.` (é o que o atendente vê ao tentar ouvir). - Navegador bloqueou o som automático: Aviso `Prévia pronta — toque de novo para ouvir.` - Troca de voz recusada: Aviso `Não foi possível trocar a voz. Tente novamente.` - Sem persona ativa: `Nenhuma persona ativa encontrada.` no cartão da resposta em voz, com o interruptor desabilitado. ### Passo a passo #### Como escolher a voz da IA 1. Abra **Voz & tom** no menu. 2. No cartão **Voz da IA**, clique no botão de tocar de pelo menos três vozes para ouvir a prévia. 3. Clique na linha da voz escolhida; ela ganha o selo `Voz atual`. #### Como ouvir uma frase na voz da IA antes de ligar 1. No cartão **Teste com a sua frase**, escreva a frase na caixa. 2. Aperte o play do player logo abaixo. #### Como fazer a IA responder áudio com áudio 1. Escolha a voz no cartão **Voz da IA**. 2. Ligue o interruptor **Responder em voz (TTS)**. 3. Daí em diante, quando o lead mandar áudio, a resposta sai em áudio. #### Como ler a transcrição de um áudio do lead 1. Em **1 · ÁUDIOS RECEBIDOS**, clique no cartão do áudio. 2. Leia o texto em **2 · TRANSCRIÇÃO** e o jeito de falar em **3 · REGISTRO DE FALA**. 3. Use **Próxima página** para ver áudios mais antigos. ### Perguntas frequentes #### A IA responde em áudio a toda mensagem? Não. Com **Responder em voz (TTS)** ligado, ela responde em áudio quando o lead manda áudio; mensagem de texto continua recebendo texto. #### Quantas vozes existem para escolher? Nove: quatro femininas, quatro masculinas e uma neutra. #### Qual voz a IA usa se eu nunca escolhi? A neutra, Alloy. #### A IA pode falar com a minha voz ou a voz do meu vendedor? Não nesta tela: as vozes são sintéticas de catálogo. Para o lead ouvir a voz do seu time, grave respostas em Intent & catálogo, no cartão Respostas gravadas. #### Qual o tamanho máximo da frase de teste? 240 caracteres; o contador ao lado do player mostra quantos já foram usados. #### Por que um áudio aparece Sem transcrição? Ele chegou antes de a transcrição estar disponível ou a transcrição falhou. O áudio continua no player para ouvir. #### O registro de fala muda a resposta da IA? Ele mostra o jeito de falar do lead e um tom sugerido. O tom da persona, que vale para todas as conversas, se escreve no Editor de persona. ### Guia: Voz & tom Os áudios que os leads mandam, o que foi dito neles e a voz com que a sua IA responde. Dois controles mudam comportamento; o resto é leitura. Muita gente responde por áudio no WhatsApp, e esta tela existe por causa disso. Ela mostra o que chegou falado, o que foi dito e com que voz a sua IA responde. De tudo que aparece aqui, só **duas coisas** mudam o comportamento dela: a **voz escolhida** e o interruptor **Responder em voz (TTS)** — responder em áudio, em português do dia a dia. O resto é leitura. #### A tela por partes Na tela: Tela Voz & tom com o card de áudios recebidos à esquerda e a galeria de vozes da IA à direita. Nesta conta ainda não chegou áudio nenhum: por isso a esquerda está vazia e os cartões de transcrição e registro de fala não aparecem. 1. **Os áudios que chegaram**: Os áudios que os leads mandaram, do mais recente para o mais antigo. Vazio como aqui quer dizer que ninguém mandou áudio ainda — e os cartões **2 · TRANSCRIÇÃO** e **3 · REGISTRO DE FALA** só aparecem depois que você seleciona um áudio desta lista. 2. **A voz da IA**: O primeiro dos dois controles de verdade da tela. O nome que aparece entre parênteses é o da sua persona: escolha uma voz que combine com ele. 3. **Nove vozes em três grupos**: **FEMININAS** (Nova, Shimmer, Coral, Sage), **MASCULINAS** (Onyx, Echo, Ash, Ballad) e **NEUTRA** (Alloy), cada uma com o timbre descrito em duas palavras. Clicou, trocou: não existe botão de salvar. 4. **A prévia de cada voz**: Ouça antes de escolher, quantas vezes quiser. Prévia não debita nada do seu saldo. 5. **A voz em uso**: A escolhida fica com o cartão realçado e a marca **Voz atual**. É esta que sai no WhatsApp quando responder em áudio está ligado. 6. **A voz do lead nunca é copiada**: Todas as vozes são de catálogo. O áudio de quem fala com você serve só para ser entendido — nada é clonado nem imitado. #### 1, 2 e 3 são o caminho do áudio Os três números não são tarefas para você executar em ordem. São o trajeto que um áudio faz sozinho quando chega, mostrado passo a passo para você poder conferir onde parou: - **1 · ÁUDIOS RECEBIDOS**: O que os leads mandaram falado. Clique em um para ver os dois cartões seguintes daquele áudio. - **2 · TRANSCRIÇÃO**: O mesmo áudio virado texto — é assim que a IA entende o que foi dito. **Sem transcrição** quer dizer que aquele áudio não pôde ser lido; a conversa segue normal, mas aquele trecho ela não ouviu. - **3 · REGISTRO DE FALA**: A leitura do jeito de falar daquela pessoa — formal, informal ou neutro — com as expressões que apareceram. Serve de espelho: se todo mundo fala informal e a sua IA responde de terno e gravata, o desencontro está aqui, à vista. #### Escolher a voz 1. **Ouça as prévias**: O botão redondo ao lado de cada voz toca uma amostra. Ouça pelo menos três antes de decidir — no papel os nomes não dizem nada. 2. **Teste com a sua frase**: No cartão **Teste com a sua frase**, escreva até 240 caracteres e ouça na voz atual. Use uma frase que a sua IA realmente diria, com o nome da empresa e um preço dentro: nome próprio e número são onde as vozes mais se diferenciam. 3. **Clique na voz**: A escolha salva no clique e vale da próxima resposta em diante. Trocar não afeta áudio nenhum que já foi enviado. 4. **Decida se ela responde falando**: O interruptor **Responder em voz (TTS)**, no fim da coluna, faz a resposta sair em áudio quando o lead manda áudio. Desligado, ela entende o áudio e responde por escrito. > **Como é quando está bem resolvido:** A voz combina com o nome da persona, você já ouviu a sua própria frase nela, e a decisão de responder em áudio é consciente: falando com quem fala, escrevendo com quem escreve. Nesse ponto esta tela vira o que ela deve ser — um lugar de conferir, não de mexer. #### Com um teste A/B rodando > **A troca vale só para a variante A:** Se você tem um teste em [Personas A/B](https://attendto.com.br/manual/personas), a voz e o interruptor de responder em áudio mudam **apenas na variante A**. A tela não avisa. Metade dos seus leads continua ouvindo a voz antiga, e o teste passa a comparar duas coisas diferentes do que você pensa. Para mexer na variante B, vá ao editor dela. #### O jeito de falar não se ajusta aqui Voz é o timbre; tom é o jeito. Esta tela cuida do timbre. Não existe, aqui nem em outro lugar, um campo para escolher entre "você" e "senhor", nem um controle de tamanho da resposta — se alguém te prometeu isso, a promessa estava errada. O jeito de falar se controla escrevendo, no campo **Tom de voz** da persona, em [Configurações](https://attendto.com.br/manual/configuracoes) ou no editor de [Personas A/B](https://attendto.com.br/manual/personas). É texto livre, e é ali que cabem instruções como "trate por você", "respostas de no máximo três linhas" ou "nunca prometa prazo sem confirmar". O **Nome da IA** também mora lá, não aqui. #### O que custa e o que não custa - **Ouvir prévia não debita nada.** Pode ouvir as nove, várias vezes. - **Testar com a sua frase não debita nada.** Escreva e ouça à vontade antes de decidir. - **Receber áudio de lead debita quando ele vira texto.** Transformar a fala em texto é cobrado por minuto, e aparece no extrato como **Minuto de voz**. Áudio de três minutos custa três vezes o de um. Com a IA atendendo, todo áudio é transcrito; com a equipe atendendo, só com **Transcrever áudios no atendimento humano** ligado em [Configurações](https://attendto.com.br/manual/configuracoes) — desligado (o padrão), o atendente ouve e nada é cobrado. O saldo e o preço de cada item estão em [Saldo & Recargas](https://attendto.com.br/manual/saldo-e-recargas). Vale olhar depois da primeira semana com áudio: público que fala muito muda a conta do mês. #### Quem pode mexer - Trocar a voz e ligar o responder em áudio: **só o dono da conta**. - Ouvir prévias e testar frases: de administrador para cima. - Ler os áudios, a transcrição e o registro de fala: quem tem acesso à tela. No painel: Abrir Voz & tom. Como as pessoas procuram: transcrever áudio do whatsapp; ia responder em áudio; voz da ia; escolher voz do atendente virtual; texto para fala; áudios dos leads; transcrição automática de áudio; testar voz da ia; resposta em voz tts; tom de voz do lead. ## Modelos de mensagem do WhatsApp: criar template, escolher categoria e enviar para aprovação da Meta URL: https://attendto.com.br/manual/modelos-de-mensagem Menu: Inteligência > Modelos de mensagem Modelos de mensagem é a área do painel onde a empresa escreve, envia para aprovação da Meta e acompanha os modelos (templates) de WhatsApp, as únicas mensagens que podem ser enviadas a quem não escreveu nas últimas 24 horas. Quando aparece: Precisa do WhatsApp conectado em Conexões, com a conta de negócio da Meta vinculada. Cada número conectado tem os seus próprios modelos. ### Quem pode usar - Dono: Vê a lista, cria modelos, envia para aprovação e remove modelos. - Admin: Vê a lista, cria modelos, envia para aprovação e remove modelos. - Atendente: Não vê o item no menu nem na busca do Ctrl K: a tela é só de dono e admin. Pelo endereço direto, o atendente é levado de volta ao Painel. ### Telas #### Modelos de mensagem A tela Modelos de mensagem serve para ver todos os modelos do WhatsApp com o estado de aprovação na Meta, a categoria e a prévia de cada um, e para criar ou remover modelos. Endereço no painel: `/app/modelos` ![Captura da tela Modelos de mensagem. A tela Modelos de mensagem serve para ver todos os modelos do WhatsApp com o estado de aprovação na Meta, a categoria e a prévia de cada um, e para criar ou remover modelos.](https://attendto.com.br/prints-do-manual/modelos-de-mensagem--modelos-de-mensagem.png) A tela Modelos de mensagem na conta de demonstração, com dados fictícios e os valores desfocados. ##### Topo da lista O resumo do que está em análise e as ações. Botões e ações: - **Atualizar**: Busca de novo a lista de modelos e o estado de cada um na Meta. - **Novo modelo**: Abre o editor de modelo. Também aparece: - Com modelos em análise: "‹n› modelos estão em análise na Meta", avisando que o estado muda sozinho quando ela responder. - Sem nada em análise, a frase explica que modelo é a mensagem aprovada para quem não escreveu nas últimas 24 horas. - Aviso em amarelo quando a conexão não tem a conta de negócio da Meta vinculada, pedindo para reconectar o WhatsApp pelo Facebook em Conexões. ##### Cartão do modelo Um cartão por modelo, em duas colunas em telas largas. Botões e ações: - **Remover o modelo ‹nome›**: Botão da lixeira: abre a confirmação de remoção. - **Ver como o lead recebe**: Abre o texto inteiro e a prévia na bolha do WhatsApp, com cabeçalho, rodapé e botões (vira "Ocultar prévia"). Também aparece: - Nome do modelo. - Selo de estado com um ponto colorido e o texto, com a explicação na dica: Aprovado, Em análise na Meta, Recusado, Pausado por qualidade, Desativado pela Meta, Em recurso na Meta, Arquivado por desuso, Limite de modelos atingido, Não chegou à Meta, entre outros. - Selo da categoria (Marketing, Utilidade ou Autenticação), selo do tipo de mídia do cabeçalho quando há, e o idioma. - Bloco "O QUE PRECISA MUDAR" quando a Meta recusou, com o motivo em português. - As duas primeiras linhas do texto e os botões do modelo (resposta rápida, link ou telefone). ##### Diálogo Remover o modelo Confirmação da remoção de um modelo. Botões e ações: - **Cancelar**: Fecha sem remover. - **Remover modelo**: Apaga o modelo daqui e da conta na Meta. Ele deixa de servir para campanhas e para retomar conversa fora das 24 horas. Não tem desfazer. Também aparece: - Em modelo aprovado, o aviso de que a Meta bloqueia o mesmo nome por 30 dias depois de apagado. ##### Estados da tela - Carregando: Faixas cinzas no lugar dos cartões. - Sem nada ainda: "Nenhum modelo ainda", explicando para que serve um modelo, com o botão Criar o primeiro modelo. - Se der erro: "Não foi possível carregar os seus modelos", com o aviso de que nada foi perdido e o botão Tentar de novo. - WhatsApp não conectado: "Conecte o WhatsApp para criar modelos", com o botão Ir para Conexões. #### Novo modelo A tela Novo modelo serve para escrever um modelo de WhatsApp com prévia ao lado, escolher a categoria e o idioma, acrescentar cabeçalho, rodapé e botões e enviar tudo para a aprovação da Meta. Endereço no painel: `/app/modelos/novo` ![Captura da tela Novo modelo. A tela Novo modelo serve para escrever um modelo de WhatsApp com prévia ao lado, escolher a categoria e o idioma, acrescentar cabeçalho, rodapé e botões e enviar tudo para a aprovação da Meta.](https://attendto.com.br/prints-do-manual/modelos-de-mensagem--novo-modelo.png) A tela Novo modelo na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Pelo botão Novo modelo (ou Criar o primeiro modelo) na tela Modelos de mensagem. ##### Voltar Botões e ações: - **Voltar para os modelos**: Volta à lista sem salvar o que foi escrito. ##### Identificação Nome, idioma e categoria. O lead não vê o nome. Campos e filtros: - **Nome do modelo** (obrigatório): Só minúsculas, números e sublinhado; a tela ajusta enquanto você digita (exemplo: confirmacao_de_reuniao). Tem contador de caracteres. - **Idioma**: Português (Brasil), Português (Portugal), Inglês (Estados Unidos) ou Espanhol (Espanha). Nome e idioma juntos são a identidade do modelo na Meta. Botões e ações: - **Categoria**: Cartões para escolher entre Marketing e Utilidade, cada um com para que serve e como a Meta cobra. Abaixo, "Quando usar" e "Evite" da categoria escolhida. A dica do ícone explica que a categoria muda o preço e é motivo comum de recusa. ##### Mensagem O único campo obrigatório além do nome. Campos e filtros: - **O que o lead recebe** (obrigatório): O texto da mensagem, com contador de caracteres. Use {{1}}, {{2}} onde o texto muda a cada lead. Aceita *negrito*, _itálico_ e ~riscado~. Não pode começar nem terminar com variável. - **Exemplo da variável ‹n›**: Aparece para cada variável do texto, dentro de "Exemplos das variáveis". A Meta exige um exemplo de cada uma para revisar; é ele que aparece na prévia. ##### O que o lead vai ver Prévia fiel da bolha do WhatsApp, com os seus exemplos no lugar das variáveis. No computador fica fixa ao lado do formulário; no celular, logo abaixo da mensagem. ##### Ajustes (opcionais) Cabeçalho, rodapé e botões. Dá para enviar sem nenhum deles. Campos e filtros: - **Título do modelo**: O cabeçalho em texto (exemplo: Reunião confirmada), com contador de caracteres. - **Exemplo da variável do título**: Aparece quando o cabeçalho tem variável; a Meta exige o exemplo. - **Rodapé**: Texto fixo, sem variável, que aparece em cinza abaixo da mensagem (exemplo: Responda SAIR para não receber mais). - **Texto do botão ‹n›**: O texto que aparece no botão. - **Endereço do botão ‹n›**: Só no botão do tipo Link: o endereço que o botão abre. - **Telefone do botão ‹n›**: Só no botão do tipo Telefone: o número que o botão liga, com DDI. Botões e ações: - **Texto**: Cabeçalho em texto. - **Imagem**: Cabeçalho com imagem. - **Escolher imagem**: Envia a imagem de exemplo (JPG ou PNG) que a Meta analisa junto com o texto. A imagem de cada envio você escolhe depois, na campanha. - **Trocar**: Escolhe outra imagem de exemplo. - **Remover a imagem do cabeçalho**: Tira a imagem escolhida. - **Resposta rápida**: Acrescenta um botão que devolve o próprio texto como mensagem do lead. - **Link**: Acrescenta um botão que abre um endereço no navegador. - **Telefone**: Acrescenta um botão que inicia uma ligação. - **Tipo do botão ‹n›**: Troca o tipo de um botão já criado. - **Remover botão ‹n›**: Apaga o botão. Também aparece: - Sem botões, a tela explica o que cada tipo faz. - Ao chegar no máximo de botões aceito, os botões de acrescentar somem. - Imagem escolhida mostra a miniatura, o nome, o tamanho e "aceita pela Meta". ##### Envio para aprovação O botão final e o aviso do que falta. Botões e ações: - **Enviar para aprovação**: Manda o modelo para a análise da Meta e volta à lista, onde ele aparece Em análise na Meta. Também aparece: - Aviso fixo: quem aprova é a Meta, que não garante prazo; quando ela responder, o estado muda na lista e chega um aviso. - Os erros de cada campo aparecem depois que você sai do campo ou tenta enviar, em vermelho quando impedem o envio e em amarelo quando são só alerta. ##### Estados da tela - Carregando: Enquanto a imagem sobe, o botão mostra "Enviando imagem…"; durante o envio, "Enviando…". - Se der erro: Ao tentar enviar com problema, aparece "Falta um ajuste antes de enviar" (ou "Faltam ‹n› ajustes antes de enviar"), lembrando que são regras da própria Meta. ### Passo a passo #### Como criar um modelo de mensagem do WhatsApp 1. Abra **Modelos de mensagem** e clique em **Novo modelo**. 2. Preencha **Nome do modelo** e escolha o **Idioma**. 3. Escolha a **Categoria** lendo o "Quando usar" e o "Evite". 4. Escreva o texto em **O que o lead recebe** e preencha um exemplo para cada variável. 5. Confira a bolha em **O que o lead vai ver**. 6. Clique em **Enviar para aprovação**. #### Como pôr uma imagem no cabeçalho do modelo 1. No editor, em **Ajustes (opcionais)**, clique em **Imagem**. 2. Clique em **Escolher imagem** e selecione um JPG ou PNG. 3. Espere aparecer **aceita pela Meta** e envie o modelo. Na campanha você escolhe a imagem de cada envio. #### Como acrescentar botões ao modelo 1. Em **Ajustes (opcionais)**, clique em **Resposta rápida**, **Link** ou **Telefone**. 2. Preencha o texto do botão e, se for link ou telefone, o endereço ou o número. 3. Confira os botões na prévia antes de enviar. #### Como ver por que um modelo foi recusado 1. Na lista de **Modelos de mensagem**, procure o cartão com o estado **Recusado**. 2. Leia o bloco **O QUE PRECISA MUDAR**. 3. Crie um modelo novo com o ajuste em **Novo modelo**. #### Como remover um modelo 1. No cartão do modelo, clique no ícone da lixeira. 2. Leia o aviso (em modelo aprovado, o nome fica bloqueado por 30 dias na Meta). 3. Clique em **Remover modelo**. ### Perguntas frequentes #### Por que só aparecem as categorias Marketing e Utilidade no editor? São as duas que o editor compõe. Autenticação é para código de login com texto fixo da Meta e não serve para atendimento; um modelo dessa categoria criado fora do painel aparece na lista com o selo Autenticação. #### Posso criar dois modelos com o mesmo nome? Só em idiomas diferentes: para a Meta, nome e idioma juntos são a identidade do modelo. #### Preciso clicar em Atualizar para ver se o modelo foi aprovado? Não. O estado muda sozinho quando a Meta responde; Atualizar só força uma nova leitura na hora. #### Por que o atendente não consegue abrir Modelos de mensagem? Criar e apagar modelo mexe na conta de negócio da empresa na Meta, então a tela é de dono e admin. O atendente é levado de volta ao Painel. #### A imagem que envio no editor é a que vai para os clientes? Não. Ela é a amostra que a Meta analisa. A imagem que vai de fato é escolhida em cada campanha, no passo do modelo. #### Posso usar formatação no texto do modelo? Pode: *negrito*, _itálico_ e ~riscado~, do jeito do WhatsApp. A prévia mostra como fica. ### Guia: Modelos de mensagem Os textos aprovados que deixam você falar com quem parou de responder. Escreva aqui, veja como o lead recebe e mande para aprovação. Depois de 24 horas sem resposta do lead, o WhatsApp fecha a porta: você não escreve mais o que quiser. Só passa **texto aprovado com antecedência**. Esta tela é onde esses textos nascem. Você escreve, manda para aprovação e acompanha o resultado sem sair daqui. Modelo aprovado passa a aparecer em três lugares: no Inbox quando a janela está fechada, nas campanhas e nas sequências automáticas. > **Cada número tem os seus modelos:** O texto aprovado não é do painel: ele vive na conta da Meta em que o **número** está. Com mais de um número conectado, a lista abaixo mostra os modelos de **todos** eles juntos, sem dizer de quem é cada um; já sincronizar e **criar** valem para a **conta padrão** do canal. É por isso que o assistente de campanha pergunta por qual número enviar **antes** de listar os modelos — ali a lista já sai recortada. Ver [Conexões](https://attendto.com.br/manual/conexoes). #### A lista de modelos Na tela: Lista de modelos de mensagem com as situações de aprovação de cada um. Cada modelo com a sua situação. Só os aprovados podem ser enviados. 1. **O aviso do que está em análise**: Quantos modelos estão esperando resposta. **Novo modelo** abre o editor com a prévia ao lado, mostrando como o lead vai receber. 2. **Um modelo aprovado**: Nome, situação, categoria e o texto com as variáveis. **Ver como o lead recebe** abre a bolha do WhatsApp igualzinha. 3. **Esperando a Meta**: Nada do seu lado está pendente. Quando ela responder, o estado muda sozinho aqui. 4. **Recusado, com o motivo em português**: Nada de código de erro. Aqui o bloco **O que precisa mudar** explica a recusa e o conserto — neste caso, texto de propaganda numa categoria que só serve para dar andamento a um pedido. - **Aprovado**: Pode ser enviado. É o único estado que serve para alguma coisa. - **Em análise na Meta**: Foi enviado para aprovação e está na fila. Costuma sair em minutos, às vezes leva horas. Não há nada a fazer. - **Recusado**: Não passou, e a tela diz por quê. Quase sempre é promessa exagerada, texto de propaganda na categoria errada ou variável mal colocada. Corrija e mande de novo. - **Pausado por qualidade**: Era aprovado, mas muita gente bloqueou ou denunciou. É o sinal mais claro de que a mensagem está incomodando: reescreva antes de insistir. #### Escrever um modelo que passa 1. **Dê um nome que você reconheça daqui a três meses**: `retomada_orcamento` é melhor que `modelo2`. O nome aparece na hora de escolher, no meio de uma campanha. 2. **Escreva curto e específico**: Uma frase de contexto e uma pergunta. Texto longo cheio de adjetivo é o que mais volta recusado. 3. **Use variáveis para personalizar**: `{{1}}` vira o nome da pessoa, `{{2}}` o que você quiser. "Oi {{1}}, tudo bem?" chega com o nome real de cada um. 4. **Confira na prévia**: A bolha ao lado mostra a mensagem como ela chega no celular do lead. Se ficou estranho ali, vai ficar estranho lá. 5. **Mande para aprovação**: Daí é esperar. Enquanto isso o modelo fica em análise e não pode ser usado. > **Modelo com imagem no cabeçalho:** Em **Ajustes**, troque o cabeçalho de **Texto** para **Imagem** e envie um JPG ou PNG de até 5 MB. Essa imagem é a **amostra que a Meta analisa** junto com o texto — a imagem que cada lead recebe você escolhe na hora do disparo, em [Campanhas](https://attendto.com.br/manual/campanhas), que pede o arquivo antes de confirmar. Pelo Inbox esse modelo ainda não sai: a conversa não anexa o arquivo do cabeçalho, e a tela avisa. > **Toda mensagem por modelo é cobrada:** Diferente da resposta dentro das 24 horas, que hoje não tem taxa de WhatsApp, o modelo tem preço por entrega. Numa campanha de 500 pessoas isso é uma conta de verdade — e a tela diz quanto e **quem cobra** antes de você confirmar. A partir de 1º de outubro de 2026 a Meta passa a cobrar também as mensagens dentro da janela de 24 horas. Ver [Saldo & Recargas](https://attendto.com.br/manual/saldo-e-recargas). > **Não escreva modelo para o que a janela cobre:** Se o lead falou com você hoje, responda normalmente: não tem custo e chega igual. Modelo é para quem sumiu. #### Onde eles são usados - **No [Inbox](https://attendto.com.br/manual/inbox)**, quando a janela fechou. A tela oferece os aprovados e você preenche as variáveis na hora. - **Em [Campanhas](https://attendto.com.br/manual/campanhas)**, para falar com muita gente de uma vez. - **Nas sequências automáticas**, quando um lead some e o painel volta a chamar sozinho. #### Quando o modelo é recusado, ou para de funcionar - **Recusado logo na primeira análise**: Quase sempre é promessa, urgência falsa ou texto que parece propaganda pura. Reescreva como você escreveria para um cliente que já te conhece, tire o ponto de exclamação e mande de novo — não há limite de tentativas. - **Aprovado ontem, recusado hoje**: Modelo aprovado pode perder a aprovação depois, por qualidade ou por reclamação de quem recebeu. Quando isso acontece, a campanha e a cadência que usam aquele modelo **falham no envio** até você escolher outro. Vale conferir a lista antes de um disparo grande. - **A cadência avisa que o modelo tem variáveis demais**: Uma sequência automática só sabe preencher a primeira variável (o nome). Modelo com duas ou mais só serve para campanha, onde você preenche o resto na hora. - **Está demorando para aprovar**: A análise não é nossa e não tem prazo garantido. Faça isso com folga: pedir aprovação na véspera de uma campanha é a receita para não disparar. > **Uma boa base de modelos é assim:** Poucos, aprovados, e cada um resolvendo um momento diferente: retomar quem sumiu, confirmar um horário, avisar de uma novidade. Modelo demais só faz você perder tempo escolhendo — e cada um deles precisa continuar aprovado para servir de alguma coisa. No painel: Abrir Modelos de mensagem. Como as pessoas procuram: criar template whatsapp; modelo de mensagem whatsapp; aprovação de template meta; template recusado pela meta; categoria marketing ou utilidade; mensagem fora da janela de 24 horas; template com imagem; botões no template whatsapp; variáveis no template; apagar template whatsapp. ## Campanhas de WhatsApp: enviar modelo aprovado para um público da base, ver o custo antes e acompanhar a entrega URL: https://attendto.com.br/manual/campanhas Menu: Inteligência > Campanhas Campanhas é a área do painel que envia um modelo de mensagem aprovado pela Meta para um público da sua base, mostra quantos contatos vão receber e o custo estimado antes do envio, e acompanha entregas, leituras, respostas e falhas. Quando aparece: Precisa do WhatsApp conectado em Conexões e de pelo menos um modelo de mensagem aprovado. O custo estimado só aparece quando é a plataforma que cobra o envio; quando o WhatsApp é da sua empresa, a tela avisa que a Meta cobra direto no seu cartão. ### Quem pode usar - Dono: Cria, agenda, envia, cancela e retoma campanhas, tira números das próximas campanhas e devolve contatos na tela Fora das campanhas. - Admin: Cria, agenda, envia, cancela e retoma campanhas, tira números das próximas campanhas e devolve contatos na tela Fora das campanhas. - Atendente: Não vê o item no menu nem na busca do Ctrl K: campanhas gastam saldo e falam com a base inteira, então são de dono e admin. Pelo endereço direto a lista não carrega e a tela mostra o aviso de que não foi possível carregar as campanhas. ### Telas #### Campanhas A tela Campanhas serve para criar uma campanha de WhatsApp em três passos (público, modelo e revisão), ver a lista das campanhas com os números de cada uma e abrir o relatório para acompanhar, cancelar ou retomar o envio. Endereço no painel: `/app/campanhas` ![Captura da tela Campanhas. A tela Campanhas serve para criar uma campanha de WhatsApp em três passos (público, modelo e revisão), ver a lista das campanhas com os números de cada uma e abrir o relatório para acompanhar, cancelar ou retomar o envio.](https://attendto.com.br/prints-do-manual/campanhas--campanhas.png) A tela Campanhas na conta de demonstração, com dados fictícios e os valores desfocados. ##### Cabeçalho A explicação curta da tela e os dois atalhos. Botões e ações: - **Fora das campanhas**: Abre a lista de quem não recebe campanha, e por quê. - **Nova campanha**: Abre o assistente Nova campanha, no passo 1 de 3. Também aparece: - Frase fixa: o modelo aprovado vai para um público da base, as respostas caem no Inbox e a IA assume a conversa. ##### Aviso de guard-rail diário Faixa que aparece só quando o teto diário de mensagens de campanha foi atingido e ainda há fila. Também aparece: - Diz a hora em que o teto foi atingido e a hora em que a fila retoma sozinha. O teto protege o número de bloqueio na Meta; nada precisa ser feito. ##### Lista de campanhas Um cartão por campanha; clicar abre o relatório. Botões e ações: - **‹nome da campanha›**: Clicar no cartão abre o relatório da campanha. Também aparece: - Nome e selo de status: Rascunho, Agendada, Enviando, Concluída, Falhou ou Cancelada. - Linha com o modelo usado, o número de destinatários e a data de criação; na agendada, "agendada para ‹data e hora›"; com mais de um número de WhatsApp, "enviada por ‹número›". - O público descrito em português (por exemplo, a banda, o canal ou o grupo de compra escolhido). - Em telas largas, os números Enviadas, Entregues e Responderam. ##### Nova campanha · passo 1 de 3 — público Nome da campanha, de onde vêm os contatos, histórico de campanha, tamanho da leva e o resumo de quem entra. Campos e filtros: - **Nome da campanha** (obrigatório): Como a campanha aparece na lista. Exemplo da tela: "Retomada de clientes inativos". - **Canal de entrada**: Filtra pelo canal por onde o contato entrou; cada opção mostra a contagem. - **Banda BANT**: Filtra pela temperatura: Quente, Morno, Frio ou Sem score. - **Status**: Filtra pelo status do lead (Novo, Em conversa, Qualificado e outros). - **Etiqueta**: Filtra pelas etiquetas usadas na base. - **Atividade da conversa**: "Esperando nossa resposta" ou "Parados há ‹n›d ou mais", com os dias da regra de reengajamento da conta. - **nos últimos**: Aparece com Não receberam ou Já receberam: a janela em dias (de 1 a 365) para olhar o histórico de campanhas. - **Quantos contatos nesta leva**: Com "Enviar só para os primeiros" marcado, quantos contatos entram nesta leva, do mais recente para o mais antigo. Botões e ações: - **Filtrar contatos**: Monta o público com os filtros da Base de contatos. - **Por histórico de compra**: Monta o público por um dos oito grupos de compra (RFV), como Campeões e Em risco. Grupo sem ninguém fica apagado. - **Importar pedidos no Monitor de Sucesso**: Aparece quando a conta ainda não tem pedidos: os grupos de compra ficam zerados e o link leva ao Monitor de sucesso. - **Tanto faz**: Não filtra pelo histórico de campanhas. - **Não receberam**: Deixa só quem não recebeu campanha nos últimos N dias. - **Já receberam**: Deixa só quem já recebeu campanha nos últimos N dias. - **Enviar só para os primeiros**: Liga o limite da leva; desmarcado, vai para o público inteiro. - **Ver quem vai receber**: Abre a lista nominal, com nome e telefone, na ordem de envio (vira "Esconder a lista"). - **Continuar**: Vai ao passo 2. Fica travado sem nome, sem grupo escolhido ou com ninguém apto a receber; a dica diz qual é o motivo. Também aparece: - Dica "o que conta como recebida": envio entregue, lido ou respondido conta; envio que falhou não conta, e a pessoa volta para a fila. - Resumo do público: "‹n› contatos vão receber" e, quando a plataforma cobra, o custo estimado (ou "o custo aparece quando você escolher o modelo"). - Quando a conta é do próprio cliente, o resumo avisa que a Meta cobra cada modelo entregue direto no cartão da empresa. - Aviso de saldo quando o saldo não cobre todos os contatos: quantos cabem, quanto falta e o link para Carteira. - "Esta é uma leva de ‹n› dos ‹n› que podem receber" quando o limite deixa gente para depois. - Quem ficou de fora e por quê: pediram para não receber, marcados para não receber campanha, sem telefone, sem consentimento nem base legal, em atendimento humano agora, em canal sem modelo de mensagem ou com telefone que não dá para discar. ##### Nova campanha · passo 2 de 3 — modelo O número de envio, o modelo aprovado, o arquivo do cabeçalho e as variáveis. Campos e filtros: - **Por qual número enviar?**: Aparece com mais de um número de WhatsApp (ou com número em uso também no celular). Escolha antes do modelo: os modelos aprovados são de cada número. "Conta padrão do canal" usa o número padrão. - **Variáveis do modelo**: Para cada variável do modelo ({{1}}, {{2}}…), escolha o que entra: Primeiro nome, Nome completo ou Empresa. Botões e ações: - **Modelo aprovado**: Lista dos modelos aprovados do número; clicar escolhe. Modelo que pede arquivo no cabeçalho mostra o selo Imagem, Vídeo ou Documento; o de Localização aparece como indisponível. - **Escolher ‹imagem/vídeo/documento›**: Abre o seletor de arquivo para o cabeçalho do modelo. A tela mostra os tipos e o tamanho máximo aceitos antes de você escolher. - **Trocar**: Abre a confirmação "Trocar o arquivo?" e depois o seletor; o arquivo atual fica até o novo ser lido. - **Remover**: Abre a confirmação "Remover o arquivo?": sem arquivo, um modelo de mídia não pode ser enviado. - **Trocar arquivo**: Confirma a troca do arquivo. - **Crie um modelo**: Aparece quando o número não tem modelo aprovado e leva a Modelos de mensagem. - **Voltar**: Volta ao passo 1 sem perder o que foi escolhido. - **Continuar**: Vai ao passo 3. Fica travado sem modelo escolhido, com modelo de cabeçalho que a campanha não sabe montar ou sem o arquivo que o modelo pede. Também aparece: - Aviso do número em uso também no celular: a conversa pode ser continuada por você no aparelho, e enquanto isso a IA fica de fora; quando medido, diz quanto tempo a leva deve levar. - Sem WhatsApp conectado: "Conecte o WhatsApp em Conexões para listar seus templates aprovados." - Se a lista de modelos não carregar, aparece "Não foi possível carregar os seus modelos" com o botão Tentar de novo. ##### Nova campanha · passo 3 de 3 — revisão e envio A última conferência antes de gastar. Campos e filtros: - **Agendar para (opcional)**: Data e hora para a campanha sair sozinha. Em branco, o envio é imediato. Botões e ações: - **Voltar**: Volta ao passo 2. - **Agendar**: Aparece quando há data preenchida: cria a campanha como agendada. - **Disparar para ‹n›**: Cria e envia a campanha agora para os ‹n› contatos aptos. Não tem desfazer. Também aparece: - Cartão com o nome, o modelo, o público em português, a prévia do arquivo do cabeçalho e o texto com as variáveis no lugar. - O resumo do público de novo, colado ao botão: quantos recebem, o custo estimado e os avisos de saldo. - Quando a plataforma cobra, o preço por mensagem entregue aparece embaixo da data. ##### Relatório da campanha Abre ao clicar numa campanha da lista. Campos e filtros: - **Enviadas**: Mensagens enviadas. - **Entregues**: Mensagens que chegaram ao aparelho. - **Lidas**: Mensagens lidas. - **Responderam**: Contatos que responderam. - **Falhas**: Envios recusados. Botões e ações: - **Retomar envio**: Aparece na campanha que falhou: continua de onde parou, sem reenviar para quem já recebeu. - **Cancelar campanha**: Aparece em campanha agendada, enviando ou rascunho e interrompe o envio. - **Não enviar mais para estes ‹n›**: Abre a confirmação para tirar os números que falharam das próximas campanhas. Com um número só, o botão diz "Não enviar mais para este número". - **Tirar das campanhas**: Confirma: os contatos ficam fora de toda campanha a partir de agora, com o motivo gravado. Continuam na base e no Inbox. - **Ver a lista Fora das campanhas**: Aparece quando todos os que falharam já estão fora e leva à tela Fora das campanhas. Também aparece: - Taxa de entrega, taxa de resposta, o alvo e quantos estão "Ainda na fila". - Data e hora do agendamento, o público e o arquivo que foi no cabeçalho. - Lista nominal de quem falhou, com telefone e motivo; quem já está fora aparece com "já está fora". - Na campanha que parou, a frase diz por quê: o saldo acabou (ou não cobria nem o primeiro contato), o WhatsApp está desconectado ou o arquivo do cabeçalho não subiu. ##### Estados da tela - Carregando: Uma faixa cinza no lugar da lista. - Sem nada ainda: "Nenhuma campanha ainda", com o convite para criar a primeira campanha de reengajamento ou novidade em 3 passos. - Se der erro: "Não foi possível carregar as suas campanhas", com o pedido para não criar outra antes de conseguir ver a lista, e o botão Tentar de novo. - Saldo não cobre o público: Aviso antes do envio com quantos contatos cabem no saldo e quanto falta, com o link para Carteira. - Teto diário atingido: Faixa de guard-rail com a hora em que a fila retoma sozinha. - Campanha falhou: O selo Falhou, o motivo da parada e o botão Retomar envio. #### Fora das campanhas A tela Fora das campanhas serve para ver quem não recebe campanha, reengajamento nem cadência, com o motivo de cada um, e devolver às campanhas os números que você mesmo tirou. Endereço no painel: `/app/campanhas/fora` ![Captura da tela Fora das campanhas. A tela Fora das campanhas serve para ver quem não recebe campanha, reengajamento nem cadência, com o motivo de cada um, e devolver às campanhas os números que você mesmo tirou.](https://attendto.com.br/prints-do-manual/campanhas--fora-das-campanhas.png) A tela Fora das campanhas na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Pelo botão Fora das campanhas no topo de Campanhas, ou pelo link Ver a lista Fora das campanhas no relatório de uma campanha. ##### Topo Botões e ações: - **Voltar para as campanhas**: Volta para a lista de campanhas. Também aparece: - Explicação fixa: estar fora não silencia a IA nem o atendente; a conversa no Inbox continua normal, e o público de uma campanha já desconta esses contatos. ##### Busca Campos e filtros: - **Buscar por nome ou telefone**: Aparece quando a lista tem seis contatos ou mais e filtra pelos dois campos. ##### Entrega falhou Contatos marcados por você depois de uma falha de entrega; dá para desfazer. Botões e ações: - **Voltar a receber**: Tira a marca e o contato volta a entrar nas próximas campanhas. Também aparece: - Cada linha com nome, telefone e o motivo, com a campanha e a data em que a marca nasceu. ##### Pediram para sair Recusa do próprio contato (LGPD). Só leitura: não se desfaz por aqui. Também aparece: - Cada linha com nome, telefone e o motivo. ##### Estados da tela - Carregando: Uma faixa cinza enquanto a lista carrega. - Sem nada ainda: "Ninguém está fora das campanhas", explicando que o relatório de uma campanha oferece o botão para tirar números que falharam. - Se der erro: "Não foi possível carregar a lista", com o aviso de que as marcas continuam valendo no envio, e o botão Tentar de novo. - Busca sem resultado: "Nenhum contato com ‹texto›." ### Passo a passo #### Como criar e enviar uma campanha de WhatsApp 1. Abra **Campanhas** e clique em **Nova campanha**. 2. Preencha **Nome da campanha** e monte o público em **Filtrar contatos** ou **Por histórico de compra**. 3. Confira o resumo de quantos contatos vão receber e clique em **Continuar**. 4. Escolha o **Modelo aprovado**, o arquivo do cabeçalho se o modelo pedir, e o que entra em cada variável. Clique em **Continuar**. 5. Revise a prévia e o custo estimado mostrado na tela, e clique em **Disparar para ‹n›**. #### Como agendar uma campanha 1. Monte a campanha até o passo 3 de 3. 2. Preencha **Agendar para (opcional)** com a data e a hora. 3. Clique em **Agendar**. A campanha aparece na lista como **Agendada**, com a data e hora do envio. #### Como mandar a campanha em levas menores 1. No passo 1, marque **Enviar só para os primeiros** e digite quantos contatos entram. 2. Envie a primeira leva. 3. Na próxima, crie outra campanha com o mesmo público e escolha **Não receberam** em Histórico de campanha. #### Como retomar uma campanha que parou 1. Resolva a causa mostrada no relatório (recarregar o saldo, reconectar o WhatsApp ou trocar o arquivo). 2. Abra a campanha na lista. 3. Clique em **Retomar envio**. Quem já recebeu não recebe de novo. #### Como tirar números que falharam das próximas campanhas 1. Abra o relatório da campanha. 2. No bloco dos números que falharam, clique em **Não enviar mais para estes ‹n›**. 3. Confirme em **Tirar das campanhas**. #### Como devolver um contato às campanhas 1. Em **Campanhas**, clique em **Fora das campanhas**. 2. No grupo **Entrega falhou**, encontre o contato. 3. Clique em **Voltar a receber**. ### Perguntas frequentes #### Onde vejo quanto a campanha vai custar antes de enviar? No resumo do público, nos passos 1 e 3: a tela mostra quantos contatos vão receber e o custo estimado, que depende da categoria do modelo escolhido. Quando o WhatsApp é da sua empresa, a tela avisa que a Meta cobra direto no seu cartão. #### Por que o campo Por qual número enviar? não aparece? Ele só aparece quando a conta tem mais de um número de WhatsApp ativo ou um número em uso também no celular. Com um número só, a campanha sai pela conta padrão. #### Quais dados posso colocar nas variáveis do modelo? Cada variável recebe Primeiro nome, Nome completo ou Empresa do contato. #### Posso cancelar uma campanha agendada? Sim. Abra a campanha na lista e clique em Cancelar campanha. O botão aparece enquanto ela está agendada, enviando ou em rascunho. #### Estar Fora das campanhas impede o atendimento no Inbox? Não. A marca só tira o contato de campanhas, reengajamento e cadências; a conversa, a IA e o atendente seguem normalmente. #### Posso devolver às campanhas quem pediu para sair? Não por esta tela. O grupo Pediram para sair é a recusa do próprio contato (LGPD) e aparece só para leitura. #### Por que o atendente não consegue ver as campanhas? Campanhas gastam saldo e falam com a base inteira, então ficam com dono e admin. O item some do menu e da busca do atendente. ### Guia: Campanhas Mandar a mesma mensagem para muita gente de uma vez: quem recebe, quanto custa e como não gastar duas vezes com a mesma pessoa. Campanha é falar com muita gente ao mesmo tempo: avisar da promoção, reativar quem sumiu, anunciar o serviço novo. Tudo com mensagem aprovada, porque quase ninguém dessa lista falou com você nas últimas 24 horas. > **Campanha gasta dinheiro de verdade:** Cada mensagem enviada é cobrada. Uma leva de 500 pessoas é uma conta de três dígitos. Por isso a tela mostra, antes de você confirmar, quanto custa **e quem cobra** — e por isso existe o limite de leva. #### Quem cobra a campanha Campanha é sempre mensagem de **marketing**, a categoria mais cara do WhatsApp. Quem emite essa cobrança é o dono da conta em que o seu número está: - **Você conectou o seu WhatsApp**: A Meta cobra cada mensagem direto no seu cartão, no valor dela. A plataforma **não cobra nada por cima** — o resumo do público diz isso em vez de mostrar um valor estimado, porque o valor não é nosso para estimar. Confira o gasto no Gerenciador da Meta. - **O número é hospedado por nós**: A fatura do WhatsApp vem para a plataforma e o valor sai do seu saldo, pelo preço da **categoria** do modelo — marketing, utilidade, autenticação e atendimento têm preços diferentes, e a tabela de cada um está em [Saldo & Recargas](https://attendto.com.br/manual/saldo-e-recargas). Aí sim a tela mostra **custo estimado** antes do disparo, e o botão só dispara depois que você confirma. Com mais de um número conectado, a resposta passa a depender de **por qual deles a leva sai** — cada número responde pela conta em que mora. É mais um motivo para conferir o campo **Por qual número enviar?** antes de disparar. Nos dois casos vale a mesma regra do WhatsApp: **responder alguém dentro das 24 horas depois da mensagem dele não tem taxa hoje** — por isso campanha custa e conversa de atendimento não. A partir de **1º de outubro de 2026** a Meta passa a cobrar também as mensagens dentro dessa janela; o valor brasileiro ainda não saiu. #### Montar uma campanha São três passos, na ordem em que as decisões acontecem: **quem recebe**, **o que eles recebem** e **conferir antes de gastar**. 1. **Dê um nome e escolha quem recebe**: O nome é para você reconhecer o disparo daqui a um mês. O público sai do mesmo vocabulário de filtros da [Base de contatos](https://attendto.com.br/manual/base-de-contatos): canal, temperatura, etiqueta, situação. Nada de lista paralela que significa outra coisa. 2. **Decida o tamanho da leva**: Não precisa mandar para todo mundo de uma vez. Marque **Enviar só para os primeiros** e teste em 20, veja a resposta, depois solte o resto. 3. **Escolha o número, se você tem mais de um**: **Por qual número enviar?** abre no passo 2, antes da lista de modelos. Deixando em **Conta padrão do canal**, a leva sai pela conta padrão de [Conexões](https://attendto.com.br/manual/conexoes). Com um número só, o campo nem aparece. 4. **Escolha o modelo e preencha as variáveis**: Só aparecem os já aprovados **daquele número** — por isso a escolha do número vem antes. Se o que você quer dizer não existe ainda, crie em [Modelos de mensagem](https://attendto.com.br/manual/modelos-de-mensagem) e volte quando estiver aprovado. 5. **Revise e dispare**: O último passo mostra a mensagem final, quantos vão receber e quanto custa. O botão diz o número: "Disparar para 50" não deixa dúvida sobre o que vai acontecer. #### Escolher o público Na tela: Passo de escolha do público de uma campanha, com filtros e a contagem de elegíveis. A contagem muda enquanto você mexe nos filtros, antes de qualquer envio. 1. **De onde vêm os contatos**: Ou você filtra a base — canal, temperatura, situação, etiqueta, os mesmos filtros da Base de contatos — ou parte do histórico de compra. Se já sabe montar a lista lá, já sabe montar o público aqui. 2. **Quem já recebeu campanha**: **Não receberam** é o filtro que mais economiza dinheiro: ele impede você de pagar duas vezes para falar com a mesma pessoa na mesma semana. 3. **Tamanho da leva**: O teto de quantos recebem agora. É o freio de mão: teste o texto em 20 antes de gastar com 800. 4. **A conta antes do gasto**: Quantos vão receber, quanto vai custar e quem ficou de fora com o motivo em português. **Ver quem vai receber** abre a lista nominal antes de você confirmar. Existe um filtro que economiza mais dinheiro que todos os outros juntos: **quem ainda não recebeu campanha nos últimos 30 dias**. Ele é o que impede você de pagar duas vezes para falar com a mesma pessoa na mesma semana. > **Quem está sendo atendido agora não recebe promoção:** Contato com uma conversa em atendimento humano — alguém do time assumiu, alguém está esperando na fila do transbordo, ou você respondeu por fora do painel há pouco — sai do público com o motivo **em atendimento humano agora**. É de propósito: promoção no meio de uma negociação em andamento estraga a conversa, e você paga por ela. A conta é conferida **duas vezes**, ao montar o público e outra vez no instante do envio, porque numa leva grande passam minutos entre uma coisa e outra e alguém pode entrar na conversa nesse meio-tempo. > **Envio que falhou volta para a fila:** Se a mensagem não chegou, aquela pessoa continua contando como "não recebeu" e entra na próxima leva. É o contrário do que a maioria dos sistemas faz, e é de propósito: quem não recebeu é exatamente quem precisa ser chamado de novo. Quando a falha é do **número** — sem WhatsApp, telefone que não disca — use o botão do relatório para tirá-lo das próximas (seção abaixo). #### Números que falham sempre: Fora das campanhas O relatório de cada campanha lista **quem falhou, com nome e motivo** — número sem WhatsApp, telefone que não dá para discar, envio que não saiu. O botão **Não enviar mais para estes** tira esses contatos de toda campanha e disparo futuro, com o motivo gravado. Importa no bolso: a entrega que o WhatsApp recusa **já foi debitada**, e um número morto voltando a cada leva é dinheiro repetido no mesmo lugar. - **O contato não é apagado.** Ele continua na sua base, a conversa continua no Inbox e a IA responde normalmente se ele escrever — só campanhas, disparos, reengajamento e cadências param. - **Dá para desfazer um a um.** A tela **Fora das campanhas** (botão no topo de Campanhas) lista todos, com o motivo e a data — quem trocou de número volta com um clique em **Voltar a receber**, e a ficha do contato tem o mesmo desfazer. - **Quem pediu para sair aparece lá também**, em grupo separado e sem desfazer: recusa do contato (LGPD) não se desfaz por uma tela de campanhas. - Ao montar a próxima campanha, o público já desconta esses contatos e diz o motivo: **marcados para não receber campanha**. #### Mandar imagem, vídeo ou arquivo Dá, e é o que faz a diferença numa promoção. Mas não é um anexo que você põe em qualquer mensagem: **quem decide é o modelo**. Todo modelo aprovado tem um tipo de topo — texto, imagem, vídeo ou documento — escolhido lá na criação dele, e o WhatsApp não deixa mudar isso na hora do envio. - Modelo de topo **de texto**: a tela nem pergunta por arquivo, porque não existe onde encaixá-lo. - Modelo de topo **de mídia**: aparece a etiqueta **Imagem**, **Vídeo** ou **Documento** ao lado do nome, e a campanha **só sai** depois que você escolhe o arquivo. Na tela: Passo de escolha do modelo, com um modelo marcado como Imagem e o campo para escolher o arquivo do cabeçalho. O passo 2, de cima para baixo: por qual número sai, qual modelo, e o arquivo que o modelo pede. 1. **Por qual número enviar**: Aparece quando você tem mais de um número de WhatsApp conectado. Os modelos aprovados são **de cada número**, então trocar aqui limpa o modelo já escolhido — de propósito, para a campanha não sair com um texto que aquele número não tem. 2. **A etiqueta que diz o que o modelo pede**: **Imagem**, **Vídeo** ou **Documento** ao lado do nome. Modelo sem etiqueta é só texto — e não aceita arquivo nenhum. 3. **Escolher o arquivo**: Um arquivo para a campanha inteira: a mesma imagem vai para todo mundo da leva. Depois de escolher, dá para **trocar** ou **remover** — os dois pedem confirmação, nada some num clique errado. 4. **O que cabe, antes do erro**: Imagem: JPG ou PNG até 5 MB. Vídeo: MP4 ou 3GP até 16 MB. Documento: PDF até 16 MB. Se o arquivo não servir, a mensagem diz o motivo e o que fazer. No **passo 3 você vê a mensagem montada**: a sua imagem em cima, o texto embaixo com as variáveis no lugar. É exatamente o que vai chegar no celular do contato — confira ali antes de disparar, porque depois não tem desfazer. > **Mídia não muda o preço:** Uma campanha com imagem custa o mesmo que uma sem: o WhatsApp cobra pela **mensagem entregue**, não pelo peso do arquivo. Quem cobra também não muda — continua valendo a regra de quem cobra a campanha. Se o modelo que você quer usar ainda é só texto, não dá para "adicionar" imagem nele. Crie um modelo novo com topo de imagem em [Modelos de mensagem](https://attendto.com.br/manual/modelos-de-mensagem) e espere a aprovação da Meta — ele aparece aqui depois, já com a etiqueta. #### Saldo: o aviso antes e a parada no meio Isto vale só para quem tem o número hospedado por nós — é o único caso em que a campanha gasta o saldo daqui. Quem conectou o próprio WhatsApp nunca vê nada disto: a Meta cobra o cartão dele, e o saldo desta conta não paga a leva. **Antes de disparar**, o resumo do público compara o custo estimado com o que você tem. Se não cobrir, ele diz com número: quanto você tem, **quantos contatos cabem** e quanto falta. O botão continua disponível — a decisão é sua, e mandar o que cabe é uma escolha legítima. Se o saldo não pagar nem o primeiro contato, o aviso diz isso com todas as letras: nada sai, e a leva para logo no começo. No **primeiro passo**, quando o modelo ainda não foi escolhido, a tela mostra só quantos contatos entram — o custo aparece depois. Não é omissão: o preço vem da **categoria** do modelo, e uma leva de marketing custa várias vezes uma de utilidade. Um número antes da escolha seria um número errado justamente na tela em que você decide o tamanho da leva. **Se o saldo acabar no meio**, a leva **para**. Ela não continua entregando sem cobrar e não fecha como concluída: fica marcada como interrompida, com o motivo escrito no relatório. Quem já recebeu, recebeu; os outros continuam na fila, intactos. > **Recarregou? É só retomar:** Abra a campanha parada e clique em **Retomar envio**. Ela continua exatamente de onde ficou — quem já recebeu **não recebe de novo** e não é cobrado de novo. O relatório também mostra **quantos ainda estão na fila**, para o número de enviadas nunca ficar sem explicação. #### Trabalhar em levas Uma lista de 300 contatos não precisa virar um disparo de 300. Mande 50, leia as respostas, ajuste o texto, mande os próximos 50. A cada nova campanha, o filtro **não receberam** já exclui sozinho quem foi da leva anterior. A ordem da leva é a mesma da Base de contatos, do mais novo para o mais antigo. E antes de confirmar você vê a lista com nome e sobrenome de quem vai receber. #### O teto diário: por que a fila às vezes espera Existe um guard-rail de **250 mensagens de campanha por dia** na conta — e tentativa **recusada também conta**, porque para a reputação do seu número na Meta a tentativa vale. Quando o teto bate, a tela avisa ("Guard-rail acionado") com a hora em que ele foi atingido, e a fila **retoma sozinha às 21h** (meia-noite no relógio universal, que é a régua do WhatsApp). Nada precisa ser feito, e ninguém fica de fora: quem não saiu hoje sai amanhã, na ordem. > **O teto é o seguro do seu número:** Ele existe para o WhatsApp nunca ler a sua conta como disparadora de spam — número novo, em especial, precisa crescer devagar. Se uma leva tem muita recusa (lista importada costuma ter), o teto ainda trabalha a seu favor: dá tempo de tirar os números ruins pelas **Fora das campanhas** antes da próxima leva. #### Depois do disparo - A campanha mostra quantas foram entregues, quantas foram lidas e **quantas geraram resposta**. A última é a única que interessa. - Quem responde volta a ser conversa normal no [Inbox](https://attendto.com.br/manual/inbox), com a IA cuidando e a janela de 24 horas aberta de novo. - Quem pede para sair é descadastrado na hora e não entra em campanha nenhuma daqui para frente. - Na lista de campanhas, quem tem mais de um número conectado vê também **enviada por** e o apelido da conta — dá para saber por onde cada leva saiu meses depois. > **Número sinalizado pausa só as campanhas dele:** Se o WhatsApp sinalizar queda de qualidade de um dos seus números, as campanhas que saem por ele são **pausadas** — e as dos outros números seguem rodando, porque não têm nada com o problema. A retomada é sua: quando o número se recuperar, abra a campanha e clique em **Retomar envio**. > **O melhor teste é o mais barato:** Dois modelos diferentes, 20 pessoas cada, mesmo dia. O que tiver mais resposta é o que vai para os outros 400. Isso custa o preço de 40 mensagens e economiza o de 400. #### Quando o disparo não sai como planejado - **O público veio muito menor do que a base**: É consentimento, quase sempre. A tela diz na cara quantos pediram para não receber e ficaram de fora. A lista **Sem consentimento**, em [Base de contatos](https://attendto.com.br/manual/base-de-contatos), mostra quem são. - **Alguém não recebeu, e não foi erro nenhum**: Procure o motivo **em atendimento humano agora**: aquela conversa tinha gente dentro na hora do envio. A campanha fecha normalmente, esse contato **não é cobrado**, e o registro fica na jornada dele como **Campanha não enviada**. Chame de novo na próxima leva, quando a conversa já tiver terminado. - **O botão de continuar não habilita**: Falta nome, falta modelo aprovado, falta o arquivo de um modelo que pede mídia, ou o público ficou em zero. Passe o mouse no botão travado: ele diz qual dos casos é o seu. Modelo que perdeu a aprovação some da lista — confira em [Modelos de mensagem](https://attendto.com.br/manual/modelos-de-mensagem). - **O arquivo foi recusado**: Ou o tipo não serve para aquele topo (imagem aceita JPG e PNG; vídeo, MP4 e 3GP; documento, PDF), ou passou do tamanho. A mensagem diz qual dos dois é, e o que fazer: converter ou comprimir. - **Parte das mensagens falhou**: Número inválido ou aparelho que não recebe. Quem falhou continua contando como quem **não recebeu**, então entra naturalmente na próxima leva — não é preciso montar lista de repescagem à mão. - **O custo estimado assustou**: É para isso que ele aparece antes. Reduza o tamanho da leva, aperte o filtro, ou use **Não receberam** para não pagar de novo por quem já foi chamado esta semana. - **A campanha parou no meio**: Abra o relatório dela: o motivo está escrito lá. Se for saldo, recarregue em [Saldo & Recargas](https://attendto.com.br/manual/saldo-e-recargas) e clique em **Retomar envio** — quem já recebeu não recebe de novo. Se for WhatsApp desconectado ou arquivo que não subiu, o texto diz qual dos dois. - **Não aparece custo estimado nenhum**: Então o seu número está na sua própria conta do WhatsApp: a Meta cobra você direto e a plataforma não tem valor para estimar. A leva continua custando — só que na fatura do WhatsApp, não no saldo daqui. Ver [Saldo & Recargas](https://attendto.com.br/manual/saldo-e-recargas). > **Uma campanha bem montada é assim:** Público que você consegue explicar numa frase, leva pequena na primeira vez, custo conferido antes de confirmar, e o filtro de histórico ligado. Dispare a primeira leva, veja o que voltou, e só então mande o resto. No painel: Abrir Campanhas. Como as pessoas procuram: campanha de whatsapp; enviar mensagem para lista de clientes; enviar modelo aprovado; agendar campanha whatsapp; custo da campanha whatsapp; reengajar clientes inativos; campanha por segmento rfv; relatório de campanha; retomar campanha; números que falharam; fora das campanhas; campanha com imagem no whatsapp. ## Saldo & Recargas: como recarregar por Pix, boleto ou cartão, ver o extrato e o plano URL: https://attendto.com.br/manual/saldo-e-recargas Menu: Conta > Saldo & Recargas Saldo & Recargas é a tela de cobrança do painel: mostra quanto a conta tem para a IA gastar, recebe recargas por Pix, boleto ou cartão, mostra o plano, o consumo do mês, as notas fiscais e o extrato de cada débito. Quando aparece: Aparece para dono e administrador em toda conta. Em conta vendida por um parceiro com marca própria o item se chama **Plano & Recargas**: a tela fala da mensalidade com o parceiro, a recarga serve só para o que passar do incluído no mês, não há pagamento com cartão nem a lista de Faturas. Em conta Enterprise com contrato, o alto da tela troca o card do plano por Seu plano, Pagamentos e Contrato e documentos. ### Quem pode usar - Dono: Vê e usa tudo: recarrega, assina o plano, paga a fatura em aberto do Plano sob medida e é o único que vê **Cancelar assinatura** (ou o aviso de fidelidade do contrato Enterprise). - Admin: Recarrega, assina o plano, baixa notas fiscais, exporta o extrato e lê o contrato. Não vê **Cancelar assinatura** nem a faixa **Fatura em aberto** do Plano sob medida. - Atendente: Não vê o item no menu; abrir o endereço direto leva de volta ao Painel. Continua vendo o cartão de créditos e saldo no pé do menu, mas os botões dele levam a esta tela, que não abre para o papel. ### Telas #### Saldo & Recargas A tela Saldo & Recargas serve para colocar crédito na conta, acompanhar o que a IA consome e guardar os comprovantes: plano, consumo do mês, tabela de preços da conta, notas fiscais e extrato. Endereço no painel: `/app/carteira` ![Captura da tela Saldo & Recargas. A tela Saldo & Recargas serve para colocar crédito na conta, acompanhar o que a IA consome e guardar os comprovantes: plano, consumo do mês, tabela de preços da conta, notas fiscais e extrato.](https://attendto.com.br/prints-do-manual/saldo-e-recargas--saldo-e-recargas.png) A tela Saldo & Recargas na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Pelo item do menu, pelo botão **Recarregar** do cartão de créditos e saldo no pé do menu, ou pelo botão **Recarregar agora** da tela Agente pausado. Em conta revendida o título da tela é **Plano & Recargas**. ##### Cartão de créditos e saldo (pé do menu, em qualquer tela) O resumo do saldo que fica sempre à vista no menu lateral e atualiza sozinho a cada mensagem; clicar nele abre os detalhes. Botões e ações: - **Recarregar**: Leva à tela Saldo & Recargas para gerar uma recarga. - **Recarregar e religar a IA**: Aparece no lugar de Recarregar quando créditos e saldo zeraram e a IA parou; leva à recarga. - **Ajustar teto**: Aparece quando há teto de gasto configurado; abre Configurações na parte de IA, onde o teto é definido. - **Seu plano · mensalidade e uso do mês**: Só em conta revendida: leva à tela do plano e das recargas. - **Falar com especialista**: Aparece quando o Plano sob medida terminou ou a IA da conta vai ser desligada; abre o contato com o especialista no lugar da recarga. - **Ver carteira**: Aparece quando o cartão não conseguiu ler o saldo; abre esta tela. Também aparece: - **Créditos de IA**: o que resta da franquia do plano, com a selo **em uso** quando a IA está gastando dela, a barra do que já foi usado (com marca nos 80%), o percentual usado e a data em que renovam. Esgotados, aparece **Esgotados** e quando voltam. - **Saldo pré-pago**: o saldo das recargas, marcado **em uso** quando os créditos acabaram. - Na conta Enterprise: **Mensagens do ciclo** (usadas de incluídas) e **Saldo · SMS, e-mail e modelos**, com o selo **IA sem cobrança no ciclo** ou **IA própria · paga ao seu provedor**. - Faixa **IA parada desde ‹hora›** quando créditos e saldo zeraram: os leads chegam no Inbox, mas a IA não responde. - Avisos curtos conforme o estado: data em que os créditos acabam no ritmo atual, há quantos dias a IA usa o saldo, para quantos dias o saldo ainda dá. - Linha **Teto de gasto do dia** ou **Teto de gasto do mês** com o quanto já foi gasto e quando a IA volta se pausar no teto. - Menu recolhido: o cartão vira um anel com o percentual usado; passar o mouse mostra os números. No celular, com o menu fechado, um aviso pequeno sobe para o topo só quando há alerta. ##### Detalhes do saldo (ao clicar no cartão do menu) Painel ao lado do menu (no celular, uma folha que sobe) com o disponível, a projeção do ciclo e o consumo por tipo. Esc fecha. Botões e ações: - **Recarregar agora**: Leva à recarga; aparece assim quando a IA está parada (nos demais casos o botão diz Recarregar). - **Ver consumo**: Abre esta tela; na conta Enterprise abre a IA própria, onde fica o consumo do contrato. - **Ligar**: Aparece ao lado de **Recarga automática: desligada** e abre Configurações em Cobrança & alertas para ligá-la. - **Ajustar**: Aparece ao lado de **Recarga automática: ligada** e abre a mesma configuração para mudar valores. - **Fechar detalhes**: Fecha o painel (o mesmo que a tecla Esc). - **Tentar de novo**: Aparece quando a leitura falhou; busca os números outra vez. Também aparece: - Título **Créditos e saldo** (ou **Uso do ciclo** no Enterprise) com o ciclo e quantos dias faltam. - **Disponível para a IA**: créditos + saldo, numerados na ordem em que a IA gasta: 1 os créditos do plano, 2 o saldo. - **Projeção**: no ritmo recente, se os créditos sobram até a renovação ou em que dia acabam, com um gráfico do uso acumulado do ciclo e a linha do que o plano inclui. - **Teto de gasto**: quanto já foi gasto do teto do dia ou do mês, e se a IA está pausada por ele. - **Consumo do ciclo por tipo** (sem plano: **Consumo de ‹mês›**): Mensagens da IA, Leads qualificados, Áudio, Imagens lidas, Módulos, Outros itens e Estornos, com **Total líquido do ciclo** quando houve estorno. - Na conta Enterprise: **Mensagens incluídas** (quantas restam), a nota dos avisos por e-mail e do excedente, e **Saldo pré-pago** para SMS, e-mail e modelos. - Em conta revendida: **Dúvidas sobre o plano? Fale com ‹parceiro›.** ##### Avisos no alto da tela Faixas que só aparecem quando há algo a fazer. Botões e ações: - **Pagar** (Dono): Na faixa **Fatura em aberto** do Plano sob medida: a primeira fatura leva à ativação da conta; as seguintes abrem o pagamento em nova aba. - **Copiar**: Na faixa **Recarga automática aguardando pagamento**: copia o código Pix da recarga automática gerada. - **Ver estado pausado**: Na faixa **Saldo esgotado**: abre a tela Agente pausado. - **Falar com especialista**: Na faixa da transição ou do Plano sob medida encerrado: abre o contato com o especialista. Também aparece: - **Fatura em aberto · ‹tipo› · ‹valor›** com os itens e o vencimento (Plano sob medida, só para o dono). - **Saldo esgotado** — o agente pausa novas conversas. Recarregue para retomar. - Conta revendida: **Você chegou ao limite do seu mês** (recarregue ou espere o próximo ciclo) ou **Sua mensalidade ainda não está ativa** (a IA só atende depois do primeiro pagamento). - **O Plano sob medida foi encerrado.** A IA não responde mais; recarga e plano somem da tela. - Aviso da data em que a IA desliga nesta conta e o saldo de boas-vindas que sobrar é encerrado. ##### Recarregar saldo O formulário de recarga. O título muda: **Saldo pré-pago, sem assinatura** na conta comum, **Saldo para SMS, e-mail e modelos do WhatsApp** no Enterprise e **Crédito extra, quando você precisar** em conta revendida. Campos e filtros: - **Valor da recarga** (obrigatório): Quatro valores prontos em botões ou o valor digitado no campo **ou digite um valor (R$)**. Vale o que estiver no campo. - **Forma de pagamento** (obrigatório): Pix, Boleto ou Cartão. Em conta revendida só Pix e Boleto. Botões e ações: - **Pix**: Escolhe Pix; o botão de gerar passa a dizer Gerar Pix. - **Boleto**: Escolhe boleto bancário; o botão passa a dizer Gerar boleto. - **Cartão**: Escolhe cartão; o botão passa a dizer Gerar cartão. Não aparece em conta revendida. - **Gerar Pix**: Cria a cobrança Pix: mostra o QR Code e o código copia e cola. - **Gerar boleto**: Cria a cobrança e mostra **Abrir pagamento** para ver o boleto. - **Gerar cartão**: Cria a cobrança e mostra **Abrir pagamento** para pagar com cartão em nova aba. - **Copiar**: Copia o código Pix gerado. - **Abrir pagamento**: Abre a página de pagamento da cobrança em nova aba. Também aparece: - Depois de gerar: **Aguardando pagamento**, o valor da cobrança e o QR Code (no Pix). - O saldo entra sozinho quando o pagamento é confirmado; não há botão de confirmar. - Se o servidor recusar a recarga (por exemplo, conta que não recarrega mais), a frase do motivo aparece num aviso. ##### Saldo disponível O cartão colorido com o número grande do saldo. Botões e ações: - **Pré-visualizar estado sem saldo**: Abre a tela Agente pausado só para ver como ela é; não muda nada na conta. Também aparece: - **Saldo disponível** (em conta revendida, **Disponível para o atendimento**: o incluído no mês somado ao saldo pago). - Com plano: **Franquia do plano: ‹valor›**; em revenda: **‹valor› do incluído no mês · ‹valor› de saldo pago**. ##### Consumo do mês O que a IA consumiu desde o dia 1º, item a item, dos créditos do plano e do saldo, com os estornos e o total líquido. Também aparece: - Título **Consumo de ‹mês›** e o período **De ‹dia› até hoje, ‹dia›**. - Uma linha por item com quantidade × preço e o total; imagem lida pela IA marcada **Novo**. - Linhas **Estorno** com a descrição do que voltou, e **Total do mês** no rodapé. - Frase com as imagens que chegaram e não foram cobradas, e por quê. - Vazio: **Nenhum consumo neste mês ainda.** Erro: **Não foi possível carregar o consumo do mês**, com Tentar de novo. ##### Card do plano (conta comum) Mostra o plano mensal da conta e o que dá para fazer com ele em cada situação. Botões e ações: - **Abrir pagamento**: Com a assinatura aguardando confirmação, abre a página de pagamento da mensalidade. - **Cancelar assinatura** (Dono): Abre a confirmação de cancelamento. Só o dono vê; no contrato Enterprise com fidelidade, aparece o aviso de fidelidade no lugar dele. - **Verificar pagamento**: Com pagamento não identificado, consulta de novo a situação da assinatura. - **Assinar novamente**: Com a assinatura suspensa por falta de pagamento, inicia uma assinatura nova. - **Falar com especialista**: Quando o Plano sob medida terminou ou está terminando, leva ao especialista para uma proposta nova. Também aparece: - Sem plano: o preço do plano, a franquia de créditos renovada a cada ciclo, o benefício **Transbordos para atendimento humano ilimitados, sem custo por conversa**, o botão de assinar (abre o pagamento) e a frase **Ao assinar, você concorda com os Termos de Uso.** - **Aguardando confirmação do pagamento** depois de iniciar a assinatura. - Plano ativo: **Próxima fatura: ‹data›** e **Franquia restante: ‹valor›** (no Enterprise e no Plano sob medida, **Mensalidade do contrato: ‹valor›**). - Cancelado: **Ativo até ‹data›** — os benefícios seguem até o fim do período já pago. - **Pagamento não identificado** ou **Assinatura suspensa por falta de pagamento** (a franquia do plano é zerada). - Enterprise na fidelidade: **Seu contrato tem fidelidade até ‹data›**, a multa de quem encerra antes e com quem falar para encerrar. - Plano sob medida encerrado ou encerrando: o card diz até quando a conta segue e oferece Falar com especialista; não oferece outro plano. ##### Diálogo Cancelar o plano A confirmação que abre em **Cancelar assinatura**. O foco começa em Voltar, nunca no botão que cancela. Botões e ações: - **Voltar**: Fecha sem cancelar. - **Confirmar cancelamento** (Dono): Cancela. Dentro de 7 dias do primeiro pagamento, encerra na hora com devolução (o texto diz o que é devolvido); depois disso, o plano segue até o fim do período pago e não renova. Também aparece: - Título **Cancelar o plano ‹nome›?** e o texto do que acontece no seu caso (arrependimento de 7 dias ou fim no período pago). - Recusa do servidor (fidelidade do Enterprise, outro pedido em andamento) aparece em aviso com a frase dele. ##### Seu plano (conta revendida) Em conta vendida por um parceiro, o plano é a mensalidade com ele, na marca dele; a recarga fica logo abaixo para o que passar do incluído. Campos e filtros: - **CPF ou CNPJ de quem paga**: Só aparece quando a cobrança exige o documento; é pedido uma vez e sai na fatura. Botões e ações: - **Ativar minha mensalidade**: Inicia a mensalidade com o parceiro e mostra o pagamento. - **Abrir pagamento**: Abre a página de pagamento da mensalidade em nova aba. Também aparece: - **Sua mensalidade com a ‹parceiro›** e o valor por mês. - **Aguardando a confirmação do pagamento** e, com a mensalidade ativa, **Próxima cobrança: ‹data›**. - Cancelar ou mudar de plano é com o parceiro: a tela diz o nome dele. ##### Seu plano, Pagamentos e Contrato e documentos (Enterprise) Na conta Enterprise com as Condições do Plano Enterprise, três cartões substituem o card do plano. Botões e ações: - **Baixar PDF assinado**: Baixa as Condições assinadas com o relatório de assinaturas eletrônicas. Só aparece depois das duas assinaturas. - **Ler**: Abre os Termos de Uso e a Política de Privacidade em nova aba. Também aparece: - **Seu plano** (Enterprise com IA própria): Nível, Mensagens (por ciclo e excedente por mil), Fidelidade e Próxima fatura; selo **ativo desde ‹dia›** ou **aguardando ativação**. - **Pagamentos** (Do contrato Enterprise): implantação e mensalidades pagas, com a data. Vazio: **Nada pago ainda.** - **Contrato e documentos**: a linha **Condições do Plano Enterprise · ‹número›** com quem assinou e quando (ou para quem foi enviada e que aguarda assinatura), e **Termos de Uso e Política de Privacidade** com a data do aceite e a versão em vigor. - O mesmo PDF aparece em IA própria, na aba Segurança e dados. ##### Tabela de preços Cada evento que debita saldo, com o preço que vale na sua conta hoje (com a regra do seu plano aplicada). Também aparece: - Linhas: Lead qualificado Quente, Lead qualificado Morno, Mensagem processada, Mensagem no Instagram (com o canal liberado), Modelo entregue (WhatsApp), Minuto de voz / STT, Imagem lida pela IA, Transbordo p/ atendimento humano, Mensagem SMS, Mensagem de e-mail, Ajuste da qualificação ao seu negócio e o modelo de segmento gerado pela IA. - No lugar do preço podem aparecer **Cobrado pela Meta** (o seu número cobra direto na sua conta da Meta), **Pago ao seu provedor** (IA própria do cliente), **Incluído** (no contrato) ou **Sem tarifa hoje**. - Quando a plataforma cobra o modelo entregue, a linha abre por categoria: Marketing, Utilidade, Autenticação, Atendimento e **Ainda sem categoria**. - Com **Modo atendimento** ligado, as linhas de lead somem e a nota **Sua conta está no modo atendimento: lead quente e lead morno não são cobrados.** aparece. - Com dois ou mais números de WhatsApp, uma nota avisa que a linha do modelo vale para a conta padrão do canal. - Em conta revendida a tabela mostra só os preços da conta e pode estar carregando ou com erro (**Não foi possível carregar a tabela de preços agora**, com Tentar de novo). ##### Faturas A nota fiscal (NFS-e) de cada recarga e mensalidade, emitida automaticamente. Não aparece em conta revendida. Botões e ações: - **Baixar NF**: Baixa o PDF da nota fiscal emitida. Também aparece: - Uma linha por pagamento: o que foi pago, a data e o valor. - Situação: **Emitida**, **Processando**, **Falhou — vamos reemitir** ou **Cancelada**. Sem nota pronta, o lugar do botão mostra um traço. - Vazio: **Suas notas fiscais aparecem aqui após cada recarga ou mensalidade.** Erro: **Não foi possível carregar as suas faturas**, com Tentar de novo. ##### Extrato Cada entrada e cada débito, do mais recente para o mais antigo, com o saldo que ficou depois. Nada é editado nem apagado. Botões e ações: - **Exportar CSV**: Baixa o extrato inteiro em planilha (arquivo extrato-‹data›.csv). Também aparece: - Cada linha traz, da esquerda para a direita: o sinal (mais para entrada, menos para débito, ponto para linha sem custo), a descrição do que gerou a linha com data e hora, o valor (traço quando não há custo) e o saldo que ficou depois da operação. - Imagens que chegaram e não foram cobradas aparecem como **Imagem não lida: ‹motivo›**, com o nome do contato e **sem custo**. - Vazio: **Sem transações ainda.** Erro: **Não foi possível carregar o extrato** — a tela avisa que nenhum lançamento foi perdido. ##### Estados da tela - Carregando: Esqueletos no lugar do saldo, do plano, das faturas e do extrato. - Se der erro: Se o saldo não puder ser lido, o cartão do saldo dá lugar a **Não foi possível carregar o seu saldo**, explicando que isso não quer dizer conta zerada, com Tentar de novo. O aviso de saldo esgotado nunca aparece por erro de leitura. - Saldo e créditos zerados: Faixa Saldo esgotado com Ver estado pausado; a IA para de responder conversas novas. - Conta revendida: Título Plano & Recargas, card Seu plano da mensalidade com o parceiro, recarga sem cartão, sem Faturas. - Conta Enterprise com contrato: Seu plano, Pagamentos e Contrato e documentos no alto; a recarga paga só SMS, e-mail e modelos do WhatsApp. - Plano sob medida encerrado ou IA desligada pela transição: A recarga e o plano somem; o caminho é Falar com especialista. - Volta de um pagamento aprovado: Um aviso confirma o pagamento e diz que saldo ou plano atualizam em instantes. #### Agente pausado A tela Agente pausado serve para mostrar o que acontece quando o saldo acaba: a IA para de responder conversas novas, quantas conversas esperam a recarga e o atalho para recarregar. Endereço no painel: `/app/carteira/pausado` ![Captura da tela Agente pausado. A tela Agente pausado serve para mostrar o que acontece quando o saldo acaba: a IA para de responder conversas novas, quantas conversas esperam a recarga e o atalho para recarregar.](https://attendto.com.br/prints-do-manual/saldo-e-recargas--agente-pausado.png) A tela Agente pausado na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Pelo botão **Ver estado pausado** da faixa Saldo esgotado, ou por **Pré-visualizar estado sem saldo** no cartão do saldo, em Saldo & Recargas. Em conta revendida o título é **Atendimento em pausa**. Quem usa: Dono, Admin, Atendente. ##### Agente pausado — saldo esgotado O aviso principal, com o saldo atual e a garantia de que as conversas em andamento ficam salvas. Também aparece: - Texto: sem saldo, a IA para de responder novas conversas; o saldo atual aparece no meio da frase. - Com saldo positivo, a faixa **Pré-visualização — seu saldo está positivo e o agente segue ativo.** deixa claro que é só uma prévia. ##### Conversas aguardando recarga Quantas conversas estão paradas esperando o saldo voltar. Botões e ações: - **Recarregar agora**: Leva a Saldo & Recargas para gerar a recarga (para o atendente, o painel volta ao Painel). Também aparece: - O número de conversas no estado Aguardando recarga do Inbox. - Se a lista de conversas não puder ser lida, aparece um traço e **Não foi possível contar agora.** — nunca um zero falso. ##### Estados da tela - Se der erro: **Não foi possível conferir o seu saldo**: a tela não afirma que o saldo acabou e pede para conferir antes de recarregar, com Tentar de novo. ### Passo a passo #### Como recarregar o saldo por Pix 1. No menu, abra **Saldo & Recargas** (ou clique em **Recarregar** no cartão do pé do menu). 2. Em **Valor da recarga**, toque num dos valores prontos ou digite o valor no campo abaixo deles. 3. Em **Forma de pagamento**, escolha **Pix**. 4. Clique em **Gerar Pix**. 5. Leia o QR Code com o aplicativo do banco ou clique em **Copiar** e cole o código no Pix copia e cola. 6. Pago, o saldo entra sozinho no cartão do saldo, no menu e no **Extrato**. #### Como pagar a recarga com boleto ou cartão 1. Em **Saldo & Recargas**, escolha o valor em **Valor da recarga**. 2. Em **Forma de pagamento**, escolha **Boleto** ou **Cartão** (em conta revendida, só Pix e Boleto). 3. Clique em **Gerar boleto** ou **Gerar cartão**. 4. Clique em **Abrir pagamento** e conclua na aba que abrir. 5. O saldo entra quando o pagamento é confirmado; no boleto, isso depende da compensação bancária. #### Como assinar o plano mensal e ganhar créditos de IA 1. Em **Saldo & Recargas**, localize o card do plano, à direita. 2. Leia o preço, a franquia de créditos e o benefício do transbordo, e clique no botão de assinar. 3. Conclua o pagamento na página que abrir; o card mostra **Aguardando confirmação do pagamento** até a confirmação. 4. Ativo, o card passa a mostrar **Próxima fatura** e **Franquia restante**, e o cartão do menu mostra os **Créditos de IA**. #### Como cancelar a assinatura do plano 1. Entre como dono da conta (o botão não aparece para administrador). 2. Em **Saldo & Recargas**, no card do plano, clique em **Cancelar assinatura**. 3. Leia o texto: dentro de 7 dias do primeiro pagamento o plano encerra na hora com devolução; depois disso, segue até o fim do período pago. 4. Clique em **Confirmar cancelamento** (ou **Voltar** para desistir). 5. O card passa a mostrar **Ativo até ‹data›** quando o plano segue até o fim do período. #### Como baixar a nota fiscal de uma recarga ou mensalidade 1. Em **Saldo & Recargas**, role até **Faturas**. 2. Ache o pagamento pela data e pelo valor. 3. Com a situação **Emitida**, clique em **Baixar NF**; com **Processando**, a nota ainda está saindo. #### Como exportar o extrato para uma planilha 1. Em **Saldo & Recargas**, role até **Extrato**. 2. Clique em **Exportar CSV**. 3. Abra o arquivo no Excel ou no Google Planilhas para somar por tipo de débito e comparar meses. #### Como baixar o contrato Enterprise assinado 1. Em **Saldo & Recargas**, localize o cartão **Contrato e documentos**. 2. Na linha **Condições do Plano Enterprise**, confira que ela diz assinado pelas duas partes. 3. Clique em **Baixar PDF assinado** para receber o documento com o relatório de assinaturas. 4. Para reler os Termos de Uso e a Política de Privacidade, clique em **Ler**. #### Como ativar a mensalidade em conta revendida (Plano & Recargas) 1. No menu, abra **Plano & Recargas**. 2. No card **Seu plano**, clique em **Ativar minha mensalidade**. 3. Se a tela pedir, preencha **CPF ou CNPJ de quem paga** e clique de novo. 4. Clique em **Abrir pagamento** e pague; a IA começa a atender depois da confirmação. ### Perguntas frequentes #### Por que na minha conta o item se chama Plano & Recargas e não Saldo & Recargas? Porque a sua conta foi contratada por um parceiro que revende a plataforma. Nela o contrato principal é a mensalidade com o parceiro, e a recarga cobre só o que passar do incluído no mês. A tela é a mesma rota, com textos ajustados: sem cartão de crédito na recarga e sem a lista de Faturas. #### O atendente consegue ver o saldo da conta? Vê o cartão de créditos e saldo no pé do menu, como todo mundo da equipe. A tela Saldo & Recargas é de dono e administrador: para o atendente, abrir o endereço leva de volta ao Painel. #### Pré-visualizar estado sem saldo muda alguma coisa na conta? Não. O botão só abre a tela Agente pausado para você ver como ela fica; com saldo positivo, ela mostra a faixa de pré-visualização dizendo que o agente segue ativo. #### Apareceu Não foi possível carregar o seu saldo. Meu saldo zerou? Não necessariamente. É uma falha de leitura da tela, não do saldo: nada foi cobrado nem perdido. Clique em Tentar de novo antes de decidir recarregar. #### Fechei a tela antes de copiar o código Pix. Perdi a recarga? Não. Uma cobrança não paga não credita nada; basta gerar o Pix de novo com o mesmo valor e pagar o código novo. #### Onde ligo a recarga automática? Em Configurações, na parte Cobrança & alertas. O atalho mais rápido é o link Ligar ao lado de Recarga automática nos detalhes do cartão do saldo. Quando uma recarga automática é gerada e espera pagamento, Saldo & Recargas mostra a faixa dela com o Pix para copiar. #### Por que a linha Modelo entregue (WhatsApp) diz Cobrado pela Meta? Porque o número que você conectou está numa conta da Meta que é sua: a Meta cobra cada modelo entregue direto no seu cartão e a plataforma não debita nada desse item do saldo. #### Por que a nota fiscal aparece como Processando? A nota é emitida logo depois do pagamento e leva um tempo para sair. Enquanto isso, a linha fica em Processando e sem o botão Baixar NF; se a emissão falhar, a linha diz Falhou — vamos reemitir. #### Administrador pode cancelar a assinatura? Não. Cancelar assinatura aparece só para o dono da conta. No contrato Enterprise com fidelidade, nem o dono vê o botão: no lugar dele vem a data da fidelidade e com quem falar para encerrar. ### Guia: Saldo & Recargas Quanto você tem, quanto gastou e no que gastou. É o combustível do atendimento: sem saldo, a IA para de responder conversa nova. A conta é pré-paga: você põe crédito e o consumo debita, evento por evento. Nada de fatura no fim do mês com surpresa dentro — o saldo está sempre à vista, inclusive no canto do menu, em qualquer tela do painel. #### O cartão do menu No pé do menu lateral, em toda tela, fica o cartão de **Créditos de IA** e **Saldo pré-pago**. Os créditos são a franquia do plano: a IA gasta deles **primeiro** e, quando acabam, segue pelo saldo. O ponto que pulsa no trilho mostra de onde a IA está tirando agora. Clique no cartão (ou tecle Enter nele) para abrir os detalhes ao lado; Esc fecha. Na tela: Menu lateral com o cartão de créditos de IA e saldo e, ao lado, os detalhes abertos com o disponível, a projeção, o teto de gasto e o consumo do ciclo por tipo. O cartão e os detalhes. Os números mudam sozinhos a cada mensagem: não precisa recarregar a página. 1. **Créditos e saldo**: O número grande é o que **resta** dos créditos do plano; a barra é o que já foi **usado**, com uma marca nos 80%, e ao lado a data em que renovam. Embaixo, o saldo pré-pago. 2. **Disponível para a IA**: Créditos + saldo, na ordem em que a IA gasta: **1** os créditos do plano, **2** o saldo. 3. **Projeção**: No ritmo dos **últimos 7 dias** (uma mudança recente de uso aparece logo): se os créditos sobram até a renovação ou em que dia acabam, e quanto tempo o saldo dura depois. Estornos, como um primeiro contato que a Meta recusou, voltam aos créditos e já saem da conta. O que sobra dos créditos **não acumula** para o ciclo seguinte. 4. **Teto de gasto**: Aparece quando você configurou um teto em [Configurações](https://attendto.com.br/manual/configuracoes), em **IA & persona**. Ao bater o teto, a IA pausa até virar o dia (ou o mês). 5. **Consumo do ciclo por tipo**: Quanto saiu em mensagens, leads qualificados, áudio e imagens desde o início do ciclo. **Módulos** saem só do saldo pré-pago, nunca dos créditos do plano. - **Acima de 80%**: A barra fica âmbar e o cartão diz em que dia, no ritmo atual, os créditos acabam. - **Créditos esgotados**: Nada parou: a IA está usando o saldo, e o cartão diz desde quando. Os créditos voltam na renovação. - **Saldo baixo**: Créditos + saldo abaixo do limiar que você define em **Cobrança & alertas**. O cartão estima para quantos dias ainda dá. - **IA parada**: Créditos e saldo em zero: os leads continuam chegando no Inbox, mas a IA não responde até a recarga. - **Menu recolhido**: O cartão vira um anel com o percentual usado; passar o mouse (ou focar com o teclado) mostra os números, e clicar abre os mesmos detalhes. - **No celular**: O cartão fica no menu; tocar nele abre os detalhes de baixo para cima. Com o menu fechado, um anel pequeno sobe para o topo da tela só quando há alerta. - **Plano Enterprise**: A IA não cobra no ciclo: o cartão conta as **mensagens do ciclo** contra as incluídas no contrato, e o saldo fica para SMS, e-mail e modelos do WhatsApp. > **Avisos sem precisar olhar o cartão:** Quando os créditos passam de **80%**, quando **acabam** e quando o **saldo fica baixo**, o sino avisa e o responsável pela conta recebe um e-mail — **uma vez por ciclo** cada aviso, sem repetição. #### A tela por partes Na tela: Tela Saldo & Recargas com o formulário de recarga à esquerda e, à direita, o saldo, o card do plano e a tabela de preços. À esquerda você paga; à direita você entende o que está pagando. Faturas e Extrato ficam logo abaixo, fora da foto. 1. **A regra do pré-pago**: Você recarrega, o consumo debita, e quando acaba a IA pausa e avisa. Não existe conta a pagar depois: o que não foi recarregado não é gasto. 2. **Quanto colocar**: Quatro valores prontos — 100, 250, 500 e 1.000 — ou o valor que você digitar no campo logo abaixo. O que estiver digitado é o que vale. 3. **Como pagar**: **Pix**, **Boleto** ou **Cartão**, e o botão muda de nome conforme a escolha. O saldo entra sozinho quando o pagamento é confirmado — no Pix isso é quase imediato; no boleto, depende da compensação bancária. 4. **O saldo, em cima de tudo**: Quanto você tem para gastar agora. Logo abaixo, a **franquia do plano**, quando existe. **Pré-visualizar estado sem saldo** mostra como o painel fica quando o crédito acaba — é só uma prévia, não muda nada. 5. **O card do plano**: Com o plano ativo: a data da próxima fatura, quanto sobrou da franquia do mês e **Cancelar assinatura**, que só o dono da conta enxerga. Sem plano, o mesmo card mostra o preço e o convite para assinar. 6. **O preço de cada coisa**: Cada evento que consome saldo e quanto ele custa **na sua conta hoje**: lead qualificado quente e morno, mensagem processada, modelo entregue, minuto de voz, imagem lida pela IA, transbordo, SMS e e-mail. Com o plano ativo, os leads saem por centavos e o transbordo fica **Sem custo**. #### Recarregar 1. **Escolha o valor**: Um dos quatro botões ou um valor digitado. Uma referência honesta: some o que você gastou no mês passado no **Extrato** e recarregue isso mais uma folga — recarga curta é o que faz o saldo zerar num sábado. 2. **Escolha a forma de pagamento**: **Pix** para entrar em minutos, **Boleto** quando o financeiro exige, **Cartão** para praticidade. 3. **Gere a cobrança e pague**: No Pix aparece o código para copiar ali mesmo. Não feche a tela antes de copiar; se fechar, é só gerar de novo. 4. **Confira o saldo**: Confirmado o pagamento, o crédito entra sozinho e aparece no card azul e no menu. Se o valor entrou, a linha correspondente já está no **Extrato**. #### O que acontece quando o saldo acaba A IA para de responder **conversas novas**. É a parte que assusta e é a que menos machuca, porque nada se perde: as mensagens continuam chegando e ficando registradas, e a conversa entra em **Aguardando recarga** no [Inbox](https://attendto.com.br/manual/inbox), esperando você. - O lead recebe uma frase neutra, **uma única vez**. Ela nunca diz que faltou saldo — para quem está do outro lado, é só uma resposta que vai demorar um pouco. - Ninguém do time é bloqueado: dá para assumir a conversa e responder como humano normalmente. - Assim que o crédito entra, as conversas saem sozinhas desse estado e a IA retoma de onde parou. Você não precisa destravar nada. > **O erro que custa dinheiro é deixar zerar:** Saldo em zero numa sexta à noite é fim de semana inteiro de lead esperando resposta enquanto o concorrente responde. O painel avisa antes, por e-mail e por notificação — e o aviso só serve para quem age nele. > **A recarga automática não se liga aqui:** Esta tela mostra o resultado dela, nunca a configuração. Ligar "quando o saldo cair de X, cobre Y" é em [Configurações](https://attendto.com.br/manual/configuracoes), em **Cobrança & alertas**. Vale gastar cinco minutos lá: é o que faz esta tela nunca mais precisar de você às pressas. #### O plano mensal Ao lado do pré-pago existe o plano **Pro**: uma mensalidade que já vem com uma **franquia mensal de créditos** e com transbordo humano ilimitado. Quem tem volume constante sai muito na frente — o lead qualificado passa a custar centavos em vez de reais, e chamar uma pessoa para a conversa deixa de ter preço. - **A franquia não acumula.** Ela renova a cada ciclo, e o que sobrou não passa para o mês seguinte. Sobrar muito todo mês é sinal de que o pré-pago puro sairia mais barato. - **Estourar a franquia não corta o atendimento.** O consumo acima dela cai no saldo pago — por isso vale manter algum crédito mesmo com o plano ativo. - O card mostra a data da próxima fatura e quanto ainda resta da franquia deste mês — o mesmo número do cartão do menu, onde ela aparece como **Créditos de IA**. **Cancelar assinatura** é só do dono da conta. Dentro de **7 dias** do primeiro pagamento vale o direito de arrependimento, com reembolso integral e encerramento imediato. Fora desse prazo não há multa nem reembolso: o plano continua valendo até o fim do período já pago e não renova depois. > **Conta com contrato Enterprise:** O card mostra o nível contratado (**Enterprise Core**, **Enterprise Scale** ou **Enterprise Custom**) e a **mensalidade do contrato** no lugar da franquia, e a mensalidade aparece com o mesmo nome em **Faturas**. Dentro de **7 dias** da primeira confirmação de pagamento, cancelar devolve tudo o que foi pago: implantação, mensalidade e excedente. Depois disso, enquanto durar a fidelidade do contrato, o card mostra até quando ela vale, a multa de quem encerra antes e com quem falar para encerrar. #### O Plano sob medida Na conta contratada pela proposta de um especialista, o card do plano mostra a **mensalidade do contrato** e não oferece outro plano. Com os modelos da sua empresa, o cartão do menu mostra as **mensagens do ciclo** e o excedente por mil; com a IA da plataforma, só os **créditos de IA**. A fatura de cada ciclo aparece no topo, no cartão **Fatura em aberto**, com o botão **Pagar**. O passo a passo está em [Como funciona a sua contratação](https://attendto.com.br/manual/primeiros-passos). #### Contrato e documentos (Enterprise) Na conta Enterprise com as Condições do Plano Enterprise, o alto da Carteira troca o card do plano por três cartões: - **Seu plano**: O nível e a mensalidade, as mensagens incluídas por ciclo e o excedente por mil, a fidelidade e a próxima fatura. O selo diz **ativo desde** o dia em que o Enterprise ligou, ou **aguardando ativação** enquanto falta assinar, pagar ou conectar. - **Pagamentos**: As cobranças pagas do contrato — a implantação e cada mensalidade —, com a data em que entraram. - **Contrato e documentos**: O que a sua empresa assinou e aceitou: as **Condições do Plano Enterprise**, com quem assinou e quando, e os **Termos de Uso e Política de Privacidade**, com a data do aceite e a versão em vigor (**Ler** abre o texto numa aba nova). - **Baixar PDF assinado** entrega o documento com o **relatório de assinaturas** da assinatura eletrônica: quem assinou, quando e de onde — a prova de que as duas partes assinaram. Antes das duas assinaturas, a linha diz para quem o documento foi enviado e não há o que baixar. - O PDF fica guardado aqui pelo tempo do contrato e depois dele: dá para baixar de novo quando precisar. - A fidelidade é **contada da data da última assinatura** — a das duas partes que assinou por último. Encerrar antes do fim dela, fora dos 7 dias do arrependimento, tem **multa de 20% das mensalidades que faltam até o fim da fidelidade, proporcionais por dia, até 3 mensalidades** (a mensalidade do contrato, sem implantação nem excedente); o link da multa chega por e-mail ao dono da conta. Depois da fidelidade, não há multa. - O mesmo PDF aparece em IA própria, na aba **Segurança e dados**, para quem cuida da parte técnica. - O card de recarga vira **Saldo para SMS, e-mail e modelos do WhatsApp**: no Enterprise, o saldo paga só o que fica fora do contrato e é cobrado à parte. #### Ler a tabela de preços A tabela lista cada evento cobrável com o preço que vale **na sua conta**, já com a regra do seu plano aplicada. O débito acontece no momento do evento, e é a mesma linha que você vai encontrar depois no extrato: - **Lead qualificado (quente ou morno)**: Cobrado **uma vez por lead** em cada faixa, não a cada mensagem: quando a nota chega a morno e, se o lead esquentar, quando chega a quente. Quem já pagou quente não paga morno depois. Como a nota é calculada está em [Qualificação](https://attendto.com.br/manual/qualificacao). Com o **Modo atendimento** ligado (venda direta, em [Configurações](https://attendto.com.br/manual/configuracoes) → IA & persona), nenhuma das duas faixas é cobrada: as linhas saem desta tabela e do cartão de saldo, e o extrato não ganha linha de lead. - **Mensagem processada**: Cada mensagem que a IA lê e responde numa conversa. - **Modelo entregue (WhatsApp)**: O texto aprovado que sai quando a janela de 24 horas está fechada — de campanha, de cadência, de reabertura ou enviado à mão. **Quem cobra depende de onde o seu número mora**: veja a seção abaixo. Quando quem cobra somos nós, esta linha abre em **quatro preços**, um por categoria. Ver [Modelos de mensagem](https://attendto.com.br/manual/modelos-de-mensagem). - **Minuto de voz**: Áudio de lead virando texto, cobrado por minuto. Com a equipe atendendo, só entra com **Transcrever áudios no atendimento humano** ligado em [Configurações](https://attendto.com.br/manual/configuracoes). Ver [Voz & tom](https://attendto.com.br/manual/voz-e-tom). - **Imagem lida pela IA**: Figurinha, foto borrada, imagem grande demais e a que passa do limite da conversa não são cobradas. Ver [Leitura de imagens](https://attendto.com.br/manual/configuracoes). - **Transbordo para atendimento humano**: Cada passagem de bastão para uma pessoa. Com o plano ativo, fica **Sem custo**. - **SMS e e-mail**: Preço próprio por canal, diferente do WhatsApp e do chat do site. - **Ajuste da qualificação ao seu negócio**: Cada vez que a IA termina de reescrever as perguntas de um público (**Qualificação → Ajustar ao meu negócio**), inclusive quando não há nada a trocar. Erro, cancelamento e ajuste que não terminou não cobram. No extrato: “ajuste da qualificação ao negócio”. Ver [Conta pronta para o seu segmento](https://attendto.com.br/manual/configuracoes). - **Modelo de segmento gerado pela IA**: O modelo que a IA monta para um segmento fora da lista, em **Configurações → Seu segmento**. Casar com um modelo pronto, dar erro ou cancelar não cobra. No extrato: “modelo de segmento gerado pela IA”. Os preços de cada item podem mudar. Quando algum preço sobe, o preço novo vale na hora, inclusive para o saldo que você já tem, e você recebe um e-mail com os preços novos. Quando um preço baixa, o saldo que você já pagou continua sendo gasto pelo preço da época da recarga, e o preço menor vale a partir da próxima recarga. Se você tiver saldo de recargas feitas em preços diferentes, vale o maior deles até esse saldo acabar. #### Quem paga o WhatsApp O WhatsApp cobra por **modelo entregue**, e quem ele cobra é o dono da conta em que o número está: a sua, se você conectou o seu próprio WhatsApp; a nossa, se o número que você usa é hospedado por nós. - **Seu número, sua conta do WhatsApp**: É o caminho normal. A Meta cobra cada modelo entregue direto no seu cartão, no valor dela — **a plataforma não cobra nada por cima disso**, e a linha aparece como *Cobrado pela Meta* na tabela de preços. Marketing é a categoria mais cara; utilidade e autenticação custam menos. - **Número hospedado por nós**: A fatura do WhatsApp vem para a plataforma, e o valor do modelo entregue sai do seu saldo — pelo preço da **categoria** daquele modelo, que a tabela mostra aberto. Com **mais de um número** conectado, deixa de haver uma resposta só: cada número mora numa conta, e a fatura segue o número por onde a mensagem saiu. A linha da tabela aqui fala pela **conta padrão** do canal, e a tela avisa isso quando percebe que você tem mais de um. A ordem de quem entrega é sempre a mesma: manda a conta da conversa; não havendo conversa, a que a campanha ou a cadência escolheu; não havendo escolha, a padrão. Ver [Conexões](https://attendto.com.br/manual/conexoes). **Por que quatro preços e não um.** O WhatsApp não tem uma tarifa de modelo: tem quatro, e a diferença entre elas é grande. Um envio de **marketing** (oferta, novidade, convite) é a categoria mais cara. **Utilidade** (aviso de pedido, lembrete, confirmação) e **autenticação** (código de acesso) custam uma fração disso. **Atendimento** — a resposta ao cliente que escreveu primeiro — não tem tarifa hoje. Na prática isso muda o que compensa mandar: o mesmo saldo entrega muito mais avisos de utilidade do que campanhas de marketing. A tabela mostra os dois números lado a lado justamente para essa escolha ser feita com o valor na frente. Há uma **quinta linha**, chamada *Ainda sem categoria*. Um modelo só ganha categoria quando a Meta a informa para a plataforma, e enquanto isso a entrega sai por esse preço base — que é mais caro que utilidade e mais barato que marketing. Abrir [Modelos de mensagem](https://attendto.com.br/manual/modelos-de-mensagem), ou o próprio assistente de campanha, é o que traz a categoria; depois disso a linha da categoria certa passa a valer sozinha. **Responder dentro das 24 horas depois da mensagem do cliente não tem taxa de WhatsApp hoje** — nem da Meta, nem nossa. É o motivo de valer a pena responder rápido. A partir de **1º de outubro de 2026** isso muda: a Meta passa a cobrar também as mensagens de atendimento e as de utilidade enviadas dentro da janela. O valor para o Brasil ainda não foi divulgado. O que continua sendo cobrado pela plataforma em qualquer caso é o nosso trabalho: mensagem processada pela IA, lead qualificado, minuto de voz e transbordo. Retomadas automáticas, lembretes de reunião e disparos do agente especialista entram como **mensagem processada** mesmo quando saem por modelo — é o preço do trabalho da IA, não a tarifa do WhatsApp, que continua seguindo a regra acima. #### Faturas e extrato Abaixo, duas listas que respondem a perguntas diferentes. **Faturas** é o que o seu contador pede: a nota fiscal de cada pagamento, com **Baixar NF** quando ela já foi emitida (nota recém-paga aparece como processando até sair). **Extrato** é o que responde "para onde foi o dinheiro": cada entrada e cada débito, com o saldo que ficou depois daquela operação. Nada é editado nem apagado ali. **Exportar CSV** baixa tudo para planilha — é assim que se compara mês a mês e se descobre qual canal ficou caro. As imagens que chegaram e a IA **não** cobrou (figurinha, foto borrada, grande demais, acima do limite) aparecem no Extrato numa linha **sem custo**, agrupadas por dia, para você saber que chegaram. O cartão do consumo do mês (**Consumo de outubro**, por exemplo), acima do Extrato, soma o que cada item custou no mês, com as imagens lidas e as que vieram sem custo. > **Como é quando está bem resolvido:** Recarga automática ligada, saldo com folga de pelo menos uma semana de consumo, e o extrato conferido uma vez por mês para ver se a mistura de gastos mudou. Com isso, esta tela vira um lugar que você abre por curiosidade, não por emergência. #### Quem pode mexer - Recarregar e assinar o plano: administrador ou dono da conta. - Cancelar a assinatura: **só o dono**. - Ver saldo, tabela de preços e extrato: quem tem acesso à tela. No painel: Abrir Saldo & Recargas. Como as pessoas procuram: como recarregar saldo; recarga por pix; pagar com boleto; saldo pré-pago; créditos de ia; franquia do plano; cancelar assinatura; baixar nota fiscal; exportar extrato csv; agente pausado sem saldo; plano e recargas revenda; contrato enterprise pdf assinado; teto de gasto; tabela de preços por mensagem. ## Compliance: trilha de auditoria, LGPD, opt-out e direito ao apagamento dos leads URL: https://attendto.com.br/manual/compliance Menu: Conta > Compliance Compliance é a tela de auditoria e LGPD do painel: mostra a trilha de tudo o que foi feito na conta, os números de consentimento, opt-out e apagamento, a base legal do primeiro contato e os atalhos para atender os direitos do titular. ### Quem pode usar - Dono: Vê a tela inteira, exporta a trilha em CSV e usa todos os atalhos de direitos do titular. - Admin: Mesmo acesso do dono: vê, exporta e usa os atalhos. - Atendente: Não vê o item no menu; abrir o endereço direto leva de volta ao Painel. As ações sobre uma pessoa (opt-out, exportar dados, anonimizar) ficam na ficha do lead, no CRM. ### Telas #### Compliance A tela Compliance serve para provar o que aconteceu na conta, com a trilha de auditoria que só cresce, e para encaminhar pedidos de LGPD: a exportação da conta inteira sai daqui, e as ações sobre uma pessoa levam à ficha dela no CRM. Endereço no painel: `/app/compliance` ![Captura da tela Compliance. A tela Compliance serve para provar o que aconteceu na conta, com a trilha de auditoria que só cresce, e para encaminhar pedidos de LGPD: a exportação da conta inteira sai daqui, e as ações sobre uma pessoa levam à ficha dela no CRM.](https://attendto.com.br/prints-do-manual/compliance--compliance.png) A tela Compliance na conta de demonstração, com dados fictícios e os valores desfocados. ##### Indicadores do topo Quatro números calculados dos leads e das decisões da IA da conta. Também aparece: - **Consentimentos**: quantos leads registraram consentimento. - **Opt-outs**: quantos leads pediram para não receber mais mensagens. - **Apagamentos**: quantos leads foram anonimizados. - **Cobertura de reasoning**: a fração das decisões automáticas da IA que ficaram gravadas com o motivo, com a dica **‹n› decisões da IA**. Traço e **sem decisões ainda** quando a IA ainda não decidiu nada. ##### Trilha de auditoria A linha do tempo de eventos da conta, 50 por página, do mais recente para o mais antigo. Só cresce: nada é editado nem apagado. Botões e ações: - **Exportar**: Baixa a trilha em CSV (arquivo auditoria-‹data›.csv), que abre no Excel ou no Google Planilhas. Enquanto baixa, o botão diz Exportando… - **‹ Anteriores**: Volta para a página de eventos mais recentes. Desabilitado na primeira página. - **Próximos ›**: Avança para eventos mais antigos. Desabilita quando a página veio com menos de 50 eventos, o fim da trilha. Também aparece: - Subtítulo: **Append-only · toda ação de handoff/LGPD grava um evento**. - Cada evento mostra o autor (nome do atendente, e-mail de quem estava logado, ou **Sistema** quando foi a IA ou uma rotina automática), o nome do evento em português e a data e hora. - Alguns eventos abrem um detalhe embaixo, por exemplo o atendente que assumiu a conversa ou quantos contatos entraram numa importação. - Eventos que aparecem: Conversa transferida, Mensagem do atendente, Conversa devolvida à IA, Conversa encerrada, Conversa reaberta, Conversa excluída, Consentimento registrado, Opt-out do lead, Lead anonimizado, Dados exportados (portabilidade), Contato excluído, Modelo enviado, Público criado, Teste A/B iniciado, Atendente convidado, Acesso do atendente revogado, Assinatura ativada, Recarga automática disparada, Verificação em duas etapas ligada, entre outros. ##### Consentimento no 1º contato O cartão verde que declara como e com que base legal o consentimento é coletado. Também aparece: - Coletado no primeiro contato pelo WhatsApp, com base legal **legítimo interesse**. - Opt-out disponível a qualquer momento. ##### Direitos do titular Quatro atalhos (LGPD · CCPA · GDPR). Só o primeiro executa nesta tela; os outros três levam ao CRM, porque a ação é sempre sobre uma pessoa. Botões e ações: - **Exportar auditoria**: Baixa o mesmo CSV da trilha, com o motivo registrado em cada decisão automática. - **Portabilidade**: Leva ao CRM para escolher o lead; na ficha dele, **Exportar dados** entrega os dados em formato aberto. - **Direito ao apagamento**: Leva ao CRM para escolher o lead; na ficha dele, **Anonimizar (LGPD)** remove os dados pessoais de forma irreversível. - **Opt-out imediato**: Leva ao CRM para escolher o lead; na ficha dele, **Registrar opt-out** interrompe as mensagens e mantém os dados. ##### Estados da tela - Carregando: A trilha mostra **Carregando…** enquanto busca os eventos. - Sem nada ainda: **Nenhum evento de auditoria ainda.** É uma conta que ainda não fez nada que gere evento; o primeiro transbordo já cria a primeira linha. - Se der erro: **Não foi possível carregar a trilha de auditoria**, explicando que isso não quer dizer que não há eventos e que nada foi apagado, com Tentar de novo. Se a exportação falhar, um aviso pede para tentar novamente. ### Passo a passo #### Como exportar a trilha de auditoria em CSV 1. No menu, abra **Compliance**. 2. No cartão **Trilha de auditoria**, clique em **Exportar** (ou use **Exportar auditoria** em **Direitos do titular**). 3. Abra o arquivo auditoria-‹data›.csv no Excel ou no Google Planilhas e use a busca da planilha para achar o evento. #### Como atender um pedido de apagamento de dados (LGPD) 1. Em **Compliance**, clique em **Direito ao apagamento**; o painel abre o CRM. 2. Busque e abra a ficha da pessoa que fez o pedido. 3. Se houver chance de precisar do histórico (cobrança, contrato, disputa), clique antes em **Exportar dados** e guarde o arquivo. 4. Clique em **Anonimizar (LGPD)** e confirme. A ação é irreversível e o contador **Apagamentos** sobe. #### Como registrar o opt-out de um contato 1. Em **Compliance**, clique em **Opt-out imediato**; o painel abre o CRM. 2. Abra a ficha da pessoa. 3. Clique em **Registrar opt-out** e confirme. As mensagens para ela param, os dados ficam, e o evento Opt-out do lead entra na trilha. #### Como entregar os dados de um titular (portabilidade) 1. Em **Compliance**, clique em **Portabilidade**; o painel abre o CRM. 2. Abra a ficha da pessoa. 3. Clique em **Exportar dados** e envie o arquivo a quem pediu. A trilha registra Dados exportados (portabilidade). #### Como descobrir quem transferiu ou encerrou uma conversa 1. Em **Compliance**, olhe a **Trilha de auditoria**: cada linha diz o autor, o evento e quando. 2. Use **Próximos ›** para voltar no tempo de 50 em 50. 3. Se não lembrar o dia, clique em **Exportar** e procure na planilha pelo nome do evento (Conversa transferida, Conversa encerrada) ou pelo autor. ### Perguntas frequentes #### Qual é a base legal que a plataforma declara para falar com os leads? Legítimo interesse, com o consentimento registrado no primeiro contato pelo WhatsApp e o opt-out disponível a qualquer momento. É o que o cartão Consentimento no 1º contato mostra. #### O que significa Sistema como autor de um evento? Que o evento não foi feito por uma pessoa logada: foi a IA ou uma rotina automática do painel. #### Por que Cobertura de reasoning mostra um traço? Porque a IA ainda não tomou nenhuma decisão automática na conta para ser medida. O traço vira percentual assim que as primeiras decisões acontecem. #### Qual a diferença entre Exportar e Exportar auditoria? Nenhuma no arquivo: os dois baixam o CSV da trilha da conta. Exportar fica no cabeçalho da trilha; Exportar auditoria fica entre os direitos do titular, para quem chega pensando no pedido de LGPD. #### O atendente pode ver a trilha ou exportar a auditoria? Não. Compliance é de dono e administrador; para o atendente, o endereço volta ao Painel. O que ele faz no atendimento, porém, entra na trilha com o nome dele. #### Anonimizar um lead muda os números agregados da conta? O lead deixa de ter nome, telefone, e-mail e empresa e passa a contar em Apagamentos. Os totais da operação, como o número de conversas do mês, continuam de pé. ### Guia: Compliance O registro de tudo o que foi feito na conta e as ferramentas de LGPD, na mesma tela. A pergunta que ela responde é uma só: é sobre a conta inteira ou sobre uma pessoa? Esta tela junta duas coisas que parecem uma só e não são: o **registro de tudo o que foi feito** na conta, que se preenche sozinho, e as **ferramentas de LGPD**, que você usa quando alguém exerce um direito. Quem confunde as duas passa meia hora procurando um botão que não existe aqui. #### A decisão que você toma aqui Antes de clicar em qualquer coisa, responda: **o pedido é sobre a conta inteira ou sobre uma pessoa?** Se é "me mostre tudo o que foi feito" — auditoria interna, jurídico, um cliente grande pedindo prova de processo —, o CSV desta tela resolve. Se é "fulano pediu para apagar os dados dele", esta tela não faz: quem faz é a ficha daquela pessoa em [CRM & Graph](https://attendto.com.br/manual/crm), porque a ação é sempre sobre um nome específico. > **Nada aqui gasta e nada aqui quebra:** Esta tela só lê e baixa: não debita saldo e não tem botão destrutivo. O que apaga de verdade — **Anonimizar (LGPD)** — mora na ficha da pessoa, no CRM. #### A tela por partes Na tela: Tela de Compliance com quatro indicadores no topo, a trilha de auditoria à esquerda e o cartão de direitos do titular à direita. Números em cima, o histórico à esquerda, os atalhos de LGPD à direita. 1. **Os quatro números**: **Consentimentos** (quantos leads registraram consentimento), **Opt-outs** (quantos pediram para não receber mais), **Apagamentos** (quantos foram anonimizados) e **Cobertura de reasoning** — este último é quanta decisão automática ficou registrada com o motivo. Traço no lugar do número quer dizer que ainda não houve decisão para registrar. 2. **Trilha de auditoria e o botão Exportar**: A trilha **só cresce**: nada aqui se apaga nem se edita, nem por você nem por quem administra a conta. É isso que a torna útil como prova. **Exportar** baixa em CSV, que abre no Excel. 3. **A linha do tempo**: Uma linha por evento: quem fez, o que fez e quando. O autor é o nome do atendente, o e-mail de quem estava logado, ou **Sistema** quando foi a IA. Alguns eventos abrem um detalhe embaixo — o atendente que assumiu a conversa, quantos contatos entraram na importação. 4. **Paginação de 50 em 50**: **‹ Anteriores** e **Próximos ›** andam meia centena por vez. Não existe contador total: quando **Próximos ›** desabilita, é porque a página veio com menos de 50 e você chegou ao fim. 5. **Como o consentimento é coletado**: Em que momento o consentimento é registrado e com que base legal. É o texto que você mostra quando alguém — cliente, jurídico, auditoria — pergunta por que você tinha o telefone daquela pessoa. 6. **Direitos do titular: só o primeiro executa aqui**: Quatro botões, e é aqui que quase todo mundo se perde. **Exportar auditoria** roda nesta tela. **Portabilidade**, **Direito ao apagamento** e **Opt-out imediato** são atalhos: eles te levam para o CRM, porque a ação é sempre sobre uma pessoa. #### O que a trilha registra sozinha Você não digita nada aqui. A trilha se preenche com o uso do painel, e estes são os eventos que caem nela: - Conversa transferida para um humano, e a mensagem que o atendente enviou. - Consentimento registrado e opt-out do lead. - Contatos importados por planilha, com quantos entraram. - Empresas unificadas, público criado, mudança na equipe, assinatura ativada. Conta nova mostra **Nenhum evento de auditoria ainda**. Não é defeito: é uma conta que ainda não fez nada. O primeiro transbordo já coloca a primeira linha ali. #### Levar a trilha para fora - **Exportar** entrega um CSV — abre no Excel, no Google Planilhas e em qualquer coisa que leia planilha. - O teto é de **10 mil linhas**. Conta antiga e movimentada bate nesse teto, e o que passa disso não entra no arquivo. - **Exportar auditoria**, no cartão da direita, faz o mesmo caminho e traz junto o motivo registrado em cada decisão automática. - Exportar exige **administrador ou dono**. O papel atendente não entra nesta tela. > **Procurar na planilha é mais rápido:** A trilha é cronológica e vai de 50 em 50. Se você procura um evento específico e não lembra o dia, exporte o CSV e use a busca da planilha — leva segundos, contra dezenas de cliques em **Próximos ›**. #### Quando o pedido é de uma pessoa Abra a ficha dela em [CRM & Graph](https://attendto.com.br/manual/crm). São três ações, e a diferença entre elas importa: - **Registrar opt-out**: Para de mandar mensagem para aquela pessoa e **mantém os dados**. É a resposta certa para "não quero mais receber" — e ela vence qualquer campanha, sempre. - **Exportar dados**: A portabilidade: um arquivo com o que a conta tem sobre a pessoa, em formato aberto. É o que você entrega quando ela pede os próprios dados. - **Anonimizar (LGPD)**: **Irreversível.** Remove nome, telefone, e-mail e empresa. Os números agregados ficam de pé — o total de conversas do mês não muda —, mas a pessoa deixa de existir como pessoa. > **Exporte antes de anonimizar:** Depois de anonimizar não há de onde tirar o dado: ele não fica escondido em canto nenhum, esperando um pedido educado. Se existe qualquer chance de você precisar do histórico daquela relação — cobrança em aberto, contrato, disputa —, **Exportar dados** primeiro, anonimizar depois. Na ordem inversa não tem conserto. #### Quando não sai como esperado - **A tela não abre para você.** Compliance é de administrador ou dono. Quem entra como atendente não chega aqui — peça para quem administra a conta. - **A trilha está vazia.** Conta nova, ou operação que ainda acontece fora do painel. Um transbordo e uma importação já enchem a primeira página. - **O número de Opt-outs subiu e você não sabe por quê.** Cada opt-out vira um evento na trilha, com data e autor. A resposta está lá, não no número. - **Você procura uma alteração e não acha.** A trilha registra o que foi feito no atendimento e na conta — não é histórico de edição de campo a campo. Se o que você quer é a mudança de um dado do lead, ela está na ficha dele no CRM. #### Como é quando está bem - A trilha tem eventos **de hoje**, não só do mês passado: sinal de que a operação está rodando dentro do painel, e não por fora dele. - **Cobertura de reasoning** com número no lugar do traço — as decisões automáticas estão saindo com o motivo gravado, e você consegue explicar qualquer uma delas depois. - Opt-out registrado no mesmo dia do pedido. Quem pediu para sair e continua recebendo é o único erro desta área que vira problema de verdade. - Um CSV recente guardado fora do painel. Auditoria não costuma marcar hora. No painel: Abrir Compliance. O CSV da conta inteira sai daqui. A ação sobre uma pessoa sai da ficha dela. Como as pessoas procuram: lgpd painel de atendimento; trilha de auditoria; exportar auditoria csv; direito ao apagamento; anonimizar lead; opt-out de contato; portabilidade de dados; base legal legítimo interesse; quem transferiu a conversa; registro de consentimento. ## Conexões: como conectar o WhatsApp oficial, Instagram, SMS, e-mail e o web chat URL: https://attendto.com.br/manual/conexoes Menu: Conta > Conexões 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 - Dono: Conecta, renomeia, define a conta padrão, escolhe a persona de cada conta, troca provedor e desconecta. - Admin: Mesmo acesso do dono em todos os canais. - Atendente: Nã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` ![Captura da tela 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.](https://attendto.com.br/prints-do-manual/conexoes--conexoes.png) 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. Também aparece: - 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). Também aparece: - 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 ID** (obrigató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 Token** (obrigatório): O token permanente gerado na Meta. Guardado e nunca reexibido. - **App Secret** (obrigatório): A Chave Secreta do Aplicativo; valida cada mensagem que a Meta envia. - **Verify Token** (obrigató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. Também aparece: - 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. Também aparece: - 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: - **Provedor** (obrigató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. Também aparece: - 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: - **Provedor** (obrigató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. Também aparece: - 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 conta** (obrigató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. Também aparece: - 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` ![Captura da tela 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.](https://attendto.com.br/prints-do-manual/conexoes--conectar-whatsapp.png) 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). Quem usa: Dono, Admin, Atendente. ##### 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. Também aparece: - 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. Também aparece: - 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. Também aparece: - 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` ![Captura da tela 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.](https://attendto.com.br/prints-do-manual/conexoes--personalizar-web-chat.png) 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 →**. Quem usa: Dono, Admin, Atendente. ##### 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. Também aparece: - 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: 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. > **O caminho de menor arrependimento:** Ligue o web chat primeiro e trate o WhatsApp como tarefa agendada. Você já começa a receber conversa e a IA já começa a qualificar no seu site, sem depender de aprovação de ninguém. #### 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](https://attendto.com.br/manual/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](https://attendto.com.br/manual/personas) e [Base de conhecimento](https://attendto.com.br/manual/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](https://attendto.com.br/manual/modelos-de-mensagem). Onde a escolha aparece: no [Inbox](https://attendto.com.br/manual/inbox) e no [Funil](https://attendto.com.br/manual/funil) como filtro, para você olhar só o que entrou por um número; em [Campanhas](https://attendto.com.br/manual/campanhas) e nas cadências como campo de envio, para decidir por onde a leva sai. > **Um número só pertence a uma empresa:** Se o número que você está conectando já está em uso em outra conta, a tela recusa e explica: **este número já está conectado em outra empresa**. Ela nunca diz qual — se a linha é sua e alguém conectou antes, o suporte libera. #### 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](https://attendto.com.br/manual/saldo-e-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](https://attendto.com.br/manual/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](https://attendto.com.br/manual/modelos-de-mensagem). > **O número sai do aplicativo do celular:** Ao entrar na API oficial, o número **deixa de funcionar no aplicativo do WhatsApp no celular**. Todo o atendimento passa a ser pelo painel, e não há como usar os dois ao mesmo tempo. Não faça isso com o número pessoal do dono nem com o número que a equipe atende no celular sem avisar todo mundo antes — é o tipo de surpresa que para a operação numa terça de manhã. > **Dá para começar sem verificar a empresa na Meta:** Sem a verificação, quem chama você é atendido **sem limite**. O que fica limitado é o que você inicia: **250 conversas por dia**. Para quase toda operação começando, isso sobra. Verificar a empresa pode ser tarefa da segunda semana. #### 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. > **Este segundo caminho depende de onde o número vive hoje:** Ele está disponível para toda conta, na tela de Conexões. A Meta só aceita o número que está no **aplicativo WhatsApp Business** e não está ligado a outra plataforma; número em outro provedor precisa ser desligado lá antes. O resto desta seção descreve como o caminho funciona. 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. > **Desligue as respostas automáticas do aplicativo ANTES de conectar:** No celular: **Configurações → Ferramentas comerciais → Mensagem de saudação** e **Mensagem de ausência**. Se ficarem ligadas, o aplicativo e a IA respondem ao mesmo tempo ao seu lead — e **não temos como desligá-las daqui**: elas são invisíveis para a API. 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. > **O extrato não vai bater com a fatura da Meta:** As mensagens que você envia **pelo celular** não aparecem no seu extrato aqui, porque não somos nós que as entregamos. Elas continuam sendo cobradas pela Meta, do lado dela. O que está no seu extrato é só o que saiu pelo painel. 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 ``, 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](https://attendto.com.br/manual/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](https://attendto.com.br/manual/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](https://attendto.com.br/manual/base-de-contatos). #### Conectar o Instagram > **O Direct do Instagram está disponível para toda conta:** O cartão do Instagram aparece na sua tela de Conexões: é só conectar a conta profissional, sem pedir liberação a ninguém. Os recursos de comentário (gatilhos, IA nos comentários, moderação e lives) ainda dependem de uma permissão da Meta — o guia do Instagram explica. Conectado, o Direct da sua conta cai no [Inbox](https://attendto.com.br/manual/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. > **Pré-requisito: a conta precisa ser Profissional:** Perfil pessoal não recebe mensagem por aplicativo — é regra do Instagram, para qualquer ferramenta. Converter não tem custo e leva um minuto, no app do celular: 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 webhook de recebimento é o que faz a resposta chegar:** Com o canal já ligado, SMS e e-mail mostram um **Webhook de recebimento**. Copie e cole no painel do provedor. Sem esse passo você envia normalmente, o cliente responde — e a resposta não aparece em lugar nenhum. É o defeito mais comum destes dois canais, e ele se disfarça muito bem de problema do painel. #### 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](https://attendto.com.br/manual/inbox), o aviso desaparece da linha por conta própria. > **Se o aviso aparece e as mensagens estão chegando normalmente:** Pode acontecer. O aviso conta o que é recusado na porta, e chamada malformada vinda de fora também é recusada e contada. Enquanto as conversas de verdade continuam entrando no [Inbox](https://attendto.com.br/manual/inbox), o número está bem: o aviso vai embora na próxima mensagem legítima. Descartar em silêncio seria pior — no dia em que o App Secret estivesse mesmo errado, você não teria como saber. 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](https://attendto.com.br/manual/campanhas). #### Desconectar e trocar de provedor > **Desconectar apaga as credenciais:** **Desconectar** derruba a conta na hora — para de receber e de enviar — e **apaga as credenciais salvas**. Elas não voltam: para religar é preciso gerar tudo de novo no provedor ou na Meta. Conversas e contatos ficam intactos; o que se perde é o acesso. Use quando for trocar de verdade, nunca como tentativa de "desligar e ligar para ver se resolve". - 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](https://attendto.com.br/manual/saldo-e-recargas). 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 ``. 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](https://attendto.com.br/manual/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. Como as pessoas procuram: como conectar whatsapp oficial; conectar whatsapp api da meta; usar whatsapp no celular e na ia; coexistência whatsapp business; vários números de whatsapp; conectar instagram direct; instalar chat no site; personalizar web chat; token permanente whatsapp; verificar empresa na meta; conectar sms zenvia; conectar e-mail smtp; persona por número; número padrão whatsapp. ## Instagram: gatilhos de comentário, IA nos comentários, boas-vindas no Direct e moderação URL: https://attendto.com.br/manual/instagram Menu: Conta > Instagram O menu Instagram reúne as telas que decidem o que acontece depois que a conta profissional está conectada: gatilhos de comentário que mandam mensagem no Direct, a IA respondendo comentários, boas-vindas, perguntas de abertura, menções em story, gatilhos em lives e a moderação dos comentários. Quando aparece: O grupo Instagram aparece no menu só quando o canal Instagram está habilitado na conta; a conexão da conta profissional é feita em Conexões. Boas-vindas, Perguntas de abertura e Stories funcionam com a conta conectada. Gatilhos, IA nos comentários, Moderação e Lives dependem também da permissão de comentários da Meta: sem ela, essas telas mostram o aviso Este recurso está em aprovação da Meta. ### Quem pode usar - Dono: Configura tudo: gatilhos, chave geral, IA nos comentários e a mesa de revisão, boas-vindas, perguntas, stories, lives e a moderação. - Admin: Mesmo acesso do dono em todas as telas do Instagram. - Atendente: Não vê o grupo Instagram no menu. Se abrir um endereço direto, a tela carrega, mas salvar, ligar chaves, aprovar respostas e ocultar ou apagar comentários são recusados para o papel. As conversas do Direct ele atende normalmente no Inbox. ### Telas #### Instagram — Gatilhos de comentário A tela de Gatilhos de comentário serve para criar a regra “comenta a palavra que a gente te chama”: quem comentar a palavra combinada recebe a sua resposta pública e uma mensagem sua no Direct, e a IA assume quando a pessoa responder. Endereço no painel: `/app/conexoes/instagram` ![Captura da tela Instagram — Gatilhos de comentário. A tela de Gatilhos de comentário serve para criar a regra “comenta a palavra que a gente te chama”: quem comentar a palavra combinada recebe a sua resposta pública e uma mensagem sua no Direct, e a IA assume quando a pessoa responder.](https://attendto.com.br/prints-do-manual/instagram--gatilhos.png) A tela Instagram — Gatilhos de comentário na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Pelo item Gatilhos do menu Instagram, ou pelo botão **Gatilhos e boas-vindas** no cartão do Instagram em Conexões. ##### Cabeçalho e conta (comum a todas as telas do Instagram) Título da tela, a explicação curta e, com mais de uma conta conectada, o seletor de conta. A conta escolhida vale para as telas do menu juntas até você trocar. Botões e ações: - **Voltar para Conexões**: Volta à tela Conexões. - **‹@conta›**: Cada conta conectada é uma aba com a foto e o @; escolher troca gatilhos, contadores, boas-vindas e comentários da tela. ##### Chave geral dos gatilhos Liga ou desliga todos os gatilhos de comentário da conta de uma vez, valendo na hora. Botões e ações: - **Gatilhos de comentário da conta ‹conta›**: O interruptor geral. Desligado, os comentários continuam chegando, mas ninguém recebe resposta automática. - **Religar gatilhos**: Aparece quando a plataforma pausou os gatilhos (o Instagram sinalizou problema na conta ou os envios falharam em sequência); religa depois de revisar os textos. Também aparece: - Situação: **Gatilhos de comentário: ligados**, **desligados** ou **pausados desde ‹data›**. - Aviso **Gatilhos de comentário desligados.** quando foi você quem desligou. - Aviso **Pausamos os gatilhos de comentário ‹data›.** com o motivo; nada é enviado enquanto estiver pausado. - Aviso **A Meta recusou botão no primeiro envio desta conta.**: a mensagem sai com o texto e os botões vão quando a pessoa responder. ##### O que os gatilhos desta conta produziram O funil inteiro do recurso e o que não virou mensagem, com o motivo. Também aparece: - **comentários pegos**: bateram a palavra e passaram na triagem da IA. - **DMs enviadas**: mensagens do gatilho que saíram de fato. - **conversas abertas**: a pessoa respondeu e a IA assumiu. - **leads no funil**: com ‹n› quentes · ‹n› mornos e quantos seguem a conta. - Faixa de barrados: **‹n› comentários não viraram DM** com o motivo mais comum e os demais (triagem, tetos, opt-out). Sem nenhum: **Nenhum comentário barrado até agora**. - Erro: **Não foi possível carregar os números do gatilho**, com Tentar de novo. ##### Gatilhos A lista dos gatilhos da conta (‹n› gatilhos nesta conta), um por linha. Botões e ações: - **Novo gatilho**: Abre o formulário de criar gatilho. - **Gatilho “‹palavra›” ativo**: Interruptor de cada linha: desliga ou religa só aquele gatilho. - **Editar**: Abre o mesmo formulário com o gatilho preenchido. - **Remover**: Abre a confirmação de remover o gatilho. Também aparece: - Cada linha mostra a palavra, onde ela vale (a publicação ou Reel com a data e o começo da legenda, Qualquer publicação ou Reel, ou A próxima publicação ou Reel (armado)) e o que sai (respostas públicas e DM com ou sem botões). - Vazio: **Nenhum gatilho nesta conta ainda.** com a sugestão de criar o primeiro. ##### Formulário Novo gatilho / Editar gatilho Tudo o que sai é texto seu; a IA só lê o comentário antes (triagem de sarcasmo, ofensa e spam). Campos e filtros: - **Palavra ou frase combinada** (obrigatório): Comparação exata por palavra inteira; maiúsculas e acentos não importam. Até 80 caracteres. - **Onde vale** (obrigatório): Uma publicação ou Reel (escolha na galeria ou cole o link), Qualquer publicação ou Reel (a conta inteira) ou A próxima publicação ou Reel (fica armado e se prende à primeira que você postar). - **Ou cole o link da publicação**: Alternativa à galeria: o link do post ou Reel. - **Resposta pública no comentário**: Até 3 variações sorteadas, ou nenhuma (só a DM). Não entra no consumo. - **Mensagem no Direct** (obrigatório): Até 1.000 caracteres. {nome} vira o @ de quem comentou. É a mensagem que conta no consumo, uma por pessoa a cada 24 horas. - **Botões na mensagem**: Até 3, cada um com texto de até 20 caracteres e link começando com https://. Botões e ações: - **Ver todas as publicações**: Abre o diálogo Todas as publicações, que carrega mais conforme você rola. - **+ Adicionar variação**: Acrescenta um campo de resposta pública (até 3). - **Remover variação ‹n›**: Tira aquela variação. - **Inserir emoji na variação ‹n›**: Abre o seletor de emoji no campo. - **Inserir emoji na mensagem do Direct**: Abre o seletor de emoji na mensagem. - **+ Adicionar botão**: Acrescenta um botão com texto e link (até 3). - **Gatilho: remover botão ‹n›**: Tira aquele botão. - **Criar gatilho**: Salva o gatilho novo (no editar, o botão diz Salvar gatilho). - **Salvar gatilho**: Grava as mudanças do gatilho em edição. - **Cancelar**: Fecha o formulário sem salvar. Também aparece: - Galeria **Escolha a publicação** com miniaturas, Reels marcados e a data; sem publicações ou com erro, a tela sugere colar o link. - Prévia **Prévia — como a pessoa vê no Direct**, com um @ de exemplo no lugar de {nome} e os botões. - Erros aparecem em aviso vermelho antes de salvar (palavra vazia, publicação não escolhida, botão sem título ou com link sem https://). ##### Diálogo Remover o gatilho Quem comentar a palavra deixa de receber resposta pública e mensagem na hora; as conversas e leads já criados ficam. Botões e ações: - **Cancelar**: Fecha sem remover. - **Remover gatilho**: Apaga o gatilho. ##### Estados da tela - Carregando: Blocos cinzas no lugar dos cartões. - Sem nada ainda: **Nenhuma conta de Instagram conectada.** com o botão **Ir para Conexões**. - Se der erro: **Não foi possível carregar as suas contas de Instagram**, avisando que nada do que foi configurado se perdeu, com Tentar de novo. - Canal Instagram não habilitado na conta: **O canal Instagram ainda não está disponível na sua conta.** - Permissão de comentários da Meta ainda não liberada: **Este recurso está em aprovação da Meta**: o Direct, boas-vindas, perguntas de abertura e stories funcionam; gatilhos, IA nos comentários, moderação e lives aguardam a aprovação. #### Instagram — IA nos comentários A tela IA nos comentários serve para decidir se a IA responde em público quem comenta sem digitar a palavra do gatilho, como “quanto custa?”, e quem aprova: você na mesa de revisão ou a própria IA nas categorias que você liberar. Endereço no painel: `/app/conexoes/instagram/ia` ![Captura da tela Instagram — IA nos comentários. A tela IA nos comentários serve para decidir se a IA responde em público quem comenta sem digitar a palavra do gatilho, como “quanto custa?”, e quem aprova: você na mesa de revisão ou a própria IA nas categorias que você liberar.](https://attendto.com.br/prints-do-manual/instagram--ia-nos-comentarios.png) A tela Instagram — IA nos comentários na conta de demonstração, com dados fictícios e os valores desfocados. ##### A IA responde comentários: as três posições Escolha como a IA age nos comentários desta conta. Botões e ações: - **Desligado**: O padrão: só os gatilhos escritos por você respondem; a IA não escreve nada em público. - **Sugerir**: A posição recomendada: a IA escreve e a resposta espera na mesa de revisão; nada sai sem um humano aprovar. - **Automático por categoria**: As categorias que você ligar saem sozinhas; as outras continuam vindo para a mesa. Também aparece: - A posição recomendada vem marcada com o selo **recomendado**. ##### Mesa de revisão Uma sugestão por vez: o comentário e a publicação à esquerda, o rascunho editável, o porquê e a fonte à direita. Desligada, a mesa fica esmaecida só para mostrar o que você ganha ao ligar. Campos e filtros: - **Rascunho da IA — edite se quiser**: O texto que vai ser publicado. Sem fonte na sua base, o campo vem vazio com o rótulo **Escreva a resposta**. Botões e ações: - **Aprovar e responder**: Publica o texto do campo como resposta ao comentário no Instagram. Atalho: tecla A. - **Editar**: Leva o cursor para o rascunho. Atalho: tecla E. - **Descartar**: Tira a sugestão da fila sem publicar; o descarte fica registrado na moderação. Atalho: tecla D. - **Inserir emoji na resposta**: Abre o seletor de emoji no rascunho, no ponto do cursor. Também aparece: - Cabeçalho **Aguardando você** com a barra de progresso e **‹n› de ‹m›** da sessão de revisão. - O autor, há quanto tempo, **comentário público** e a categoria (Pergunta de preço, Elogio, Dúvida de horário, Reclamação ou Outro assunto). - Contador **‹n›/‹limite›** que conta como o servidor (emoji conta um); acima do limite da resposta curta a tela avisa, e acima do que o Instagram aceita o botão de aprovar fica bloqueado. - **Por que sugeri isto:** com o motivo, e **fonte: “…”** ou **sem fonte na sua base — o texto é seu**. - Aviso quando foi a regra da fonte que segurou o rascunho, e quando o comentário já não está no Instagram (só dá para descartar). - Os atalhos não disparam com o foco num campo de texto nem com o seletor de emoji aberto. - Vazio: **Fila vazia** — nada esperando por você. - Editar antes de aprovar guarda a sua versão como exemplo da sua voz (ver A sua voz). ##### Automático por categoria Cada categoria ligada sai sem passar pela mesa. Os interruptores só ficam disponíveis com a posição Automático por categoria escolhida. Botões e ações: - **Responder ‹categoria› automaticamente**: Liga ou desliga a categoria (pergunta de preço, elogio, dúvida de horário). Reclamação aparece desligada e não pode ser ligada. - **Publicar sozinha mesmo sem fonte na base**: Nasce desligado e só vale no automático: ligado, as categorias escolhidas saem mesmo sem fonte na sua base, sem ninguém ler antes. Preço e horário continuam pedindo fonte; reclamação segue fora. Também aparece: - Cada categoria mostra exemplos de comentário (“quanto custa?”, “adorei”, “abre no sábado?”). - A regra da fonte: uma categoria ligada só sai sozinha quando a resposta tem lastro na sua base de conhecimento. ##### Como ela escreve O comprimento e o emoji da resposta pública; a persona da conta continua mandando no resto da voz. Botões e ações: - **Usar emoji nas respostas públicas**: Liga ou desliga o emoji nas respostas que a IA escreve. Os seus campos continuam com o seletor de emoji. Também aparece: - A resposta sai curta; passou do limite, não sai sozinha e vem para a mesa marcada longa demais. ##### A sua voz Pares de comentário e resposta que ensinam o jeito de responder da sua conta, sem treinar modelo nenhum. Campos e filtros: - **Um comentário**: Um comentário de exemplo, como “quanto custa?”. - **Como VOCÊ responderia**: A sua resposta para ele, com contador do limite do canal. Botões e ações: - **Guardar exemplo**: Acrescenta o par à lista; com a lista cheia, o próximo empurra o mais antigo para fora. - **Remover o exemplo “‹comentário›”**: Abre a confirmação de remover aquele exemplo. - **Desfazer**: Aparece depois que uma correção sua na mesa virou exemplo; volta a lista como estava. - **Inserir emoji no comentário do exemplo**: Seletor de emoji no campo do comentário. - **Inserir emoji na sua resposta**: Seletor de emoji no campo da resposta. Também aparece: - Lista **Comentário: “…” / Você responderia: “…”** e o contador **‹n› de ‹m›**. - Aviso quando algum exemplo é mais longo que o limite do canal: a IA mantém o tom, encurtando. ##### Diálogo Remover este exemplo da sua voz? A IA deixa de usar o exemplo; as respostas já publicadas ficam. Não dá para desfazer. Botões e ações: - **Cancelar**: Fecha sem remover. - **Remover exemplo**: Remove o exemplo. ##### Estados da tela - Carregando: Blocos cinzas no lugar das posições e da mesa. - Se der erro: **Não foi possível carregar a IA nos comentários** (a configuração continua valendo) ou **Não foi possível carregar a fila de revisão** (nenhuma sugestão foi perdida), com Tentar de novo. #### Instagram — Boas-vindas no Direct A tela Boas-vindas no Direct serve para receber quem chama a empresa no Direct pela primeira vez com um texto seu, um áudio gravado por você, ou os dois, antes de a IA assumir. Endereço no painel: `/app/conexoes/instagram/boas-vindas` ![Captura da tela Instagram — Boas-vindas no Direct. A tela Boas-vindas no Direct serve para receber quem chama a empresa no Direct pela primeira vez com um texto seu, um áudio gravado por você, ou os dois, antes de a IA assumir.](https://attendto.com.br/prints-do-manual/instagram--boas-vindas.png) A tela Instagram — Boas-vindas no Direct na conta de demonstração, com dados fictícios e os valores desfocados. ##### Boas-vindas no Direct Sai uma vez por pessoa, no primeiro contato espontâneo. Quem chega por gatilho de comentário recebe a mensagem do gatilho, não esta. Campos e filtros: - **Formato das boas-vindas**: Desligadas, Texto, Áudio gravado ou Áudio + texto. - **Texto das boas-vindas** (obrigatório): Até 1.000 caracteres; aparece com os formatos que têm texto. - **Botões na mensagem**: Até 3, com link; acompanham o texto (só áudio não leva botão). - **Versão para quem segue a conta**: Opcional: texto e botões próprios para quem já segue o perfil; em branco, a versão geral vale para todos. O áudio é o mesmo nas duas. - **Botões da versão de seguidor**: Aparecem quando a versão de seguidor tem texto. Botões e ações: - **Desligadas**: Sem boas-vindas: a IA responde direto. - **Texto**: Boas-vindas só em texto. - **Áudio gravado**: Boas-vindas só em áudio. - **Áudio + texto**: Áudio e texto juntos. - **Gravar as boas-vindas**: Começa a gravar pelo microfone (o mesmo gravador do Inbox). - **Parar a gravação**: Encerra a gravação e mostra a prévia para ouvir. - **Regravar do zero**: Com uma gravação nova na tela, descarta e grava outra. - **Descartar a gravação**: Joga fora a gravação ainda não salva. - **Remover o áudio salvo**: Tira o áudio que está valendo (vale ao salvar). - **Enviar arquivo de áudio**: Aparece quando o navegador só grava num formato que o Instagram não aceita: envie um M4A, MP3 ou OGG gravado no celular. - **Tentar de novo**: Recarrega o áudio salvo quando ele não carregou. - **Inserir emoji no texto das boas-vindas**: Seletor de emoji no texto. - **Inserir emoji na versão para quem segue**: Seletor de emoji na versão de seguidor. - **+ Adicionar botão**: Acrescenta um botão com texto e link. - **Salvar boas-vindas**: Grava formato, texto, botões, versão de seguidor e áudio. Também aparece: - **Gravando… ‹m:ss›** enquanto grava; **O navegador bloqueou o microfone — libere nas permissões do site.** quando não há permissão. - Prévia da mensagem como a pessoa vê no Direct, para a versão geral e a de seguidor. - Avisos **O Instagram recusou o áudio no último envio.** e **O Instagram recusou os botões das boas-vindas no último envio.**: o texto continuou saindo e o aviso some no próximo envio aceito. - Erros antes de salvar: texto vazio num formato com texto, áudio faltando num formato com áudio, botões inválidos. ##### Estados da tela - Carregando: Blocos cinzas no lugar do formulário. - Se der erro: O mesmo aviso das telas do Instagram: **Não foi possível carregar as suas contas de Instagram**, com Tentar de novo. #### Instagram — Perguntas de abertura A tela Perguntas de abertura serve para escrever até 4 perguntas prontas que o Instagram mostra a quem abre o seu Direct pela primeira vez; o toque vira a primeira mensagem e o seu atendimento responde. Endereço no painel: `/app/conexoes/instagram/perguntas` ![Captura da tela Instagram — Perguntas de abertura. A tela Perguntas de abertura serve para escrever até 4 perguntas prontas que o Instagram mostra a quem abre o seu Direct pela primeira vez; o toque vira a primeira mensagem e o seu atendimento responde.](https://attendto.com.br/prints-do-manual/instagram--perguntas-de-abertura.png) A tela Instagram — Perguntas de abertura na conta de demonstração, com dados fictícios e os valores desfocados. ##### Perguntas de abertura A vitrine de assuntos do Direct, uma lista por conta conectada. Campos e filtros: - **Pergunta de abertura ‹n›**: Até 80 caracteres, com o contador ‹n›/80 ao lado. Botões e ações: - **Remover a pergunta ‹n›**: Tira aquela pergunta da lista. - **Adicionar pergunta**: Acrescenta um campo (até 4). - **Salvar perguntas**: Envia as perguntas ao Instagram. Fica apagado sem mudança ou com pergunta acima do limite. Também aparece: - Pergunta longa demais: **O Instagram aceita até 80 caracteres por pergunta.** - Aviso quando a lista vai vazia: salvar sem nenhuma pergunta **remove as perguntas do Direct**. - Quem toca numa pergunta é respondido pelo atendimento de sempre: boas-vindas (se ligadas) e depois a IA. ##### Estados da tela - Carregando: Um bloco cinza no lugar da lista. #### Instagram — Stories A tela Stories serve para decidir o que acontece quando alguém marca a sua conta num story (agradecimento fixo no Direct) e explica como chegam as respostas aos seus stories. Endereço no painel: `/app/conexoes/instagram/stories` ![Captura da tela Instagram — Stories. A tela Stories serve para decidir o que acontece quando alguém marca a sua conta num story (agradecimento fixo no Direct) e explica como chegam as respostas aos seus stories.](https://attendto.com.br/prints-do-manual/instagram--stories.png) A tela Instagram — Stories na conta de demonstração, com dados fictícios e os valores desfocados. ##### Menção em story A pessoa marcou a sua conta no story dela: vira lead na hora, com a menção registrada na conversa. Campos e filtros: - **Texto do agradecimento**: O texto fixo enviado no Direct, até 500 caracteres, com o contador ‹n›/500. A IA não improvisa em cima de menção. Botões e ações: - **Agradecer no Direct quando alguém mencionar a sua conta num story**: Liga o envio do agradecimento na próxima menção. Nasce desligado. - **Salvar**: Grava a chave e o texto. Fica apagado sem mudança, com texto acima do limite ou com a chave ligada sem texto. Também aparece: - Aviso: cada agradecimento enviado **debita 1 mensagem do Instagram do saldo**; sem saldo, a menção entra no Inbox sem a resposta automática. - Erros: **O agradecimento precisa ter até 500 caracteres.** e **Escreva o texto do agradecimento antes de ligar o envio.** ##### Resposta a story Nada para configurar. Também aparece: - A resposta a um story seu chega no Inbox como qualquer mensagem, marcada **“Respondeu ao seu story”**, e o atendimento de sempre responde. ##### Estados da tela - Carregando: Um bloco cinza no lugar do cartão da menção. #### Instagram — Lives A tela Lives serve para ligar, por conta, os gatilhos de conta inteira também nos comentários das suas lives, com teto próprio por hora. Endereço no painel: `/app/conexoes/instagram/lives` ![Captura da tela Instagram — Lives. A tela Lives serve para ligar, por conta, os gatilhos de conta inteira também nos comentários das suas lives, com teto próprio por hora.](https://attendto.com.br/prints-do-manual/instagram--lives.png) A tela Instagram — Lives na conta de demonstração, com dados fictícios e os valores desfocados. ##### Gatilhos nas lives Quem comenta a palavra durante a live recebe a mesma mensagem no Direct. Botões e ações: - **Responder gatilhos também nos comentários das suas lives**: Liga ou desliga, valendo na hora. Nasce desligado. Também aparece: - Valem só os gatilhos de conta inteira; a tela diz quantos você tem ativos (ou sugere criar um em Gatilhos com a opção de conta inteira). Gatilho preso a um post não olha a live. - A mensagem no Direct só sai enquanto a live está no ar; se ela acabar antes, a tentativa fica registrada na Moderação com o motivo. - Teto próprio por hora, mais apertado que o dos posts. Cada mensagem enviada debita 1 mensagem do Instagram do saldo; triagem da IA, a regra de uma mensagem por pessoa em 24 horas e o opt-out continuam valendo. ##### Estados da tela - Carregando: Um bloco cinza no lugar do cartão. - Permissão de comentários da Meta ainda não liberada: **Este recurso está em aprovação da Meta**. #### Instagram — Comentários e moderação A tela Comentários e moderação serve para ver cada comentário que passou pelos gatilhos com a decisão tomada, filtrar por situação, gatilho, publicação, período e autor, e ocultar, reexibir ou apagar comentários com confirmação. Endereço no painel: `/app/conexoes/instagram/moderacao` ![Captura da tela Instagram — Comentários e moderação. A tela Comentários e moderação serve para ver cada comentário que passou pelos gatilhos com a decisão tomada, filtrar por situação, gatilho, publicação, período e autor, e ocultar, reexibir ou apagar comentários com confirmação.](https://attendto.com.br/prints-do-manual/instagram--moderacao.png) A tela Instagram — Comentários e moderação na conta de demonstração, com dados fictícios e os valores desfocados. ##### Filtros da moderação Os filtros se somam e a lista aperta a cada escolha. O número dentro de cada situação conta o recorte que você já escolheu. Botões e ações: - **‹situação› ‹n›**: A fileira de situações: Todos, Respondidos, Respondidos pela IA, Barrados pela IA, Sugestões, Ocultados e Apagados. Setas esquerda e direita (e Home e End) andam pela fileira; Enter ou espaço escolhe. - **Gatilho**: Mostra só os comentários pegos por uma palavra. - **Publicação**: Mostra só os comentários de um post ou Reel. - **Período**: Hoje, Últimos 7 dias, Últimos 30 dias ou Todo o período, no fuso da conta. - **‹filtro›: todos**: Primeira opção de cada menu: desliga aquele filtro. - **Remover o filtro ‹nome›**: O x da pílula de filtro ligada: desliga aquele filtro. - **Buscar por autor do comentário**: Campo **Buscar @autor**: um pedaço do @ basta, com ou sem arroba. A busca roda quando você para de digitar ou aperta Enter. - **Limpar a busca por autor**: Apaga o texto da busca. Também aparece: - Em contas com histórico longo, a busca por autor avisa até onde procurou; escolher uma publicação ou um período faz ela ir mais fundo. ##### Lista de comentários As sugestões de ocultar ficam destacadas no topo em qualquer filtro; o resto vem do mais novo para o mais antigo e carrega mais ao rolar. Botões e ações: - **Atualizar**: Pergunta ao Instagram, um por um, quais comentários da lista ainda existem e marca os que foram apagados direto no aplicativo. Confere um lote por clique e diz quantos ficaram para o próximo clique. - **Ocultar**: Abre a confirmação para esconder o comentário do público (tem volta). - **Reexibir**: Aparece no comentário oculto; abre a confirmação para mostrá-lo de novo. - **Apagar**: Abre a confirmação para remover o comentário do perfil para sempre. - **Ver todos os comentários**: Aparece na lista vazia com filtro ligado; desliga todos os filtros. Também aparece: - Cada comentário mostra o autor, os selos **Sugerimos ocultar**, **Oculto**, **Apagado** ou **Apagado no Instagram**, o texto, a decisão com o motivo e a data. - Comentário apagado fica na lista, riscado e sem botões. - **E mais ‹n› sugestões de ocultar esperando decisão** quando há mais sugestões do que as mostradas no topo. - Rodapé: a IA nunca oculta nem apaga sozinha; ocultar tem volta, apagar não tem. - Vazio sem filtro: **Nenhum comentário passou pelos gatilhos ainda.** Vazio com filtro: a frase da situação com o recorte (por exemplo, nenhum comentário barrado pela IA nos últimos 7 dias). ##### Diálogo de moderação Ocultar este comentário?, Reexibir este comentário? ou Apagar este comentário do seu post?, sempre com o texto e o autor do comentário dentro do diálogo. Botões e ações: - **Cancelar**: Fecha sem fazer nada. - **Ocultar comentário**: Esconde o comentário do post para o público; quem escreveu não é avisado. - **Reexibir comentário**: O comentário volta a aparecer no post. - **Apagar de vez**: Remove o comentário do seu perfil público, para sempre. Também aparece: - Se o comentário já não existia no Instagram, a tela avisa e atualiza a linha em vez de mostrar erro. ##### Estados da tela - Carregando: Blocos cinzas no lugar da barra de filtros e da lista. - Se der erro: **Não foi possível carregar os comentários**, explicando que os comentários continuam no seu post, com Tentar de novo. - Permissão de comentários da Meta ainda não liberada: **Este recurso está em aprovação da Meta**. ### Passo a passo #### Como criar um gatilho de comentário no Instagram 1. No menu **Instagram**, abra **Gatilhos** (com mais de uma conta, escolha a conta no topo). 2. Clique em **Novo gatilho**. 3. Escreva a **Palavra ou frase combinada** (por exemplo, EU QUERO). 4. Em **Onde vale**, escolha **Uma publicação ou Reel** e selecione a publicação, ou use **Qualquer publicação ou Reel** ou **A próxima publicação ou Reel**. 5. Se quiser, clique em **+ Adicionar variação** e escreva até 3 respostas públicas. 6. Escreva a **Mensagem no Direct** usando {nome}, acrescente botões com **+ Adicionar botão** e confira a prévia. 7. Clique em **Criar gatilho** e confirme que a chave geral diz **ligados**. #### Como desligar todos os gatilhos de uma conta de uma vez 1. Em **Instagram — Gatilhos de comentário**, escolha a conta. 2. Clique no interruptor da chave geral: a situação muda para **desligados** e vale na hora. 3. Para religar, clique de novo; se a plataforma pausou os gatilhos, revise os textos e use **Religar gatilhos**. #### Como ligar a IA para responder comentários com revisão 1. No menu **Instagram**, abra **IA nos comentários**. 2. Escolha **Sugerir**. 3. Quando um comentário chegar, leia o rascunho, o **Por que sugeri isto** e a fonte. 4. Clique em **Aprovar e responder** (tecla A), edite antes se quiser (tecla E) ou **Descartar** (tecla D). 5. Para automatizar depois, escolha **Automático por categoria** e ligue só as categorias que quiser. #### Como configurar a mensagem de boas-vindas no Direct 1. No menu **Instagram**, abra **Boas-vindas**. 2. Escolha o formato: **Texto**, **Áudio gravado** ou **Áudio + texto**. 3. Para áudio, clique em **Gravar as boas-vindas**, fale e clique em **Parar a gravação**; ouça a prévia. 4. Escreva o **Texto das boas-vindas** e, se quiser, a **Versão para quem segue a conta**. 5. Clique em **Salvar boas-vindas**. #### Como cadastrar perguntas de abertura no Direct 1. No menu **Instagram**, abra **Perguntas de abertura**. 2. Escreva até 4 perguntas de até 80 caracteres, usando **Adicionar pergunta** para mais campos. 3. Clique em **Salvar perguntas**; o Instagram passa a mostrá-las a quem abre o Direct pela primeira vez. #### Como agradecer automaticamente quem marca a sua conta num story 1. No menu **Instagram**, abra **Stories**. 2. Escreva o **Texto do agradecimento**. 3. Ligue **Agradecer no Direct quando alguém mencionar a sua conta num story**. 4. Clique em **Salvar**. #### Como ocultar ou apagar um comentário pelo painel 1. No menu **Instagram**, abra **Moderação**. 2. Ache o comentário com a fileira de situações, os filtros **Gatilho**, **Publicação** e **Período** ou a busca por @autor. 3. Clique em **Ocultar** (tem volta) ou **Apagar** (não tem volta). 4. Confira o texto e o autor no diálogo e clique em **Ocultar comentário** ou **Apagar de vez**. ### Perguntas frequentes #### Por que o menu Instagram não aparece no meu painel? O grupo só existe quando o canal Instagram está habilitado na conta, e ele não aparece para o papel atendente. Com o canal habilitado, conecte a conta profissional em Conexões para usar as telas. #### Por que a tela de Gatilhos diz que o recurso está em aprovação da Meta? Gatilhos, IA nos comentários, Moderação e Lives dependem da permissão de comentários da Meta. Enquanto ela não estiver liberada para a sua conta, essas telas mostram o aviso; Direct, boas-vindas, perguntas de abertura e stories já funcionam. #### Com duas contas de Instagram, preciso escolher a conta em cada tela? Não. O seletor no topo aparece com mais de uma conta, e a conta escolhida vale para todas as telas do menu Instagram até você trocar. #### Os atalhos A, E e D da mesa podem publicar algo sem querer? Não enquanto você digita: eles não funcionam com o foco num campo de texto, com o seletor de emoji aberto ou com o foco em outra parte da página. Só valem com a mesa ligada e uma sugestão na tela. #### Qual a diferença entre Remover um gatilho e desligar o interruptor dele? Desligar pausa o gatilho e mantém tudo para religar depois. Remover apaga o gatilho; em ambos os casos, quem comentar a palavra deixa de receber mensagem na hora, e as conversas e leads já criados ficam. #### Posso mandar um arquivo de áudio em vez de gravar as boas-vindas no navegador? Pode, quando o navegador só grava num formato que o Instagram não aceita: a tela mostra Enviar arquivo de áudio, e você envia um M4A, MP3 ou OGG gravado no celular. #### O que acontece se eu salvar as perguntas de abertura com a lista vazia? As perguntas saem do Direct e quem abrir a conversa volta a ver só o campo de digitação. A tela avisa antes de salvar. #### Por que o botão Atualizar da moderação não confere todos os comentários de uma vez? Cada comentário é conferido com uma consulta ao Instagram, então cada clique confere uma parte da lista. A mensagem diz quantos conferiu, quantos sumiram e quantos faltam para o próximo clique. ### Guia: Instagram — Gatilhos, IA nos comentários e boas-vindas Transformar comentário em conversa no Direct — "comenta CRM que minha equipe entra em contato" — e receber bem quem chama espontaneamente, com a sua mensagem de boas-vindas e a IA atendendo depois. Esta tela cuida dos dois jeitos de o Instagram virar conversa: quem te chama **no Direct** por conta própria e quem **comenta uma publicação** respondendo ao seu convite. O conectar da conta continua em [Conexões](https://attendto.com.br/manual/conexoes) — aqui você configura o que acontece depois que ela está conectada: os gatilhos de comentário, as boas-vindas de cada conta e a moderação dos comentários. > **Os recursos de comentário dependem de uma permissão da Meta:** O Direct, as boas-vindas, as perguntas de abertura e as respostas e menções em story funcionam em toda conta com o Instagram conectado. Os **gatilhos de comentário**, a **IA nos comentários**, a **moderação** e as **lives** dependem de uma permissão que a Meta ainda não liberou para a plataforma; até lá, essas telas mostram o aviso e só abrem nas contas do programa de testes. #### Antes de começar: a conta conectada O Instagram só entrega mensagens de **conta Profissional** — Comercial ou Criador de conteúdo. Perfil pessoal não recebe mensagem por aplicativo, é regra deles para qualquer ferramenta. A conexão é feita no cartão do Instagram em [Conexões](https://attendto.com.br/manual/conexoes), e termina com um teste simples e obrigatório: **mande um "oi" para a sua conta de outro perfil** (o celular de um colega serve). A conexão só fica pronta quando esse oi chega aqui — é a prova de que o caminho inteiro funciona, em vez de um verde por otimismo. Com mais de uma conta conectada, tudo nesta tela é **por conta**: o seletor no topo escolhe qual, e cada uma tem os próprios gatilhos, as próprias boas-vindas e os próprios números. #### O gatilho de comentário, do anúncio à conversa A ideia inteira cabe numa frase que você mesmo publica: **"comenta CRM que minha equipe entra em contato"**. Você cria o gatilho aqui antes de postar; daí em diante, quem comentar a palavra recebe a sua resposta no comentário (se você quiser) e **uma mensagem sua no Direct**. Quando a pessoa responde essa mensagem, a IA assume a conversa, qualifica como em qualquer canal e o lead entra no [Funil](https://attendto.com.br/manual/funil). 1. **Escolha a conta**: No seletor do topo. O gatilho pertence a uma conta — os números e os textos dele também. 2. **Escolha a publicação**: Três modos: **uma publicação** (escolha na lista ou cole o link do post ou Reel), **qualquer publicação** (a palavra vale na conta inteira — para quem anuncia a mesma palavra na bio) ou **a próxima publicação** — o gatilho fica armado e se prende sozinho à primeira que você postar depois de criá-lo. O caminho comum é por publicação: campanhas diferentes usam palavras diferentes. 3. **Escreva a palavra**: Uma palavra ou frase **exata**. Maiúsculas e acentos não importam — "CRM", "crm" e "Crm!" são a mesma coisa —, mas não existe sinônimo nem quase-igual: "precinho" **não** aciona um gatilho de "preço". A palavra é o combinado público entre você e quem comenta; quanto mais curta e fácil de digitar, melhor. 4. **Escreva a resposta pública (se quiser)**: É o que aparece embaixo do comentário da pessoa, no próprio post. Você pode escrever **até 3 variações** — elas são sorteadas para as respostas não saírem todas idênticas, uma embaixo da outra. Dá para desligar e deixar só a mensagem no Direct. 5. **Escreva a mensagem do Direct**: É o seu texto, não o da IA. Use **{nome}** para incluir o @ da pessoa (é o nome que o Instagram nos entrega no comentário) e diga quem está falando: a pessoa está saindo de um comentário público para a caixa de entrada dela. Se quiser, acrescente **até 3 botões com link** — para o site, o catálogo, o agendamento. 6. **Ligue e publique**: Salve o gatilho, confira a chave geral da conta e publique o post com o convite. A tela mostra desde quando os gatilhos estão ligados; desligar é um clique e vale na hora. Na tela: Tela de gatilhos do Instagram com a conta conectada no topo, o funil do que os gatilhos produziram, a lista de gatilhos e o começo do painel de comentários. A tela inteira do recurso: a conta, os números, os gatilhos criados e o começo da moderação. 1. **A conta e a chave geral**: Com mais de uma conta conectada, o seletor aqui escolhe qual você está configurando. A chave **desliga todos os gatilhos da conta** num clique — e religa do mesmo jeito, valendo na hora. 2. **O funil do recurso**: Comentários pegos, DMs enviadas, conversas abertas e leads no funil — e, com o mesmo destaque, **o que não virou mensagem e por quê**: triagem, tetos, pedidos de não contato. Queda aparece como queda, com nome. 3. **Os gatilhos criados**: Um por linha: a palavra, onde ela vale (uma publicação escolhida ou a conta inteira) e o que sai — resposta pública e DM. **Editar** abre o mesmo formulário do criar; a chavinha desliga só aquele gatilho. > **A IA lê o comentário antes de qualquer resposta sair:** Palavra certa não basta. "CRM? isso aí é golpe" e "caro demais esse CRM" contêm a palavra e **não recebem** mensagem: uma triagem por IA lê cada comentário que bateu a palavra e barra sarcasmo, ofensa e spam, com o motivo registrado. É o que impede o gatilho de responder exatamente quem não devia. > **Os botões com link podem chegar na segunda mensagem:** O Instagram às vezes recusa botões no primeiro envio feito a partir de um comentário. Quando isso acontece, o texto da sua mensagem vai primeiro, sozinho — e os botões chegam assim que a pessoa responder. Você não precisa fazer nada; a tela de prévia avisa quando esse é o caso. #### Uma mensagem só — e por que isso te protege A partir de um comentário, o Instagram permite **uma única mensagem** no Direct — regra deles, sem exceção, e com prazo: o comentário tem de ter **menos de 7 dias**. Se a pessoa não responder, não existe segunda tentativa. Pode parecer pouco, mas é essa regra que mantém o recurso saudável: quem recebe uma mensagem depois de comentar entende o porquê; quem recebesse cinco denunciaria como spam — e denúncia atinge **a sua conta**, não a nossa. Por isso a mensagem do gatilho é a que mais merece capricho: ela precisa se apresentar, lembrar o comentário e convidar a resposta — porque **é a resposta da pessoa que abre a conversa de verdade**. #### Os tetos — e o porquê de cada um Os limites abaixo já vêm ligados, de propósito. O limite técnico do Instagram é bem mais alto; o limite que importa é o da **denúncia** — uma conta que dispara demais vira alvo de "marcar como spam", e isso derruba o alcance de tudo que você posta: - **30 mensagens por publicação, por hora**: Um Reel que viraliza de madrugada não pode virar centenas de mensagens em minutos. O excedente fica registrado — você vê o volume e decide se sobe o teto. - **200 mensagens por conta, por dia**: O ritmo de uma conta saudável. Bem abaixo do que o Instagram tecnicamente permite, de propósito. - **1 mensagem por pessoa a cada 24 horas**: Quem comenta em cinco posts seus recebe **uma** mensagem, não cinco. - **7 dias por comentário**: Comentário mais velho que isso não recebe mensagem — é o prazo do próprio Instagram. Quando um teto segura alguém, nada é escondido: o comentário aparece no painel como **barrado**, com o motivo. Você vê o que deixou de sair e decide com o número na frente. #### Boas-vindas: a primeira fala é sua Para quem chama a sua conta **espontaneamente no Direct**, você pode fixar uma recepção sua: um **texto**, um **áudio gravado** por você (o gravador está na própria tela) ou os dois. Ela sai **antes** de a IA improvisar qualquer coisa — a primeira impressão fica com a sua voz — e **só no primeiro contato** de cada pessoa: quem já conversou com você não recebe boas-vindas de novo a cada mensagem. - É por conta: cada conta conectada tem as próprias boas-vindas — a da loja pode ser diferente da do consultório. - Quem chegou por gatilho de comentário recebe a mensagem do gatilho, não as boas-vindas — a apresentação já foi feita ali. - Sem boas-vindas configuradas, a IA responde direto, como em qualquer canal. - Você pode pôr **emoji** no texto pelo mesmo seletor do [Inbox](https://attendto.com.br/manual/inbox) — é o mesmo em todos os campos de conteúdo do canal, inclusive na mensagem do gatilho. Se quiser, escreva **duas versões**: uma geral e uma **para quem já segue a sua conta**. São textos e botões próprios de cada uma — o **áudio é o mesmo nas duas**, você não grava duas vezes. Na hora de mandar, perguntamos ao Instagram se aquela pessoa segue e escolhemos a versão certa. - **Deixou a versão de seguidor em branco?** A geral vale para todo mundo — nada quebra, e ninguém fica sem recepção. - **Quem não segue recebe a geral.** E **quem o Instagram não respondeu** também recebe a geral: na dúvida, a mensagem que serve para qualquer pessoa. - A prévia mostra as duas lado a lado, do jeito que vão chegar. #### Perguntas de abertura: a vitrine do seu Direct Quem abre o Direct da sua conta pela primeira vez pode ver até **4 perguntas prontas** antes de digitar — "Quais são os preços?", "Como funciona a entrega?". Você as escreve na tela **Perguntas de abertura** do menu Instagram; quem exibe é o próprio Instagram. - **O toque vira a primeira mensagem da pessoa** — e quem responde é o seu atendimento de sempre: boas-vindas fixas (se ligadas), depois a IA com a sua persona e a sua base. Não existe resposta fixa escondida na pergunta. - Cada pergunta aceita até **80 caracteres**, e a lista vale por conta conectada. - **Salvar sem nenhuma pergunta remove as do Direct** — a tela avisa antes. - Elas aparecem para quem abre a conversa pela primeira vez; quem já falou com a conta vê o histórico normal. #### Stories: respostas e menções Story movimenta o Direct de dois jeitos, e a tela **Stories** do menu Instagram cuida dos dois. Quando alguém **responde a um story seu**, a resposta chega no Inbox como qualquer mensagem — marcada com "Respondeu ao seu story", para o atendente saber de onde veio — e o atendimento de sempre responde. Nada para configurar. - **Menção em story**: a pessoa marcou a sua conta no story dela. Ela vira lead na hora, com a menção registrada na conversa — com ou sem agradecimento. - Se você **ligar o agradecimento** na tela Stories, a próxima menção recebe a sua mensagem fixa no Direct (até 500 caracteres). O texto é seu; a IA não improvisa em cima de menção. - Cada agradecimento enviado **debita 1 mensagem do Instagram do saldo**, como qualquer envio do canal. Sem saldo, a menção entra no Inbox sem a resposta automática — nada some. - O agradecimento nasce **desligado** em toda conta: envio que custa saldo é você quem liga. #### Lives: os gatilhos ao vivo Na tela **Lives** do menu Instagram você liga, por conta, os gatilhos também nos comentários das suas lives. Valem os **gatilhos de conta inteira** (gatilho preso a um post específico não olha a live) — quem comenta a palavra durante a live recebe a mesma mensagem no Direct, com triagem da IA, regra de mesma pessoa em 24h e opt-out funcionando como sempre. - A resposta no Direct **só sai enquanto a live está no ar** — regra do Instagram. Se a live acabar antes, a tentativa fica registrada na Moderação com o motivo, e nada trava os seus gatilhos de post. - O teto da live é próprio e mais apertado: até **20 mensagens por live por hora** (nos posts são 30). - Cada mensagem enviada debita 1 mensagem do Instagram do saldo, como nos gatilhos de sempre. - A chave nasce **desligada** em toda conta. #### Os números do gatilho Cada gatilho (e a conta, no agregado) mostra o funil inteiro do recurso, sem vaidade: - **Comentários pegos**: Comentários que bateram a palavra e passaram na triagem. - **DMs enviadas**: Mensagens de gatilho que saíram de fato. - **Conversas abertas**: Pessoas que responderam a mensagem — é o "clique" deste canal, o momento em que a IA assume. - **Leads no funil**: Leads nascidos do gatilho, com o corte quente e morno da qualificação. E, com o mesmo destaque, o que **não** virou mensagem e por quê: barrados pela triagem (com o motivo mais comum), barrados por teto, pedidos de não contato. Queda não aparece como tela vazia — aparece como queda, com nome. #### A IA respondendo comentários O gatilho responde quem digitou a palavra combinada. Mas muita gente comenta **"quanto custa?"**, **"abre sábado?"** ou **"adorei"** sem digitar palavra nenhuma — e até aqui essas pessoas não recebiam nada. É isso que a IA nos comentários resolve: ela lê o comentário, escreve uma resposta pública curta, no tom da sua conta, e **você decide quem aperta o botão**. Na tela: A seção da IA nos comentários inteira: as três posições no topo, a mesa de revisão com uma sugestão, as categorias automáticas com os quatro interruptores e o interruptor de publicar sem fonte na base, o bloco Como ela escreve e o bloco A sua voz. As três posições, a mesa de revisão e a sua voz — tudo por conta conectada. 1. **As três posições**: **Desligado** é como a conta nasce: só os gatilhos funcionam. **Sugerir** é o recomendado — a IA escreve e nada sai sem você aprovar. **Automático por categoria** deixa você escolher o que sai sozinho. 2. **A mesa de revisão**: Uma sugestão por vez: o comentário e a publicação à esquerda; o rascunho **editável**, o porquê e a fonte à direita. Os atalhos **A** (aprovar), **E** (editar) e **D** (descartar) funcionam de verdade. Quando foi a falta de fonte que segurou o rascunho, a mesa **diz isso** e mostra onde fica o interruptor que a afrouxa. 3. **Automático por categoria**: Preço, elogio e horário podem sair sozinhos. **Reclamação não** — o interruptor dela é travado, e o motivo está escrito logo abaixo. Nesta foto a conta está em **Sugerir**, então todos aparecem apagados: eles só ficam disponíveis no automático. Por padrão, mesmo nas categorias que você ligar só sai sozinha a resposta com **fonte na sua base de conhecimento** — e o último interruptor, **Publicar sozinha mesmo sem fonte na base**, é o que abre mão disso por sua conta e risco. 4. **A sua voz**: Exemplos de como VOCÊ responderia. **Três já ensinam** a sua voz e cabem dez — o décimo primeiro empurra o mais antigo para fora. O contador ao lado do botão diz quantos você já guardou (nesta foto, **1 de 10**). Toda vez que você edita um rascunho antes de aprovar, a sua correção **vira exemplo** — com um desfazer ao lado do aviso. A **carinha** à direita de cada um dos dois campos abre o seletor de emoji e insere onde o seu cursor está — e o contador embaixo do segundo campo conta a figurinha como **um** caractere, igual ao servidor. - **Desligado**: O padrão de nascença. Só os gatilhos escritos por você respondem; a IA não escreve nada em público. - **Sugerir**: O recomendado. A IA escreve e a resposta espera na mesa de revisão. Nada aparece embaixo da publicação sem um humano apertar o botão. - **Automático por categoria**: Você liga categoria por categoria. As ligadas saem sozinhas; as desligadas continuam vindo para a mesa. > **Reclamação nunca é automática:** É a única categoria que a tela não deixa ligar — e o servidor recusa mesmo por fora da tela. Responder errado a um cliente insatisfeito, em público, custa mais do que o silêncio. Reclamação sempre vem para a mesa. **A IA só responde o que tem lastro na sua base de conhecimento.** Se você pergunta o preço e o preço não está cadastrado em [Base de conhecimento](https://attendto.com.br/manual/base-de-conhecimento), ela **não inventa**: cala, e o comentário aparece na mesa com o campo em branco e o motivo escrito, para você responder com as suas palavras. É o buraco da sua base ficando visível em vez de virar um preço chutado embaixo do seu Reel. Isso vale também **dentro do automático**: uma categoria ligada só sai sozinha quando a resposta tem fonte. Quando falta fonte, o rascunho vem para a mesa e ela **diz que foi isso** que o segurou — não é defeito, é a regra agindo. > **Publicar sozinha mesmo sem fonte na base:** Se você quer o automático de verdade, o interruptor está logo abaixo dos quatro, em **Automático por categoria** — e ele nasce **desligado**. Ligado, as categorias que você escolheu saem sozinhas mesmo sem fonte: o texto vem do que o modelo sabe, não do que está escrito na sua base, e **ninguém lê antes** de ele aparecer embaixo do seu post. Preço e horário continuam pedindo fonte mesmo assim — sem ela a IA não escreve nada nessas, para não inventar valor. E **reclamação segue fora do automático**, com ele ligado ou não. Nós recomendamos deixar desligado; a decisão é sua, e fica registrada em [Compliance](https://attendto.com.br/manual/compliance). 1. **Ligue em Sugerir**: Escolha **Sugerir** na conta que você quer. Nada muda em público — a partir daí, os comentários que valem resposta começam a aparecer na mesa, e o sino avisa. 2. **Revise as primeiras**: Leia o rascunho, o **por que sugeri isto** e a **fonte** que sustenta o texto. Aprove, edite antes de aprovar, ou descarte. Tudo o que você faz aqui fica registrado. 3. **Ensine o seu jeito**: Sempre que você editar antes de aprovar, guardamos a sua versão como exemplo da sua voz. Depois de alguns, os rascunhos já chegam falando como você. 4. **Só então, se quiser, automatize**: Com a mesa te dando confiança, ligue **Automático por categoria** e escolha o que sai sozinho. O resto continua vindo para você — e o que a sua base não sustenta também, a não ser que você ligue *Publicar sozinha mesmo sem fonte na base*, logo abaixo dos interruptores. #### Como ela escreve — e como auditar o que saiu A resposta pública sai **curta e com emoji** — uma ou duas linhas, do jeito que gente responde pelo celular. Parágrafo formal em comentário denuncia robô na hora. O limite é de **180 caracteres**: se a resposta passar disso, ela **não sai sozinha** — vem para a mesa marcada "longa demais", e você decide. - **Sem emoji**, se a sua marca não usa: o interruptor *Usar emoji nas respostas públicas* fica em **Como ela escreve**. Advogado, clínica e funerária costumam desligar — o tom continua curto e humano, só sem figurinha. Ele governa **a IA**, não você: o seletor de emoji dos campos continua ali, e com ele desligado os seus exemplos chegam ao modelo sem figurinha, para não ensinarem o contrário do que você pediu. - **O tom da persona continua mandando** no resto: tratamento, formalidade e o nome que assina são os que você já cadastrou para esta conta. - **Os seus exemplos vencem tudo**: eles ensinam a voz melhor que qualquer descrição. Se os seus exemplos forem mais longos que o limite do canal, a tela avisa — mantemos o seu tom, encurtando. - **Emoji onde você escreve**: o botão de carinha abre o mesmo seletor do [Inbox](https://attendto.com.br/manual/inbox) no rascunho da mesa e nos dois campos do exemplo de voz. Ele insere onde o seu cursor está, não no fim. O contador embaixo do campo conta a figurinha como **um** caractere — igual ao servidor, que é quem decide se a resposta passou dos 180. Para auditar o que saiu em seu nome, use a barra de filtros da moderação: a aba **Respondidos pela IA** mostra cada resposta pública que a IA escreveu — o texto publicado, a categoria e quando. **Toda resposta automática entra ali**, com o motivo. E o que você **descartou** também fica registrado: você precisa poder auditar o que não saiu tanto quanto o que saiu. > **Os freios de sempre continuam valendo:** Os tetos por publicação e por conta, a janela de 7 dias, o pedido de não contato e a chave geral da conta valem igual para a IA nos comentários. Com os gatilhos desligados ou pausados pelo freio, ela não escreve nem publica — nem o que você aprovar na mesa. **Resposta pública não tem custo.** Ela não consome o seu saldo — o que custa continua sendo a mensagem no Direct, pela régua de sempre. #### Achar um comentário no meio do rolo Quando um Reel engata, a lista de comentários vira um rolo — e a pergunta que você faz não é "quais chegaram", é "quais foram **barrados**", "o que aconteceu **naquela publicação**" ou "cadê o comentário **daquela pessoa**". A barra em cima da lista responde as três. - **A fileira de situações**: **Todos · Respondidos · Respondidos pela IA · Barrados pela IA · Sugestões · Ocultados · Apagados.** O número dentro de cada uma conta o que há naquela situação **dentro do recorte que você já escolheu** — filtrou por um Reel, o número é daquele Reel. "44 barrados" já conta uma história. Pelo teclado: as setas andam pela fileira e o Enter escolhe. - **A aba Sugestões**: As sugestões de ocultar aparecem destacadas no topo da lista, em qualquer aba — moderação não pode se esconder na página 5. Na aba **Sugestões** elas são a própria lista, junto com as que você já decidiu: ali o bloco do topo não se repete. - **Gatilho**: Qual palavra pegou o comentário. Útil quando a mesma publicação tem duas palavras combinadas — "orçamento" e "catálogo" viram duas listas separadas. - **Publicação**: Só os comentários de um post ou Reel específico. - **Período**: Hoje, últimos 7 dias, últimos 30 dias ou tudo. O dia é o **seu**: vira à meia-noite do fuso configurado em Configurações, não à meia-noite de outro país. - **Buscar @autor**: Um pedaço do @ da pessoa basta — com ou sem arroba, sem se importar com maiúsculas. Em contas com histórico muito longo a busca olha os comentários mais recentes do recorte e avisa até onde procurou; escolher uma publicação ou um período faz ela ir mais fundo. - Os filtros **se somam**: "barrados, naquele Reel, nos últimos 7 dias" é uma escolha só de cada vez, e a lista aperta a cada uma. - As **sugestões de ocultar continuam no topo**, mesmo com um filtro ligado. Elas esperam a sua decisão — não podem se esconder na página 5 nem sumir porque você trocou de aba. - Rolar continua **dentro do filtro**: a lista carrega mais do mesmo recorte, e comentário novo chegando no meio não faz nada pular nem repetir. - Lista vazia **com filtro ligado** diz exatamente isso ("nenhum comentário barrado pela IA nos últimos 7 dias") e oferece o caminho de volta. Vazio nunca é uma frase só, porque as causas não são a mesma. Na tela: Painel de comentários e moderação com a fileira de situações no topo — Todos, Respondidos, Respondidos pela IA, Barrados pela IA, Sugestões, Ocultados e Apagados, cada uma com o seu número —, os marcadores de gatilho, publicação e período, o campo de busca por autor e a lista de comentários com a sugestão de ocultar destacada no topo. A barra de filtros e a lista. O número dentro de cada situação é o total daquela situação dentro do recorte escolhido — não o tamanho da página, nem o total da conta. > **Respondidos pela IA nasce em zero:** Esse filtro existe para você auditar o que a IA escreveu em seu nome quando ela passar a responder comentários. Hoje quem escreve as respostas públicas é **você**, nas variações do gatilho — então ele fica em zero, e isso é a verdade, não uma falha. #### Moderação: o que cada botão faz O painel de comentários lista o que chegou nos seus posts com gatilho — e a triagem põe no topo os que ela sugere esconder, com o motivo à vista. **A IA nunca oculta nem apaga nada sozinha**: ela sugere com o botão pronto, e quem aperta é você, um comentário por vez, sempre confirmando num diálogo que mostra o texto e o autor do comentário — você confirma o que está vendo. Toda ação fica na trilha de auditoria: quem fez, o quê, em qual comentário, quando. - **Ocultar**: O comentário some do post para o público, mas **continua existindo** — quem escreveu não é avisado, e você pode reexibir quando quiser. **Tem volta.** - **Reexibir**: Desfaz o ocultar: o comentário volta a aparecer no post para todo mundo. - **Apagar**: Remove o comentário **do seu perfil público, para todo mundo, para sempre**. Não existe desfazer — nem aqui, nem no Instagram. Na dúvida, oculte em vez de apagar. Apagou um comentário **direto no aplicativo do Instagram**? O Instagram não nos avisa quando isso acontece — não existe aviso automático de comentário excluído. Por isso o painel tem o botão **Atualizar**, em cima da lista: ele pergunta ao Instagram, **um comentário de cada vez**, quais das linhas que você está vendo ainda estão lá — e marca as que já não estão. - A linha ganha o selo **Apagado no Instagram** e deixa de oferecer botão: não há mais o que moderar ali. - Ela **continua na lista**, riscada. O histórico do que passou pelo gatilho é seu, e não some sozinho. - Se você clicar em Ocultar ou Apagar num comentário que já sumiu, o painel entende na hora e marca a linha, em vez de mostrar um erro do Instagram. - Errou? **Desmarca sozinho.** Se numa conferência seguinte o Instagram disser que o comentário está lá, a linha volta ao normal e os botões voltam junto. O que **você** apagou pelo painel nunca volta — apagar é para sempre. - O Atualizar só roda quando você pede: cada comentário conferido é uma consulta ao Instagram. Por isso ele confere no máximo 30 por clique — a tela diz quantos conferiu e quantos ficaram para o próximo clique. > **Apagar age no seu perfil, não no painel:** Ocultar e apagar mudam o que o público vê **no seu post do Instagram**, não só uma lista interna. Apagar o comentário de um cliente insatisfeito é uma decisão de imagem — por isso ela é sempre sua, nunca da IA, e sempre com confirmação. #### A janela de 24 horas — a diferença para o WhatsApp Como no WhatsApp, depois que a pessoa escreve você tem **24 horas** para responder. A diferença está no que acontece quando a janela fecha: no WhatsApp dá para reabrir com um [modelo aprovado](https://attendto.com.br/manual/modelos-de-mensagem); **no Instagram não existe modelo de retomada — de ninguém**. Fechou, a única coisa que reabre a conversa é a própria pessoa escrever de novo. Por isso a conversa de Instagram no [Inbox](https://attendto.com.br/manual/inbox) não tem botão de reabrir: não é um recurso que falta, é uma porta que o Instagram não tem. E um detalhe do gatilho: a mensagem de gatilho **não abre janela nenhuma**. Ela é a mensagem única permitida a partir do comentário — a janela de 24 horas só nasce quando a pessoa responde. Até lá, a conversa aparece no Inbox esperando, com o campo de escrever desabilitado e o motivo explicado. #### O que custa e o que não custa - **Mensagem no Direct** — cada mensagem da conversa processada pela IA, e também a mensagem do gatilho, conta como uma mensagem no seu extrato, como em qualquer canal. O saldo e o extrato estão em [Saldo & Recargas](https://attendto.com.br/manual/saldo-e-recargas). - **Resposta pública no comentário não cobra.** É o seu texto publicado no seu post. - **A triagem dos comentários não cobra.** Ela roda em todo comentário que bateu a palavra, sem aparecer no extrato. - **O Instagram não tem tarifa própria** — diferente do WhatsApp, não existe cobrança da Meta por conversa nem por modelo neste canal. #### Quando alguma coisa parece errada - **Comentaram a palavra e nada aconteceu**: Olhe o painel do gatilho: se o comentário está em **barrados**, o motivo está do lado (triagem, teto do dia, pessoa que já recebeu nas últimas 24h, pedido de não contato). Se nem aparece, confira se a palavra bateu **exata** — "precinho" não aciona "preço" — e se o gatilho está no post certo e ligado. - **Mensagem do Direct não chega no painel**: Quase sempre é a chave **Permitir acesso a mensagens** desligada no app do Instagram, ou a autorização vencida — a conta fica amarela com um botão de reconectar. O passo a passo está em [Conexões](https://attendto.com.br/manual/conexoes). - **"Pausamos os gatilhos de comentário"**: O freio de emergência agiu: o Instagram sinalizou um problema de política na conta, ou os envios começaram a falhar em sequência. Nada sai enquanto estiver pausado. Revise os textos do gatilho e religue quando quiser — a tela mostra o motivo e a hora. - **A mesma pessoa aparece duas vezes, no Instagram e no WhatsApp**: O Instagram não entrega o telefone de ninguém, então o lead do Direct nasce separado. Quando a pessoa informa um telefone ou e-mail que já existe, o painel **sugere** unir os contatos — a decisão é sua, nunca automática, porque unir errado mostraria a conversa de outra pessoa. No painel: Abrir Instagram — Gatilhos e boas-vindas. Como as pessoas procuram: comenta a palavra e recebe no direct; gatilho de comentário instagram; resposta automática no direct; ia responde comentários do instagram; mesa de revisão de comentários; boas-vindas no direct do instagram; perguntas de abertura ice breakers; agradecer menção em story; gatilho em live do instagram; ocultar comentário do instagram; apagar comentário pelo painel; moderação de comentários instagram. ## Módulos: como ativar a Base de conhecimento avançada, o Revenue AI e outros complementos da conta URL: https://attendto.com.br/manual/modulos Menu: Conta > Módulos Módulos é a loja de complementos da conta: nela você conhece, ativa, desliga e religa módulos como a Base de conhecimento avançada e o Revenue AI, e pede para ser avisado quando um módulo novo chegar. Quando aparece: O item Módulos aparece no grupo Conta do menu nas contas em que a loja de módulos está liberada. Nas demais contas, os módulos ficam em Configurações e estes endereços mostram a página de não encontrado. ### Quem pode usar - Dono: Vê a loja e as páginas dos módulos e é o único que ativa, desliga, mantém ligado, religa, assina o módulo no fim do teste e liga ou desliga cada capacidade do Revenue AI. - Admin: Vê a loja, a página de cada módulo e o painel do Revenue AI, e pode pedir aviso de módulos em breve. Não ativa nem desliga: no lugar do botão aparece “Só o responsável pela conta ativa” e os interruptores ficam travados. - Atendente: Não vê o item Módulos no menu. Se abrir o endereço da loja ou de um módulo, volta para o início do painel. ### Telas #### Módulos A tela Módulos serve para ver os complementos disponíveis para a conta, filtrar por categoria e situação, ativar ou abrir cada um e pedir aviso dos que ainda vão chegar. Endereço no painel: `/app/modulos` ![Captura da tela Módulos. A tela Módulos serve para ver os complementos disponíveis para a conta, filtrar por categoria e situação, ativar ou abrir cada um e pedir aviso dos que ainda vão chegar.](https://attendto.com.br/prints-do-manual/modulos--loja.png) A tela Módulos na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Menu Conta → Módulos. ##### Destaque do topo A chamada da Base de conhecimento avançada. Botões e ações: - **Conhecer o módulo**: Abre a página da Base de conhecimento avançada. - **Ver o exemplo do provedor de internet**: Abre a página do módulo direto no exemplo “Como fica no seu segmento”. Também aparece: - O selo diz “Novo módulo” e, quando a Base avançada já está incluída no seu plano, “incluído no seu plano”. - Ilustração das três camadas: Memória da empresa, Ações no seu sistema e Avisos do seu sistema. ##### Busca e categorias Campos e filtros: - **Buscar módulo**: Busca pelo nome ou pelo que você quer resolver (nome, descrição, categoria e etiquetas). Botões e ações: - **Todos**: Mostra os módulos de todas as categorias, com a contagem. - **‹categoria›**: Um botão por categoria do catálogo filtra os cartões, com a contagem de cada uma. ##### Para a sua conta Os cartões dos módulos. Ligue e desligue quando quiser: o que você ensinou fica guardado. Botões e ações: - **Todos**: Mostra todos os módulos. - **Ativos**: Só os módulos ligados na conta. - **Disponíveis**: Só os que podem ser ativados agora. - **Abrir**: No módulo ativo, abre a Base avançada ou o painel do Revenue AI. - **Ativar** (Dono): Na Base avançada, leva à página do módulo para ativar; no Revenue AI, abre o diálogo de ativação. - **Ativar · taxa única ‹valor›** (Dono): No Revenue AI ainda não habilitado, abre o diálogo de ativação com a taxa única. - **Religar** (Dono): No Revenue AI já pago antes, liga de novo sem nova cobrança. - **Avise-me**: Nos módulos em breve, pede um e-mail quando o módulo chegar. - **Vamos avisar**: Aparece no lugar do Avise-me depois do pedido (desabilitado). Também aparece: - Cada cartão traz quem oferece o módulo (a marca do painel), a subcategoria, o nome, a descrição e as etiquetas. - Selos: Ativo, Incluída no seu plano, Em breve, ou os dias de teste da Base avançada. - O cartão da Base avançada é o destaque, com um mini fluxo ilustrado; o valor do módulo aparece no próprio cartão quando ele não está incluído no plano. - Módulos em breve mostram “Sem preço ainda” e se entram no Revenue AI sem nova taxa. - Para quem não é dono: “Só o responsável pela conta ativa”. ##### Diálogo Ativar (Revenue AI) A confirmação de um módulo de taxa única. Botões e ações: - **Agora não**: Fecha sem ativar. - **Ativar por ‹valor›**: Ativa o módulo e tira a taxa única do saldo; em conta de demonstração o botão diz só Ativar. Também aparece: - O que muda a partir de agora: cada capacidade com “hoje” ou a rodada em que chega, sem nova taxa. - Taxa única de habilitação, Cobrança (do saldo da conta, uma vez só) e Saldo disponível. - Sem saldo suficiente, o aviso manda recarregar em Saldo & Recargas e o botão fica bloqueado. - Desligar a qualquer momento em Módulos; religar não cobra de novo e o que o módulo gravou fica na conta. ##### Estados da tela - Carregando: Três cartões em esqueleto. - Sem nada ainda: “Nenhum módulo com esse nome”, sugerindo buscar pelo que você quer resolver, com o botão Limpar a busca. - Se der erro: “Não foi possível carregar os módulos”, dizendo que nada mudou na conta, com o botão de tentar de novo. #### Base de conhecimento avançada A tela Base de conhecimento avançada, em Módulos, serve para conhecer o módulo (memória, ações e avisos), ver como ele fica no seu Segmento e ativá-lo, desligá-lo ou acompanhar o plano dele. Endereço no painel: `/app/modulos/base-avancada` ![Captura da tela Base de conhecimento avançada. A tela Base de conhecimento avançada, em Módulos, serve para conhecer o módulo (memória, ações e avisos), ver como ele fica no seu Segmento e ativá-lo, desligá-lo ou acompanhar o plano dele.](https://attendto.com.br/prints-do-manual/modulos--base-avancada.png) A tela Base de conhecimento avançada na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Na loja, Conhecer o módulo ou o cartão da Base avançada; dentro do módulo, o botão Plano e preço. Abrir uma tela da Base avançada com o módulo desligado também traz para cá. ##### Apresentação Botões e ações: - **Módulos**: No caminho do topo, volta para a loja. Também aparece: - Selo Novo, a categoria e quem oferece o módulo. - As três camadas: Memória da empresa (o Curador de conhecimento propõe fatos e nada entra sem aprovação), Ações no seu sistema (consultas testadas antes de publicar; só leitura por padrão) e Avisos do seu sistema (regras “quando chegar X, faça Y”). ##### Como fica no seu segmento Exemplos prontos por Segmento, com os passos e uma conversa de exemplo. Botões e ações: - **Provedor de internet**: Mostra o exemplo de cobertura por endereço. - **Farmácia**: Mostra o exemplo de estoque e preço do remédio. - **Varejo**: Mostra o exemplo de status do pedido. - **Clínicas e serviços**: Mostra o exemplo de agenda disponível. Também aparece: - A conversa de exemplo leva o nome da IA da sua persona ativa. ##### Os agentes que este módulo liga Também aparece: - Curador de conhecimento, Operador de ações e Mensageiro de avisos, cada um com registro do que fez e por quê. - No Enterprise, a frase diz que eles rodam no modelo da sua empresa, escolhido em Roteamento. ##### Perguntas frequentes Também aparece: - Preciso de programador?, A IA pode mudar algo no meu sistema? e E se o meu sistema cair?, com as respostas. ##### Preço e ativação (módulo desligado) O cartão lateral com o que está incluído e o botão de ativar. Botões e ações: - **Ativar** (Dono): Com o módulo incluído no plano, liga a Base avançada e abre a Visão geral dela. - **Religar · ‹valor› do saldo** (Dono): Quando o teste já foi usado, religa o módulo e a mensalidade sai do saldo na hora. Também aparece: - Incluído no plano: Memória da empresa sem limite de fatos, consultas ao seu sistema sem cobrança, o limite de itens por sincronização e o custo da Meta nas mensagens fora das 24 h. - Fora do plano: a mensalidade, as consultas incluídas por mês e o valor da consulta excedente aparecem no cartão; o botão principal começa o período de teste, sem cobrança, e a mensalidade só sai do saldo no fim dele. - Para quem não é dono, o botão fica desabilitado e o texto lembra que só o responsável pela conta ativa. ##### Seu plano (módulo ligado) Botões e ações: - **Desligar** (Dono): Pergunta “Desligar a Base avançada?”: no teste ou com o módulo incluído no plano, desliga e nada é cobrado; no ciclo pago, segue ligada até o fim do ciclo já pago, sem devolução. - **Manter ligada** (Dono): Cancela o desligamento agendado (nada é cobrado de novo) ou fecha a confirmação. - **Recarregar**: Leva à Carteira quando falta saldo para a mensalidade. - **Assinar agora** (Dono): No teste, quando as consultas incluídas acabam e as sincronizações pausam, confirma a assinatura para elas voltarem. Também aparece: - Selo Ativo ou de teste, com a data do fim do teste, da próxima cobrança ou do desligamento. - Consultas neste ciclo: as usadas e as incluídas, com a barra. - Aviso “Saldo insuficiente para a mensalidade”: o módulo segue ligado até a data mostrada. - Para quem não é dono: “Só o responsável pela conta liga e desliga o módulo.” ##### Estados da tela - Carregando: Esqueletos da apresentação e do cartão de preço. - Se der erro: “Não foi possível carregar o módulo”, dizendo que nada mudou na conta, com o botão de tentar de novo. #### Revenue AI A tela Revenue AI serve para ver o que o módulo Revenue AI tem funcionando na conta e ligar ou desligar cada capacidade dele, como o perfil de cliente ideal e o follow-up avançado. Endereço no painel: `/app/modulos/revenue-ai` ![Captura da tela Revenue AI. A tela Revenue AI serve para ver o que o módulo Revenue AI tem funcionando na conta e ligar ou desligar cada capacidade dele, como o perfil de cliente ideal e o follow-up avançado.](https://attendto.com.br/prints-do-manual/modulos--revenue-ai.png) A tela Revenue AI na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Na loja, o cartão do Revenue AI ativo (Abrir). Sem o módulo ativo, o endereço volta para a loja. ##### Cabeçalho Botões e ações: - **Módulos**: No caminho do topo, volta para a loja. Também aparece: - Selo Ativo, a categoria Vendas e quem oferece o módulo. ##### O que está funcionando Uma linha por capacidade do módulo, com a situação, o que faz e onde aparece. Botões e ações: - **‹capacidade› ligada** (Dono): Interruptor que liga ou desliga a capacidade; desligar não apaga nada. - **Configurar**: Abre a seção da capacidade em Configurações (quando ela precisa de configuração, o botão diz o que falta). Também aparece: - Resumo: quantas capacidades disponíveis estão funcionando agora. - Selos de cada capacidade: Funcionando, Desligada por você, Precisa configurar ou Em breve (com a rodada em que chega). - Onde aparece cada capacidade e os números dela, quando houver. ##### Estados da tela - Carregando: Linhas em esqueleto no painel do módulo. - Se der erro: “Não foi possível carregar o painel do módulo”, dizendo que nada mudou, com o botão de tentar de novo. - Módulo não está ativo: A tela volta sozinha para a loja de Módulos, onde ele é ativado. ### Passo a passo #### Como ativar a Base de conhecimento avançada 1. No menu, em Conta, abra **Módulos**. 2. No destaque do topo, clique em **Conhecer o módulo** (ou no cartão da Base avançada). 3. Leia o que está incluído no cartão lateral e, sendo o dono da conta, clique no botão de ativar (**Ativar**, quando o módulo está incluído no seu plano). 4. O painel abre a Visão geral da Base avançada; comece pela Memória da empresa, que o Curador já está lendo as conversas. #### Como desligar a Base avançada sem perder o que a IA aprendeu 1. Abra **Módulos** e o cartão da Base avançada, ou use **Plano e preço** dentro do módulo. 2. No cartão **Seu plano**, clique em **Desligar**. 3. Leia a confirmação: no teste ou com o módulo incluído no plano, nada é cobrado; no ciclo pago, ele segue ligado até o fim do ciclo. 4. Confirme em **Desligar**. Para desfazer um desligamento agendado, use **Manter ligada**. #### Como ativar o Revenue AI 1. Em **Módulos**, encontre o cartão do Revenue AI (use **Buscar módulo** ou o filtro **Disponíveis**). 2. Sendo o dono, clique no botão de ativar do cartão. 3. No diálogo, confira o que chega hoje, a taxa única e o saldo disponível. 4. Clique em **Ativar por ‹valor›**. Sem saldo, recarregue em Saldo & Recargas e volte. #### Como ligar ou desligar uma capacidade do Revenue AI 1. Em **Módulos**, clique em **Abrir** no cartão do Revenue AI. 2. Na lista do que está funcionando, use o interruptor da capacidade. 3. Se a capacidade disser **Precisa configurar**, clique no botão dela para abrir a seção certa em Configurações. #### Como ser avisado quando um módulo novo chegar 1. Em **Módulos**, ache o cartão com o selo **Em breve**. 2. Clique em **Avise-me**; o botão vira **Vamos avisar**. 3. Quando o módulo chegar, você recebe um e-mail. ### Perguntas frequentes #### Quem pode ativar ou desligar um módulo? Só o dono da conta (o responsável). O admin vê a loja e as páginas, mas no lugar do botão aparece “Só o responsável pela conta ativa”. #### O que acontece com o que eu ensinei se desligar a Base avançada? Fica guardado. Ao religar, os fatos, as ações e os fluxos continuam lá. #### Desligar a Base avançada no meio do mês devolve a mensalidade? Não. No ciclo pago, ela segue ligada até o fim do ciclo já pago e não renova. No período de teste, ou quando o módulo está incluído no seu plano, desliga sem cobrança. #### Religar o Revenue AI cobra a taxa de novo? Não. A taxa de habilitação é única: depois de paga, o botão vira Religar e liga sem nova cobrança. #### Por que não vejo Módulos no menu? O atendente não vê o item. Nas contas em que a loja de módulos não está liberada, os módulos ficam em Configurações. #### Onde vejo o valor de um módulo? No próprio cartão da loja e no cartão lateral da página do módulo, antes de confirmar. Quando a Base avançada está incluída no seu plano, o cartão diz isso no lugar do valor. Como as pessoas procuram: loja de módulos; ativar base de conhecimento avançada; desligar módulo; ativar revenue ai; complementos da conta; add-on ia whatsapp; módulo em breve avise-me; religar módulo; capacidades do revenue ai. ## Integrações: receber leads por API, avisar o seu CRM por webhook e devolver conversões à Meta URL: https://attendto.com.br/manual/integracoes Menu: Conta > Integrações A área Integrações do painel serve para ligar o painel aos outros sistemas da empresa: receber leads por API com primeiro contato automático pelo WhatsApp, avisar o seu CRM por webhook a cada passo do lead, devolver as conversões do funil para os anúncios da Meta e receber os pedidos de venda. Quando aparece: O item Integrações aparece para o dono e para o administrador da conta. A Entrada de leads, os Webhooks, as Entregas e os Pedidos existem em toda conta; o primeiro contato automático precisa de uma conta do WhatsApp conectada e de um modelo de mensagem aprovado pela Meta. A aba Conversões pode avisar que ainda não está disponível na conta. O atalho para os webhooks de entrada só aparece com o módulo Base avançada ativo. ### Quem pode usar - Dono: Faz tudo: cria, edita, pausa, reativa e exclui integrações, gera chaves, envia lead de teste, ajusta e salva o primeiro contato, cria e testa webhooks, vê e reenvia entregas, conecta e liga as conversões da Meta e gera a chave de pedidos. - Admin: Vê as integrações, os números, o registro de entradas, a gaveta de cada entrada e a tela do primeiro contato, mas sem os botões de criar, editar, pausar, gerar chave ou enviar teste, e sem a barra de salvar no primeiro contato. Nas abas Webhooks e Entregas vê o aviso de que elas ficam com o dono da conta. Em Conversões vê a configuração e o registro, mas não liga o envio, não troca o token e não envia teste. - Atendente: Não vê Integrações no menu: os dados desta área ficam fechados para o papel de atendente, e a tela do primeiro contato leva à tela de acesso negado. ### Telas #### Integrações A tela Integrações serve para reunir, em cinco abas, tudo o que liga o painel a outros sistemas: Entrada de leads, Webhooks, Entregas, Conversões e Pedidos. Endereço no painel: `/app/integracoes` ![Captura da tela Integrações. A tela Integrações serve para reunir, em cinco abas, tudo o que liga o painel a outros sistemas: Entrada de leads, Webhooks, Entregas, Conversões e Pedidos.](https://attendto.com.br/prints-do-manual/integracoes--visao-geral.png) A tela Integrações na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Pelo item Integrações do grupo CONTA no menu lateral. Cada aba tem endereço próprio: abrir Integrações com a aba no fim do endereço (entrada, webhooks, entregas, conversoes ou pedidos) já mostra a aba certa, e atualizar a página volta na mesma aba. O aviso do sino sobre um webhook pausado também leva direto à aba Webhooks. ##### Cabeçalho da tela O título, a frase de apoio e os botões que mudam conforme a aba aberta. Botões e ações: - **Documentação da API**: Na aba Entrada de leads, abre a documentação da API de entrada de leads para passar a quem programa o seu sistema. Conforme o endereço do painel, abre numa aba nova ou dentro do próprio painel. - **Nova integração** (Dono): Na aba Entrada de leads, abre o assistente de quatro passos que cria uma integração e mostra a chave dela uma única vez. - **Como receber** (Dono): Na aba Webhooks, rola até o cartão Para quem vai programar o recebimento; sem nenhum webhook criado, abre o guia dos webhooks na Central de ajuda. - **Novo webhook** (Dono): Na aba Webhooks, abre o formulário para cadastrar um endereço que vai receber os avisos. - **Ver os webhooks** (Dono): Na aba Entregas, volta para a aba Webhooks. - **Como funciona**: Na aba Conversões, abre o guia das conversões na Central de ajuda. Também aparece: - Título Integrações e a frase Receber leads, avisar seus sistemas e medir anúncios. - Os botões do canto direito dependem da aba: Entrada de leads, Webhooks, Entregas e Conversões têm botões próprios; Pedidos não tem. ##### Abas da tela A faixa de abas que troca o conteúdo sem sair da tela. Botões e ações: - **Entrada de leads**: Mostra as integrações que recebem leads por API, com o número de integrações ao lado do nome. - **Webhooks**: Mostra os endereços que recebem avisos do painel, com a quantidade de webhooks ao lado do nome (só para o dono). - **Entregas**: Mostra o registro de tudo o que saiu para os seus sistemas pelos webhooks. - **Conversões**: Mostra a configuração e o registro das conversões devolvidas aos anúncios da Meta. Leva o selo Novo. - **Pedidos**: Mostra a chave e o exemplo para o seu sistema enviar os pedidos de venda. Também aparece: - Com o foco numa aba, as setas para a direita e para a esquerda passam para a aba vizinha. - Em tela estreita a faixa de abas rola sozinha até a aba escolhida. ##### Aba Pedidos Recebe as vendas do seu ERP, loja virtual ou outro sistema para alimentar o RFV do Monitor de sucesso. Campos e filtros: - **URL de ingestão**: O endereço para onde o seu sistema manda os pedidos, com o botão de copiar ao lado. - **Chave de API (X-Api-Key)**: A chave da conta para os pedidos, mostrada mascarada. Sem chave, aparece Nenhuma chave gerada. - **Exemplo (curl)**: Um exemplo pronto de envio de pedido, com a chave no lugar certo depois de gerada. Botões e ações: - **Gerar chave**: Cria a primeira chave de pedidos e mostra a chave inteira uma única vez, com o aviso para copiar na hora. - **Gerar nova chave**: Cria uma chave nova na hora, sem pedir confirmação, e a anterior deixa de funcionar no mesmo instante. - **Copiar**: Copia o endereço, a chave recém-gerada ou o exemplo. - **Ver o guia passo a passo**: Abre o guia de integração de pedidos numa aba nova. Só aparece quando o painel está no endereço da plataforma. Também aparece: - Cartão Receber pedidos: seu sistema empurra vendas e alimenta o RFV do Monitor. - O pedido é aceito de novo sem duplicar quando chega com o mesmo identificador externo; ele casa com o contato pelo telefone ou pelo e-mail. - Se a chave não carrega, a tela mostra Não foi possível carregar a sua chave de API e esconde o botão de gerar, para ninguém trocar sem querer a chave que está em uso. ##### Estados da tela - Carregando: Cada aba mostra blocos cinza no formato do conteúdo enquanto os dados chegam. - Se der erro: Cada aba tem a própria mensagem de falha, sempre com o botão Tentar de novo; os leads, avisos e conversões continuam funcionando, só a tela não carregou. #### Entrada de leads A aba Entrada de leads serve para criar integrações que recebem leads de outros sistemas por API, acompanhar cada lead que chegou e testar o caminho até o primeiro contato pelo WhatsApp. Endereço no painel: `/app/integracoes/entrada` ![Captura da tela Entrada de leads. A aba Entrada de leads serve para criar integrações que recebem leads de outros sistemas por API, acompanhar cada lead que chegou e testar o caminho até o primeiro contato pelo WhatsApp.](https://attendto.com.br/prints-do-manual/integracoes--entrada-de-leads.png) A tela Entrada de leads na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Integrações, aba Entrada de leads (é a aba que abre por padrão). O botão Ver entradas da tela do primeiro contato volta para esta aba já com a integração escolhida e rolando até o registro. ##### Faixa de abertura A explicação do caminho do lead, que pode ser escondida. Botões e ações: - **Entendi**: Esconde a faixa de abertura. O painel lembra a escolha para o seu usuário neste navegador. Também aparece: - Título Receba leads de qualquer sistema e responda em segundos. - O caminho do lead em seis etapas: Seu sistema, Entrada de leads, Primeiro contato, IA qualifica, Rodízio e Atendente. ##### Suas integrações A grade com um cartão por integração e os números dos últimos 7 dias. Botões e ações: - **Ver entradas**: Escolhe a integração e rola até a lista Últimos leads recebidos. - **Editar** (Dono): Abre o assistente da integração com os dados atuais para mudar nome, origem, base legal, primeiro contato e destino. Não aparece na integração interna. - **Mais** (Dono): Abre o menu da integração. As setas para cima e para baixo andam entre os itens; Esc fecha e devolve o foco ao botão. - **Pausar** (Dono): No menu Mais, pausa a integração: os envios do seu sistema passam a ser recusados até você reativar. Na integração interna, os pedidos entram no CRM sem primeiro contato. - **Reativar** (Dono): No menu Mais, volta a aceitar os leads da integração pausada. - **Gerar nova chave** (Dono): No menu Mais, abre a confirmação para trocar a chave da integração. - **Excluir** (Dono): No menu Mais, abre a confirmação para excluir a integração. Também aparece: - Cada cartão mostra o nome, a origem, a data de criação e o selo Ativa ou Pausada. - A chave aparece mascarada, com quando foi usada pela última vez ou ainda não usada. Integração interna, criada pela própria plataforma para um formulário de site, aparece como Sem chave. - Números dos últimos 7 dias: Recebidos, Novos, Já existiam e Recusados (em vermelho quando há recusa). - Quando o sistema mandou o mesmo lead de novo, aparece quantos reenvios repetidos foram ignorados, sem custo. - A linha do primeiro contato diz se está ligado, com o modelo e quem cobra pelo envio; parado, com o motivo em vermelho; ou desligado, quando a IA só fala depois que o lead escreve. - Clicar em qualquer parte do cartão que não seja botão escolhe a integração e troca o detalhe mostrado abaixo da grade. ##### Detalhe da integração escolhida O cabeçalho do detalhe, com o nome da integração e a situação ao vivo. Também aparece: - Acima do nome, a etiqueta Receber leads por API (ou o formulário de origem, na integração interna). - Selo ao vivo: Recebendo, com o horário do último lead ou nenhum lead ainda; ou Pausada, os envios são recusados. ##### Como conectar Tudo o que quem cuida do seu sistema precisa para mandar leads. Campos e filtros: - **Endereço do envio**: O endereço para onde o seu sistema manda cada lead. Ele aparece na tela e na documentação. - **Chave da integração**: A chave mascarada, só com o começo e o fim. Vai no cabeçalho X-Api-Key de cada envio; a chave completa só aparece quando é criada. - **Exemplo de envio**: Exemplo pronto em três abas: JSON, cURL e a Resposta que o sistema recebe. Botões e ações: - **Copiar endereço do envio**: Copia o endereço do envio. - **Gerar nova** (Dono): Abre a confirmação para gerar uma chave nova para esta integração. - **JSON**: Mostra o exemplo do corpo do lead. - **cURL**: Mostra o exemplo de chamada completa, pronto para testar no terminal. - **Resposta**: Mostra o que o seu sistema recebe de volta quando o lead entra. - **Copiar o exemplo**: Copia o exemplo da aba aberta. - **Receber no formato do seu sistema** (Dono): Abre o diálogo para ligar os campos de um formato próprio do seu sistema aos campos do painel. - **Documentação completa**: Abre a documentação da API de entrada de leads. Também aparece: - Aviso Use a chave só de servidor para servidor: nunca coloque a chave no código do site ou do aplicativo. - Na integração interna, no lugar deste cartão aparece Como os pedidos chegam, com a página de origem, a base legal e o modelo usado, sem chave nem API. ##### Últimos leads recebidos O registro de entradas da integração, que se atualiza sozinho. Campos e filtros: - **Todos**: Filtro por situação, com a contagem de cada grupo: Todos, Novos, Contatados, Responderam e Com problema. Botões e ações: - **Novos**: Mostra só os leads novos. - **Contatados**: Mostra os leads que receberam o primeiro contato. - **Responderam**: Mostra os leads que responderam ao primeiro contato. - **Com problema**: Mostra as entradas recusadas, bloqueadas, sem saldo ou com falha no envio. - **Carregar mais**: Traz as entradas mais antigas da lista. - **Ver todas**: No vazio de um filtro, volta ao filtro Todos. - **Reativar integração** (Dono): Aparece quando a integração está pausada e nada chegou nos últimos 7 dias; reativa a integração ali mesmo. Também aparece: - Cada linha mostra o nome do lead (ou Entrada recusada), o telefone, a trilha do que aconteceu, o motivo quando houver, a situação e a hora. - As situações vêm escritas em português e coloridas: novo, agendado, na fila, contatado, respondeu, sem envio, bloqueado, não confirmado, falhou, sem saldo e recusado. - O lead de teste tem o selo Teste. - Linhas que chegam com a tela aberta entram destacadas e são anunciadas ao leitor de tela. - O rodapé diz quantas entradas estão à vista do total dos últimos 7 dias. ##### Gaveta da entrada Abre ao clicar no nome de um lead do registro e mostra tudo o que chegou. Botões e ações: - **Reenviar primeiro contato**: Aparece quando o envio pode ser repetido. Mostra a confirmação com quem cobra o novo envio e, se a mensagem pode já ter chegado, pede para conferir no Inbox antes. - **Reenviar agora**: Confirma o reenvio: a mensagem sai em segundos para o lead. - **Cancelar**: Desiste do reenvio. - **Abrir conversa**: Abre a conversa do lead no Inbox. - **Abrir ficha do lead**: Abre a ficha do lead no CRM. - **Entendi**: Fecha a gaveta de uma entrada recusada. Também aparece: - Selos do resultado e da situação; quando há problema, um aviso com o motivo e o que fazer. - Origem: plataforma, campanha, conjunto, anúncio e o ID no seu sistema. - Dados recebidos: os campos extras que o sistema mandou; dado sensível aparece escondido. - Base legal: qual foi, de onde veio e a prova do aceite, quando existe. - Linha do tempo: cada passo do primeiro contato, com a hora. - A entrada recusada mostra só o motivo, a origem e o ID. ##### Enviar lead de teste Manda um lead de verdade pela integração, marcado como teste, e mostra cada passo acontecendo. Campos e filtros: - **Seu celular** (obrigatório): Aparece com o interruptor ligado: o número com DDD que recebe a mensagem do jeito que o lead recebe. Botões e ações: - **Mandar o primeiro contato para o meu WhatsApp**: Liga o envio do primeiro contato do teste para o seu celular. Usa um envio do modelo, com o custo do modelo quando a conta debita do saldo. - **Enviar lead de teste**: Envia o teste. Depois do primeiro, o botão passa a dizer Enviar outro teste. Também aparece: - Passos acompanhados ao vivo: Requisição recebida, Lead criado e marcado como teste, Primeiro contato enviado e Entregue no seu WhatsApp. - Quando a mensagem não sai, o passo diz Nada foi cobrado e o que falta fazer. - Abaixo dos passos aparece a Resposta da API, linha por linha. - Com a integração pausada, o teste avisa que é preciso reativar antes. - Só aparece para o dono, e não aparece na integração interna sem primeiro contato. ##### Primeiro contato automático O resumo do primeiro contato da integração, ao lado do registro. Botões e ações: - **Ajustar primeiro contato**: Abre a tela Primeiro contato automático desta integração. Também aparece: - Selo Ligado ou Desligado. - Modelo com o nome e a categoria, Custo, Horário, Teto por dia, Teto do mês com modelos pagos e Recontato. - Últimos 7 dias: quantos responderam de quantos receberam a mensagem, com a barra da taxa. ##### Base legal padrão Por que você pode falar com os leads desta integração. Também aparece: - Mostra a base escolhida no assistente e o resumo dela; se o sistema mandar a base legal de cada lead, vale a do lead. - Sem base padrão, aparece Sem base legal padrão: cada lead precisa trazer a base no campo legal_basis, ou é recusado. ##### Diálogo Nova integração O assistente em quatro passos: Nome e origem, Base legal, Primeiro contato e Destino. O mesmo diálogo abre como Editar integração. Campos e filtros: - **Nome da integração** (obrigatório): Nome para reconhecer a integração depois; só você e o seu time veem. Enter no campo avança. - **De onde vêm esses leads?**: A origem: Anúncios da Meta, Outra plataforma de anúncios, Formulário do site, Portal ou marketplace ou Outro sistema. Cada escolha mostra uma explicação. - **Por que você pode falar com essas pessoas?** (obrigatório): A base legal: Pediram para eu entrar em contato (Recomendado para anúncio), São meus clientes ou Já coletei o consentimento deles. A declaração fica registrada com o seu nome, a data e a hora em cada lead. - **Conta do WhatsApp**: A conta do WhatsApp que manda o primeiro contato; só as contas ativas aparecem. - **Modelo aprovado**: O modelo aprovado pela Meta usado na primeira mensagem. Modelo com mídia no cabeçalho ou sem preço confirmado aparece desabilitado, com o motivo. - **Teto por dia**: Quantas primeiras mensagens esta integração manda no máximo por dia. - **Quadro do Funil**: O quadro onde o cartão do lead nasce; o padrão vem marcado. - **Coluna de entrada**: A coluna do quadro onde o cartão nasce. - **Etiquetas automáticas**: Etiquetas que todo lead desta integração ganha. Já vem uma sugestão pela origem; Enter adiciona, Backspace no campo vazio tira a última. Botões e ações: - **Anúncios da Meta**: Escolhe a origem anúncios da Meta (a campanha, o conjunto e o anúncio vêm junto). - **Outra plataforma de anúncios**: Escolhe a origem de formulários de anúncio de outra plataforma. - **Formulário do site**: Escolhe a origem formulário do seu site ou página de lançamento. - **Portal ou marketplace**: Escolhe a origem portais e marketplaces do seu segmento. - **Outro sistema**: Escolhe qualquer outro sistema que faça uma chamada HTTP. - **Mandar a primeira mensagem sozinho pelo WhatsApp**: No passo 3, liga ou desliga o primeiro contato automático. Fica travado com a base São meus clientes, sem conta do WhatsApp conectada ou quando não dá para confirmar quem paga o envio. - **Este sistema pode atualizar as etapas do funil**: No passo 4, deixa a chave da integração mudar a etapa do lead, inclusive venda e perda. A venda marcada pelo sistema também vai para as conversões da Meta. - **Receber no formato do seu sistema**: No passo 4, abre o diálogo de formato próprio; o formato é salvo junto com a integração. - **Voltar**: Volta ao passo anterior. - **Continuar**: Confere o passo e avança. Sem nome, sem base legal ou sem modelo com o primeiro contato ligado, mostra o erro no campo. - **Criar integração**: No passo 4, cria a integração e mostra a tela Integração criada. - **Salvar alterações**: Na edição, salva só o que mudou; vale para os próximos leads, e a permissão de etapas vale na hora. - **Copiar a chave**: Na tela Integração criada, copia a chave, que não aparece de novo. - **Copiar o endereço**: Na tela Integração criada, copia o endereço do envio. - **Enviar lead de teste**: Na tela Integração criada, fecha o assistente e já dispara o teste da integração. - **Concluir**: Fecha o assistente e abre o detalhe da integração criada. Também aparece: - No passo 3, a prévia da mensagem no WhatsApp e a faixa de custo: quem cobra (a plataforma, debitando do saldo antes de cada envio, ou a Meta, direto no cartão da conta do WhatsApp) e o máximo por dia com o teto escolhido. - O horário de envio vem da conta e é ajustado depois, na tela do primeiro contato. - Com a base São meus clientes, o primeiro contato fica desligado: mensagem de marketing para cliente de contrato pede o consentimento dele. ##### Diálogo Receber no formato do seu sistema Liga os campos de um exemplo real do seu sistema aos campos do painel. Campos e filtros: - **Exemplo do seu sistema**: Cole um exemplo completo do JSON que o seu sistema envia; o diálogo já abre com um exemplo e lê os campos. - **Campos encontrados**: Uma linha por campo do exemplo, com a escolha do destino: Não usar, Nome, Telefone, E-mail, ID no seu sistema, Campanha de anúncio, Conjunto, Anúncio ou Dado recebido. Botões e ações: - **Encontrar campos**: Lê o exemplo colado e sugere o destino de cada campo. - **Salvar formato**: Salva o formato: a integração passa a aceitar um lead por envio nesse formato. Exige algum campo ligado ao Telefone. - **Cancelar**: Fecha sem salvar. Também aparece: - Assim ficaria o lead: a prévia com Nome, Telefone, E-mail, ID no seu sistema, Origem e os dados recebidos. - Sem telefone ligado, aparece o aviso de que o lead seria recusado. ##### Diálogo Gerar nova chave? Confirma a troca da chave da integração e mostra a chave nova uma única vez. Botões e ações: - **Gerar nova chave**: Gera a chave nova; a atual para de funcionar na hora. - **Copiar a chave nova**: Copia a chave nova para colar no seu sistema. - **Já guardei a chave**: Fecha o diálogo e lembra de trocar a chave no seu sistema. - **Cancelar**: Mantém a chave atual. Também aparece: - Até a chave nova ser trocada no sistema, os envios dele são recusados; os leads que já chegaram continuam no painel. ##### Diálogo Excluir esta integração? Confirma a exclusão da integração. Botões e ações: - **Excluir integração**: Exclui: a chave para de funcionar na hora. Os leads e as entradas que já chegaram continuam no painel. - **Cancelar**: Desiste de excluir. ##### Estados da tela - Carregando: Três cartões cinza na grade e dois blocos do detalhe enquanto as integrações chegam. - Sem nada ainda: Receba leads de qualquer sistema: a explicação, o botão Nova integração (só para o dono) e o botão Ver a documentação. No registro, Esperando o primeiro lead até chegar o primeiro. - Se der erro: Não conseguimos carregar as integrações agora, com Tentar de novo; os leads continuam chegando normalmente. - Integração pausada sem nada nos últimos 7 dias: Nada chegou nos últimos 7 dias, com o botão Reativar integração. - Filtro do registro sem resultado: Nenhuma entrada com esta situação, com o botão Ver todas. - Primeiro contato parado: O cartão da integração mostra Primeiro contato parado, em vermelho, com o motivo. #### Primeiro contato automático A tela Primeiro contato automático serve para ligar e ajustar a primeira mensagem que sai sozinha pelo WhatsApp quando um lead chega por uma integração: conta, modelo aprovado, variáveis, horário, recontato, teto por dia e custo. Endereço no painel: `/app/integracoes/entrada/‹…›/primeiro-contato` ![Captura da tela Primeiro contato automático. A tela Primeiro contato automático serve para ligar e ajustar a primeira mensagem que sai sozinha pelo WhatsApp quando um lead chega por uma integração: conta, modelo aprovado, variáveis, horário, recontato, teto por dia e custo.](https://attendto.com.br/prints-do-manual/integracoes--primeiro-contato.png) A tela Primeiro contato automático na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Em Integrações, aba Entrada de leads, escolha a integração e clique em Ajustar primeiro contato. Quem usa: Dono, Admin. ##### Trilha e cabeçalho Onde você está e o atalho para o registro da integração. Botões e ações: - **Integrações**: Na trilha, volta para a aba Entrada de leads. - **Ver entradas**: Volta para a aba Entrada de leads com a integração escolhida e rola até o registro. Também aparece: - Trilha Integrações, Entrada de leads e o nome da integração. - Acima do título, o nome da integração. ##### Aviso de saldo insuficiente Aparece quando há leads esperando a primeira mensagem por falta de saldo. Botões e ações: - **Recarregar saldo**: Abre a Carteira para recarregar. Também aparece: - O primeiro contato parou: saldo insuficiente, com quantos leads estão esperando. Ao recarregar, as mensagens saem sozinhas para quem chegou nas últimas 24 horas. ##### Números dos últimos 7 dias Também aparece: - Enviados · 7 dias, com a variação contra a semana anterior. - Responderam, com a porcentagem dos contatados que responderam e foram assumidos pela IA. - Até a mensagem: o tempo típico entre o lead chegar e a mensagem sair. - Gasto · 7 dias: o que foi cobrado na semana, ou o aviso de que a Meta cobra na conta do WhatsApp. ##### Mandar a primeira mensagem sozinho O interruptor geral do primeiro contato desta integração. Botões e ações: - **Mandar a primeira mensagem sozinho** (Dono): Liga ou desliga o envio automático. Desligado, a IA só fala quando o lead escrever, e os ajustes abaixo ficam apagados. Também aparece: - Na integração interna sem primeiro contato, a frase diz que quem chama é o comercial e o interruptor fica travado. - Sem conta do WhatsApp conectada, aparece o aviso com o link para Conexões. ##### Conta e modelo A conta do WhatsApp e os modelos aprovados pela Meta nesta conta. Campos e filtros: - **Conta do WhatsApp**: A conta que envia; a lista mostra quando é a padrão e quando é conta própria (a Meta cobra direto). Trocar de conta atualiza os modelos dela. - **Modelo aprovado**: Um cartão por modelo, com título, nome técnico, categoria, o texto e quem cobra. Modelo que não pode sair no primeiro contato aparece apagado, com o motivo. Botões e ações: - **Atualizar**: Busca de novo a lista de modelos aprovados na Meta. - **Criar modelo**: Abre a criação de um modelo de mensagem, quando a conta não tem nenhum aprovado. - **Atualizar lista**: Busca de novo os modelos, no vazio da lista. - **Tentar de novo**: Repete a atualização dos modelos quando ela falhou; o primeiro contato continua com o modelo escolhido. Também aparece: - Linha Lista atualizada com a Meta, com há quanto tempo. - Quando o modelo escolhido foi pausado ou apagado na Meta, aparece O primeiro contato parou, com o motivo. - Na integração interna, o cartão só mostra a conta, o modelo e o que vai em cada espaço, com o selo de que são definidos pelo formulário: não se troca por esta tela. ##### O que vai em cada espaço da mensagem Aparece quando o modelo tem variáveis: cada espaço numerado vira um dado do lead. Campos e filtros: - **Preencher ‹n› com**: O dado que entra no espaço: Primeiro nome, Nome completo, Nome da empresa, Nome da persona, Nome da campanha de anúncio ou Campo recebido. - **Se faltar, usar**: O texto usado quando o lead não tem o dado. Em branco, a mensagem não sai para quem não tiver o dado, e o motivo fica no registro. - **Nome do campo recebido**: Com Campo recebido, a chave que o seu sistema manda dentro de fields. Também aparece: - Com o nome da campanha, um aviso lembra que o lead vê esse texto: use só se ele for apresentável. ##### Regras de envio Para a mensagem chegar na hora certa, para a pessoa certa, sem gastar à toa. Campos e filtros: - **Das**: A hora de início do envio, de 5h a 14h. - **às**: A hora de fim do envio, de 16h a 23h. O fuso da conta aparece ao lado. - **Teto por dia**: Mensagens por dia nesta integração, de 1 a 5.000. Passou do teto, o resto sai no dia seguinte e você recebe um aviso. Botões e ações: - **‹n› dias**: Escolhe por quantos dias a mesma pessoa não recebe outra primeira mensagem: 15, 30, 60 ou 90 dias, por qualquer integração. - **Diminuir o teto em 50**: Baixa o teto por dia em 50. - **Aumentar o teto em 50**: Sobe o teto por dia em 50. - **Ajustar**: Abre a parte de cobrança das Configurações, onde fica o teto do mês. Também aparece: - Só para quem tem base legal e Nunca interrompe o seu time: regras com o selo Sempre ligada. - A barra das 24 horas mostra o horário escolhido e a hora de agora; a frase abaixo diz se quem chegar agora recebe em segundos ou em qual horário. - Teto do mês com modelos pagos: vale para a conta toda, somando primeiros contatos e cadências, com a barra do quanto já foi usado. - Aviso de que mensagens de marketing em volume alto podem reduzir a qualidade do número na Meta. ##### Como o lead recebe A prévia da mensagem no WhatsApp com um lead de exemplo. Botões e ações: - **Lead sem nome**: Troca a prévia para um lead de exemplo sem nome, para ver o texto de quando o dado falta. - **Ver a IA assumir a conversa**: Simula o lead respondendo e a IA assumindo a conversa. A resposta mostrada é ilustrativa. Depois vira Recomeçar a prévia. Também aparece: - A bolha com os espaços já preenchidos e os botões do modelo. - Com o primeiro contato desligado, a prévia fica coberta pelo aviso Primeiro contato desligado. - Quando a mensagem não sairia para o lead de exemplo, aparece o aviso com o dado que falta. ##### Custo por envio O preço do modelo nesta conta e quanto o saldo aguenta. Campos e filtros: - **Leads por mês**: Régua para simular o volume do mês; abre perto do que chegou no último mês por esta integração. Também aparece: - O valor por lead, debitado antes de cada envio; se a Meta recusar na hora, o valor volta para o saldo. - Estimativa por mês e o máximo por dia com o teto escolhido. - Saldo atual e por cerca de quantos dias ele dura no ritmo estimado, contando a franquia do mês. - Em conta própria do WhatsApp, o cartão diz que não há custo na plataforma: a Meta cobra pela tabela dela. ##### Barra de alterações não salvas Aparece presa ao pé da tela quando algo mudou. Botões e ações: - **Salvar** (Dono): Salva o primeiro contato; vale para os próximos leads desta integração. - **Descartar** (Dono): Volta para o que estava salvo. ##### Estados da tela - Carregando: Números e cartões cinza com o nome da integração ainda em branco. - Se der erro: Não conseguimos carregar o primeiro contato agora, com Tentar de novo; os leads continuam recebendo a mensagem normalmente. - A integração foi excluída: Esta integração não existe mais, com o botão Ver integrações. - A conta não tem modelo aprovado: Nenhum modelo aprovado nesta conta, com Criar modelo e Atualizar lista. - Quem abre é administrador: Tudo aparece, mas o interruptor e os ajustes ficam travados e a barra de salvar não aparece. #### API de entrada de leads A tela API de entrada de leads é a documentação, dentro do painel, para quem programa o sistema que vai mandar leads: autenticação, campos, origem, base legal, respostas, erros e motivos de recusa. Endereço no painel: `/app/integracoes/documentacao` ![Captura da tela API de entrada de leads. A tela API de entrada de leads é a documentação, dentro do painel, para quem programa o sistema que vai mandar leads: autenticação, campos, origem, base legal, respostas, erros e motivos de recusa.](https://attendto.com.br/prints-do-manual/integracoes--documentacao-da-api.png) A tela API de entrada de leads na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Pelos botões Documentação da API, Documentação completa e Ver a documentação da aba Entrada de leads, quando o painel está num endereço de marca própria; no endereço da plataforma, os mesmos botões abrem a página pública numa aba nova. ##### Topo da documentação Botões e ações: - **Enviar o primeiro lead**: Pula para a seção Enviar leads. - **Ver os campos**: Pula para a seção Campos do lead. Também aparece: - Selo Documentação da API · versão 1, a data de atualização e os selos Chave por integração, JSON · UTF-8 e Mensagens em português. - Um exemplo de lead enviado sendo escrito na hora, com a resposta de lead criado. - O endereço da API é o da sua conta e aparece nos exemplos da própria tela. ##### Nesta página O índice que acompanha a leitura, com uma barra de progresso no alto. Botões e ações: - **Voltar ao topo**: Volta ao começo da documentação. Também aparece: - Começando: Visão geral, Autenticação e Enviar leads. - Referência: Campos do lead, Origem do anúncio, Base legal (LGPD), Primeiro contato, Resposta, Erros, Motivos de recusa e Atualizar a etapa. - Boas práticas: Repetidos e reenvio, Limites, Formato do seu sistema e Depois que o lead entra. - Em tela estreita o índice vira uma lista que abre e fecha. - Cada título de seção tem um botão que copia o link direto para ela. ##### Exemplos de código Botões e ações: - **cURL**: Mostra o envio em cURL. - **JavaScript**: Mostra o envio em JavaScript. - **Python**: Mostra o envio em Python. - **PHP**: Mostra o envio em PHP. - **Tudo certo**: Mostra a resposta de quando o lead entrou. - **Com recusa**: Mostra a resposta com um lead recusado e o motivo. - **Chave inválida**: Mostra a resposta de chave inválida. - **Muitas chamadas**: Mostra a resposta de quando o sistema chama demais. - **Copiar o endereço**: Copia o endereço do envio. - **Copiar os cabeçalhos**: Copia os cabeçalhos de autenticação. - **Copiar o exemplo**: Copia o exemplo da linguagem aberta. - **Copiar o lead completo**: Copia o exemplo de lead com todos os campos. - **Copiar a resposta**: Copia a resposta aberta. - **Copiar o exemplo de atualizar a etapa**: Copia o exemplo de mudança de etapa pelo seu sistema. ##### Esta página ajudou? Campos e filtros: - **O que faltou?**: Depois de Não, um campo para contar o que você procurava e não achou. Botões e ações: - **Sim**: Registra que a página ajudou. - **Não**: Abre o campo O que faltou?. - **Enviar**: Manda o comentário; a equipe lê cada mensagem. - **Abrir Integrações no painel**: No fim da página, volta para a aba Entrada de leads. #### Webhooks de saída A tela Webhooks de saída é a documentação, dentro do painel, para quem programa o recebimento dos avisos: como receber, como conferir a assinatura, o envelope, os eventos, os cabeçalhos, as novas tentativas e a pausa automática. Endereço no painel: `/app/integracoes/documentacao/webhooks` ![Captura da tela Webhooks de saída. A tela Webhooks de saída é a documentação, dentro do painel, para quem programa o recebimento dos avisos: como receber, como conferir a assinatura, o envelope, os eventos, os cabeçalhos, as novas tentativas e a pausa automática.](https://attendto.com.br/prints-do-manual/integracoes--documentacao-dos-webhooks.png) A tela Webhooks de saída na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Pelo botão Documentação dos webhooks do cartão Para quem vai programar o recebimento, na aba Webhooks, quando o painel está num endereço de marca própria; no endereço da plataforma, o botão abre a página pública numa aba nova. ##### Topo da documentação Botões e ações: - **Conferir a assinatura**: Pula para a seção que explica como conferir a assinatura do aviso. - **Ver os eventos**: Pula para a lista de eventos. Também aparece: - Selo Documentação dos webhooks · versão 1, a data de atualização e os selos de eventos, JSON · UTF-8 e assinatura. - Um exemplo de aviso de lead qualificado chegando ao seu sistema. ##### Nesta página Botões e ações: - **Voltar ao topo**: Volta ao começo da documentação. - **Node.js**: Mostra a conferência da assinatura em Node.js. Também aparece: - Começando: Visão geral, Receber um aviso e Conferir a assinatura. - Referência: Envelope, Os 13 eventos, Dados pessoais e Cabeçalhos. - Boas práticas: Novas tentativas, Pausa automática, Ordem e duplicidade, Evento de teste e Registro de entregas. - Exemplos de conferência da assinatura em Node.js, Python e PHP. ##### Final da página Botões e ações: - **Sim**: Registra que a página ajudou. - **Não**: Abre o campo O que faltou?. - **Abrir Webhooks no painel**: Volta para a aba Webhooks de Integrações. #### Webhooks A aba Webhooks serve para cadastrar os endereços do seu CRM ou outro sistema que recebem um aviso assinado na hora em que um lead chega, qualifica, vai para um atendente, muda de etapa ou vira venda, e a aba Entregas mostra cada aviso enviado com a resposta. Endereço no painel: `/app/integracoes/webhooks` ![Captura da tela Webhooks. A aba Webhooks serve para cadastrar os endereços do seu CRM ou outro sistema que recebem um aviso assinado na hora em que um lead chega, qualifica, vai para um atendente, muda de etapa ou vira venda, e a aba Entregas mostra cada aviso enviado com a resposta.](https://attendto.com.br/prints-do-manual/integracoes--webhooks.png) A tela Webhooks na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Integrações, aba Webhooks. A aba Entregas fica ao lado; o botão Abrir o registro completo da gaveta de um webhook abre a aba Entregas já filtrada nele. ##### Atalho para os webhooks de entrada Aparece só com o módulo Base avançada ativo. Também aparece: - Cartão Webhooks de entrada · na Base avançada: leva aos avisos que o seu sistema manda para o painel, com regras de quando chegar X, faça Y. ##### Números dos webhooks Também aparece: - Entregues · 7 dias, com a variação sobre a semana passada. - Taxa de entrega das entregas dos últimos 7 dias; quando parte das falhas veio de um endereço já pausado, a frase diz quantas. - Resposta média dos sistemas que recebem. - Tentando de novo, com o horário da próxima tentativa ou nenhuma na fila. ##### Cartão do webhook Um cartão por endereço cadastrado. Botões e ações: - **Ativo**: Interruptor que pausa ou ativa o webhook. Pausado, nada é enviado, e os eventos desse período não ficam na fila. - **Reativar**: No aviso de pausa automática, volta a enviar os próximos avisos; as falhas se reenviam pelo registro de entregas. - **Ver as falhas**: No aviso de pausa automática, abre a gaveta de entregas já em Falharam. - **Entregas**: Abre a gaveta com as entregas deste webhook. - **Testar**: Abre o diálogo Enviar evento de teste. Com o webhook pausado, fica desabilitado com a dica Ative o webhook para testar. - **Editar webhook ‹endereço›**: Botão de lápis: abre o formulário de edição do webhook. - **Excluir webhook ‹endereço›**: Botão de lixeira: abre a confirmação de exclusão. - **Ver na lista de entregas**: No resultado do teste, abre a gaveta de entregas. Também aparece: - O endereço dividido em domínio e caminho. - Selo Ativo, Pausado ou Pausado automaticamente; selo Com dados pessoais ou Sem dados pessoais; quem criou e quando. - Os eventos que o endereço recebe, em etiquetas; os que passam de cinco ficam num +N com a lista ao passar o mouse. - Saúde dos últimos 7 dias: a porcentagem entregue, as falhas, o último envio com Entregue, Não entregue, Tentando de novo ou Nunca disparado, e a barra (vermelha quando falha mais do que entrega). - O resultado do teste aparece no próprio cartão: Enviando o teste, Entregue com o tempo, Não entregue com o motivo, ou Aguardando. ##### Para quem vai programar o recebimento O cartão para mostrar à equipe que cuida do seu CRM. Botões e ações: - **Documentação dos webhooks**: Abre a documentação completa dos webhooks de saída. - **Copiar os cabeçalhos de cada aviso**: Copia o exemplo dos cabeçalhos. Também aparece: - Como saber que o aviso é seu: ler os cabeçalhos X-Webhook-Timestamp e X-Webhook-Signature-V2, calcular a assinatura com o segredo e comparar, e usar X-Webhook-Id para não processar o mesmo aviso duas vezes. - Cabeçalhos de cada aviso, em exemplo. - Se o seu sistema não responder: a trilha das novas tentativas, até a plataforma parar; uma resposta de sucesso conta como entregue. - Depois de muitos avisos seguidos sem sucesso, o webhook é pausado e você é avisado por e-mail e no sino; tudo fica no registro com o botão Reenviar. ##### Diálogo Novo webhook Diga para onde mandar e o que avisar; o mesmo diálogo abre como Editar webhook. Campos e filtros: - **Endereço que vai receber** (obrigatório): O endereço seguro (https) que o seu sistema reservou para os avisos. Endereço sem https, inválido ou de rede interna é recusado com a explicação. - **O que avisar** (obrigatório): Os eventos em grupos (Leads, Funil, Atendimento e Pedidos), com a contagem de marcados. Num webhook novo já vêm marcados lead criado, qualificado, atribuído, mudou de etapa, venda e perdido. - **Segredo de assinatura**: Na edição, o segredo mascarado. Ele só aparece inteiro uma vez, quando o webhook é criado. Botões e ações: - **Marcar todos**: Marca todos os eventos do grupo; com o grupo todo marcado, vira Desmarcar. - **Enviar dados pessoais**: Quando aparece, liga o envio de nome, telefone, e-mail e resumo da conversa para este endereço, depois de uma confirmação. Desligar é direto. - **Gerar segredo novo**: Na edição, pede confirmação e gera um segredo novo; o atual para de valer na hora. - **Manter o atual**: Desiste de gerar o segredo novo. - **Excluir**: Na edição, abre a confirmação de exclusão. - **Cancelar**: Fecha sem salvar. - **Criar webhook**: Cria o webhook e mostra a tela Webhook criado, com o segredo de assinatura. - **Salvar alterações**: Salva; as mudanças valem a partir do próximo aviso. - **Copiar o segredo de assinatura**: Na tela Webhook criado, copia o segredo, que não aparece de novo. - **Enviar evento de teste**: Na tela Webhook criado, abre o teste do webhook. - **Concluir**: Fecha e leva o foco ao botão Testar do cartão novo. Também aparece: - Cada evento tem o nome em português e uma descrição: Lead criado, Lead qualificado, Lead quente, Pediu para não receber mensagens, Dados apagados (LGPD), Mudou de etapa, Venda (ganho), Perdido, Negócio reaberto, Atribuído a um atendente, Transbordo para humano, Primeiro contato e Pedidos importados. - Sem o interruptor de dados pessoais, o formulário avisa que o sistema recebe só identificadores: ID do lead, etapa, nota, valores e campos do negócio que não são sensíveis. - Cada aviso sai assinado no cabeçalho X-Webhook-Signature-V2. ##### Diálogo Ligar dados pessoais? A confirmação antes de ligar dados pessoais num webhook. Botões e ações: - **Manter desligado**: Fecha sem ligar. - **Ligar dados pessoais**: Liga só para este webhook; a mudança fica na auditoria com quem ligou e quando. Também aparece: - Mostra o que passa a sair no aviso Lead qualificado, com as linhas novas destacadas. ##### Diálogo Enviar evento de teste Manda um exemplo com dados fictícios para o endereço. Campos e filtros: - **Evento**: Só os eventos que o webhook recebe, em grupos, com a descrição do escolhido. Botões e ações: - **Copiar corpo**: Copia o corpo do exemplo que vai sair. - **Enviar teste**: Envia o exemplo; o resultado aparece no cartão em alguns segundos. - **Cancelar**: Fecha sem enviar. ##### Diálogo Excluir este webhook? Botões e ações: - **Excluir webhook**: Exclui: o endereço para de receber avisos na hora e o registro de entregas dele é apagado junto. - **Cancelar**: Desiste de excluir; o foco abre neste botão. ##### Gaveta Entregas do webhook As entregas de um webhook, sem sair da aba. Botões e ações: - **Todas**: Mostra todas as entregas do webhook. - **Entregues**: Mostra só as entregues. - **Falharam**: Mostra só as que falharam. - **Reenviar**: Reenvia a entrega aberta com o mesmo ID de evento, para o seu sistema não duplicar. - **Abrir o registro completo**: Abre a aba Entregas já filtrada neste webhook. Também aparece: - Cada entrega abre com a resposta, o erro e o corpo enviado, com o botão Copiar corpo. - Selo Atualiza sozinho enquanto a lista acompanha os envios. ##### Aba Entregas: Registro de entregas Tudo o que saiu para os seus sistemas nos últimos 30 dias. Campos e filtros: - **Filtrar por webhook**: Todos os webhooks ou um endereço. - **Filtrar por evento**: Todos os eventos ou um evento, em grupos. - **Buscar por lead ou ID do evento**: Busca pelo nome do lead ou pelo ID do evento. Botões e ações: - **Todas**: Mostra todas as entregas, com o total. - **Entregues**: Mostra as entregues. - **Falharam**: Mostra as que falharam. - **Ver só esse endereço**: Filtra a lista no endereço pausado que causou as falhas. - **Corpo enviado**: Mostra o corpo que saiu. - **Resposta**: Mostra o começo da resposta do seu sistema. - **Cabeçalhos**: Mostra os cabeçalhos enviados. - **Reenviar**: Reenvia com o mesmo ID de evento. Num webhook pausado, pede antes Reativar e reenviar. - **Reativar e reenviar**: Reativa o webhook pausado e reenvia a entrega. - **Copiar corpo**: Copia o corpo enviado para testar no seu sistema. - **Limpar filtros**: No vazio de um filtro, tira todos os filtros. - **Carregar mais antigas**: Traz mais entregas antigas. - **Ir para os webhooks**: No registro vazio, volta para a aba Webhooks. Também aparece: - Saúde · últimos 7 dias: a taxa em destaque, Entregues, Falharam, Tentando de novo e Resposta média. - Gráfico de entregas por dia: cada barra é um botão que mostra o dia, as entregas, as falhas com o motivo e as pausas. - Lista agrupada por dia, mais recentes primeiro, no horário de Brasília. Cada linha mostra o evento, o lead, a hora, o resumo, o endereço, a tentativa e a situação: Entregue, Tentando de novo, Não entregue ou Na fila. - Ao abrir uma entrega: o aviso, cada tentativa com o código e o tempo, e as abas Corpo enviado, Resposta e Cabeçalhos. ##### Estados da tela - Carregando: Números e cartões cinza enquanto os webhooks e o registro chegam. - Sem nada ainda: Nenhum webhook ainda, com Novo webhook e Ver como funciona. No registro, Nenhuma entrega ainda, com Ir para os webhooks. - Se der erro: Não conseguimos carregar os seus webhooks agora (ou o registro), com Tentar de novo; os avisos continuam saindo normalmente. - Quem abre não é o dono da conta: Os webhooks ficam com o dono da conta: só o dono cria, muda e acompanha os avisos. Vale para as abas Webhooks e Entregas. - O webhook foi pausado automaticamente: O cartão fica com o selo Pausado automaticamente e o aviso com Reativar e Ver as falhas. - Filtro do registro sem resultado: Nenhuma entrega com estes filtros, com Limpar filtros. #### Conversões A aba Conversões serve para devolver à Meta, pela API de Conversões, cada lead qualificado, etapa do funil e venda, para as campanhas procurarem pessoas parecidas com quem compra e não só com quem clica. Endereço no painel: `/app/integracoes/conversoes` ![Captura da tela Conversões. A aba Conversões serve para devolver à Meta, pela API de Conversões, cada lead qualificado, etapa do funil e venda, para as campanhas procurarem pessoas parecidas com quem compra e não só com quem clica.](https://attendto.com.br/prints-do-manual/integracoes--conversoes.png) A tela Conversões na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Integrações, aba Conversões. O aviso do sino de token recusado também leva para esta aba. ##### Abertura e Enviar conversões A explicação, o caminho do anúncio à venda e o controle geral do envio. Botões e ações: - **Enviar conversões** (Dono): Interruptor que liga ou desliga o envio de todas as etapas para a Meta. Só liga depois da conexão conferida. Também aparece: - Título Ensine seus anúncios a trazer quem compra, não só quem clica. - O caminho Anúncio, Lead qualificado, Etapas do quadro e Venda, com o laço de volta para a campanha. - Enviadas · 7 dias e Casadas (a porcentagem casada pelo ID do formulário do anúncio). - A frase de situação: ligado desde quando e por quem, desligado, pronto para ligar, ou parado até trocar o token, com quantas conversões aguardam. - Selo Enviando em tempo real, Envio desligado ou Parado até trocar o token. ##### Faixa de token recusado Aparece no alto quando a Meta recusou o token ou quando é preciso colar o token de novo. Botões e ações: - **Trocar token** (Dono): Leva ao passo 1 e abre o campo do token. Também aparece: - Diz quantas conversões estão aguardando; elas saem sozinhas quando o token é trocado. Para quem não é dono, pede para o dono trocar. ##### Passo 1: Conectar ao seu conjunto de dados Você gera o token na sua conta da Meta e cola aqui, junto com o código de teste; não é pedida senha nem acesso à conta de anúncios. Campos e filtros: - **ID do conjunto de dados** (obrigatório): Só números; no Gerenciador de Eventos, o número em Identificação, abaixo do nome do conjunto. - **Token de acesso** (obrigatório): Cole o token; depois de salvo, ele não aparece inteiro de novo. - **Código de teste** (obrigatório): O código TEST da aba Eventos de teste, canal Site; a conferência manda um evento de teste com ele. Botões e ações: - **Mostrar token** (Dono): Mostra o token digitado; vira Ocultar token. - **Conferir conexão** (Dono): Manda um evento de teste para a Meta e guarda a conexão quando ela é aceita. - **Trocar token** (Dono): Abre o formulário para colar um token novo. - **Conferir de novo** (Dono): Confere de novo a conexão já salva. - **Cancelar** (Dono): Fecha a troca de token sem mudar nada. Também aparece: - Selo do passo: Conectado, Falta conectar, Token recusado ou Cole o token de novo. - Conectado, mostra o Conjunto de dados, o Token de acesso guardado com segurança e a Última conferência. - Onde gerar o token: três passos ilustrados no Gerenciador de Eventos. ##### Passo 2: Escolher o que enviar Cada etapa do quadro vira um evento na Meta; o ganho vai com o valor do negócio. Liberado depois da conexão conferida. Campos e filtros: - **Quadro**: O quadro do Funil cujas etapas viram eventos; cada coluna declara o seu papel no funil. Botões e ações: - **Evento na Meta:** (Dono): Cada linha tem a etapa, o papel, o evento na Meta e um interruptor que liga ou desliga aquela etapa; a mudança grava na hora e mostra Salvo. - **Abrir o Funil**: Quando não há quadro, abre o Funil para criar um. Também aparece: - Selo com quantas etapas estão ligadas das disponíveis. - A coluna de entrada e a de perdido não viram evento; o ganho sai como Compra, com o valor do negócio. - Em segmento de saúde, as conversões ainda não saem, e as linhas aparecem com Não sai neste segmento. ##### Passo 3: Testar Mande um evento de teste e confira na aba de testes do Gerenciador de Eventos que ele chegou. Campos e filtros: - **Código de teste**: O código da aba de testes; sem ele, o evento contaria como real. - **Evento**: Qual etapa ligada vai no teste. Botões e ações: - **Enviar evento de teste** (Dono): Manda o evento de teste com um identificador inventado, que não casa com nenhum cliente seu. - **Ver o que sai no evento de teste**: Mostra o corpo enviado à Meta. ##### Qualidade do casamento Como cada conversão foi ligada a uma pessoa na Meta. Botões e ações: - **7 dias**: Mostra o período de 7 dias. - **30 dias**: Mostra o período de 30 dias. Também aparece: - Enviadas, Aguardando, Recusadas e Puladas. - A barra dividida entre ID do formulário e Telefone e e-mail criptografados. - Por etapa: quantas de cada etapa foram enviadas. - A nota de qualidade que a Meta calcula fica no Gerenciador de Eventos; a tela não inventa esse número. ##### Registro de envios Cada conversão que saiu, está na fila ou foi pulada, com o motivo. Botões e ações: - **Todos**: Mostra todos os envios. - **Enviados**: Mostra os enviados. - **Aguardando**: Mostra os que aguardam. - **Recusados**: Mostra os recusados pela Meta. - **Pulados**: Mostra os pulados, com o motivo. - **Reenviar** (Dono): Reenvia a conversão recusada com o mesmo ID, sem duplicar. - **Mostrar mais**: Traz mais linhas do registro. Também aparece: - Colunas Quando, Lead, Evento, Casamento, Situação, Tentativas e Ação, no horário de Brasília. - A venda marcada pelo seu sistema aparece como Marcada pelo seu sistema. ##### O que vai para a Meta, e o que nunca vai Botões e ações: - **Política de privacidade**: Abre a política de privacidade. Também aparece: - Vai: a etapa alcançada e a hora, o valor da venda, o ID do formulário do anúncio e, sem ele, telefone e e-mail criptografados. - Nunca vai: o nome do lead, a conversa e o resumo da IA, telefone ou e-mail em texto aberto, os campos do negócio e nada de quem pediu para não receber mensagens ou teve os dados apagados. - A Meta não cobra por estes envios, e o seu saldo não é tocado. ##### Estados da tela - Carregando: Blocos cinza da abertura e dos três passos. - Sem nada ainda: Nenhuma conversão enviada ainda: aparece no lugar do registro até conectar e ligar o envio. - Se der erro: Não conseguimos carregar as conversões agora, com Tentar de novo; o envio para a Meta continua funcionando. - Primeira vez, sem conexão: Os passos 2 e 3 ficam travados com Liberado depois que a conexão for conferida. - Quem abre não é o dono: Só o dono da conta conecta, liga o envio e envia o teste; os campos e interruptores aparecem travados. - A conta ainda não tem a função: As conversões ainda não estão disponíveis nesta conta. ### Passo a passo #### Como criar uma integração para receber leads de outro sistema 1. Abra **Integrações** no menu e fique na aba **Entrada de leads**. 2. Clique em **Nova integração**. 3. Em **Nome da integração**, dê um nome fácil de reconhecer e escolha a origem em **De onde vêm esses leads?**. Clique em **Continuar**. 4. Escolha a base legal em **Por que você pode falar com essas pessoas?** e clique em **Continuar**. 5. Decida se o primeiro contato sai sozinho: com **Mandar a primeira mensagem sozinho pelo WhatsApp** ligado, escolha a **Conta do WhatsApp**, o **Modelo aprovado** e o **Teto por dia**. Clique em **Continuar**. 6. Escolha o **Quadro do Funil**, a **Coluna de entrada** e as **Etiquetas automáticas** e clique em **Criar integração**. 7. Na tela Integração criada, clique em **Copiar a chave** e em **Copiar o endereço** e passe os dois para quem cuida do seu sistema. A chave não aparece de novo. 8. Clique em **Enviar lead de teste** para ver o caminho funcionando, ou em **Concluir**. #### Como receber no próprio WhatsApp o primeiro contato de um lead de teste 1. Em **Integrações**, aba **Entrada de leads**, clique no cartão da integração. 2. No cartão **Enviar lead de teste**, ligue **Mandar o primeiro contato para o meu WhatsApp**. 3. Preencha **Seu celular** com DDD. 4. Clique em **Enviar lead de teste** e acompanhe os quatro passos até Entregue no seu WhatsApp. 5. Responda a mensagem no seu celular para ver a IA assumir a conversa. O lead aparece no topo de **Últimos leads recebidos** com o selo Teste. #### Como ajustar o horário, o recontato e o teto do primeiro contato automático 1. Em **Integrações**, aba **Entrada de leads**, escolha a integração e clique em **Ajustar primeiro contato**. 2. Confira se **Mandar a primeira mensagem sozinho** está ligado. 3. Em **Conta e modelo**, escolha o modelo aprovado e, se o modelo tiver espaços, diga o que vai em cada um e o texto de **Se faltar, usar**. 4. Em **Regras de envio**, escolha o horário em **Das** e **às**, quantos dias esperar para não mandar de novo à mesma pessoa e o **Teto por dia**. 5. Confira a prévia em **Como o lead recebe** e o custo em **Custo por envio**. 6. Clique em **Salvar** na barra do pé da tela. #### Como gerar uma nova chave de integração quando a antiga vazou ou se perdeu 1. Combine com quem cuida do seu sistema: a chave antiga para de funcionar na hora. 2. Em **Integrações**, aba **Entrada de leads**, clique em **Mais** no cartão da integração e escolha **Gerar nova chave** (ou clique em **Gerar nova** no cartão **Como conectar**). 3. Confirme em **Gerar nova chave**. 4. Clique em **Copiar a chave nova**, troque a chave no seu sistema e clique em **Já guardei a chave**. #### Como receber leads de um sistema que manda um formato próprio 1. No cartão **Como conectar** da integração, clique em **Receber no formato do seu sistema**. 2. Cole em **Exemplo do seu sistema** um exemplo real do que o sistema envia e clique em **Encontrar campos**. 3. Em **Campos encontrados**, escolha o destino de cada campo e ligue pelo menos um ao Telefone. 4. Confira a prévia em Assim ficaria o lead e clique em **Salvar formato**. #### Como criar um webhook para avisar o CRM quando um lead qualifica ou vira venda 1. Em **Integrações**, abra a aba **Webhooks** e clique em **Novo webhook**. 2. Preencha **Endereço que vai receber** com o endereço https do seu sistema. 3. Em **O que avisar**, marque os eventos; **Marcar todos** marca um grupo inteiro. 4. Clique em **Criar webhook** e depois em **Copiar o segredo de assinatura**: ele aparece uma vez só. 5. Clique em **Enviar evento de teste**, escolha o **Evento** e clique em **Enviar teste**. O resultado aparece no cartão. #### Como reenviar um aviso de webhook que não foi entregue 1. Corrija antes o problema no sistema que recebe. 2. Em **Integrações**, abra a aba **Entregas** e clique em **Falharam**. 3. Abra a entrega e confira a aba **Resposta**. 4. Clique em **Reenviar**. Se o webhook estiver pausado, confirme em **Reativar e reenviar**. O aviso sai com o mesmo ID de evento, sem duplicar no seu sistema. #### Como ligar as conversões da Meta para os anúncios aprenderem com as vendas 1. No Gerenciador de Eventos da Meta, gere o token de acesso do conjunto de dados e copie o código de teste. 2. Em **Integrações**, abra a aba **Conversões**. 3. No passo 1, preencha **ID do conjunto de dados**, **Token de acesso** e **Código de teste** e clique em **Conferir conexão**. 4. No passo 2, escolha o **Quadro** e ligue as etapas que devem virar evento. 5. No passo 3, clique em **Enviar evento de teste** e confira a chegada no Gerenciador de Eventos. 6. Ligue **Enviar conversões** no alto da aba. ### Perguntas frequentes #### Onde encontro o endereço para o meu sistema mandar os leads? No cartão Como conectar da integração, no campo Endereço do envio, com o botão de copiar. O mesmo endereço aparece nos exemplos da tela de documentação da API. #### O lead de teste entra nos números e nos relatórios? Não. Ele aparece no topo de Últimos leads recebidos com o selo Teste, mas não entra nos números da integração, nos relatórios nem nos webhooks. #### O que acontece se o meu sistema mandar o mesmo lead duas vezes? O reenvio repetido é ignorado, sem custo e sem mensagem nova. O cartão da integração e o registro mostram quantos reenvios repetidos foram ignorados nos últimos 7 dias. #### Por que não consigo ligar o primeiro contato numa integração? O interruptor fica travado quando a base legal é São meus clientes, quando não há conta do WhatsApp conectada, quando não dá para confirmar quem paga o envio do modelo ou quando quem abre não é o dono da conta. #### O saldo acabou. Os leads perdem o primeiro contato? Não de imediato. A tela do primeiro contato mostra quantos leads estão esperando e, ao recarregar o saldo, as mensagens saem sozinhas para quem chegou nas últimas 24 horas. #### Pausei um webhook. Os avisos do período ficam guardados? Não. Pausado, nada é enviado e os eventos desse período não ficam na fila. O que falhou antes da pausa continua no registro de entregas e pode ser reenviado depois de reativar. #### Excluir um webhook apaga o histórico de entregas? Sim. O endereço para de receber avisos na hora e o registro de entregas dele é apagado junto. #### O administrador da conta pode criar integrações e webhooks? Não. O administrador vê as integrações, o registro e a tela do primeiro contato sem os botões de mudança. Webhooks, Entregas e o envio de conversões ficam com o dono da conta. #### O meu sistema pode mudar a etapa do lead no Funil? Pode, se o interruptor Este sistema pode atualizar as etapas do funil estiver ligado na integração. Desligado, a chave só envia leads. A venda marcada pelo sistema também vai para as conversões da Meta. ### Guia: Integrações Quatro abas: receber leads de outros sistemas, avisar o seu sistema quando algo acontece aqui, acompanhar cada aviso entregue e receber os pedidos das suas vendas. Integrações é a tela que conversa com os outros sistemas da sua empresa. Ela tem quatro abas: **Entrada de leads** traz leads de outros sistemas para cá, **Webhooks** avisa o seu sistema quando algo acontece aqui, **Entregas** mostra cada aviso que saiu e a resposta do seu sistema, e **Pedidos** recebe as vendas que alimentam o Monitor de sucesso. Dá para usar só uma, e a maioria começa pela entrada de leads. Cada aba tem endereço próprio, então dá para mandar o link direto de uma delas para quem cuida do seu sistema. Os webhooks, que antes ficavam em Configurações, agora moram aqui, do mesmo jeito que você deixou. #### Entrada de leads Cada sistema que manda leads (o distribuidor dos seus anúncios, o formulário do site, um portal, o seu CRM) ganha uma integração com chave própria. O lead entra com a origem completa, vai direto para a coluna do Funil que você escolheu e, se você ligar, recebe a primeira mensagem pelo WhatsApp em segundos. O passo a passo completo, com base legal, custo e o lead de teste, está em [Receber leads de outros sistemas](https://attendto.com.br/manual/integracoes). O botão **Documentação da API**, no alto da aba, abre a página para quem programa: endereço, formato, exemplos prontos em várias linguagens e o significado de cada resposta. Na tela: Tela de Integrações na aba Entrada de leads, com as abas Webhooks, Entregas e Pedidos ao lado e os cartões das integrações. As quatro abas no alto; a Entrada de leads abre primeiro. #### Webhooks e Entregas: avisar o seu sistema Na aba **Webhooks** você cadastra o endereço do seu sistema e escolhe, entre 13 eventos, o que avisar: lead criado, qualificado, atribuído a um atendente, transbordo para humano, mudou de etapa, venda, perdido e outros. Cada aviso sai assinado, é tentado até 6 vezes e fica na aba **Entregas** por 30 dias, com o botão **Reenviar**. Os avisos levam identificadores e os campos do negócio que não são sensíveis: nome, telefone e e-mail do lead não saem. O passo a passo, os eventos, os dados pessoais e o que fazer quando uma entrega falha estão em [Webhooks: avise o seu CRM a cada passo](https://attendto.com.br/manual/integracoes). Lead de teste, criado pelo botão **Enviar lead de teste** da entrada de leads, nunca sai em webhook: o seu sistema só é avisado de lead de verdade. #### Pedidos: receber as vendas do seu sistema 1. **Gere a chave**: **Gerar chave** cria a credencial que o seu sistema vai usar. Ela aparece por inteiro **uma única vez**: copie na hora e guarde onde você guarda senha. 2. **Mande o exemplo para quem programa**: O bloco de exemplo já vem com o endereço de ingestão preenchido. Copiar o exemplo e a chave é tudo o que a outra ponta precisa para a primeira chamada. 3. **Empurre os pedidos**: Cada pedido leva um identificador do lado de vocês (`external_id`). Mandar o mesmo pedido de novo **não duplica**: ele é reconhecido e atualizado. 4. **Confira no Monitor**: Pedido que entrou vira histórico de compra do contato e aparece no [Monitor de sucesso](https://attendto.com.br/manual/monitor-de-sucesso). Se não apareceu, o problema é o casamento com o contato, o próximo aviso. > **O pedido precisa achar um contato que já existe:** A importação casa por telefone ou e-mail com alguém que **já está** na sua [Base de contatos](https://attendto.com.br/manual/base-de-contatos). Pedido de quem nunca falou com você e nunca foi importado não encontra dono. Quando "metade sumiu", é quase sempre isto, e não a chave ou o endereço. Importe a base antes de ligar a torneira dos pedidos. > **Gerar nova chave de pedidos não pede confirmação:** Na aba Pedidos, um clique em **Gerar nova chave** já cria a nova e **invalida a anterior no mesmo segundo**. Não há "tem certeza?", não há desfazer, e o sistema que ainda usa a chave velha para de mandar pedidos na hora, em silêncio, do seu lado. Só clique com quem cuida do seu sistema disponível para trocar a chave lá. A chave de cada integração de entrada de leads é outra, e essa pede confirmação. #### Quem consegue mexer > **Só o dono da conta:** Criar, editar, pausar e excluir integrações, gerar chaves e cadastrar webhooks é do dono da conta: para os outros papéis, os botões não aparecem, e as abas Webhooks e Entregas dizem que ficam com o dono. Na aba Pedidos, um administrador vê a aba **como se estivesse vazia**, sem mensagem de permissão. Então, se você jurava ter uma chave gerada e encontra a aba limpa, entre com o usuário dono da conta antes de gerar outra: gerar de novo invalidaria justamente a que está funcionando. #### Como é quando está bem - Cada sistema que manda leads com a sua própria integração, e os **Últimos leads recebidos** sem nada em **Com problema**. - Os webhooks com a saúde dos 7 dias perto de 100%, nenhum **Pausado automaticamente** e o **Último envio** batendo com o movimento do dia. - As chaves guardadas fora do painel, junto das outras credenciais do seu sistema. - O aviso **Pediu para não receber mensagens** integrado com qualquer outra ferramenta sua que dispare mensagem. - Pedidos entrando sozinhos e o [Monitor de sucesso](https://attendto.com.br/manual/monitor-de-sucesso) com dado do mês inteiro, e não do dia em que alguém lembrou de subir planilha. Webhooks, pedidos e chaves não debitam saldo. O que custa é o primeiro contato automático da entrada de leads, quando você o liga numa conta do WhatsApp da plataforma: o valor aparece antes de ligar, e as regras estão em [Receber leads de outros sistemas](https://attendto.com.br/manual/integracoes). No painel: Abrir Integrações. Abra junto com quem cuida do seu sistema: as chaves aparecem uma vez só. ### Guia: Receber leads de outros sistemas O seu distribuidor de leads, o formulário do site ou o seu CRM mandam o lead para cá, e a IA manda a primeira mensagem pelo WhatsApp em segundos. A **Entrada de leads** é a primeira aba de [Integrações](https://attendto.com.br/manual/integracoes). Cada sistema que manda leads para cá ganha a sua **integração**: um nome, uma chave própria, a base legal declarada, o primeiro contato pelo WhatsApp e o lugar do Funil onde o cartão nasce. Todo lead que entra fica registrado, com a origem completa: campanha, conjunto, anúncio e UTM. O ID do anúncio liga o lead ao gasto da planilha em [Investimento → Venda](https://attendto.com.br/manual/investimento). Quem programa encontra o endereço, os exemplos de código e as respostas da API no botão **Documentação da API**, no alto da tela. Este guia é para quem configura e acompanha. Na tela: Aba Entrada de leads com a apresentação no alto e os cartões de três integrações ativas, cada um com os números dos últimos 7 dias. Cada cartão mostra a chave mascarada, os números da semana e se o primeiro contato está ligado. #### Criar uma integração 1. **Nome e origem**: **Nova integração** abre um assistente de quatro passos. Dê um nome que você reconheça depois ("Distribuidor — anúncios Meta") e diga de onde vêm os leads. A origem só muda o ícone e a ajuda do passo. 2. **Base legal**: Diga por que você pode falar com essas pessoas. Nenhuma opção vem marcada: é uma declaração sua, e ela fica registrada com o seu nome. As regras de cada base estão logo abaixo. 3. **Primeiro contato**: Escolha a conta do WhatsApp e o modelo aprovado que sai sozinho para cada lead novo. A prévia mostra a mensagem com um lead de exemplo, e a faixa de custo mostra quanto cada envio custa antes de você ligar. 4. **Destino**: O quadro e a coluna do Funil onde o cartão nasce, e as etiquetas que cada lead ganha ao entrar. O assistente já sugere uma etiqueta pela origem ("anúncio meta", por exemplo): tire no X se não quiser. 5. **Guarde a chave**: Ao criar, a chave aparece **uma única vez**. Copie e entregue a quem cuida do seu sistema, junto com o endereço. Depois disso, a tela mostra só o começo e o fim dela. 6. **Envie um lead de teste**: Antes de ligar o seu sistema, use **Enviar lead de teste** e acompanhe cada passo acontecendo. O teste está explicado mais abaixo. Na tela: Passo 3 do assistente de nova integração: a conta do WhatsApp, o modelo aprovado, a prévia da mensagem com um lead de exemplo e a faixa de custo. No passo 3, a prévia mostra a mensagem com um lead de exemplo e a faixa diz quanto cada envio custa. #### A base legal de cada lead Sem base legal, o lead é recusado na entrada e nenhum dado dele fica guardado. A base pode vir no próprio lead, mandada pelo seu sistema, ou ser a **base padrão** da integração, a que você escolheu no passo 2. Quando as duas existem, vale a do lead, e o registro diz que ela veio do seu sistema. - **Pediram para eu entrar em contato**: A pessoa preencheu um formulário ou um anúncio pedindo contato. É a base certa para lead de anúncio, e a que libera o primeiro contato automático. - **Já coletei o consentimento deles**: A pessoa autorizou receber mensagens da sua empresa. Também libera o primeiro contato automático. - **São meus clientes**: Pessoas com quem você já tem contrato. O lead entra normalmente, mas **o primeiro contato automático não sai**: mensagem de marketing para cliente de contrato precisa do consentimento dele. > **O primeiro contato não põe ninguém numa cadência:** A primeira mensagem é uma só. A cadência de [Follow-up](https://attendto.com.br/manual/follow-up) continua exigindo o consentimento do próprio lead, que ele dá na conversa: quem não responde ao primeiro contato não entra sozinho em cadência automática. Na ficha do lead, a base aparece como uma frase: "Pediram para entrar em contato · declarada por Marcelo Antunes pela integração Distribuidor em 22/09/2026". Trocar a base padrão depois não apaga quem declarou na época. #### O primeiro contato automático Ligado, todo lead novo com base legal recebe um modelo aprovado pela conta do WhatsApp que você escolheu, assinado pela persona daquela conta. No Inbox, a mensagem aparece com a etiqueta **Primeiro contato automático** e o nome do modelo. Se o lead responder, a IA assume a conversa como sempre. Ao abrir a integração, **Ajustar primeiro contato** leva à tela completa: conta e modelo, o que vai em cada espaço da mensagem, as regras de envio, a prévia de como o lead recebe e o custo por envio. Nada muda até você clicar em **Salvar**, na barra que aparece embaixo. Na tela: Tela do primeiro contato automático: os números da semana, o interruptor, a conta e o modelo escolhido, e a prévia de como o lead recebe a mensagem. Se o modelo escolhido for pausado ou apagado na Meta, a tela e o cartão da integração avisam que o primeiro contato parou. - **Horário de envio**: Das 8h às 21h, no fuso da sua conta (horário de Brasília, se nenhum foi configurado). Lead que chegar fora desse horário recebe a mensagem no começo do próximo horário, e o mesmo vale para a mensagem que ficou esperando recarga, respeitando o teto por dia. A IA continua respondendo 24 horas se o lead escrever. - **Variáveis da mensagem**: Cada espaço do modelo recebe um dado do lead: primeiro nome, nome completo, nome da empresa, da persona, da campanha ou um campo que o seu sistema mandou. Ao criar a integração, o primeiro espaço já vem com o primeiro nome e o segundo com o nome da persona. Espaço sem valor usa o texto padrão que você escrever ao lado. Sem texto padrão, a mensagem não sai. - **Não mandar de novo para a mesma pessoa**: Quem se cadastrar de novo dentro do prazo escolhido, por qualquer integração, não recebe outra primeira mensagem. Mesmo ligado, o primeiro contato não sai, e o registro diz o motivo, quando: - a pessoa pediu para não receber mensagens, mesmo que se cadastre de novo; - o contato está marcado para não receber campanha; - o número não é um celular do Brasil (o lead entra, e a IA responde se ele escrever); - um atendente está na conversa: a mensagem fica de fora e o histórico do lead anota; - o lead já está conversando com você: a IA segue sem gastar modelo; - já houve um primeiro contato para essa pessoa dentro do prazo. #### Quanto custa e quando é cobrado O custo aparece no passo 3 e na tela do primeiro contato, antes de você ligar. Ele depende da conta do WhatsApp escolhida e da categoria do modelo. - **Conta da plataforma**: Cada envio é **debitado do seu saldo antes de sair**, primeiro da franquia do plano e depois do saldo. Consulte o valor por categoria em [Saldo & Recargas](https://attendto.com.br/manual/saldo-e-recargas). - **Conta própria do WhatsApp**: Sem custo na plataforma. A Meta cobra direto no cartão da sua conta, pela tabela dela. No seletor **Conta do WhatsApp**, ela aparece com **conta própria** ao lado do número. - **Não enviado**: A Meta recusou o envio na hora, ou a conta caiu antes de ele sair: há certeza de que a mensagem não saiu. O valor **volta para o saldo** e o extrato mostra a devolução. - **Falhou depois de sair**: A Meta aceitou o envio e avisou depois que não conseguiu entregar (um número sem WhatsApp, por exemplo). A tarifa já correu, então o valor **não volta**. A mensagem aparece como **Falhou** no Inbox. - **Envio não confirmado**: O WhatsApp não confirmou se a mensagem saiu. O valor fica debitado, porque ela pode ter chegado. Confira a conversa no Inbox antes de clicar em **Reenviar**: reenviar cria um envio novo e cobra de novo. - **Sem saldo**: A mensagem espera a recarga por até 24 horas e sai sozinha quando o saldo volta. Depois disso, é dispensada. > **Dois tetos seguram o gasto:** O **teto por dia** é de cada integração: passou dele, o resto sai no dia seguinte. O **teto do mês com modelos pagos** é da conta toda e soma primeiros contatos e cadências. Atingido, o primeiro contato para até o mês virar. Os dois avisam você no sino quando chegam no limite. O teto do mês também pode ser mudado em [Configurações](https://attendto.com.br/manual/configuracoes), na aba Cobrança & alertas. Quando o primeiro contato de uma integração para (saldo insuficiente, modelo pausado ou apagado na Meta, conta do WhatsApp desconectada, teto do mês atingido), o sino mostra o aviso enquanto o problema durar, e o cartão da integração diz o que parou. No celular chega no máximo um aviso por integração por dia. #### Onde o lead aparece Com destino escolhido, o cartão nasce direto na coluna do quadro que você indicou. **O destino da integração manda no quadro escolhido; os outros quadros seguem as regras deles.** Sem destino, o cartão nasce em cada quadro que tem regra para lead novo, como já acontece hoje. Quando o telefone já é de um lead seu, nada é duplicado: só o que está vazio é preenchido, as etiquetas são somadas, e a ficha ganha a linha "Entrou de novo pela campanha X". Nada que o seu time digitou é apagado, e quem já tem cartão no quadro de destino não ganha outro. Na ficha, no Inbox e no cartão do Funil, o lead ganha o selo **Veio da integração**, com a campanha e o conjunto. A ficha mostra também os **Dados recebidos**: cada campo que o seu sistema mandou, com nome legível. Um campo em `fields` com o **Nome na API** de um campo do negócio (em Funil → Configurar quadro → Campos do cartão) preenche esse campo no cartão. Campo de moeda vai em reais (`450000` ou `"450.000,00"`); os webhooks devolvem em centavos. Valor que não serve para o campo (uma data que não existe, uma opção fora da lista) fica em Dados recebidos, e o registro da entrada diz qual campo foi ignorado e por quê. #### Atualizar a etapa pelo seu sistema Com a permissão **Atualizar etapas** ligada (ao abrir a integração, em **Editar**), a mesma chave move o cartão do lead no quadro de destino (ou no quadro padrão, sem destino) pela rota `stage` da API, usando o **Nome na API** de cada coluna, que fica em Configurar quadro → Colunas e etapas. A permissão vem **desligada**, vale só para esta integração e cada mudança fica na auditoria. Com ela desligada, a chave só envia leads. > **A etapa que pede dados também pede pela API:** Se a coluna pede campos para o cartão entrar, a chamada precisa mandar esses campos em `fields`. Voltar uma etapa só com `allow_backwards`, e a perda precisa de um motivo de perda que exista naquele quadro. Mandar a mesma etapa de novo não move o cartão nem repete os avisos; campos diferentes são gravados. #### Quando o seu sistema manda um formato próprio Se o seu sistema não consegue mandar no nosso formato, use **Receber no formato do seu sistema**, no passo 4 do assistente ou em **Como conectar**, ao abrir a integração. Cole um exemplo do que ele manda: os campos aparecem sozinhos, e você diz qual é o telefone, o nome, o e-mail e a campanha. O telefone é obrigatório. O que você não ligar a nada chega em **Dados recebidos**. Ao abrir de novo, o diálogo mostra as ligações que você salvou. O **Enviar lead de teste** não passa pelo formato do seu sistema: ele funciona igual, e a mensagem de teste chega com o seu nome. #### Os últimos leads recebidos Ao abrir uma integração, a lista **Últimos leads recebidos** se atualiza sozinha. Os filtros separam **Novos**, **Contatados**, **Responderam** e **Com problema**. Clique numa linha para ver tudo o que entrou, a base legal, a linha do tempo e os atalhos para a conversa e a ficha. Na tela: Lista de últimos leads recebidos com os filtros no alto e linhas na fila, respondidas, contatadas e uma entrada recusada por telefone inválido. Cada linha traz a origem do anúncio, a situação do primeiro contato e, quando houver, o motivo. - **Na fila e Agendado**: A mensagem vai sair em segundos, ou no começo do próximo horário de envio. - **Contatado**: O primeiro contato saiu. Vira **Respondeu** quando o lead escreve de volta. - **Sem envio**: O lead entrou, mas a mensagem não saiu, por um dos motivos de cima. O motivo aparece na linha. - **Bloqueado**: A pessoa pediu para não receber mensagens. A entrada fica registrada só com a origem, e a ficha dela avisa que ela se cadastrou de novo e que nenhuma mensagem automática é enviada. - **Não confirmado, Falhou e Sem saldo**: Veja o que cada um quer dizer no custo. - **Recusado**: O lead não entrou (sem base legal ou sem telefone, por exemplo). A linha mostra só o telefone mascarado e o motivo, com o detalhe quando o telefone é inválido ("veio sem DDD"), e some depois de 7 dias. O mesmo lead reenviado pelo seu sistema não vira linha nova nem custa nada: o cartão da integração conta esses reenvios repetidos à parte. #### O lead de teste **Enviar lead de teste** manda um lead de verdade pela integração, marcado como teste. Ele aparece no topo da lista com o selo **Teste** e fica fora dos números de leads, dos relatórios de leads e dos webhooks. Na ficha, o botão **Apagar lead de teste** tira o lead e a conversa do painel. > **Receba você mesmo o primeiro contato:** Ligue **Mandar o primeiro contato para o meu WhatsApp** e informe o seu celular: você recebe a mensagem do jeito que o lead recebe, com o **seu** primeiro nome onde entraria o do lead. Esse teste usa um envio do modelo e é cobrado como um envio normal: o valor aparece no extrato e no gasto da tela do primeiro contato. #### Chave, pausa e exclusão - **Gerar nova chave**: Pede confirmação. Confirmada, a chave atual para de funcionar na hora, e o sistema que usa esta integração precisa receber a nova. - **Pausar**: A integração passa a recusar os envios até você reativar. As primeiras mensagens que ainda esperavam para sair (fora do horário ou sem saldo) também não saem. Nada é apagado. - **Excluir**: Pede confirmação. A chave para na hora. Os leads e as entradas que já chegaram continuam no painel. No painel: Abrir Integrações. Crie a primeira integração e mande um lead de teste antes de ligar o seu sistema. ### Guia: Webhooks: avise o seu CRM a cada passo O seu CRM fica sabendo na hora quando um lead chega, qualifica, vai para um atendente, muda de etapa ou vira venda, com cada entrega registrada e o botão Reenviar. Os **Webhooks** são a segunda aba de [Integrações](https://attendto.com.br/manual/integracoes). Cada webhook é um endereço do seu sistema que recebe um aviso a cada evento que você escolheu, assinado com um segredo próprio. Tudo o que sai fica na aba **Entregas** por 30 dias, com o corpo enviado, a resposta e cada tentativa. Quem programa encontra os exemplos de cada evento, a conferência da assinatura e as regras das novas tentativas no botão **Documentação dos webhooks**, no cartão **Para quem vai programar o recebimento**. Este guia é para quem configura e acompanha. #### Criar um webhook 1. **Abra o formulário**: Abra **Integrações → Webhooks → Novo webhook**. 2. **Endereço e eventos**: Cole o endereço do seu sistema (HTTPS) e escolha os eventos, em grupos: lead, atendimento, funil e pedidos. 3. **Guarde o segredo**: Guarde o segredo de assinatura: ele aparece uma vez. 4. **Teste**: Clique em **Testar**: o resultado aparece no próprio cartão. Na tela: Aba Webhooks: os números dos últimos 7 dias e os cartões de três endereços, um deles pausado automaticamente. A aba Webhooks, com a saúde de cada endereço. O interruptor **Ativo** pausa o webhook: nada é enviado até você reativar, e os eventos desse período não ficam na fila. **Editar** muda o endereço e os eventos, e é lá também que fica o **Gerar segredo novo**: o segredo atual para de valer na hora, então atualize o seu sistema logo depois. #### Os 13 eventos Lead criado, lead qualificado, lead quente, atribuído a um atendente, transbordo para humano, primeiro contato, mudou de etapa, venda, perdido, negócio reaberto, pediu para não receber mensagens, dados apagados e pedidos importados. O “lead qualificado” sai uma vez por lead. O aviso de mudança de etapa traz o papel da coluna no campo `role` (entrada, qualificado, atendimento, intermediária, ganho ou perdido), para o seu sistema entender qualquer quadro (pode vir vazio enquanto as colunas do quadro não tiverem papel). #### Dados pessoais: não saem Os avisos levam identificadores: o ID do lead, o ID no seu sistema, a etapa, a nota e os valores. A mudança de etapa e a venda levam também os campos do negócio que não são sensíveis; campo de texto livre leva o que o time escreveu nele. Nome, telefone, e-mail e o resumo da conversa não saem, e campo marcado como sensível nunca sai. Quando um titular pede para apagar os dados, o aviso **Dados apagados (LGPD)** sai para o seu sistema apagar o que guardou sobre ele, e o começo da resposta do seu sistema é apagado do registro de entregas. #### Entregas, tentativas e reenvio Cada aviso é tentado até 6 vezes: na hora, depois de 1 min, 5 min, 30 min, 2 h e 6 h. Na aba **Entregas** você vê cada tentativa; ao abrir uma entrega, aparecem a resposta do seu sistema e o corpo enviado. **Reenviar** manda com o mesmo ID de evento, para o seu sistema não duplicar. Depois de 50 avisos seguidos sem sucesso, o webhook é pausado e você recebe um aviso. Na tela: Aba Entregas: a saúde dos últimos 7 dias com o gráfico por dia e a lista de entregas com os filtros. O registro de entregas: a saúde dos 7 dias, o gráfico por dia e cada entrega, com o Reenviar nas que falharam. O aviso de pausa aparece no cartão, no sino e por e-mail. Corrija o endereço no sistema que recebe e clique em **Reativar**; as entregas que ficaram de fora continuam no registro, com o botão **Reenviar**. Os avisos do período em que ele ficou pausado sozinho também estão lá, como **Não entregue**: nada se perde. Reenviar uma entrega de um webhook pausado pede **Reativar e reenviar**. #### Ordem e duplicidade Os avisos podem chegar fora de ordem quando há novas tentativas. Ordene pelo campo `occurred_at` e ignore um `event_id` que já chegou. No transbordo automático com rodízio chegam dois avisos de transbordo, um da IA e outro da atribuição. #### Endereços que não são aceitos A recusa vem com o motivo específico, embaixo do campo do endereço. As regras: - `https`, sempre. `http` não passa. - Porta padrão. Endereço com porta alternativa é recusado. - Sem usuário e senha embutidos no endereço. - Endereço público. Endereço da rede interna da sua empresa é bloqueado. Se o sistema que precisa ser avisado só existe dentro da rede da empresa, o caminho é publicar um endereço na internet que converse com ele, e não insistir em cadastrar o interno aqui. > **Excluir não tem volta:** **Excluir** pede confirmação e, confirmado, o endereço para de receber na hora e o registro de entregas dele é apagado junto. O segredo vai embora também: recriar o mesmo endereço depois gera um segredo novo, e o seu sistema precisa trocar. Se a ideia é só pausar, use o interruptor **Ativo**. #### Quem consegue mexer Webhooks e entregas são do dono da conta. Para os outros papéis, as duas abas mostram que ficam com o dono, sem os endereços e sem o registro. Webhooks e entregas não debitam saldo. No painel: Abrir Webhooks. Abra junto com quem cuida do seu CRM: o segredo aparece uma vez só. ### Guia: Conversões para os seus anúncios Devolva à Meta quem qualificou e comprou #### O que é Quando um lead qualifica, avança nas etapas do seu quadro ou fecha negócio, o painel avisa a Meta. As campanhas aprendem a procurar pessoas parecidas com quem avançou no seu funil, e não só com quem clicou. No passo **Escolher o que enviar**, escolha o quadro: cada coluna entre a entrada e o ganho pode virar um evento, e o ganho sai como Compra, com o valor. > **Nos segmentos de saúde, as conversões ainda não saem:** Consulta é dado de saúde (LGPD, art. 11). Contar à Meta que um paciente agendou ou compareceu pede um consentimento do paciente só para essa finalidade, e o painel ainda não pede esse consentimento. Por isso, num quadro de segmento de saúde, nenhuma etapa vira evento por enquanto. O paciente que está num quadro de saúde também fica de fora quando o quadro escolhido é de outro segmento. Na tela: A aba Conversões de Integrações com a conexão conferida: o controle Enviar conversões ligado, com as enviadas da semana e as casadas, e os três passos da configuração — o conjunto de dados conectado, as etapas do quadro Imobiliária com o evento de cada uma e o teste. A aba Conversões, com o quadro Imobiliária. #### Antes de começar: o conjunto de dados, o token e o código de teste Tudo acontece no **Gerenciador de Eventos** da Meta, com a conta que administra os seus anúncios. Não precisa de revisão nem de aprovação da Meta, e você não passa senha nem acesso para o painel. 1. **Crie ou escolha o conjunto de dados**: Se o seu site já tem o Pixel da Meta, use o conjunto de dados dele. Se não tem, clique em **Conectar dados**, escolha **Web**, depois **Criar novo conjunto de dados**, dê um nome e ligue à conta de anúncios que roda as campanhas. Não use um conjunto com ícone de celular: ele é de um aplicativo. 2. **Anote o ID**: Em **Conjuntos de dados**, abra o conjunto. O ID é o número que aparece abaixo do nome, como **Identificação**. 3. **Gere o token**: Na aba **Configurações** do conjunto, desça até **API de Conversões** e, em **Configurar integração direta**, clique em **Gerar token de acesso**. Copie o token na hora: a Meta mostra uma vez só. Se escolher a opção com a Dataset Quality API, deixe marcado só este conjunto, porque a Meta não deixa desfazer essa escolha. 4. **Copie o código de teste**: Na aba **Eventos de teste**, escolha o canal **Site** e abra **Confirme se os eventos do seu servidor estão configurados corretamente**. O código começa com TEST. 5. **Cole e confira**: Em **Integrações → Conversões**, cole o ID, o token e o código de teste e clique em **Conferir conexão**. A conferência manda à Meta um evento de teste de Lead qualificado, com um identificador inventado que não casa com nenhum cliente seu. Os três campos são obrigatórios. 6. **Escolha, teste e ligue**: Escolha as etapas no passo 2, mande um evento de teste no passo 3 e ligue **Enviar conversões** no topo. > **Se a página da Meta der erro ao gerar o token:** A Meta pode pedir uma confirmação de segurança ao gerar o token. Se a página mostrar "Opa! Ocorreu um erro", gere o token no navegador em que você sempre entra na Meta. > **O token fica cifrado:** O token fica guardado cifrado e nunca aparece inteiro de novo. Se precisar, cole um token novo em **Trocar token**. #### O que vai e o que nunca vai - Sim: A etapa que o lead alcançou e a hora em que aconteceu. - Sim: O valor da venda, em reais. - Sim: O ID do formulário do anúncio; sem ele, telefone e e-mail criptografados. - Não: Nome, conversa, resumo da IA e dados do negócio. - Não: Nada de quem pediu para não receber mensagens, foi tirado das campanhas ou teve os dados apagados. #### Como ler o registro Cada linha mostra a etapa, o lead, como foi casado e a situação: **Enviado**, **Aguardando** (nova tentativa agendada, ou um token novo quando a Meta recusou o token), **Recusado** (com o motivo e o botão Reenviar) ou **Pulado** (sem dado para casar, pedido do titular, prazo que a Meta aceita, venda sem valor, sem base legal registrada, etapa desligada ou quadro trocado antes de o evento sair ou dado de saúde, que por enquanto não sai). Na tela: O Registro de envios da aba Conversões: o filtro por situação com as contagens e a tabela com a hora, o lead, o evento, o casamento, a situação com o motivo e as tentativas. O registro. O Reenviar aparece só nos recusados e manda o mesmo evento, sem duplicar. - **Casadas**: As conversões que foram com o ID do formulário do anúncio, o casamento mais preciso. - **Telefone e e-mail**: Sem o ID do formulário, vão o telefone e o e-mail criptografados. A Meta compara sem receber o número em texto. - **Qualidade na Meta**: A nota que a Meta calcula fica no Gerenciador de Eventos. O painel não inventa esse número. #### Quem responde pela base legal A sua empresa é a responsável pelos dados dos leads, e o painel trata esses dados em nome dela. Ligar as conversões é uma decisão sua, registrada com o seu nome; a seção **O que vai para a Meta**, na própria aba, mostra o que é enviado e o que nunca vai. #### Perguntas frequentes **Por que o clique do anúncio de WhatsApp não casa?** Esse casamento depende de uma permissão da Meta que ainda não está liberada. Hoje a conversão casa pelo ID do formulário do anúncio ou pelo telefone e o e-mail criptografados. **A venda de meses atrás vai?** Não. A Meta só aceita eventos dos últimos 7 dias. O que passou disso aparece no registro como Pulado, com a data do fato. **Reabri o negócio e ganhei de novo. Duplica?** Não. Cada lead tem um ID de evento fixo para o ganho, e a Meta ignora o segundo envio com o mesmo ID. **Marquei a venda sem valor. Dá para corrigir?** Dá. Reabra o negócio e marque o ganho de novo com o valor: a mesma conversão, que estava como Pulado por venda sem valor, volta a aguardar e sai com o valor, sem duplicar. **Dá para reenviar com o envio desligado?** Não. Com **Enviar conversões** desligado, nada vai para a Meta, nem pelo Reenviar. Ligue o envio no topo da aba e reenvie a conversão recusada. **A Meta recusou o meu token. Perdi as conversões?** Não. Elas ficam aguardando e saem sozinhas quando você cola um token novo no passo 1, desde que o fato tenha acontecido nos últimos 7 dias. Como as pessoas procuram: api de leads; integrar crm com whatsapp; receber leads de formulário no whatsapp; primeiro contato automático whatsapp; webhook de lead qualificado; avisar crm quando lead vira venda; chave de api da integração; lead de teste; api de conversões da meta; devolver conversões para os anúncios; token do gerenciador de eventos; reenviar webhook que falhou; integração de pedidos rfv. ## Configurações do painel: equipe, segmento, horário de atendimento, IA, marca e endereço próprio URL: https://attendto.com.br/manual/configuracoes Menu: Conta > Configurações Configurações é a tela do painel onde o dono da conta define a marca, o segmento do negócio, quando e como a IA atende, quem faz parte da equipe e quanto a conta pode gastar. Quando aparece: Aparece no menu para o dono e para o admin. A seção Avançado só existe para o dono. Logo e endereço próprio pedem o plano Pro. Na conta de um parceiro com marca própria, a aparência fica com o parceiro (só o nome da empresa é editável) e a recarga automática não aparece. Cliente ideal, Closer AI e o follow-up avançado das cadências dependem do módulo Revenue AI. Quando a loja Módulos já está no menu, a seção Módulos sai daqui e o atalho leva à loja. O Modo atendimento só mostra o interruptor nas contas de venda direta; nas demais, o cartão aparece apenas se o modo já estiver ligado, com o estado. ### Quem pode usar - Dono: Vê todas as seções, inclusive Avançado, e altera tudo: nome, cores, logo, endereço próprio, horário, mensagens, persona, interruptores da IA, tetos, equipe, convites, rodízio, módulos, notificações e cobrança. - Admin: Abre a tela e vê todas as seções menos Avançado. A maior parte dos campos aparece travada, com o aviso de que só o responsável pela conta altera. O admin pode trocar o segmento e aplicar o pacote, ligar a transcrição de áudios no atendimento humano, editar as regras do Closer e os limites das cadências, marcar quem está no rodízio e a carga de cada um, e cuidar da própria verificação em duas etapas e do aviso no próprio aparelho. Não convida nem desativa ninguém. - Atendente: Não vê Configurações no menu. Se abrir o endereço da tela direto, o painel volta para a tela inicial. A verificação em duas etapas de cada pessoa fica nesta tela, então o atendente pede ajuda ao dono para chegar nela. ### Telas #### Configurações A tela Configurações serve para ajustar a conta inteira em um só lugar, dividida em seções na coluna da esquerda que trocam o conteúdo sem sair da página. Endereço no painel: `/app/configuracoes` ![Captura da tela Configurações. A tela Configurações serve para ajustar a conta inteira em um só lugar, dividida em seções na coluna da esquerda que trocam o conteúdo sem sair da página.](https://attendto.com.br/prints-do-manual/configuracoes--configuracoes.png) A tela Configurações na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Pelo item Configurações do grupo CONTA no menu. Cada seção tem endereço próprio com `#` (por exemplo `#equipe`, `#ia`, `#seu-segmento`, `#cobranca`): o link abre direto naquela seção e recarregar a página mantém a seção aberta. ##### Seções da tela (coluna da esquerda) A lista de seções: no computador é uma coluna fixa com a descrição de cada uma; no celular vira uma faixa rolável no alto. Botões e ações: - **Empresa**: Abre marca, logo, endereço próprio, dados da conta e dados fiscais. - **Seu segmento**: Abre o segmento da conta, o pacote do segmento e os cuidados que chegam à IA. - **Atendimento**: Abre canais, prazo do transbordo, transcrição de áudio, horário e mensagens automáticas. - **Agenda**: Abre a conexão com o Google Agenda e o expediente em que a IA marca reunião. - **IA & persona**: Abre nome e tom da IA, leitura de imagens, ritmo humano, resposta pelo celular, modo atendimento, condução até o pedido e teto de gastos. - **Cliente ideal**: Abre o perfil de cliente ideal declarado e o calculado pela IA. - **Cadências**: Abre as sequências de follow-up automático. - **Closer AI**: Abre os limites, a escada de desconto e o playbook de objeções da negociação. - **Equipe**: Abre a lista de membros, os convites, o acesso de cada um e o rodízio de leads. - **Módulos**: Abre o catálogo de módulos e o painel do módulo ativo. - **Segurança**: Abre a verificação em duas etapas da sua própria conta de acesso. - **Notificações**: Abre o aviso no aparelho, o resumo semanal e a pesquisa de satisfação. - **Cobrança & alertas**: Abre recarga automática, alertas de saldo, interruptores do sino e teto do mês com modelos pagos. - **Avançado** (Dono): Abre o atalho para os webhooks e a zona de perigo (exclusão da conta). Também aparece: - Cada item tem uma descrição curta embaixo do nome no computador (por exemplo, Equipe: "Membros e convites"). - O selo "Novo" aparece ao lado de Seu segmento. - O ícone de Seu segmento é o do segmento escolhido na conta. ##### Empresa · Marca O nome da empresa e as cores que pintam o painel inteiro, nos temas claro e escuro. Campos e filtros: - **Nome da empresa**: Aparece no login, na aba do navegador, na barra lateral e nos e-mails da equipe. Precisa de pelo menos 2 caracteres. - **Cor da marca**: Paleta de cores prontas e uma cor personalizada. A cor muda o painel na hora e é salva ao aplicar. - **Fim do degradê**: A segunda cor dos botões e realces, que terminam nela. - **Código hexadecimal da cor**: Dentro de Cor personalizada: digite o código da cor (por exemplo #6941C6) ou use o seletor visual. Botões e ações: - **Salvar**: Grava o nome da empresa. Só fica ativo quando o nome mudou. - **Cor personalizada**: Abre a escolha de uma cor fora da paleta, com seletor visual e campo de código. - **Usar versão legível**: Aparece quando a cor é clara demais para texto branco: troca pela versão mais escura e legível da mesma cor. - **Aplicar cor**: Salva a cor personalizada. Fica desativado enquanto a cor não tem contraste suficiente. Também aparece: - Prévia do degradê: um botão de exemplo com o texto "Assim ficam os botões da marca". - Aviso de contraste: mostra o contraste medido e o mínimo exigido quando a cor é clara demais. - Para quem não é dono, aparece "Apenas o owner pode alterar o nome." e os campos ficam travados. ##### Empresa · Logo da empresa A logo que substitui o logotipo padrão na barra lateral e no login. Selo PRO: exige o plano Pro. Campos e filtros: - **Fundo da logo**: Aparece depois de enviar a logo. Três opções, cada uma desenhada com a sua logo: Nenhum, Claro ou Escuro. Salva no clique. Botões e ações: - **Enviar logo**: Abre a escolha do arquivo. Aceita PNG ou JPG de até 1MB; fundo transparente fica melhor. - **Trocar**: Envia outra imagem no lugar da logo atual. - **Remover**: Tira a logo; a barra lateral volta ao padrão. - **Conhecer o plano**: Sem o plano Pro, leva à tela de saldo e plano. - **Nenhum**: Logo sem fundo. - **Claro**: Logo sobre um fundo claro. - **Escuro**: Logo sobre um fundo escuro. Também aparece: - Sem o plano Pro, o bloco vira um convite ao plano em vez do campo de envio. - Imagem acima de 1MB é recusada antes do envio, com o aviso para reduzir. ##### Empresa · Domínio próprio Faz a equipe entrar no painel e no login por um endereço da sua empresa, como app.suaempresa.com.br, com a sua marca. Selo PRO: exige o plano Pro. Campos e filtros: - **Domínio próprio**: O endereço que você quer usar, por exemplo app.suaempresa.com.br. Precisa ser um domínio válido da sua empresa. Botões e ações: - **Gerar instruções de DNS**: Mostra os dois registros a criar no seu provedor de DNS: um TXT, que prova que o domínio é seu, e um CNAME, que aponta o endereço para a plataforma. - **Copiar o valor do registro ‹tipo›**: Copia o valor do registro TXT ou CNAME para colar no provedor de DNS. - **Já criei o TXT — registrar**: Confere se o TXT já está publicado e registra o domínio. Enquanto confere, mostra "Conferindo o TXT…". - **Trocar domínio**: Volta ao campo para escrever outro endereço. - **Verificar agora**: Confere de novo o TXT, o CNAME e o certificado de segurança. Quando os três passam, o selo vira Ativo. - **Remover**: Tira o endereço próprio; o painel volta ao endereço padrão. - **Conhecer o plano**: Sem o plano Pro, leva à tela de saldo e plano. Também aparece: - Selo "Aguardando DNS" enquanto a verificação não fecha; selo "Ativo" quando o endereço está no ar. - Com o domínio ativo, o cartão mostra o link do login no seu endereço e avisa que os convites por e-mail passam a usar esse endereço. - Aviso fixo: a propagação de DNS leva de minutos a 24 horas e o certificado é emitido sozinho depois que o DNS aponta. - Na Cloudflare, o CNAME precisa ficar como "Somente DNS" (nuvem cinza, sem proxy); com o proxy ligado a verificação não passa. - Se o endereço não puder ser usado, aparece o motivo e a orientação de usar um domínio que pertence à sua empresa. ##### Empresa · Identidade visual (conta de parceiro) Aparece no lugar de Marca, Logo e Domínio próprio quando a conta foi vendida por um parceiro com marca própria: diz quem define a aparência e deixa só o nome da empresa editável. Campos e filtros: - **Nome da empresa**: O único campo de aparência que a conta altera nesse caso. Botões e ações: - **Salvar**: Grava o nome da empresa. ##### Empresa · Conta Quem você é nesta conta. Só leitura. Campos e filtros: - **Empresa**: O nome da conta em que você entrou. - **Papel**: O seu papel: Dono, Admin ou Atendente. - **Usuário**: O seu nome de acesso. ##### Empresa · Dados da empresa CNPJ, razão social e endereço usados em notas fiscais e documentos. Todos opcionais. Campos e filtros: - **CNPJ**: Com máscara automática no formato 00.000.000/0000-00. - **Razão social**: O nome jurídico da empresa. - **Endereço**: Rua e número. - **Cidade**: Cidade da empresa. - **UF**: Sigla do estado. - **CEP**: CEP do endereço. Botões e ações: - **Salvar dados da empresa**: Grava os campos. Se algum valor for recusado, o erro aparece embaixo do próprio campo. Também aparece: - Para quem não é dono: "Só o owner edita os dados da empresa." ##### Seu segmento Mostra o segmento do negócio, o que o pacote dele traz para a conta e os cuidados que chegam à IA. Escolher ou trocar o segmento não cria nem apaga nada. Botões e ações: - **Aplicar o pacote do segmento**: Abre a prévia do pacote, peça por peça, para escolher o que entra na conta. - **Trocar segmento**: Abre a grade de segmentos para trocar o da conta. - **Escolher o segmento**: Aparece quando a conta ainda não tem segmento (ou usa o Genérico): abre a mesma grade de escolha. - **Desfazer**: Na faixa "Pacote de ‹segmento› aplicado": desfaz tudo o que o último pacote criou; o que você já tinha continua igual. - **Concluir o preparo**: Aparece quando parte do pacote do cadastro ficou por fazer: roda só as peças que faltam. - **Tentar de novo**: Quando o segmento não carregou, busca de novo. Nada foi alterado. Também aparece: - Cartão do segmento: "Segmento da conta", o nome do segmento e a situação atual. - Selos: "Gerado pela IA para ‹o que você escreveu›" quando o modelo foi montado pela IA; "Segmento com cuidados regulatórios" em segmentos regulados. - Lista "O que o pacote de ‹segmento› traz": Quadro, Campos do negócio, Qualificação, Persona, Roteiro da base e Cadência de retomada, cada uma com uma pílula do que já existe na conta. - Bloco recolhível "Cuidados do segmento que chegam à IA", com a contagem e a lista; vem aberto nos segmentos regulados. Avisa que é um resumo e não parecer jurídico. - Faixa "O preparo da conta não terminou" quando faltam peças do pacote do cadastro. - Sem permissão: "Só o dono ou um admin da conta troca o segmento e aplica o pacote." ##### Diálogo Trocar o segmento da conta A grade de segmentos com busca, o Genérico e a opção Outro segmento. Muda só o rótulo, a pré-seleção dos modelos no Funil e na Qualificação e os cuidados que chegam à IA. Campos e filtros: - **Segmentos**: Busca na grade ("Buscar: dentista, loja, agência de viagens…"). Sem resultado, aparece "Nenhum segmento com ‹termo›" e o atalho para Outro segmento. Botões e ações: - **Limpar busca**: Apaga o termo digitado e volta a mostrar todos os segmentos. - **Outro segmento**: Último cartão da grade: abre o campo para a IA montar o modelo do seu segmento. Tem custo por uso, cobrado do saldo; o valor aparece no próprio cartão. - **Escolher Outro segmento**: Atalho que aparece quando a busca não acha nada. - **Cancelar**: Fecha sem trocar. - **Trocar para ‹segmento›**: Confirma a troca. Depois aparece o aviso "Segmento trocado para ‹segmento›" com o atalho Aplicar o pacote. - **Trocar o segmento**: Rótulo do botão enquanto nada foi escolhido; clicar sem escolher mostra o aviso para escolher um segmento. Também aparece: - O segmento atual leva a marca "Segmento atual" na grade. - O rodapé explica o que vai acontecer: "Nada é criado agora: depois você aplica o pacote, se quiser." - Se a lista de segmentos não carregar, o segmento da conta continua como está e há o botão Tentar de novo. ##### Outro segmento: a IA monta o modelo Dentro do diálogo de troca, com Outro segmento marcado: você escreve o seu segmento e a IA monta etapas, campos, perguntas, persona, roteiro e retomada, com prévia editável antes de usar. Campos e filtros: - **Qual é o seu segmento?**: Até 80 caracteres, por exemplo pet shop, buffet ou gráfica. Enter também gera. - **Tom**: Na prévia: o tom de voz da persona sugerida, editável. - **Primeira mensagem**: Na prévia: a abertura da persona sugerida, editável. Botões e ações: - **Gerar com IA**: Monta o modelo. Leva alguns segundos e mostra os passos: Segmento, Etapas, Perguntas, Persona e Cuidados. - **Cancelar**: Durante a geração: interrompe sem aplicar nem cobrar. - **Usar ‹segmento›**: Quando o texto parece um segmento que já tem modelo pronto: usa esse modelo, sem custo. - **Gerar mesmo assim**: Ignora o modelo pronto parecido e gera um novo. - **Usar este modelo**: Aceita a prévia revisada. Depois é só confirmar a troca no rodapé. - **Usar o Genérico**: Desiste do modelo gerado e escolhe o Genérico. - **Revisar**: Volta à prévia do modelo já aceito. - **Trocar pelo Genérico**: Troca o modelo aceito pelo Genérico. - **Recarregar saldo**: Quando o saldo não cobre a geração: fecha o diálogo e leva a Saldo & Recargas. - **Tentar de novo**: Quando a geração falhou: tenta outra vez. Nada foi cobrado. Também aparece: - Estados: gerando (com as frases de progresso), "Parece o segmento ‹nome›", prévia, "Modelo para ‹texto› pronto para usar", erro "Não deu para montar o modelo agora", "Sem conexão. Nada foi enviado." e "Saldo insuficiente para gerar". - Depois de gerar, a prévia mostra "Cobrado" com o valor debitado. ##### Diálogo Aplicar o pacote de ‹segmento› A prévia das seis peças do pacote, cada uma com o próprio interruptor. Nada do que você já tem é apagado ou sobrescrito; o quadro entra como quadro novo e a qualificação como público novo. Campos e filtros: - **Nome do quadro** (obrigatório): Peça Quadro: o nome do quadro novo do Funil. Obrigatório quando a peça está ligada. - **Nome do público** (obrigatório): Peça Qualificação: o nome do público novo, até 60 caracteres. Não pode repetir um público que já existe. Botões e ações: - **Parar o quadro ‹nome› de receber leads novos**: Lead novo passa a nascer só no quadro novo; os cartões que já existem ficam onde estão. - **Tornar este o quadro padrão**: O quadro novo abre primeiro no Funil e recebe os leads das integrações quando nenhum outro é escolhido. - **Tornar este o público padrão**: O público novo vira o padrão da Qualificação. - **Cancelar**: Fecha sem aplicar nada. - **Aplicar ‹n› peças**: Aplica as peças ligadas, uma de cada vez. Se uma falhar, as outras continuam aplicadas. - **Tentar de novo**: No resultado: refaz só a peça que não deu certo. - **Abrir o quadro**: Leva ao Funil com o quadro criado. - **Ver os campos**: Leva ao Funil para ver os campos do negócio. - **Ver a qualificação**: Leva à Qualificação. - **Ver a persona**: Leva a IA & persona. - **Preencher a base**: Leva à base de conhecimento, com os tópicos marcados "A preencher". - **Ver a cadência**: Leva à seção Cadências. A cadência do pacote nasce desligada. - **Desfazer**: No resultado: desfaz só aquela peça. - **Desfazer tudo**: Desfaz todas as peças que o pacote criou. - **Concluir**: Fecha o diálogo. Também aparece: - Pílulas de cada peça: "Entra", "Não entra", "Já existe", "Nada a acrescentar", "Fica como está". - Persona: só troca a persona que ainda é a padrão; persona editada "fica como está" e a do segmento aparece só para leitura. - Roteiro da base: tópicos "A preencher" e "Já na base"; nenhuma fonte vazia é criada. - Rodapé: "Vai aplicar ‹n› de 6 peças" ou "Ligue pelo menos uma peça para aplicar." - Durante a aplicação: "Aplicando… não feche esta janela." ##### Atendimento · Canais O estado de cada canal da conta, só para consulta. A conexão em si fica em Conexões. Botões e ações: - **Gerenciar**: Leva a Conexões para conectar, trocar ou desligar o canal. Também aparece: - Uma linha para WhatsApp, SMS, E-mail e Web chat, com o selo Conectado ou Não conectado. - Com mais de uma conta no mesmo canal, a linha diz "‹n› contas conectadas". - Se a lista não carregar: "Não foi possível carregar os seus canais" — não quer dizer que estão desconectados. ##### Atendimento · Prazo de resposta do transbordo (SLA) Quanto tempo a equipe tem para responder um lead que a IA passou para humano antes de o Inbox marcar "SLA violado". Campos e filtros: - **Prazo**: 2, 5, 10, 15, 30 ou 60 minutos. Um valor fora da lista aparece como "(atual)". Botões e ações: - **Salvar prazo**: Grava o prazo. Só fica ativo quando o valor mudou. ##### Atendimento · Transcrever áudios no atendimento humano Decide se, com a equipe atendendo, o áudio do lead também vira texto para o atendente. Vem desligado; ligado, tem custo por minuto, cobrado do saldo. Botões e ações: - **Transcrever áudios no atendimento humano** (Dono, Admin): Liga ou desliga a transcrição quando um atendente está na conversa. Desligado, o atendente ouve o áudio no Inbox, sem custo. Também aparece: - Com a IA atendendo, o áudio é sempre transcrito: é assim que ela entende o lead. - Para quem não pode mudar: "Só o dono ou um admin da conta altera esta configuração." ##### Atendimento · Horário de atendimento Quando o time humano atende e o que a IA faz fora desse horário. Campos e filtros: - **Fuso horário**: Brasília / São Paulo, Manaus, Fortaleza, Cuiabá, Rio Branco ou Fernando de Noronha. - **Início — ‹dia›**: Hora de abertura do dia. - **Fim — ‹dia›**: Hora de fechamento do dia. É uma faixa por dia. Botões e ações: - **Atendimento 24 horas, todos os dias**: O interruptor 24/7. Ligado, a conta fica sempre aberta e a grade abaixo não vale. - **IA continua atendendo (recomendado)**: Fora do horário a IA responde, qualifica e agenda; quem pede humano entra na fila para a abertura. - **Somente mensagem de ausência**: Fora do horário a IA não responde: o lead recebe a mensagem de ausência e a conversa fica registrada. - **Atendimento na ‹dia›-feira**: Interruptor de cada dia da semana. Desligado, o dia aparece como Fechado. - **Salvar horário**: Grava a grade inteira. Se der erro, a grade volta ao que estava. Também aparece: - Para quem não é dono: "Apenas o owner pode alterar o horário de atendimento." ##### Atendimento · Mensagens automáticas Quatro textos de até 500 caracteres cada. Só valem as variáveis {nome} (primeiro nome do lead) e {ia} (nome da IA), e não pode haver preço fixo. Campos e filtros: - **Saudação**: Referência de tom para a persona; a IA escreve a saudação real da conversa. - **Ausência (fora do horário)**: Enviada palavra por palavra quando o modo fora do horário é Somente mensagem de ausência. - **Encerramento**: A despedida da conversa. - **Aviso LGPD**: Substitui o texto padrão sobre o uso dos dados. Botões e ações: - **Salvar mensagens**: Grava os quatro textos. Fica desativado se algum passar de 500 caracteres; se o texto for recusado, o motivo aparece no cartão. Também aparece: - Contador ‹caracteres›/500 em cada campo, que fica vermelho ao passar do limite. ##### Agenda · Google Agenda Conecta o calendário para a IA oferecer horários livres, confirmar com o lead e criar o evento com convite. Só os blocos ocupado/livre são lidos. Campos e filtros: - **Duração da reunião (min)**: De 15 a 240 minutos; vem 30. - **Intervalo entre reuniões (min)**: De 0 a 120 minutos; vem 15. - **Início ‹dia›**: Abertura do expediente do dia marcado. - **Fim ‹dia›**: Fechamento do expediente do dia marcado. Botões e ações: - **Conectar Google Agenda**: Abre a autorização do Google em outra aba. Ao voltar, um aviso confirma a conexão ou o erro. - **Salvar expediente**: Grava dias, horários, duração e intervalo. - **Desconectar**: Desliga a agenda; a IA deixa de oferecer horários. Também aparece: - Conectada, aparece o selo com o e-mail da agenda. - Uma caixa de marcar por dia da semana; dia desmarcado aparece como "fechado". ##### IA & persona · Persona da IA O nome e o tom de voz da persona ativa hoje, e quem responde por cada conta conectada. Campos e filtros: - **Nome da IA**: Com que nome ela se apresenta e assina no Inbox. É o valor de {ia} nas mensagens automáticas. - **Tom de voz**: Texto livre que decide como ela trata o cliente e o quanto se estende. Botões e ações: - **Salvar persona**: Grava nome e tom. Fica desativado com o nome vazio. - **gerenciar personas →**: Abre a tela Personas, com oferta, perguntas frequentes e variantes. - **vincular em Conexões →**: Leva a Conexões para escolher a persona de cada conta conectada. - **Tentar de novo**: Quando as contas conectadas não carregaram. Também aparece: - Bloco "Quem responde por cada conta": cada conta conectada com a persona vinculada ou "persona da empresa". - Sem contas conectadas: "Nenhuma conta conectada ainda. Quando houver, cada uma pode ter a sua própria persona." - O cartão só aparece quando há uma persona ativa. ##### IA & persona · Ler as imagens que o lead envia A IA olha a foto que chega (receita, caixa de remédio, produto, comprovante) e responde com o que viu; a equipe vê embaixo da foto o que foi lido. Tem custo por imagem lida, cobrado do saldo. Campos e filtros: - **Limite por conversa**: 10 imagens a cada 24 h (padrão), 5, 20 ou Sem limite. Depois do limite, a foto vai para a equipe e não é cobrada. Botões e ações: - **Ler as imagens que o lead envia**: Liga ou desliga a leitura. Desligada, a IA pede para o lead escrever o que precisa. - **Mostrar para a equipe o que a IA leu**: Mostra ou esconde o quadro discreto embaixo de cada foto no Inbox. O lead nunca vê. - **Copiar um parágrafo para a sua política**: Copia um texto pronto sobre a leitura de imagens para colar na sua política de privacidade. - **Saiba mais na Central de ajuda**: Abre o guia de leitura de imagens. Também aparece: - Prévias lado a lado: "Desligado" e "Ligado · como fica". - Linha de preço por imagem lida, com a estimativa do que chegou nos últimos 30 dias. Foto que a IA não conseguiu ler, figurinha e imagem grande demais não são cobradas. - Aviso "Receitas e exames são dados de saúde" (LGPD, art. 11): a IA não orienta dose nem confirma uso de remédio. - No Enterprise, não há linha de preço: a leitura usa o modelo escolhido em IA própria › Roteamento. - Selo "Novo" ao lado do título. ##### IA & persona · Ritmo de conversa humana A IA responde curto, espera o lead terminar de escrever e manda em mensagens separadas, como uma pessoa digitando. Botões e ações: - **Ritmo de conversa humana**: Liga ou desliga. Salva no clique, sem botão de confirmar. Também aparece: - Prévias "Sem o ritmo humano" e "Com o ritmo humano"; a coluna ativa fica destacada. - Três mensagens seguidas do lead viram uma resposta só, e custam uma só. - No WhatsApp e no Instagram o lead vê "digitando…"; por SMS e e-mail a resposta segue inteira. - Com um atendente na conversa, nada disso se aplica. ##### IA & persona · Quando você responde pelo celular Se alguém responde ao lead pelo WhatsApp do aparelho, no mesmo número, a IA para de responder naquela conversa; campanhas, cadências e lembretes também ficam de fora nesse período. Campos e filtros: - **A IA fica calada por**: Minutos de silêncio, de 5 a 240. Salva ao sair do campo; fora do intervalo aparece "Escolha entre 5 e 240 minutos." Botões e ações: - **A IA volta sozinha quando o tempo acaba**: Ligado, a IA retoma a conversa no fim do prazo. Desligado, só volta quando alguém clica em Devolver para a IA no Inbox. ##### IA & persona · Modo atendimento Para venda direta (farmácia, loja, delivery), em que quem chama já quer comprar: lead quente e morno deixam de ser cobrados e a IA conduz o pedido sem a etapa de qualificação. Botões e ações: - **Modo atendimento**: Liga ou desliga o modo. Aparece só nas contas em que a conta pode ligar. Também aparece: - Lista "Ligado, muda:" e lista "Continua igual:" (mensagens, imagens, áudio, modelos da Meta e transbordos seguem cobrados). - Quando quem liga é a equipe da plataforma ou o parceiro, o cartão mostra só o selo Ligado, sem interruptor. - Se a configuração não carregar: "Não conseguimos ler esta configuração agora." com Tentar de novo. ##### IA & persona · Conduzir até o pedido completo Ligado, a IA segue com o cliente que esquentou ou quer comprar: pergunta o que falta, resume o pedido e passa para a equipe confirmar. Conta nova nasce com a opção ligada. Botões e ações: - **Conduzir até o pedido completo**: Liga ou desliga a condução. Desligado, a conversa vai para a equipe quando o cliente esquenta. - **Ajustar a Qualificação**: Abre a Qualificação, que define o que é um pedido completo. - **Abrir o Funil**: Abre o Funil, onde o pedido completo aparece. Também aparece: - Prévias "Desligado" e "Ligado (padrão de conta nova)" com a mesma mensagem do cliente. - Lista "Mesmo ligado, a conversa vai para a equipe quando:" pedido completo, pedido de pessoa, irritação, IA sem entender, IA sem conseguir responder, coluna do Funil que distribui pelo rodízio e chamado do Closer AI. - O pedido completo entra na fila de transbordo com o motivo "Pedido completo". ##### IA & persona · Teto de gastos de IA Limite diário e mensal de gasto com a IA. Vazio = sem teto. Ao atingir, a IA pausa novas respostas; o atendimento humano nunca para. Campos e filtros: - **Teto diário (R$)**: Valor máximo por dia. Em branco, sem teto. - **Teto mensal (R$)**: Valor máximo por mês. Em branco, sem teto. Botões e ações: - **Salvar teto**: Grava os dois tetos. ##### Cliente ideal · O cliente ideal que você declara Seis campos que descrevem quem você quer atender. Vale desde o primeiro dia; vazio não atrapalha. Campos e filtros: - **Segmento**: O tipo de negócio do cliente ideal. - **Porte (funcionários)**: Faixa de tamanho, por exemplo 11 a 50. - **Cargo de quem decide**: Quem assina a compra. - **Região**: Onde estão os clientes ideais. - **Ticket típico**: O valor que costuma ser vendido. - **Sinal de compra**: O indício de que o lead está pronto. Botões e ações: - **Salvar ICP declarado**: Grava o perfil; a IA passa a comparar os próximos leads com ele. Também aparece: - Selo "Em uso no atendimento" ou "Guardado" quando já existe um perfil calculado. - Com o módulo Revenue AI desligado, aviso de que a aderência só aparece com o módulo ativo. - Rodapé com a data e o autor da última alteração, ou "Ainda não declarado." ##### Cliente ideal · O cliente ideal que a IA calcula O perfil calculado a partir dos negócios ganhos e perdidos no Funil. Destranca com a amostra mínima e nunca substitui o declarado sem você escolher. Botões e ações: - **Calcular agora**: Pede o cálculo antes da próxima passada automática, quando a amostra já está pronta. - **Recalcular agora**: Refaz o cálculo de um perfil já calculado. - **Histórico de versões**: Mostra as versões anteriores do perfil calculado. - **Esconder versões**: Fecha o histórico. - **O declarado por você** (Dono): Faz o atendimento usar o perfil declarado. - **O calculado pelos resultados** (Dono): Faz o atendimento usar o perfil calculado. A troca fica na trilha. Também aparece: - Barra "Amostra dos últimos 180 dias" com desfechos e ganhos. - Sem amostra: "Ainda sem amostra para calcular", com quantos desfechos e ganhos faltam. - Atributos com peso e "Diferenças do que você declarou". - Bloco "Qual perfil a IA usa no atendimento". ##### Cadências Sequências automáticas de mensagens disparadas por um gatilho, que param sozinhas quando o lead responde. Com o módulo Revenue AI, viram o follow-up avançado. Campos e filtros: - **Follow-ups por lead por semana (todas as cadências)**: Aba Limites: quantas mensagens de follow-up um lead recebe por semana, somando todas as cadências. - **Teto mensal com modelos pagos (0 = sem teto)**: Aba Limites: quanto as cadências podem gastar por mês com modelos pagos. Botões e ações: - **Cadências**: Aba com a lista de cadências. - **Editor**: Aba que aparece enquanto uma cadência está sendo criada ou editada. - **Resultados**: Aba (e botão em cada cadência) com o painel de resultados. Só com o módulo Revenue AI. - **Biblioteca**: Aba de modelos prontos de cadência. Só com o módulo Revenue AI. - **Limites**: Aba dos freios que valem para todas as cadências. Só com o módulo Revenue AI. - **Nova cadência**: Abre o editor com uma cadência em branco. - **Usar**: Na Biblioteca: abre o editor com passos, público e regras preenchidos. Nada liga sozinho. - **Ativa**: Caixa de cada cadência: marcada, a cadência roda; desmarcada, fica Pausada. - **Editar**: Abre a cadência no editor. - **Excluir**: Pede confirmação em "Excluir esta cadência?". - **Excluir cadência**: Confirma a exclusão. - **Salvar limites** (Dono, Admin): Grava os limites; valem para todas as cadências. Também aparece: - Cada cadência mostra o gatilho, o número de passos e as etiquetas de objetivo, melhor momento, A/B, condições e tarefa. - Sem o módulo, um aviso explica o que o Follow-up avançado acrescenta. - Aviso em cadência pausada com passo sem modelo aprovado. ##### Closer AI As regras da negociação do Closer: quando ele entra, até quanto pode conceder e o argumento para cada objeção. Faz parte do módulo Revenue AI; sem o módulo, as regras ficam guardadas. Campos e filtros: - **BANT a partir de**: Nota mínima (0 a 100) para o Closer entrar, junto com um sinal de compra na mensagem. - **Modo**: Assistido (concede só o primeiro degrau sozinho) ou Autônomo dentro dos limites (anda a escada inteira até o teto). - **Valor máximo sem aprovação humana (0 = sem limite)**: Acima disso, a negociação vai para uma pessoa. - **Etapas do Funil do Closer**: Cartão nessas etapas entra no Closer mesmo sem sinal de compra. - **Contrapartida do teto**: O que o lead precisa aceitar para ganhar o último degrau. - **Parcelas (máximo)**: Número máximo de parcelas que o Closer oferece. - **Parcela mínima (R$)**: Valor mínimo de cada parcela. - **Cortesias permitidas (itens do catálogo)**: Itens que o Closer pode oferecer como cortesia. - **Nunca prometer**: O que o Closer nunca pode prometer. - **Argumento para ‹objeção›**: Playbook de objeções: o argumento da casa para cada objeção. Vazio = o Closer só reconhece e chama o humano. Botões e ações: - **+ degrau**: Acrescenta um degrau à escada de concessão (de 0 a 60 %, sempre crescente). - **remover**: Tira um degrau da escada. - **Salvar regras do Closer** (Dono, Admin): Grava as regras. Também aparece: - Selo "Closer ligado" ou "Closer desligado no módulo". ##### Equipe Todos os membros da conta, com o papel e o estado de acesso de cada um. Botões e ações: - **+ Convidar** (Dono): Abre o diálogo Convidar atendente. - **Ações de acesso — ‹nome›** (Dono): Menu de três pontos de cada pessoa. Nunca aparece na sua própria linha. - **Desativar acesso** (Dono): Para quem está Ativo: pede confirmação e derruba a sessão na hora. - **Reativar acesso** (Dono): Para quem está Sem acesso: devolve o acesso; a pessoa entra de novo do zero. - **Cancelar convite e excluir** (Dono): Para quem está com Convite pendente: revoga o convite e apaga o perfil que nunca entrou. - **Tentar de novo**: Quando a lista não carregou. Nenhum acesso foi removido. Também aparece: - Cada linha: iniciais, nome, e-mail, papel (Dono, Admin ou Atendente) e acesso (Ativo, Sem acesso ou Convite pendente). - Legenda do cartão: "Papéis: Dono · Admin · Atendente." - O nome cadastrado aqui é o que o lead vê quando a pessoa assume a conversa. ##### Diálogo Convidar atendente Cria a pessoa na equipe e gera o link de convite para ela criar a senha. Campos e filtros: - **Nome** (obrigatório): Nome da pessoa, como o lead vai ver. - **E-mail** (obrigatório): E-mail de acesso. Se já estiver na equipe: "Este e-mail já está na equipe". - **Papel**: Atendente (atende) ou Admin (administra a operação). - **Link do convite**: Depois de convidar: o link para a pessoa criar a senha, válido por 7 dias. Botões e ações: - **Convidar**: Adiciona a pessoa e mostra "Convite pronto" com o link. - **Copiar link**: Copia o link do convite para enviar por onde preferir. - **Concluir**: Fecha o diálogo. ##### Diálogo Desativar acesso de ‹nome›? Confirmação antes de tirar o acesso: a pessoa não entra mais e a sessão ativa é encerrada na hora. Botões e ações: - **Desativar acesso**: Confirma. Não é possível desativar o último responsável pela conta. ##### Equipe · Rodízio de leads Distribui para o próximo atendente da fila cada conversa que a IA passa para humano, e cada cartão que entra numa etapa do Funil marcada para distribuir. Vem desligado. Campos e filtros: - **Carga máxima de ‹nome›**: Coluna Carga máxima: quantas conversas abertas a pessoa aguenta ao mesmo tempo (1 a 50). Salva ao sair do campo. Botões e ações: - **Rodízio ligado** (Dono): Interruptor geral do rodízio. - **‹nome› no rodízio**: Coluna No rodízio: põe ou tira a pessoa da fila. - **Devolver ao rodízio** (Dono): Para quem saiu por strikes: devolve à fila e zera os strikes. Também aparece: - Colunas: Atendente, No rodízio, Carga máxima, Abertas agora e Strikes (7 dias). - Selos na linha: "fora · 3 strikes" e "cheio · pulado na fila". - Strikes: três quadradinhos; cada prazo de etapa estourado acende um. Três em 7 dias tiram a pessoa do rodízio. - Aviso quando o rodízio está ligado sem ninguém na fila: o transbordo continua caindo na fila comum. - Ordem da fila: quem recebeu há mais tempo é o próximo. ##### Módulos O catálogo do que vem além do Core. Ativar cobra uma taxa única de habilitação do saldo; o valor aparece no cartão e na confirmação antes de ativar. Botões e ações: - **Ativar ‹módulo›** (Dono): Abre a confirmação com o que muda hoje, o que chega depois, a taxa e o saldo disponível. - **Agora não**: Fecha a confirmação sem ativar. - **Religar** (Dono): Liga de novo um módulo já pago, sem nova cobrança. - **Desligar** (Dono): Desliga na hora; o que o módulo gravou fica guardado. - **Avise-me**: Em módulo "Em breve": pede o aviso por e-mail quando chegar. Nada é cobrado. - **Configurar**: No painel do módulo: leva à tela onde aquela capacidade se ajusta. Também aparece: - Cartão do Core com o selo "Incluído no seu plano". - Selos dos módulos: "Ativo", "Desligado · habilitação já paga" e "Em breve". - Sem saldo para a taxa, a confirmação avisa e o botão de ativar fica desativado. - Painel do módulo ativo: uma linha por capacidade com o estado Funcionando, Desligada por você, Precisa configurar ou Em breve. - Aviso "Exige o plano Pro" em conta sem a assinatura. ##### Segurança · Verificação em duas etapas (2FA) Liga o código do aplicativo autenticador na sua própria conta de acesso. Vale para qualquer papel que abra a tela. Campos e filtros: - **Código do autenticador**: Os 6 dígitos do aplicativo, para confirmar a ativação. - **Código do autenticador para desativar o 2FA**: Os 6 dígitos atuais, exigidos para desligar. Botões e ações: - **Ativar / reconfigurar 2FA**: Mostra o QR code e o segredo para entrada manual no aplicativo autenticador. - **2. Confirmar e ativar**: Confere o código e liga a verificação; ela passa a ser pedida no próximo login. - **Cancelar**: Abandona a ativação sem mudar nada. - **Desativar com código**: Desliga a verificação, desde que o código seja válido. Também aparece: - Mensagens: "2FA ativado — será exigido no seu próximo login.", "Código inválido — confira o app autenticador." e "Código inválido — o 2FA continua ativo." ##### Notificações · No seu aparelho Avisa no aparelho quando um lead pede atendimento humano, mesmo com o painel fechado. Vale por aparelho. Botões e ações: - **Ativar neste aparelho**: Pede a permissão do navegador e liga o aviso neste aparelho. - **Desativar neste aparelho**: Desliga o aviso só neste aparelho. Também aparece: - Prévia da notificação "Lead aguardando atendimento". - Estado "Ativo neste aparelho". - Navegador sem suporte: aviso para abrir o painel no Chrome, no Edge ou no celular Android. - Dica: no celular, Adicionar à tela inicial faz o aviso chegar como notificação normal. ##### Notificações · Resumo semanal da operação Toda segunda de manhã, no e-mail: leads novos, quentes, agendamentos e satisfação da semana. Botões e ações: - **Resumo semanal por e-mail** (Dono): Liga ou desliga o envio semanal. - **Enviar teste agora**: Manda uma cópia do resumo para conferir a caixa de entrada. ##### Notificações · Pesquisa de satisfação (CSAT) Ao encerrar um atendimento, a IA pergunta ao lead uma nota de 1 a 5. A média aparece no Painel e no Handoff, por atendente. A pergunta e o agradecimento não são cobrados. Botões e ações: - **Pesquisa de satisfação pós-atendimento** (Dono): Liga ou desliga a pergunta. É o único interruptor desta seção que fala com o lead. Também aparece: - Prévia da pergunta como bolha de conversa. - Enviada só dentro da janela de 24 h do canal. ##### Cobrança & alertas · Recarga automática Gera uma recarga por Pix quando o saldo cai abaixo do limiar, para o atendimento não parar. Não aparece na conta de um parceiro com marca própria. Campos e filtros: - **Limiar (R$)**: Abaixo deste saldo, a recarga é gerada. - **Valor da recarga (R$)**: Quanto cada recarga automática coloca. Botões e ações: - **Recarga automática**: Interruptor que liga ou desliga a recarga automática. - **Salvar**: Grava o interruptor, o limiar e o valor juntos. ##### Cobrança & alertas · Alertas O limiar que dispara o aviso de saldo baixo (no sino e por e-mail ao dono, uma vez por ciclo) e os interruptores do sino, que valem só neste navegador. Campos e filtros: - **Limiar de saldo baixo (R$)**: Quando saldo e créditos do plano ficam abaixo dele, o painel avisa. Não recarrega nada. Botões e ações: - **Salvar limiar** (Dono): Grava o limiar. - **Lead aguardando atendimento humano**: Liga ou desliga esse tipo de aviso no sino deste navegador. - **Recarga pendente de pagamento**: Liga ou desliga o aviso de Pix gerado e ainda não pago. - **Assinatura (pagamento pendente/atrasado)**: Liga ou desliga o aviso da mensalidade. - **Saldo baixo**: Liga ou desliga o aviso de saldo abaixo do limiar. ##### Cobrança & alertas · Teto do mês com modelos pagos Quanto a conta pode gastar por mês com modelos pagos, somando primeiros contatos automáticos e cadências. Atingido, o primeiro contato para até o mês virar e você recebe um aviso. Campos e filtros: - **Teto do mês (R$)**: Precisa ser maior que zero. Botões e ações: - **Salvar teto** (Dono): Grava o teto; a mudança fica na auditoria. Também aparece: - Linha "‹usado› de ‹teto› usados em ‹mês›" com barra de progresso. - Se o teto não carregar, o aviso diz que ele continua valendo. ##### Avançado · Os webhooks agora ficam em Integrações Os endereços avisados por evento mudaram para Integrações; este cartão só leva até lá. Botões e ações: - **Abrir Webhooks**: Abre Integrações na parte de webhooks. ##### Avançado · Zona de perigo Pedido de exclusão da conta: anonimiza todos os leads e conversas e desativa a IA, com 7 dias de carência para voltar atrás. Campos e filtros: - **Digite ‹nome da empresa› para confirmar**: No diálogo "Excluir esta conta?": o botão só libera com o nome exato. Botões e ações: - **Excluir minha conta**: Abre o diálogo de confirmação e, dentro dele, registra o pedido. - **Revisar leads no CRM →**: Leva ao CRM antes de excluir. - **Exportar auditoria em Compliance →**: Leva a Compliance para exportar a trilha. - **Cancelar exclusão**: Com exclusão agendada: cancela o pedido dentro da carência. Também aparece: - Com pedido feito: "Exclusão agendada para ‹data›" e quem pediu. ##### Estados da tela - Carregando: Cada cartão mostra um esqueleto cinza enquanto lê a conta. Em Empresa, nem os controles de marca aparecem antes de saber se a conta é de um parceiro. - Se der erro: Cada bloco tem o próprio aviso de erro com Tentar de novo, e o texto diz que nada foi alterado (por exemplo "Não foi possível carregar a sua equipe" ou "Não conseguimos carregar o segmento da conta"). - Quem abre não é o dono: Os campos ficam travados com o aviso de que só o responsável pela conta (owner) altera. - Conta sem o plano Pro: Logo da empresa e Domínio próprio viram um convite com o botão Conhecer o plano. - Conta de parceiro com marca própria: O cartão Identidade visual no lugar de Marca, Logo e Domínio próprio, e Cobrança & alertas sem a recarga automática. - Módulo Revenue AI desligado: Cliente ideal, Cadências e Closer AI avisam que a parte avançada depende do módulo e guardam o que foi preenchido. - Conta sem segmento escolhido: "Nenhum segmento escolhido" ou "Outro segmento: ‹texto› · usando o Genérico", com o botão Escolher o segmento. ### Passo a passo #### Como convidar um atendente para a equipe 1. Abra **Configurações** e clique na seção **Equipe**. 2. Clique em **+ Convidar** (só o dono vê o botão). 3. Preencha **Nome** e **E-mail** e escolha o **Papel**: **Atendente** para quem atende, **Admin** para quem administra a operação. 4. Clique em **Convidar**. Aparece **Convite pronto** com o **Link do convite**. 5. Clique em **Copiar link** e envie para a pessoa. O link vale 7 dias; na lista, ela fica como Convite pendente até criar a senha. 6. Clique em **Concluir**. #### Como trocar o segmento da conta 1. Em **Configurações**, abra **Seu segmento**. 2. Clique em **Trocar segmento**. 3. Busque em **Segmentos** e clique no cartão do seu negócio. Se não achar, clique em **Outro segmento**, escreva em **Qual é o seu segmento?** e clique em **Gerar com IA** (tem custo por uso, cobrado do saldo). 4. Com o modelo gerado, revise a prévia e clique em **Usar este modelo**. 5. Clique em **Trocar para ‹segmento›**. A troca não cria nem apaga nada. 6. Para trazer o modelo do segmento, use em seguida **Aplicar o pacote do segmento**. #### Como aplicar o pacote do segmento e desfazer depois 1. Em **Seu segmento**, clique em **Aplicar o pacote do segmento**. 2. Na prévia, ligue ou desligue cada peça. Ajuste **Nome do quadro** e **Nome do público** se quiser. 3. Decida se quer **Tornar este o quadro padrão** e **Tornar este o público padrão**. 4. Clique em **Aplicar ‹n› peças** e espere cada peça ficar pronta, sem fechar a janela. 5. Use os atalhos do resultado (**Abrir o quadro**, **Ver a qualificação**, **Preencher a base**) ou clique em **Concluir**. 6. Para voltar atrás, use **Desfazer** na peça, **Desfazer tudo** no diálogo, ou **Desfazer** na faixa verde de Seu segmento. #### Como mudar o nome da IA 1. Em **Configurações**, abra **IA & persona**. 2. No cartão Persona da IA, troque o texto de **Nome da IA**. 3. Se quiser, ajuste o **Tom de voz** no mesmo cartão. 4. Clique em **Salvar persona**. O novo nome vale nas próximas respostas e no {ia} das mensagens automáticas. 5. Para mudar o nome de uma persona específica de uma conta conectada, use **gerenciar personas →**. #### Como ligar o endereço próprio (domínio próprio) do painel 1. Em **Configurações**, seção **Empresa**, vá ao cartão Domínio próprio (exige o plano Pro). 2. Digite o endereço em **Domínio próprio**, por exemplo app.suaempresa.com.br, e clique em **Gerar instruções de DNS**. 3. No seu provedor de DNS (Registro.br, Cloudflare, GoDaddy ou outro), crie o registro TXT e o registro CNAME exatamente como aparecem. Use o botão de copiar ao lado de cada valor. 4. Na Cloudflare, deixe o CNAME como Somente DNS (nuvem cinza, sem proxy). 5. Volte ao painel e clique em **Já criei o TXT — registrar**. O selo muda para Aguardando DNS. 6. Depois que o DNS propagar (de minutos a 24 horas), clique em **Verificar agora** até o selo virar Ativo. Não apague o registro TXT depois. #### Como configurar o horário de atendimento e a mensagem de ausência 1. Em **Configurações**, abra **Atendimento**. 2. No cartão Horário de atendimento, desligue o interruptor **24/7**. 3. Escolha **IA continua atendendo (recomendado)** ou **Somente mensagem de ausência**. 4. Confira o **Fuso horário**, ligue os dias em que a equipe atende e ajuste início e fim de cada um. 5. Clique em **Salvar horário**. 6. No cartão Mensagens automáticas, escreva o texto de **Ausência (fora do horário)** e clique em **Salvar mensagens**. #### Como tirar o acesso de alguém da equipe 1. Em **Configurações**, abra **Equipe**. 2. Na linha da pessoa, abra o menu de três pontos. 3. Clique em **Desativar acesso** e confirme em **Desativar acesso** no diálogo. A sessão dela cai na hora. 4. Se o convite nunca foi aceito, o menu oferece **Cancelar convite e excluir**. 5. Para devolver o acesso, abra o mesmo menu e clique em **Reativar acesso**. #### Como ligar a verificação em duas etapas 1. Em **Configurações**, abra **Segurança**. 2. Clique em **Ativar / reconfigurar 2FA**. 3. Escaneie o QR code com o aplicativo autenticador, ou adicione pela entrada manual com o segredo mostrado. 4. Digite os 6 dígitos em **Código do autenticador** e clique em **2. Confirmar e ativar**. 5. No próximo login, o painel pede o código além da senha. ### Perguntas frequentes #### Quem tem o papel de atendente consegue abrir Configurações? Não. O item não aparece no menu do atendente e, se ele abrir o endereço direto, o painel volta para a tela inicial. Dono e admin abrem a tela. #### Por que o admin vê os campos travados? Quase todos os ajustes da conta são só do dono. O admin enxerga as seções para acompanhar, mas troca apenas o segmento, a transcrição de áudio no atendimento humano, as regras do Closer, os limites das cadências e quem está no rodízio. #### Qual a diferença entre o nome da empresa e o nome da IA? O nome da empresa (em Empresa) aparece para a equipe: login, aba do navegador, barra lateral e e-mails. O nome da IA (em IA & persona) é o que o lead lê na conversa. #### Trocar o segmento apaga o meu quadro, a minha persona ou as minhas perguntas? Não. Trocar muda só o rótulo, o que vem pré-selecionado no Funil e na Qualificação e os cuidados que chegam à IA. Nada é criado nem apagado; o modelo novo só entra se você aplicar o pacote, peça por peça. #### Por que não aparecem a logo e o domínio próprio na minha conta? Os dois exigem o plano Pro; sem ele, o bloco vira um convite com Conhecer o plano. Se a conta foi vendida por um parceiro com marca própria, quem define a aparência é o parceiro e a tela mostra o cartão Identidade visual. #### Por quanto tempo vale o link de convite da equipe? Sete dias. Se vencer, use Cancelar convite e excluir no menu da pessoa e convide de novo pelo + Convidar. #### Desligar um aviso do sino desliga em todos os meus aparelhos? Não. Os interruptores do sino em Cobrança & alertas ficam guardados só no navegador em que você mexeu. O aviso no aparelho, em Notificações, também é ligado aparelho por aparelho. #### Por que o Modo atendimento não aparece em IA & persona? O interruptor só aparece nas contas de venda direta, como farmácia, loja e delivery. Nas outras, quem libera é a equipe da plataforma ou o seu parceiro; se o modo estiver ligado, o cartão aparece só com o estado. #### O que acontece com a foto que passa do limite de imagens da conversa? Ela vai para a equipe, que vê a imagem no Inbox, e não é cobrada. O limite conta 24 horas na mesma conversa e se ajusta em Limite por conversa. #### Dá para mandar um link que abra direto numa seção de Configurações? Sim. Cada seção tem o seu endereço com `#`, como `#equipe`, `#atendimento` ou `#seguranca`. Quem abrir o link cai direto nela. ### Guia: Configurações Onde se define quem entra, quando a sua IA responde, como ela fala e como a sua marca aparece. Esta é a tela que muda o comportamento da sua IA e o seu gasto. Quase tudo aqui vale a partir da próxima mensagem que chegar — não há botão de publicar, e não há como testar num canto antes. Por isso cada seção deste guia responde a mesma pergunta: **o que muda para o lead quando eu mexo nisto**. As seções ficam na coluna da esquerda e a tela troca sem sair do lugar. Quase todo campo é do **responsável pela conta**: quem tem acesso de administrador abre a tela e enxerga tudo, mas os campos ficam travados, com o aviso de que só o responsável altera. #### As seções, e o que cada uma decide - **Empresa**: Nome, cores, logo, endereço próprio e os dados fiscais. É o que a sua equipe vê ao entrar e o que sai nos e-mails. - **Seu segmento**: O segmento do seu negócio: ele escolhe os modelos que vêm primeiro no Funil e na Qualificação e os cuidados do segmento que chegam à IA. Daqui também se aplica o pacote do segmento, peça por peça. Ver [Conta pronta para o seu segmento](https://attendto.com.br/manual/configuracoes). - **Atendimento**: Os canais ligados, o prazo de resposta do transbordo, a **transcrição de áudios no atendimento humano**, o **horário de atendimento** e as **mensagens automáticas**. A seção que mais muda o que o lead recebe. - **Agenda**: O calendário conectado e o expediente em que a sua IA pode oferecer reunião. Detalhado em [Agenda](https://attendto.com.br/manual/agenda). - **IA & persona**: O nome e o tom de voz da sua IA, o **ritmo de conversa humana**, a **condução até o pedido completo** e o teto de gastos. - **Cadências**: Sequências de follow-up automático que param sozinhas quando o lead responde. Com o módulo Revenue AI, viram o **follow-up avançado** (seção própria abaixo). Com mais de um número de WhatsApp conectado, cada cadência tem um **Enviar por** — que vale só para o lead que ainda não tem conversa aberta; tendo, ela responde pelo número daquela conversa. - **Equipe**: Quem entra, com qual papel, e quem perdeu o acesso. - **Segurança**: A verificação em duas etapas da **sua** conta de acesso. - **Notificações**: Aviso no celular, resumo semanal por e-mail e a pesquisa de satisfação. - **Cobrança & alertas**: Recarga automática e a partir de que valor você quer ser avisado. - **Avançado**: Endereços avisados por evento e a exclusão da conta. Só o responsável pela conta enxerga esta seção. #### Empresa: a marca e o endereço próprio Na tela: Seção Empresa das configurações, com o nome da empresa, as cores da marca, o envio de logo e o cartão de domínio próprio ativo. A cor escolhida vale no painel inteiro, nos temas claro e escuro. 1. **O nome que a sua equipe vê**: Aparece na tela de entrada, na aba do navegador, na barra lateral e nos e-mails que convidam alguém para o time. Não é o que o lead vê na conversa — esse é o nome da persona, em **IA & persona**. 2. **Cor da marca**: A cor pinta o painel na hora, antes de salvar. Se você escolher um tom claro demais para texto branco em cima, o painel **recusa** e mostra o contraste medido, com um atalho para a versão legível da mesma cor. 3. **Fim do degradê**: Botões e realces terminam nesta segunda cor. A prévia ao lado mostra exatamente como o botão fica — confira nela antes de salvar. 4. **Logo da empresa**: PNG ou JPG de até 1MB. Depois de enviar aparece **Fundo da logo** com três opções e a sua logo desenhada em cada uma: escolha olhando a prévia, porque logo clara sem fundo some no tema claro. 5. **Domínio próprio**: Com ele ativo, a sua equipe entra num endereço seu, com a sua marca — e os convites por e-mail passam a usar esse mesmo endereço. > **Logo e endereço próprio pedem o plano Pro:** Sem o plano, a área vira um convite em vez de um formulário. Nome da empresa, cores e dados fiscais funcionam em qualquer plano. #### Ligar o endereço próprio É a mudança mais visível para quem trabalha com você: em vez de um endereço genérico, o time entra em algo como `painel.suaempresa.com.br`. Quem mexe no domínio da sua empresa precisa fazer dois cadastros de DNS. 1. **Escreva o endereço e peça as instruções**: Digite o endereço que você quer e clique em **Gerar instruções de DNS**. Aparecem duas linhas: uma prova que o domínio é seu, outra manda o endereço para cá. 2. **Cadastre as duas linhas no seu provedor de domínio**: Copie exatamente como está. Se você usa Cloudflare, o segundo registro precisa ficar como **Somente DNS** — com o proxy ligado (a nuvem laranja) a verificação nunca fecha. 3. **Volte e registre**: Clique em **Já criei o TXT — registrar**. Se ainda não achar, espere: propagação de DNS leva de minutos a 24 horas. 4. **Espere o selo Ativo**: A verificação confere três coisas: que o domínio é seu, que ele aponta para cá e que o certificado de segurança já responde. Enquanto faltar alguma, o estado fica em **Aguardando DNS** e o botão **Verificar agora** tenta de novo. > **Não apague o registro de prova depois:** Ele precisa continuar publicado. Se sumir, a próxima verificação rebaixa o endereço e a sua equipe volta a entrar pelo endereço genérico. #### Seu segmento: o modelo do seu negócio **Trocar segmento** muda só o rótulo da conta, o que vem pré-selecionado no Funil e na Qualificação e os cuidados que chegam à IA: nada é criado nem apagado. Para trazer o modelo, **Aplicar o pacote do segmento** mostra a prévia das seis peças — quadro, campos do negócio, qualificação, persona, roteiro da base e cadência de retomada — cada uma com o próprio interruptor. O quadro entra como quadro novo, a qualificação como público novo, a persona só muda se ainda for a padrão e a cadência nasce desligada. Na tela: Seção Seu segmento das configurações: o segmento Imobiliária, os botões Aplicar o pacote do segmento e Trocar segmento, e a lista do que o pacote traz, peça por peça, com o que já existe na conta. Seu segmento: o segmento escolhido e o que o pacote dele traz, com o que a conta já tem. Na tela: Diálogo Aplicar o pacote de Imobiliária: o quadro e os campos que já existem ficam de fora, a qualificação entra como o público novo Imobiliária (2) e a persona editada fica como está. A prévia antes de aplicar: cada peça com o próprio interruptor, e o que já existe fica como está. > **Dá para desfazer:** Depois de aplicar, **Desfazer** devolve o que o pacote criou, peça por peça ou tudo; o que você já tinha continua igual. Segmento fora da lista? Quem tem o papel de atendente vê esta seção sem poder mudar nada. #### Atendimento: o horário e o que a IA faz fora dele Este cartão define quando o **seu time humano** atende — não quando a sua IA trabalha. É uma distinção que confunde no primeiro dia e decide o resto. Na tela: Cartão de horário de atendimento, com o interruptor 24/7, a escolha do que fazer fora do horário, o fuso e a grade de dias da semana. Uma faixa por dia, e o domingo fechado. O interruptor de cada dia é o que decide se ele conta. 1. **24/7**: Ligado, nada abaixo vale — a conta é considerada sempre aberta. É o estado de fábrica, e o engano mais comum: preencher a grade toda com o 24/7 ligado e achar que configurou. Desligue primeiro. 2. **O que fazer fora do horário**: A escolha mais cara da tela inteira. **IA continua atendendo** mantém a conversa viva de madrugada; **Somente mensagem de ausência** desliga a IA fora do horário. Detalhado logo abaixo. 3. **Fuso horário**: Manda em muito mais do que este cartão: é o fuso que define o que é "hoje" na sua conta — no teto de gasto diário, na contagem de contatos importados hoje e no dia em que o resumo semanal sai. 4. **Os dias e as horas**: Um interruptor por dia. Desligado, o dia fica **Fechado**. É **uma faixa por dia**: para fechar no almoço não há como partir o dia em duas, então use o horário cheio. 5. **Salvar horário**: Nada aqui salva sozinho. Se der erro ao salvar, a grade volta ao que estava — confira que o selo mudou antes de sair da tela. As duas opções de **Fora do horário** produzem operações bem diferentes: - **IA continua atendendo (recomendado)**: A sua IA responde, qualifica e marca reunião de madrugada igual. O horário muda só o transbordo. Quem pede uma pessoa, se irrita ou não é entendido ouve que a conversa ficou registrada e que alguém da equipe fala com ele no próximo horário. Quem esquentou ou quer comprar não ouve aviso nenhum: a conversa entra na fila sem anúncio e a IA segue com ele até a equipe abrir. Nos dois casos a fila espera a abertura, e o prazo de primeira resposta só começa a contar nela. - **Somente mensagem de ausência**: A sua IA **não responde** fora do horário. O lead recebe a mensagem de ausência e mais nada — sem qualificação, sem agendamento, sem transbordo. A conversa fica registrada para quando abrir. Quem escrever dez vezes na madrugada recebe o aviso uma vez a cada seis horas, não dez. > **O erro que custa lead:** Escolher **Somente mensagem de ausência** achando que é mais educado. Todo lead que chega à noite recebe uma frase e some, sem ser qualificado nem agendado. Se você quer a IA trabalhando enquanto o time dorme, a opção é a primeira. Duas consequências que o cartão não conta e que valem saber: **cadências de follow-up e retomadas automáticas não disparam fora da janela** (mensagem às 3h da manhã queima a marca), e o prazo do transbordo não corre com a casa fechada — quem entrou na fila de madrugada começa a contar na abertura do dia, então a fila não amanhece estourada. Logo acima da grade fica o **Prazo de resposta do transbordo (SLA)**: quanto tempo o time tem para responder um lead que pediu humano antes de o painel marcar o atraso. Escolha o prazo que a sua equipe cumpre no pior dia — prazo de dois minutos numa equipe de uma pessoa enche a tela de atraso e o número deixa de significar alguma coisa. Se um atendente já assumiu a conversa, ela nunca conta como atraso. A fila ao vivo está em [Transbordo para humano](https://attendto.com.br/manual/handoff). Logo abaixo do prazo fica **Transcrever áudios no atendimento humano**. Ele vem **desligado** em toda conta: quando a equipe está atendendo, o áudio do lead chega no [Inbox](https://attendto.com.br/manual/inbox) para ouvir, como no WhatsApp, e não custa nada. O Dono e os Admins mudam; toda troca fica na trilha de auditoria com o nome de quem mexeu — **Suporte** quando foi a nossa equipe, e o nome do parceiro com **(via parceiro)** na conta revendida. - **Com a IA atendendo, nada muda**: O áudio é sempre transcrito e cobrado: é o texto que a IA lê para entender o lead e responder. Isso vale também na fila do transbordo, enquanto ninguém assumiu e a IA segue respondendo. - **Quando conta como equipe atendendo**: Depois que um atendente assume a conversa, ou enquanto a IA está em silêncio porque alguém respondeu pelo celular ou pelo app do Instagram. Vale para WhatsApp, Instagram e o número em coexistência. #### As mensagens automáticas Na tela: Cartão de mensagens automáticas, com os campos de saudação, ausência, encerramento e aviso de LGPD preenchidos. Quatro textos, até 500 caracteres cada. O contador no canto de cada campo fica vermelho se você passar. 1. **Saudação**: A primeira mensagem da conversa **não é copiada daqui**: ela é escrita na hora, a partir do tom de voz da sua persona. Trate este campo como a anotação do que você espera ouvir. Para mudar de verdade como a IA abre a conversa, mexa no **Tom de voz**, em **IA & persona**. 2. **Ausência (fora do horário)**: Este texto o lead recebe palavra por palavra, e só quando o modo fora do horário é **Somente mensagem de ausência**. Diga quando vocês voltam: é a única informação útil que ele tem naquele momento. 3. **Encerramento**: A despedida usada quando o lead pede para parar de receber mensagens. Vale escrever sem ressentimento: é a última coisa que ele lê de você. 4. **Aviso LGPD**: Substitui o texto padrão sobre o uso dos dados. Escreva na sua língua, dizendo para que os dados servem e como sair. - Só duas variáveis funcionam: `{nome}` (o primeiro nome do lead) e `{ia}` (o nome da sua persona). Qualquer outra é recusada ao salvar. - **Preço fixo é recusado.** Estes textos saem sem ninguém revisar, e um valor escrito aqui vira promessa. Fale em faixa, ou mande orçar. - Se o salvamento for recusado, o campo volta ao que estava e o que você digitou se perde. Em texto longo, copie antes de clicar em salvar. #### IA & persona: como ela fala e quanto pode gastar Na tela: Seção IA e persona, com o nome da IA, o tom de voz, o interruptor de ritmo de conversa humana e as duas prévias comparadas. As duas colunas comparam a mesma resposta com e sem o ritmo humano. A coluna ativa fica destacada. 1. **Nome da IA**: O nome com que ela se apresenta e que assina cada resposta no Inbox. É também o que `{ia}` vira nas mensagens automáticas. 2. **Tom de voz**: Texto livre, e o campo com mais efeito da tela: é ele que decide se ela trata por você ou por senhor, se escreve curto ou explica. Não existe um seletor de formalidade em lugar nenhum — o controle é escrever aqui o que você quer. 3. **Ritmo de conversa humana**: Salva no clique, sem botão de confirmar. Conta nova já nasce com ele **ligado**; contas criadas antes de setembro de 2026 nasceram desligadas — é só ligar aqui. 4. **O que muda, lado a lado**: Sem o ritmo, um bloco de texto de uma vez. Com ele, respostas curtas em mensagens separadas, com o "digitando…" antes de cada uma. 5. **As quatro regras do ritmo**: A primeira é a que mexe na conta: **três mensagens seguidas do lead viram uma resposta só, e custam uma só**. Por SMS e e-mail a resposta continua inteira, e nada disso vale enquanto um atendente está na conversa. > **O ritmo humano ligado costuma sair mais barato:** Quem escreve no WhatsApp ou no Direct do Instagram escreve picado. Com o ritmo desligado, cada pedaço vira uma resposta cobrada; com ele ligado, o conjunto vira uma. Para operação de WhatsApp ou Instagram, ligado é o ajuste esperado. Logo abaixo vem **Quando você responde pelo celular**. Se alguém do time responder ao cliente pelo WhatsApp do próprio aparelho — o aplicativo normal, no mesmo número que a IA usa —, a IA para de responder naquela conversa assim que a mensagem chega até nós. Campanhas, cadências e lembretes de reunião também ficam de fora dela nesse período: ninguém automático fala por cima de quem está falando. - **A IA fica calada por**: Quantos minutos o silêncio dura, de **5 a 240**. Vem com **30**. O número certo é o do seu jeito de trabalhar: quem responde e sai da conversa quer 10; quem negocia por uma hora quer 120. Fora desse intervalo o campo recusa e diz o porquê ali mesmo. - **A IA volta sozinha quando o tempo acaba**: Vem **ligado**: o prazo vence e a IA retoma a conversa sem você fazer nada. Desligado, aquela conversa fica sem IA até alguém clicar em **Devolver para a IA**, na própria conversa. Desligue só se o time tem o hábito de fechar a conversa na mão — senão o fio emudece e ninguém entende por quê. Logo antes dele vem **Modo atendimento**, para venda direta — farmácia, loja, delivery —, em que quem chama já quer comprar. Ligado, a conta não paga lead quente nem morno, e a IA atende e conduz o pedido sem a etapa de qualificação. Conta nova de farmácia ou varejo já nasce com ele ligado; nas contas que já existiam desses segmentos, o Dono liga. Em outros segmentos o interruptor não aparece: quem libera é a nossa equipe. Na conta revendida, quem liga é o seu parceiro. Toda troca fica na trilha de auditoria com o nome de quem mexeu e de onde veio. - **O que muda no modo atendimento**: Lead quente e lead morno deixam de ser cobrados e somem da tabela de preços da [Carteira](https://attendto.com.br/manual/saldo-e-recargas) e do cartão de saldo. Quem diz que quer comprar vai para a equipe sem esperar a nota subir; com **Conduzir até o pedido completo** ligado, a IA segue até o pedido, como sempre. A IA também deixa de procurar objeções de venda em cada mensagem, salvo com o Closer AI ligado. - **O que continua igual**: Mensagens, imagens lidas, áudio, modelos da Meta e transbordos seguem cobrados. Quem pede uma pessoa ou se irrita vai para a equipe. A nota da [Qualificação](https://attendto.com.br/manual/qualificacao) continua sendo calculada, porque na venda direta ela é o próprio pedido (o que o cliente quer, entrega, pagamento): é por ela que a IA sabe o que falta, que o pedido completo chama a equipe e que o [Funil](https://attendto.com.br/manual/funil) move o cartão. Depois vem **Conduzir até o pedido completo**. Conta nova já nasce com ele ligado; nas contas mais antigas ele vem desligado até o Dono ligar. Desligado, a IA passa a conversa para a equipe quando o cliente fica Quente, ou quando diz que quer comprar e já está Morno (ou com tudo o que a Qualificação pede respondido). Ligado, ela segue com ele: pergunta o que falta, uma coisa por vez, resume o pedido e passa a conversa para a equipe confirmar. É o jeito de a atendente receber o pedido pronto — produto, pagamento, endereço, o que a sua Qualificação pedir — em vez de uma conversa pela metade. Na tela: Cartão Conduzir até o pedido completo em IA e persona, com o interruptor, as prévias Desligado e Ligado (padrão de conta nova), a lista do que continua passando para a equipe e o aviso de que o pedido completo chega à equipe pelo Funil. A prévia mostra a mesma mensagem do cliente nos dois modos. A coluna ativa fica destacada. - **O que muda ao ligar**: Intenção de compra e lead Quente deixam de transferir. A IA não promete especialista nem ligação: ela conduz até o pedido e, no fim, resume o pedido, diz que uma pessoa da equipe confirma tudo com o cliente por ali e passa a conversa para a fila com o motivo **Pedido completo** — aviso no sino e no celular e rodízio, como qualquer transbordo. Fora do horário, o cliente não recebe aviso de horário e a equipe pega na abertura. Quando falta uma informação — inclusive quando a conferência da resposta tira um trecho sem cadastro —, ela diz que não tem aquilo e pergunta se o cliente quer falar com uma pessoa. Vale também para a mensagem de retomada das cadências. - **O que continua transferindo**: O cliente pede para falar com uma pessoa, se irrita com o atendimento, ou a IA não entende o que ele quis dizer. Com o módulo Revenue AI, o Closer AI continua chamando você nos limites dele. E, se o cliente que quer comprar fosse receber uma resposta fixa no lugar da IA — o modelo de IA fora do ar, ou a resposta barrada inteira na conferência —, ele vai para a equipe como iria com a opção desligada. Quem já está na fila de transbordo é atendido como hoje, com a IA lembrando que alguém da equipe vem — fora do horário, sem prometer que é logo. - **Pedido completo**: É tudo o que a [Qualificação](https://attendto.com.br/manual/qualificacao) pede respondido. Escreva cada item do público como um pedaço do pedido (produto e preço, forma de pagamento, endereço e dia da entrega) e a IA pergunta exatamente isso. - **O cartão no Funil**: Continua andando pelas regras do quadro. O pedido completo é um transbordo: abre ticket, avisa no sino e no celular e dispara o gatilho **lead é transferido para atendente**. Antes disso, quem a IA segurou não dispara esse gatilho, porque ninguém foi transferido. No [Funil](https://attendto.com.br/manual/funil), **lead vira quente → Mover cartão** continua levando o cartão a uma coluna. Já a coluna marcada para **distribuir pelo rodízio** distribui: quando o cartão chega nela, o atendente da vez assume a conversa e, dali em diante, é ele quem responde. Para a IA terminar o pedido antes, deixe essa marca desligada na coluna para onde o cartão vai ao ficar Quente. - **Quem muda e o que fica registrado**: Só o Dono. A trilha de auditoria guarda **Condução até o pedido alterada**, ligada ou desligada, com o nome de quem mudou. A cobrança não muda: cada mensagem e cada lead Quente custam o mesmo nos dois modos. > **Só o Dono muda estes três:** Para os outros papéis os dois campos do celular e o interruptor da condução aparecem travados, com o motivo escrito embaixo do cartão. É uma decisão da conta inteira: quem atende não escolhe por quanto tempo a IA de todo mundo fica calada, nem quando a conversa passa para a equipe. Depois fica o **Teto de gastos de IA**, com um limite diário e um mensal, em reais. Ao atingir o teto a IA para de responder novas conversas e o lead recebe uma frase neutra — que **nunca** diz que faltou saldo. Duas coisas para não se surpreender: o atendimento humano continua funcionando normalmente, e **você não é avisado quando o teto é atingido**, porque é uma trava que você mesmo pôs. Um teto mensal folgado é uma boa rede de segurança; um teto diário apertado é a receita para a IA parar às 14h sem ninguém notar. #### Cadências e o follow-up avançado Na tela: Aba Cadências de Configurações com as abas Cadências, Resultados, Biblioteca e Limites e a lista de réguas da conta com etiquetas de objetivo, melhor momento, A/B, condições e tarefa. A mesma tela do item Follow-up do menu, dentro de Configurações. Uma **cadência** é uma sequência de passos disparada por um gatilho, que a IA escreve com o histórico real do lead e que para sozinha quando ele responde. Com o módulo **Revenue AI** ela vira o **follow-up avançado**: objetivo, público, gatilhos do Funil e do ICP, condições que ramificam, teste A/B, tarefa para o time, áudio da IA, pausa inteligente, biblioteca, limites e o painel de resultados. O guia completo, com o editor de fluxo e cada regra explicada, está em [Follow-up](https://attendto.com.br/manual/follow-up). #### Closer AI: negociar dentro dos seus limites Na tela: Aba Closer AI de Configurações: o cartão Quando entra (BANT a partir de 75, sinal de compra, modo assistido, valor máximo, etapas do Funil), a escada de concessão 3 %, 5 % e 10 % com a contrapartida do teto, parcelas, cortesias, o campo Nunca prometer e o playbook de objeções. Tudo o que o Closer pode prometer está aqui; fora disso, ele chama o humano. Com o módulo **Revenue AI** ligado, o **Closer** assume a conversa quando o lead está pronto: aderência BANT a partir do mínimo que você define (padrão 75, "quente") **e** um sinal de compra na mensagem (pediu preço ou disse que quer comprar), ou o cartão numa etapa do Funil marcada como do Closer, ou alguém clicou **Entregar ao Closer** no cartão ou na ficha. Enquanto ele negocia, o lead quente não é transferido para o time só por ser quente; pedido explícito de humano, frustração e dúvida da IA continuam transferindo. Sem negociar desconto, a opção **Conduzir até o pedido completo**, em IA & persona, faz a IA seguir com o lead quente até o pedido completo. - **Escada de concessão e modo**: Os degraus de desconto (padrão 3 % → 5 % → 10 %); o último é o teto e exige a **contrapartida** que você escrever ("fecha até sexta"). No modo **assistido**, o Closer concede só o primeiro degrau sozinho: um pedido maior vira pendência para você aprovar. No modo **autônomo**, ele anda a escada inteira até o teto. Acima do teto, sempre humano. Parcelas, parcela mínima, cortesias (itens do catálogo) e "nunca prometer" completam os limites, e o Auditor de Resposta apaga qualquer condição que não esteja aqui. - **Playbook de objeções**: Para cada uma das sete objeções (preço, tempo, confiança, concorrente, adiamento, sem necessidade, outra) você escreve o argumento da casa. O Closer responde com ele, cita o caso de sucesso mais parecido e faz uma pergunta. Vazio = ele só reconhece e chama o humano. A mesma objeção duas vezes seguidas também vai para o humano. - **Quando chama o humano**: Pedido além do teto, proposta acima do valor máximo, concorrente com proposta na mão, objeção repetida, pedido de reunião, sentimento negativo ou pergunta sem lastro. A pendência entra no Handoff com o dossiê: quanto já foi concedido, o que o lead pediu e o teto. No cartão e na ficha, o bloco Negociação mostra o estado ("Closer negociando · 5 % concedido (degrau 2 de 3)") com os botões Entregar ao Closer e Assumir a negociação; cada concessão fica na ficha e na trilha de auditoria. - **O que ainda vem**: Propostas rastreadas (PDF, link com aceite e rastro de abertura), a tela Propostas e o Painel do vendedor entram na próxima entrega da rodada 3. #### Equipe: quem entra e quem pode o quê Na tela: Lista da equipe com cinco pessoas, mostrando os papéis Dono, Admin e Atendente e os estados de acesso ativo, sem acesso e convite pendente. Duas etiquetas por pessoa: o papel (o que ela pode fazer) e o acesso (se ela consegue entrar hoje). 1. **Convidar**: Pede nome, e-mail e papel. O convite chega por e-mail e vale **7 dias**; a tela também mostra o link, para você mandar por onde preferir. 2. **Quem está na equipe**: Todo mundo que já foi convidado, inclusive quem nunca aceitou. O nome daqui é o que o lead vê quando essa pessoa assume uma conversa. 3. **O papel**: **Dono** é o responsável pela conta, **Admin** administra a operação e **Atendente** atende. O que cada um pode está na tabela abaixo. 4. **O acesso, e o menu de ações**: **Ativo** entra normalmente, **Convite pendente** ainda não criou a senha, **Sem acesso** foi desativado. O menu ao lado oferece só a ação que faz sentido para aquele estado — e nunca aparece na sua própria linha. - **Dono**: O responsável pela conta. É o **único** que altera qualquer coisa desta tela: marca, horário, mensagens, persona, tetos, equipe e cobrança. Também é o único que cancela o plano e o único que anonimiza um contato. - **Admin**: Administra a operação: Inbox, funil, contatos, campanhas, agenda, saldo e recargas. Abre a tela de Configurações e enxerga tudo, mas **não consegue salvar** os ajustes da conta. É o papel para quem toca o dia a dia sem mexer na configuração. - **Atendente**: Atende. Vê Inbox, funil e contatos, e some do menu dele (e da busca do Ctrl K) o saldo, o compliance, as conexões, as integrações, as campanhas, os modelos de mensagem e as configurações. É o papel de quem só conversa com lead. > **Admin não configura:** É a confusão mais comum aqui. Se você convidou alguém como Admin esperando que essa pessoa ajustasse horário ou mensagens, ela vai abrir a tela e encontrar tudo travado. **Desativar acesso** derruba a pessoa na hora: a sessão aberta é encerrada e os convites pendentes dela são cancelados. O perfil continua existindo, então o nome dela segue aparecendo no histórico das conversas que atendeu. Reativar não devolve a sessão — ela entra de novo do zero. Já **Cancelar convite e excluir** só existe para quem nunca chegou a entrar, e apaga o perfil junto. E não dá para desativar o último responsável pela conta. #### Rodízio de leads Na tela: Bloco Rodízio de leads abaixo da equipe: interruptor geral ligado e, por atendente, o interruptor No rodízio, a carga máxima, as conversas abertas agora e os três quadradinhos de strike. Uma linha por atendente: quem está na fila, quanto aguenta, quanto tem aberto e os strikes dos últimos 7 dias. Logo abaixo da lista da equipe fica o **Rodízio de leads**. Nasce desligado. Ligado, toda conversa que a IA passa para humano vai direto para o próximo atendente da fila, em vez de esperar alguém puxar da fila de transbordo. O mesmo acontece quando um cartão entra numa etapa do [Funil](https://attendto.com.br/manual/funil) marcada para distribuir. - **No rodízio**: Quem entra na fila. Desligue para quem está de férias ou só supervisiona. - **Carga máxima**: Quantas conversas abertas a pessoa pode ter ao mesmo tempo. Chegou lá, ela é pulada até fechar alguma. A coluna **Abertas agora** mostra o número de hoje. - **Ordem da fila**: Quem recebeu há mais tempo é o próximo. Quem nunca recebeu vem antes de todo mundo. - **Strikes (7 dias)**: Cada prazo de etapa estourado com a pessoa responsável vira um quadradinho aceso. Três em sete dias tiram a pessoa do rodízio — ela vê "fora · 3 strikes" e só o dono a devolve, com o botão **Devolver ao rodízio**, que zera os strikes. > **Ligado sem ninguém na fila não distribui:** Ligar o interruptor geral não põe ninguém no rodízio. Marque "No rodízio" em pelo menos um atendente; até lá o transbordo continua caindo na fila comum e a tela avisa. #### Cliente ideal: o perfil que você quer atender Na tela: Tela Cliente ideal com os seis campos do perfil declarado à esquerda e, à direita, o perfil calculado: a barra da amostra, a frase da IA, os atributos com peso, as diferenças do declarado e os dois botões de escolha da fonte. O que você declara vale desde o primeiro dia; o calculado aparece ao lado quando há 30 negócios com desfecho, e você escolhe qual a IA usa. Em **Cliente ideal** você descreve, em seis campos, quem você quer atender: segmento, porte, cargo de quem decide, região, ticket típico e o sinal de compra. Com o módulo Revenue AI ligado, a IA compara cada lead com esse perfil e mostra a **aderência** (0 a 100) no cartão do [Funil](https://attendto.com.br/manual/funil), na ficha do lead e no dossiê do transbordo, sempre com uma frase dizendo o que bateu e o que não bateu. > **BANT e ICP são eixos diferentes:** A nota BANT diz se **este** lead está pronto agora. A aderência diz se ele **parece** quem compra. Lead quente com aderência baixa fecha, mas tende a sair cedo; lead morno com aderência alta vale insistir. O perfil **calculado** nasce dos negócios que você marcou como [ganho ou perdido no Funil](https://attendto.com.br/manual/funil). Com **30 desfechos e ao menos 8 ganhos** nos últimos 180 dias, a IA calcula sozinha (a cada 6 horas, e só quando a amostra muda; entre duas versões espera 6 dias) e o cartão da direita destranca: a frase "Seu ICP principal são…", os **atributos com peso** (quanto cada um separa ganhos de perdidos, com a conta que sustenta) e as **diferenças** do que você declarou. Cada cálculo é uma versão; o histórico fica no próprio cartão e na trilha. Nada muda sozinho: em **"Qual perfil a IA usa no atendimento"** você escolhe entre o declarado e o calculado. A troca fica na trilha e vale para as próximas avaliações; o outro perfil fica guardado. O dono pode pedir **Recalcular agora** (respeita a amostra; só pula a espera de 6 dias). Antes desta rodada o texto aqui dizia que o calculado "chega depois". Chegou. O que continua valendo: o declarado nunca é substituído em silêncio. #### Módulos: ligar o que vem além do Core Na tela: Tela Módulos: o catálogo com o Core incluído, o Revenue AI ativo e os próximos módulos em breve; abaixo, o painel do Revenue AI com uma linha por capacidade e o estado de cada uma. O catálogo: o Core incluído, o Revenue AI ativo com a habilitação já paga e os próximos módulos com Avise-me. Na tela: Painel do Revenue AI abaixo do catálogo: ICP AI com a pílula Funcionando, os números dos últimos 30 dias e o interruptor ligado; Follow-up avançado, Closer AI e LDR e Outbound AI com a pílula Em breve e a rodada. O painel do módulo: uma linha por capacidade com o estado, onde aparece, os números e o interruptor. O que ainda não chegou mostra a rodada. O **Core** é o que a sua conta já usa: atendimento, SDR de IA, qualificação, CRM, funil, agenda, follow-up e rodízio. Em **Módulos** você liga o que vem além dele. O primeiro é o **Revenue AI**: perfil de cliente ideal e aderência por lead, Revenue Intelligence, follow-up avançado e o Closer AI; LDR e Outbound AI entram na próxima rodada sem nova taxa para quem já habilitou. - **Como cobra**: Habilitar custa uma **taxa única**, que sai do saldo da conta (franquia primeiro, depois recarga) na hora de ativar. O valor aparece antes de você confirmar. Depois disso, o uso segue cobrado normalmente pelo seu plano — não há mensalidade do módulo. - **Sem saldo**: Se a taxa inteira não couber no saldo, nada é cobrado e o módulo não liga. Recarregue e tente de novo. - **Desligar**: É imediato. O perfil e as avaliações ficam guardados; só param de ser usados. Religar não cobra de novo. - **Exige plano**: O Revenue AI exige a assinatura Pro (ou a assinatura com o seu parceiro). Conta pré-paga vê o aviso no cartão. - **O painel do módulo**: Com o módulo ativo aparece, logo abaixo do catálogo, uma linha por capacidade com o estado: **Funcionando**, **Desligada por você**, **Precisa configurar** (com o botão que leva à tela certa) ou **Em breve** com a rodada. Cada capacidade tem o próprio interruptor e mostra onde aparece no painel e os números dos últimos 30 dias. > **Só o responsável pela conta ativa e desliga:** Admin vê a tela, mas os botões ficam desativados. Os módulos "em breve" só têm o **Avise-me**: nada é cobrado por eles. #### Segurança: a verificação em duas etapas Diferente do resto da tela, esta seção é da **sua** conta de acesso, não da empresa — cada pessoa liga a dela, e administrador também liga a sua. Com a verificação ativa, entrar passa a exigir, além da senha, um código de seis dígitos do seu aplicativo autenticador. Ler o código na tela e digitar no aplicativo leva um minuto. > **Trocar de celular exige refazer antes:** Desligar a verificação também pede um código válido — é o que impede alguém com a sua sessão aberta de desligá-la. Não existe código de recuperação nesta tela: se você trocar de aparelho sem reconfigurar antes, com a sessão ainda aberta, vai precisar de ajuda para voltar. #### Esqueci a senha: como voltar sozinho Isto não fica aqui dentro — é na tela de entrada do painel. Logo abaixo do campo de senha há o link **Esqueci minha senha**, e ele aparece em qualquer endereço. Resolve o acesso sem depender de ninguém. 1. **Peça o código**: Informe o e-mail com que você entra no painel. A tela responde a mesma frase para qualquer e-mail digitado — ela não confirma quem tem conta, de propósito —, e o código só sai se aquele e-mail for mesmo de uma conta. 2. **Abra o e-mail**: Chega um código de **6 dígitos** que vale por **10 minutos** e serve **uma vez só**. Pedir outro invalida o anterior, e um código novo só é emitido depois de 1 minuto — é por isso que o botão **Reenviar** fica contando. 3. **Escolha a senha nova**: Digite o código e a senha nova, com pelo menos 8 caracteres. Ao confirmar, você volta para o login — a recuperação não entra na conta por você. > **Redefinir a senha desconecta todo mundo:** Todas as sessões abertas daquela pessoa são encerradas, em qualquer aparelho — inclusive os que já estavam reconhecidos e não pediam código por e-mail. É o que garante que quem soubesse a senha antiga perca o acesso na hora. Quem tem **verificação em duas etapas** continua protegido: a senha nova sozinha não entra, o app autenticador segue sendo pedido. E a troca fica registrada na trilha da conta como **Senha redefinida por e-mail**. > **Você recebe um aviso quando a senha muda:** Depois de toda redefinição sai um e-mail **Sua senha foi alterada**. Se ele chegar sem que você tenha pedido nada, alguém tem acesso à sua caixa de entrada: redefina a senha de novo na hora e avise quem administra a conta. > **O link do primeiro acesso serve uma vez só:** Se a sua conta foi aberta por quem te vendeu o sistema, o link que você recebeu para **criar a sua senha** já cumpriu o papel dele: aberto de novo, ele avisa que **a conta já foi ativada**. Daqui em diante entre sempre com o e-mail e a senha que você criou — e, se esquecer a senha, é o **Esqueci minha senha** acima que resolve, não aquele link. Se aparecer **muitas tentativas vindas da sua rede**, o limite é da rede e não seu — num escritório, várias pessoas dividem o mesmo endereço. Ele se solta sozinho em poucos minutos, e a própria mensagem da tela diz quanto falta; os dados do celular são um caminho imediato. > **No primeiro acesso depois desta atualização, o painel pede um código:** Aparelhos que já estavam reconhecidos e entravam só com a senha vão pedir um **código por e-mail** uma vez, mesmo sem ninguém ter trocado a senha. Não é sinal de invasão: o reconhecimento do aparelho passou a cair junto com a troca de senha, e os reconhecimentos antigos não sabiam disso. Depois de digitar o código uma vez, aquele aparelho volta a entrar direto. Se o e-mail não chegar, confira a caixa de spam e tente de novo em instantes — sem o código não há como entrar. #### Notificações: o que chega até você Na tela: Seção de notificações, com o aviso no aparelho, o resumo semanal por e-mail ligado e a pesquisa de satisfação ligada com a prévia da pergunta. Os dois primeiros avisam você; o terceiro manda uma mensagem ao lead. A diferença importa. 1. **No seu aparelho**: Avisa quando um lead pede atendimento humano, mesmo com o painel fechado. É **por aparelho**, não por conta: ligar no computador não liga no celular. No celular, adicione o painel à tela inicial e o aviso passa a chegar como notificação normal. 2. **Resumo semanal da operação**: Toda segunda de manhã, no e-mail do responsável pela conta: leads novos, quentes, reuniões marcadas e satisfação da semana. **Enviar teste agora** manda uma cópia sem consumir o envio de segunda. 3. **Pesquisa de satisfação**: O único interruptor desta seção que **fala com o lead**. Vem desligado de fábrica por isso mesmo. 4. **A pergunta que ele recebe**: Exatamente este texto, ao encerrar um atendimento. A resposta de 1 a 5 vira a nota, e a média aparece no [Painel](https://attendto.com.br/manual/painel) e no [Transbordo](https://attendto.com.br/manual/handoff), por atendente. Nem a pergunta nem o agradecimento são cobrados do seu saldo. > **Avise a equipe antes de ligar a pesquisa:** A pergunta sai a cada atendimento encerrado — inclusive nos que alguém encerrou por engano. Quem tem o hábito de fechar conversa para limpar a lista vai mandar pesquisa a quem não foi atendido. Os interruptores do sino (o que aparece no ícone de aviso do topo) ficam na seção **Cobrança & alertas**, não aqui — e eles valem **só neste navegador**: desligar no computador não desliga no celular. #### Cobrança & alertas: a recarga que evita a parada A **recarga automática** é a diferença entre a IA parar de responder num sábado e você nem ficar sabendo que chegou perto. Ligada, quando o saldo cai abaixo do limiar que você definir, uma recarga do valor escolhido é gerada sozinha por Pix. - Um limiar que dê **dois ou três dias de consumo** é uma boa medida: sobra tempo para o pagamento compensar antes de o saldo acabar. - Um valor de recarga que cubra **duas a quatro semanas** evita a conta virar um fluxo de recargas pequenas. - **O erro caro é inverter os dois** — recarregar um valor menor que o limiar coloca a conta em recarga atrás de recarga. - O **Limiar de saldo baixo** logo abaixo é outra coisa: é a partir de que valor o painel te avisa. Não recarrega nada sozinho. Quanto custa cada coisa, o extrato e as notas fiscais estão em [Saldo & Recargas](https://attendto.com.br/manual/saldo-e-recargas). Ainda nesta seção ficam os quatro interruptores do **sino** — o ícone de aviso no alto do painel. Cada um liga ou desliga um tipo de aviso, e vale **só neste navegador**: desligar no computador não desliga no celular. - **Lead aguardando atendimento humano**: Um aviso por conversa na fila do [Transbordo](https://attendto.com.br/manual/handoff). É o que mais aparece numa conta movimentada — e o motivo de o sino rolar. - **Recarga pendente de pagamento**: O Pix foi gerado e ainda não compensou. - **Assinatura (pagamento pendente/atrasado)**: A mensalidade precisa de atenção antes de a franquia parar. - **Saldo baixo**: Dispara no **Limiar de saldo baixo** definido logo acima — e é o mesmo interruptor do aviso “a IA parou de responder”, que é o dano já acontecendo. O sino desce **10 avisos por vez** e busca os próximos conforme você rola — numa conta com dezenas de leads na fila ele não despeja a lista inteira. O **número no ícone é sempre o total**, não o tanto que já desceu: se ele diz 34 e você vê 10, os outros 24 estão logo abaixo. Na tela: Menu de notificações aberto no alto do painel, com um lead aguardando atendimento e as ações do cabeçalho O sino fica no alto de TODAS as telas, e o número nele é a fila inteira. Nesta conta de demonstração há um aviso só; com dezenas, o menu ganha rolagem própria e vai buscando os próximos conforme você desce. - **marcar todas como vistas** apaga os pontinhos de **todos** os avisos — inclusive os que você ainda não rolou até ver. O menu continua aberto. - A **lixeira** dispensa os avisos que estão ali agora, e pede confirmação antes. Ela não apaga nada de verdade: os avisos nascem do estado da operação, então a conversa que continuar esperando traz o aviso de volta na próxima novidade. - Clicar num aviso leva à tela dele e marca aquele como visto. > **Sino vazio e sino que não carregou são coisas diferentes:** Quando a lista não vem, o menu diz que não conseguiu carregar e oferece tentar de novo — nunca “tudo em dia”. Se você leu “tudo em dia”, é porque não há mesmo ninguém esperando. #### Avançado: eventos e a zona de perigo Só o responsável pela conta enxerga esta seção. Ela tem os endereços avisados quando algo acontece — os mesmos de [Integrações](https://attendto.com.br/manual/integracoes) — e a exclusão da conta. > **Excluir a conta apaga os contatos e as conversas:** O pedido exige digitar o nome da empresa e tem **7 dias** de carência para você voltar atrás. Passado o prazo, os dados dos leads são anonimizados e a IA para de atender. Exporte o que precisar guardar antes — a trilha em [Compliance](https://attendto.com.br/manual/compliance) e os contatos em [Base de contatos](https://attendto.com.br/manual/base-de-contatos). #### O que conferir no primeiro dia 1. **Desligue o 24/7 e monte o horário de verdade**: Com o fuso certo e o modo em **IA continua atendendo**. É o ajuste que muda mais coisa de uma vez. 2. **Escreva a mensagem de ausência e o aviso de LGPD**: São os dois textos que o lead recebe palavra por palavra. 3. **Confira o ritmo de conversa humana**: Já vem ligado nas contas novas: respostas mais parecidas com gente, e conta menor no fim do mês. Desligue só se a sua operação preferir um bloco de texto por resposta. 4. **Ajuste o tom de voz da persona**: Diga como ela trata o cliente e o quanto se estende. É o campo que mais muda a conversa. 5. **Convide o time com o papel certo**: Quem só atende é **Atendente**. Lembre que **Admin** não configura. 6. **Ligue a recarga automática**: É o que impede o atendimento de parar por saldo num fim de semana. No painel: Abrir Configurações. ### Guia: Conta pronta para o seu segmento Segmento na implantação, Seu segmento, outro segmento pela IA e ajuste #### O segmento na abertura da conta 1. **Na implantação**: A conta nova é aberta com um especialista. Na implantação, ele escolhe com você um dos 16 segmentos, ou monta o seu em **Outro segmento** com a IA. Contas abertas pelo cadastro do site, até outubro de 2026, escolheram o segmento ali mesmo. 2. **A conta nasce configurada**: A conta nasce com o quadro, os campos do negócio, a qualificação, a persona inicial, o roteiro da base e a cadência de retomada do segmento. 3. **Preencha a base**: O roteiro da base fica marcado como **A preencher**: a IA só responde o que estiver na base, então complete com os seus dados. Na tela: Tela Sua conta já vem pronta para Imobiliária: os cartões do quadro do funil, dos campos do negócio, da qualificação, da persona inicial com a primeira mensagem, do roteiro da base com os tópicos a preencher e da cadência de retomada desligada. A conta pronta para Imobiliária. #### Outro segmento: a IA monta o modelo 1. **Escreva o seu segmento**: Escolha **Outro segmento**, escreva o seu (“pet shop”, “buffet”, “gráfica”) e clique em **Gerar com IA**. 2. **Se já existe modelo pronto**: Se o seu segmento já tem modelo pronto, a tela avisa (“Parece o segmento Varejo e loja”) e você usa o pronto, sem custo. 3. **Revise a prévia**: Se não tem, a IA monta etapas, campos, perguntas, persona, roteiro e retomada. Revise na prévia: cada peça tem **Editar**, e nada é aplicado antes de **Usar este modelo**. 4. **Segmentos regulados**: Nos segmentos regulados por conselho, como psicologia ou veterinária, o modelo já vem com os cuidados e com os campos sensíveis marcados. Os cuidados são escritos pela IA e não são parecer jurídico: confirme com o seu conselho. Na tela: Cadastro com Outro segmento escolhido e “pet shop” escrito: a prévia do modelo gerado pela IA com as etapas do funil, os campos, a qualificação, a persona, o roteiro, a cadência e os cuidados, cada peça com Editar, e os botões Usar este modelo e Usar o Genérico. O modelo que a IA montou para “pet shop”: cada peça tem Editar, e nada é aplicado antes de Usar este modelo. > **Quanto custa gerar:** Casar com um modelo pronto, dar erro ou cancelar não cobra nada. O que você escreveu fica guardado para criarmos os próximos modelos de segmento. Se o modelo ficar pronto antes de o cancelamento chegar, ele aparece para você revisar, e aí já conta como a geração. Cada conta pede até 10 modelos por hora. #### Seu segmento em Configurações Conta criada antes da escolha de segmento, ou que quer trocar: em **Configurações → Seu segmento**, **Trocar segmento** muda só o rótulo, o que vem pré-selecionado no Funil e na Qualificação e os cuidados que chegam à IA. Nada é criado nem apagado. A conta que já nasceu com o segmento escolhido traz o pacote: embaixo do nome do segmento aparece, por exemplo, “Escolhido no cadastro em 26/09/2026 · a conta nasceu com o pacote”, e cada peça mostra que já está na conta. Se uma peça não ficou pronta no cadastro (a aba fechada no meio do preparo, por exemplo), a frase diz “parte do pacote”, e o aviso **O preparo da conta não terminou** lista o que falta: **Concluir o preparo** roda só essas peças. Se você trocar o segmento antes, o que faltava sai do preparo, e **Aplicar o pacote do segmento** traz o pacote do segmento novo. Para trazer o modelo, clique em **Aplicar o pacote do segmento**. A prévia mostra cada peça com a própria escolha: o quadro entra como quadro novo, os campos que faltam são acrescentados, a qualificação entra como público novo, a persona só muda se ainda for a padrão, o roteiro só acrescenta os tópicos que faltam e a cadência entra desligada. Na conta sem persona nenhuma, a persona do segmento entra. A peça que já está toda na conta (todos os campos, todos os tópicos) mostra **Nada a acrescentar** e não conta no **Vai aplicar**. Depois de aplicar, o **Desfazer** devolve o que foi criado, peça por peça ou tudo, e o aviso diz o que saiu. > **O que o Desfazer não desfaz:** O quadro que já recebeu leads, o campo que já tem valor e o público que você editou depois do pacote (ou que já recebeu leads) ficam como estão (a tela diz por quê): exclua em **Funil → Configurar quadro** ou remova em Qualificação se quiser. O quadro do pacote que virou o padrão também fica quando é o único quadro da conta. O Desfazer só tira o que o próprio pacote criou. #### Usar o modelo do segmento na Qualificação Em **Qualificação → Usar modelo do segmento**, a prévia mostra o que a IA vai descobrir em cada sinal da nota, com as perguntas. Por padrão, o modelo entra como **um público novo**; se preferir **substituir** um público, a tela mostra o que sai e o que entra, e o **Desfazer** fica à mão. O público novo que já recebeu leads fica: remova em Qualificação se quiser. #### Ajustar ao meu negócio A IA lê a sua base, a persona e as perguntas de hoje e reescreve nomes, objetivos e perguntas para o seu negócio. Ela não liga nem desliga sinal e não muda peso. O resultado passa pela prévia, e você aplica troca por troca ou tudo de uma vez. Se der erro ou você cancelar, nada é cobrado. #### Segmentos com cuidados Clínica, odontologia, farmácia e advocacia vêm com os cuidados do conselho profissional e da LGPD já seguidos pela persona, pelas perguntas e pela cadência: sem promessa de resultado, dado de saúde como sensível e urgência encaminhada para quem atende. Nesses segmentos, o que o lead conta sobre a saúde ou o caso fica só no painel: o aviso de lead qualificado do webhook sai sem o resumo da conversa e sem a necessidade. O selo **Cuidados do segmento** abre o resumo de cada um. > **Não é parecer jurídico:** O resumo orienta a configuração e não é parecer jurídico. Na dúvida, confirme com o seu conselho profissional ou com o seu advogado. No painel: Abrir Seu segmento. ### Guia: Leitura de imagens A IA lê a foto que o lead manda — receita, caixa de remédio, produto, conta, comprovante — e responde com o que viu. A equipe vê o que foi lido embaixo da foto. Muito lead manda foto em vez de escrever: a receita, a caixa do remédio, o produto que quer, a conta de luz, o comprovante do Pix. A IA **lê a imagem** e responde com o que viu, sem pedir para o lead digitar o que já está na foto. Embaixo da imagem, no Inbox, a equipe vê o que a IA leu. O lead nunca vê esse quadro. #### O que a IA faz com a foto - **Lê** o texto útil da imagem (nome do produto ou do remédio, quantidade, valor) e diz o que a imagem é. - **Responde** usando o que leu: a resposta ganha a marca "Respondeu com o que leu na foto" na conversa. - **Mostra à equipe** o que foi lido, embaixo da foto, com o tipo da imagem e o preço da leitura. - Com a condução até o pedido ligada, os itens da foto entram no **pedido em montagem** da conversa. Na tela: A foto, o que a IA leu nela e a resposta que usou a leitura. O quadro é só da equipe: o lead vê a conversa normal. #### Onde ligar e desligar Em **Configurações › IA & persona**, o cartão **Leitura de imagens** tem três controles. Só o dono da conta muda, e cada mudança fica na trilha de auditoria. - **A IA lê as imagens**: Ligado por padrão. Desligado, a IA não lê a foto: diz ao lead que não consegue ver imagens por aqui e pede que ele escreva o que precisa. - **Mostrar para a equipe o que a IA leu**: O quadro embaixo de cada foto, no Inbox. Desligado, ele some da tela e das respostas do painel; a foto continua. - **Limite por conversa**: Quantas imagens a IA lê em 24 horas na mesma conversa: 10 (padrão), 5, 20 ou sem limite. Na tela: Cartão Leitura de imagens em Configurações, com os interruptores, o limite por conversa e a estimativa de custo. A estimativa ao lado usa as imagens que os seus leads mandaram nos últimos 30 dias. No painel: Abrir Configurações › IA & persona. #### Quanto custa - **Imagem lida pela IA**: Cobrada só quando a IA consegue ler. Sai do saldo como qualquer consumo, com a linha no Extrato. - **Não cobradas**: Figurinha, foto borrada ou cortada, imagem acima de 10 MB, formato que a IA não abre e imagem acima do limite da conversa. Aparecem no Extrato como "sem custo", para você saber que chegaram. Na tela: Cartão do consumo do mês na Carteira, com a linha Imagem lida pela IA e as imagens que vieram sem custo. Na Carteira, o consumo do mês mostra as imagens lidas e quantas chegaram sem custo. > **Dica:** A mensagem que a IA responde continua cobrada como sempre. Sem saldo para as duas, a conversa pausa como em qualquer consumo. #### Limite por conversa O limite conta as imagens que a IA leu (ou tentou ler) nas últimas 24 horas da mesma conversa. Passou do limite, a próxima imagem **não é lida nem cobrada**: a conversa vai para a fila da equipe, com uma nota explicando o motivo. É a proteção contra quem manda dezenas de fotos de uma vez. #### A partir de quando A IA lê só as imagens que chegam **depois que a leitura entrou no ar**. As fotos que já estavam nas conversas não são lidas nem cobradas, nem quando você desliga e liga o interruptor de novo. #### Por quanto tempo a foto fica A foto que o lead manda é apagada **90 dias depois de chegar**, como o áudio. As fotos que já estavam na conta antes da leitura contam os 90 dias a partir da data em que ela entrou no ar, e não de quando chegaram: nada some de uma vez. O que a IA leu fica na conversa; no lugar da foto aparece "Foto apagada depois de 90 dias". #### O que a IA lê em cada segmento - **Loja e comércio**: A foto do produto ou da etiqueta: a IA diz o que é e confere na sua base se você tem. - **Oficina e autopeças**: A foto da peça ou do código dela, para achar o item certo. - **Imobiliária**: A foto do imóvel, do anúncio ou da placa, para saber de qual imóvel o lead fala. - **Serviços e escritório**: A foto de um documento ou de um formulário, para montar o atendimento (a IA não copia número de documento). - **Farmácia**: A receita e a caixa do remédio, com os cuidados da seção abaixo. #### Comprovante de pagamento Em qualquer segmento, a foto de um comprovante (Pix, boleto, transferência) **nunca confirma o pagamento**. A IA diz ao lead que recebeu o comprovante e que a equipe confere e confirma por aqui, e a conversa ganha uma nota interna **Comprovante enviado: conferir**. Nada do pedido nem do Funil muda por causa da foto: quem confirma é a sua equipe. #### Receitas e remédios - Sim: Lê a receita e a caixa do remédio para montar o pedido e ver o que tem. - Sim: Receita de controle especial: avisa que a receita original é entregue na retirada ou na entrega, e o pedido vai para a conferência da equipe. - Sim: Pergunta de dose ou de uso vira uma nota interna para quem confere ("Pergunta para o farmacêutico"), e a conversa segue. - Não: Orientar dose, horário, interação ou uso. - Não: Dizer se a receita é válida. #### Dados de saúde e LGPD Receita e caixa de remédio são dado de saúde. O que a IA leu fica só na conversa, à vista da equipe; o rastro das decisões da IA diz apenas "imagem lida", sem o tipo nem o texto. O lead nunca vê o quadro. Quando um lead pede para ser esquecido, as fotos dele saem do armazenamento e o que a IA leu é apagado junto com a conversa. O texto escrito dentro da foto é tratado como conteúdo, nunca como ordem para a IA. #### No Enterprise No plano Enterprise, a leitura roda no **modelo da sua empresa**, na tarefa **Leitura de imagem** de [IA própria](https://attendto.com.br/manual/ia-propria) › Roteamento. Ela é opcional e só aceita modelo que passou na checagem "Lê uma foto de exemplo" do teste de conexão. A foto nunca vai para a IA da plataforma, nem como contingência. - **Sem a tarefa Leitura de imagem**: A IA não lê a foto: responde pela legenda que veio com ela e, sem legenda, diz que não consegue ver imagens por aqui e pede para o lead escrever. - **Modelos da empresa fora do ar**: A foto vai para a sua equipe, com o aviso na conversa. Nada é cobrado. - **Máscara de dados pessoais**: Vale para o texto. A imagem vai como chegou ao modelo da empresa, como o áudio. Na tela: Aba Roteamento da IA própria com o cartão 'Quais dos seus modelos leem imagem' e a linha Leitura de imagem. No Roteamento, os modelos que leem imagem aparecem marcados; os que são só texto ficam fora da tarefa. #### Perguntas **A IA lê PDF?** Não. Só imagem (JPEG, PNG, WEBP, HEIC). O PDF chega à conversa e a equipe abre normalmente. **E figurinha?** A IA não lê e não cobra. Figurinha sozinha não ganha resposta, e a de quem não tem conversa aberta é descartada. **E o web chat?** O web chat não recebe imagem. A leitura vale para o WhatsApp e o Direct do Instagram. **A IA errou o que leu. E agora?** A equipe vê o quadro e corrige na conversa. A foto continua lá para conferir. Como as pessoas procuram: configurações do painel; convidar atendente; trocar o segmento da conta; aplicar pacote do segmento; mudar nome da ia; tom de voz da ia; domínio próprio painel; configurar dns cname txt; horário de atendimento whatsapp; mensagem de ausência; desativar acesso de atendente; rodízio de leads; verificação em duas etapas; recarga automática pix; trocar logo do painel. ## Central de ajuda do painel: guias de cada tela com imagens, busca e passo a passo URL: https://attendto.com.br/manual/central-de-ajuda Menu: Geral > Central de ajuda A Central de ajuda é a documentação dentro do painel: um guia por tela, com imagens anotadas e passo a passo, que abre no assunto da tela em que você estava. Quando aparece: Sempre disponível, para todos os papéis. Os guias de IA própria e de Base avançada só aparecem para contas que têm essas telas, e alguns trechos dos guias mudam conforme a conta (IA própria, Base avançada incluída ou paga). ### Quem pode usar - Dono: Lê todos os guias, inclusive os de telas que só o dono e o admin operam. - Admin: Lê todos os guias, como o dono. - Atendente: Também lê todos os guias, inclusive os de telas que o papel dele não abre (o botão Abrir esta tela, nesses casos, leva de volta ao Painel). ### Telas #### Central de ajuda A tela Central de ajuda serve para encontrar o guia certo: pela busca em linguagem do dia a dia, pela jornada do lead em cinco passos ou pelo índice de todas as telas na ordem do menu. Endereço no painel: `/app/ajuda` ![Captura da tela Central de ajuda. A tela Central de ajuda serve para encontrar o guia certo: pela busca em linguagem do dia a dia, pela jornada do lead em cinco passos ou pelo índice de todas as telas na ordem do menu.](https://attendto.com.br/prints-do-manual/central-de-ajuda--indice.png) A tela Central de ajuda na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Pelo menu do usuário (sua foto ou iniciais, no canto direito da barra do topo), item Central de ajuda. A busca de comandos (Ctrl K) também traz guias da ajuda. ##### Como usar o seu painel O cabeçalho da página, com a busca logo abaixo. Campos e filtros: - **Buscar na ajuda**: Escreva a dúvida do seu jeito (por exemplo, mandar mensagem em massa ou a IA inventa preço?). A partir de 2 letras aparecem até oito guias, com o trecho que bateu. Botões e ações: - **/**: Atalho: a barra leva o cursor ao campo de busca de qualquer ponto da página. Também aparece: - Nos resultados, setas para cima e para baixo escolhem, Enter abre o guia e Esc limpa a busca. - A busca entende acentos e pontuação de qualquer jeito: orçamento e orcamento acham a mesma coisa. ##### Você estava em Quando você abre a ajuda vindo de uma tela, o primeiro bloco é o guia dela. Botões e ações: - **Você estava em ‹guia›**: Abre o guia da tela de onde você veio, com o resumo dele. ##### A volta completa O caminho que todo lead percorre, em cinco passos numerados; cada passo abre o trecho do guia correspondente. Botões e ações: - **Ler a jornada inteira**: Abre o guia da jornada completa do lead. - **O que a IA faz por dentro**: Abre o guia que explica quem decide cada parte, por que a IA respondeu aquilo e o que ela confere antes de enviar. Também aparece: - Os passos: o lead chega, a sua IA conversa, você entra quando vale a pena, o negócio anda no quadro, ninguém esfria esquecido. ##### Todas as telas O índice dos guias na mesma ordem e nos mesmos grupos do menu lateral (OPERAÇÃO, INTELIGÊNCIA, CONTA). Também aparece: - Cada linha traz o título e o resumo do guia; um guia recém-chegado leva a pílula Novo. - Guias de partes de uma tela (por exemplo, a entrada de leads dentro de Integrações) aparecem logo abaixo do guia da tela. ##### Rodapé Botões e ações: - **Imagens desta ajuda geradas em ‹data›**: Passe o mouse para saber que as imagens saem de uma conta de demonstração com dados fictícios, refeitas sempre que uma tela muda. ##### Estados da tela - Sem nada ainda: Busca sem resultado: Nada encontrado para “‹termo›”. Tente uma palavra só, ou veja o índice de telas mais abaixo. #### Guia do painel A tela de guia serve para ler a explicação completa de uma tela do painel, com imagens numeradas, passo a passo, avisos e perguntas frequentes, e voltar à tela quando terminar. Endereço no painel: `/app/ajuda/‹…›` ![Captura da tela Guia do painel. A tela de guia serve para ler a explicação completa de uma tela do painel, com imagens numeradas, passo a passo, avisos e perguntas frequentes, e voltar à tela quando terminar.](https://attendto.com.br/prints-do-manual/central-de-ajuda--guia.png) A tela Guia do painel na conta de demonstração, com dados fictícios e os valores desfocados. Como chegar: Pelo índice ou pela busca da Central de ajuda, pela busca de comandos (Ctrl K, grupo Ajuda ou Ajuda desta tela) e pelos links entre guias. ##### Cabeçalho do guia Botões e ações: - **Todos os guias**: No celular e em telas estreitas: volta ao índice da Central de ajuda. - **Abrir esta tela**: Abre a tela do painel que o guia explica. Também aparece: - O título do guia e um resumo de uma frase. ##### Corpo do guia Seções com texto, listas, passo a passo numerado, tabelas, definições, avisos (dica, atenção, cuidado), perguntas que abrem ao clicar e botões para abrir a tela citada. Também aparece: - Alguns trechos mudam conforme a sua conta: com IA própria ou com a Base avançada, o guia mostra a versão que vale para você. ##### Imagens anotadas Prints da tela com áreas numeradas; a lista abaixo da imagem explica cada número. Botões e ações: - **Destaque ‹n›: ‹título›**: A área numerada sobre a imagem: passar o mouse escurece o resto; clicar de novo amplia aquele pedaço. - **Ver de perto**: Na lista abaixo da imagem: abre a imagem ampliada já no pedaço explicado. - **Ampliar**: No celular, a imagem inteira vira o botão de ampliar. Também aparece: - A imagem ampliada abre numa janela (Tela ampliada) que se percorre arrastando. - No celular os números somem de cima da imagem; quem explica é a lista abaixo dela. ##### Navegação lateral Em telas largas: a lista de todos os guias à esquerda e o sumário à direita. Botões e ações: - **Central de ajuda**: No alto da lista da esquerda: volta ao índice. - **Nesta página**: O sumário com as seções do guia; a seção que você está lendo fica destacada e cada item leva direto a ela. Também aparece: - A lista da esquerda começa pelos guias gerais (jornada, a IA por dentro, Termos, contratação, IA da plataforma nesta conta) e segue pelos grupos do menu. ##### Rodapé do guia Botões e ações: - **Voltar para onde você estava**: Aparece quando você veio de outra tela: volta para ela. - **Anterior**: Abre o guia anterior na ordem da lista lateral. - **Próximo**: Abre o guia seguinte na ordem da lista lateral. ##### Estados da tela - Endereço de guia que não existe (ou que a conta não tem): Este guia não existe, com a explicação de que ele pode ter sido renomeado e o botão Ir para a Central de ajuda. ### Passo a passo #### Como achar a explicação de uma tela do painel 1. Abra o menu do usuário (sua foto ou iniciais) e escolha **Central de ajuda**. 2. Se você estava na tela com dúvida, clique no bloco **Você estava em**. 3. Se não, digite a dúvida em **Buscar na ajuda** ou escolha a tela em **Todas as telas**. #### Como buscar uma dúvida na ajuda sem saber o nome da tela 1. Na Central de ajuda, aperte **/** para ir ao campo de busca. 2. Escreva a dúvida com as suas palavras, por exemplo mensagem em massa. 3. Use as setas para escolher o guia e **Enter** para abrir. #### Como ver de perto um pedaço da imagem do guia 1. Passe o mouse sobre um número da imagem para destacar aquela área. 2. Clique em **Ver de perto** na lista abaixo da imagem (no celular, toque em **Ampliar**). 3. Arraste dentro da janela para percorrer a tela ampliada. #### Como voltar do guia para a tela em que eu estava 1. No fim do guia, clique em **Voltar para onde você estava**. 2. Ou, no cabeçalho do guia, clique em **Abrir esta tela** para ir à tela que ele explica. ### Perguntas frequentes #### A ajuda abre no guia da tela em que eu estava? Sim. Ao abrir a Central de ajuda vindo de uma tela, o primeiro bloco é Você estava em, com o guia daquela tela. Na busca de comandos (Ctrl K), o grupo Ajuda desta tela faz o mesmo. #### As imagens dos guias mostram dados de clientes reais? Não. As imagens saem de uma conta de demonstração com dados fictícios e são refeitas sempre que uma tela muda; a data da última geração aparece no rodapé da Central de ajuda. #### Por que não encontro o guia de IA própria ou de Base avançada? Esses guias só aparecem para contas que têm as telas correspondentes. Sem o plano ou o módulo, eles ficam fora do índice e da busca. #### O atendente consegue ler a ajuda? Sim. A Central de ajuda não tem restrição de papel: o atendente lê todos os guias, inclusive os de telas que o papel dele não abre. #### Abri um link antigo de guia e apareceu Este guia não existe. O que faço? O guia pode ter mudado de endereço. Use o botão Ir para a Central de ajuda e procure o assunto pela busca ou pelo índice. #### Qual a diferença entre a Central de ajuda e o manual público? A Central de ajuda conta cada tela com imagens e histórias, dentro do painel. O manual é o inventário: lista cada tela, campo, botão e permissão, e remete ao guia correspondente. Como as pessoas procuram: central de ajuda; ajuda do painel; manual do painel; como usar o painel; tutorial das telas; guia passo a passo; buscar dúvida na ajuda; onde fica a ajuda; documentação do sistema de atendimento. ## Acesso ao portal do revendedor: entrar, definir a senha e assinar o contrato de revenda URL: https://attendto.com.br/manual/revenda-acesso Menu: Portal do revendedor > Acesso ao portal O acesso ao portal do revendedor é o caminho de entrada de quem revende a plataforma com marca própria: definir a senha pelo convite, assinar o contrato de revenda na antessala, esperar a liberação e entrar na área de revenda com e-mail e senha. ### Quem pode usar - Dono: O portal não tem papéis de equipe: cada revendedor tem um único acesso, com o e-mail e a senha do cadastro de parceiro, e é o mesmo login da antessala e da área de revenda. A área só abre depois do contrato de revenda e da liberação. - Admin: Não se aplica: a conta do cliente final tem login próprio no painel do cliente e não entra no portal do revendedor. O cliente final nunca vê o portal. - Atendente: Atendente de uma conta de cliente não acessa o portal; quem tentar entrar sem ser revendedor recebe a recusa com o motivo. ### Telas #### Entrar na sua área A tela de entrada da revenda serve para o revendedor entrar na área de revenda com o mesmo e-mail e a mesma senha do cadastro de parceiro. Endereço no painel: `/revenda` ![Captura da tela Entrar na sua área, com nomes e valores desfocados. A tela de entrada da revenda serve para o revendedor entrar na área de revenda com o mesmo e-mail e a mesma senha do cadastro de parceiro.](https://attendto.com.br/prints-do-manual/revenda-acesso--entrar.png) A tela Entrar na sua área numa conta de demonstração, com os nomes e os valores desfocados. Como chegar: Pelo endereço da revenda; quem já está com a sessão aberta vai direto para a Visão geral. ##### Área de Revenda O painel de apresentação ao lado do formulário: a marca é sua, a carteira herda a marca e o espelho mostra o que o cliente vê. Também aparece: - Rodapé: quem participa só do programa de indicação entra pela porta do parceiro. ##### Entrar na sua área O formulário de login. Campos e filtros: - **E-mail** (obrigatório): O e-mail do cadastro de parceiro. - **Senha** (obrigatório): A mesma senha definida no convite. Botões e ações: - **Entrar**: Entra no portal e abre a Visão geral. - **Abrir o meu portal e ver o que falta**: Aparece quando a área ainda não abriu para um revendedor (por exemplo, falta o contrato): entra na antessala com as mesmas credenciais. Também aparece: - Credencial errada: a mensagem pede para conferir e usar a senha definida no convite. - Área ainda fechada: a mensagem do motivo aparece em tom neutro, não como erro, com o caminho para a antessala. ##### Topo do portal (depois de entrar) A barra que acompanha todas as telas da área de revenda. Botões e ações: - **Tema: claro**: Alterna o tema do portal entre claro, escuro e o do sistema. - **Menu da sua conta**: Abre o menu com o seu nome e o papel Revendedor. - **Sair**: Encerra a sessão e volta para a tela de entrada da revenda. Também aparece: - A sua marca publicada (logo, ou a inicial na sua cor com o nome) e o selo REVENDA. - O nome e a descrição da tela atual. - Menu lateral (no celular, faixa horizontal) com Visão geral, Sua marca, Carteira, Preços e margens (quando liberado), Módulos, Repasses e Demonstração. ##### Estados da tela - Carregando: O botão mostra Entrando… enquanto confere as credenciais. Depois de entrar, a casca do portal aparece em esqueleto até a sessão carregar. - Se der erro: Se a área não abrir depois do login, aparece Não conseguimos abrir a sua área, com o motivo e o botão Tentar de novo. Sessão expirada volta para esta tela. #### Definir senha do portal A tela de definir senha serve para o revendedor convidado criar a senha do portal pelo link do e-mail de convite e seguir para assinar o contrato de revenda. Endereço no painel: `/revenda/definir-senha/‹…›` Como chegar: Pelo link do e-mail de convite do programa de revenda. ##### Programa de Revenda O painel do lado: você vende com a sua marca, pelo preço que define, e a sua fatia sai dentro da própria cobrança do cliente. A área de revenda abre quando o contrato estiver assinado pelas duas partes. ##### Quase lá! Defina a senha para entrar no portal e assinar o contrato de revenda. Campos e filtros: - **Nova senha** (obrigatório): Mínimo de 8 caracteres. - **Confirmar senha** (obrigatório): A mesma senha, para conferir. Botões e ações: - **Definir senha e entrar**: Grava a senha e abre a antessala da revenda. Também aparece: - Senha curta ou diferente da confirmação é recusada na hora, com o motivo. - Convite inválido ou vencido: a tela pede um convite novo à equipe da plataforma. ##### Estados da tela - Carregando: O botão mostra Salvando… enquanto grava a senha. #### Portal do Revendedor O Portal do Revendedor é a antessala da revenda: mostra o contrato de revenda a assinar, os dados que vão nele e as etapas até a área de revenda abrir. Endereço no painel: `/revenda/portal` Como chegar: Depois de definir a senha pelo convite, ou pelo botão Abrir o meu portal e ver o que falta na tela de entrada. Quem também é parceiro de indicação vê o mesmo bloco no topo do portal do parceiro. ##### Cabeçalho O nome do portal e o seu nome. Botões e ações: - **Sair**: Encerra a sessão e volta para a entrada da revenda. ##### Contrato de Revenda com Marca Própria O cartão do contrato que rege a revenda: vender com a sua marca, definir o preço e receber a sua fatia dentro da cobrança do cliente. O texto completo abre na assinatura eletrônica, e a área libera quando as duas partes assinam. Botões e ações: - **Assinar contrato de revenda**: Gera o contrato e abre a página de assinatura eletrônica numa aba nova. Fica bloqueado enquanto faltarem dados do contrato. - **Abrir contrato de revenda para assinar**: Reabre a página de assinatura de um contrato já gerado. - **Já assinei — atualizar**: Recarrega a situação do contrato depois de assinar. Também aparece: - Contrato ainda não disponível: a tela explica que a espera é da plataforma e que nada do seu lado está pendente. - Contrato recusado ou com link vencido: aviso e o botão para gerar um novo. - Depois da sua assinatura: aviso de que falta a assinatura da plataforma. ##### Dados que vão no contrato O formulário de qualificação que antecede o contrato; os campos e a ajuda de cada um mudam conforme o documento seja de pessoa física ou de empresa. Campos e filtros: - **‹campo do contrato›**: Os dados que identificam você no contrato, como documento e endereço; pessoa física responde estado civil e empresa responde representante legal. Botões e ações: - **Salvar dados do contrato**: Grava os dados; com tudo preenchido, a assinatura é liberada. - **Revisar**: Com os dados completos, reabre o formulário para conferir antes de assinar. - **Fechar**: Recolhe o formulário. Também aparece: - Sem CPF ou CNPJ no cadastro, a tela pede para falar com a plataforma e incluí-lo antes de assinar. ##### Sua revenda As etapas até a área de revenda abrir, cada uma com o estado real e uma explicação ao passar o mouse. Botões e ações: - **Abrir a minha área de revenda**: Aparece quando a área foi liberada e leva à entrada da área de revenda. Também aparece: - Contrato de revenda: Concluído, Dispensado (quando a plataforma liberou sem assinatura), Agora ou aguardando a plataforma. - Liberação da sua área: feita pela plataforma depois do contrato, com aviso por e-mail. - Sua marca, seu endereço e sua carteira: o que você monta depois da liberação. - Parceria encerrada: em vez das etapas, aparece só a mensagem com a situação da revenda. ##### Estados da tela - Carregando: Um indicador de carregamento ocupa a tela até o portal saber quem você é. - Se der erro: Não foi possível carregar o painel, com o botão Tentar de novo. - Quem só participa da indicação abre este endereço: É levado para o portal do parceiro. - Sessão inexistente ou expirada: Volta para a tela de entrada da revenda. ### Passo a passo #### Como entrar no portal do revendedor pela primeira vez 1. Abra o link do e-mail de convite do programa de revenda. 2. Preencha **Nova senha** e **Confirmar senha** e clique em **Definir senha e entrar**. 3. Na antessala, preencha os **Dados que vão no contrato** e clique em **Salvar dados do contrato**. 4. Clique em **Assinar contrato de revenda** e assine na página que abrir. 5. Volte e clique em **Já assinei — atualizar**. Quando a área for liberada, use **Abrir a minha área de revenda**. #### Como entrar na área de revenda 1. Abra a entrada da revenda. 2. Preencha **E-mail** e **Senha** (a mesma do cadastro de parceiro) e clique em **Entrar**. 3. Se a área ainda não estiver aberta, clique em **Abrir o meu portal e ver o que falta**. #### Como saber o que falta para a área de revenda abrir 1. Entre na antessala (**Portal do Revendedor**). 2. Leia as etapas em **Sua revenda**: o selo de cada uma diz se é a sua vez, se está com a plataforma ou se já foi concluída. #### Como sair do portal do revendedor 1. Clique no seu nome em **Menu da sua conta**, no canto do topo. 2. Clique em **Sair**. ### Perguntas frequentes #### A senha do portal do revendedor é a mesma do programa de parceiros? Sim. O revendedor usa o mesmo e-mail e a mesma senha do cadastro de parceiro na antessala e na área de revenda. #### Assinei o contrato de indicação. Isso libera a revenda? Não. Revenda e indicação são negócios diferentes, cada um com o seu contrato; a área de revenda depende do contrato de revenda. #### Assinei o contrato, mas a área não abriu. Por quê? Depois da assinatura das duas partes, a liberação da área é feita pela plataforma, que avisa você por e-mail. A etapa Liberação da sua área mostra em que pé está. #### Meu cliente final entra por aqui? Não. O cliente final entra no painel dele, pelo seu endereço próprio e com a sua marca. O portal do revendedor é só de quem revende. #### O link do convite venceu. E agora? Peça um convite novo à equipe da plataforma; o link antigo não serve mais para definir a senha. #### Posso ter mais de um login no portal da revenda? Não. O portal tem um único acesso por revendedor; não há papéis de dono, admin ou atendente como no painel do cliente. Como as pessoas procuram: entrar no portal do revendedor; login área de revenda; definir senha convite revenda; assinar contrato de revenda; contrato white label; área de revenda não abre; liberação da revenda; antessala da revenda. ## Portal do parceiro de indicação: link de indicação, comissões e nota fiscal URL: https://attendto.com.br/manual/parceiro-de-indicacao Menu: Parceiro de indicação > Portal do parceiro O portal do parceiro é a área de quem participa do programa de indicação: ali ele aceita o termo ou assina o contrato de parceria, copia o link de indicação, acompanha as contas indicadas e as comissões do mês e envia a nota fiscal de cada fechamento. ### Quem pode usar - Dono: O portal não tem papéis de equipe: cada parceiro tem um único acesso, com o e-mail e a senha definidos no convite, e vê só os próprios indicados e comissões. - Admin: Não se aplica: as contas indicadas são de clientes, com login próprio no painel do cliente, e elas não veem o portal do parceiro. - Atendente: Atendente de uma conta de cliente não acessa o portal do parceiro. ### Telas #### Entrar no portal do parceiro A tela de entrada do parceiro serve para o parceiro de indicação entrar no portal com o e-mail e a senha definidos no convite. Endereço no painel: `/parceiro` ![Captura da tela Entrar no portal do parceiro, com nomes e valores desfocados. A tela de entrada do parceiro serve para o parceiro de indicação entrar no portal com o e-mail e a senha definidos no convite.](https://attendto.com.br/prints-do-manual/parceiro-de-indicacao--entrar.png) A tela Entrar no portal do parceiro numa conta de demonstração, com os nomes e os valores desfocados. ##### Portal do Parceiro O painel de apresentação do programa de indicação, ao lado do formulário, com o link para conhecer o programa. ##### Bem-vindo de volta O formulário de login. Campos e filtros: - **E-mail** (obrigatório): O e-mail do cadastro de parceiro. - **Senha** (obrigatório): A senha definida pelo link do convite. Botões e ações: - **Entrar no portal**: Entra no portal do parceiro. Também aparece: - Credencial errada: a mensagem lembra que, sem senha definida, é preciso usar o link do convite. - Quem só revende e entra por aqui é levado ao portal do revendedor. ##### Estados da tela - Carregando: O botão mostra Entrando… enquanto confere as credenciais. #### Definir senha do portal A tela de definir senha do parceiro serve para criar a senha do portal pelo link do convite e ativar o acesso. Endereço no painel: `/parceiro/definir-senha/‹…›` Como chegar: Pelo link do e-mail de convite do programa de parceiros. ##### Quase lá! Defina a senha para ativar o portal. Se o convite for de revenda, a tela muda para a apresentação do programa de revenda e, depois da senha, leva ao portal do revendedor. Campos e filtros: - **Nova senha** (obrigatório): Mínimo de 8 caracteres. - **Confirmar senha** (obrigatório): A mesma senha, para conferir. Botões e ações: - **Definir senha e entrar**: Grava a senha e abre o portal. Também aparece: - Senha curta ou diferente da confirmação é recusada com o motivo. - Convite inválido ou vencido: a tela pede um convite novo à equipe da plataforma. ##### Estados da tela - Carregando: O botão mostra Salvando… enquanto grava a senha. #### Portal do Parceiro O painel do parceiro serve para copiar o link de indicação, ver as vendas e a prévia de comissão do mês, acompanhar indicados e enviar a nota fiscal de cada mês fechado. Endereço no painel: `/parceiro/painel` ![Captura da tela Portal do Parceiro, com nomes e valores desfocados. O painel do parceiro serve para copiar o link de indicação, ver as vendas e a prévia de comissão do mês, acompanhar indicados e enviar a nota fiscal de cada mês fechado.](https://attendto.com.br/prints-do-manual/parceiro-de-indicacao--painel.png) A tela Portal do Parceiro numa conta de demonstração, com os nomes e os valores desfocados. Como chegar: Depois de entrar ou de definir a senha do convite. ##### Cabeçalho O nome do portal e o seu nome. Botões e ações: - **Sair**: Encerra a sessão e volta para a entrada do parceiro. ##### Termo do Parceiro Comercial Aparece antes de tudo quando o termo ainda não foi aceito e a assinatura eletrônica não é exigida; o aceite fica registrado com data, hora e identificação do acesso. Campos e filtros: - **Li e concordo com o Termo do Parceiro Comercial.**: Caixa que libera o botão de aceite. Botões e ações: - **Aceitar e entrar no portal**: Registra o aceite e abre o painel. ##### Contrato de Parceria Comercial — Indicação Aparece no lugar do painel quando a assinatura eletrônica é exigida e o contrato de indicação ainda não foi concluído pelas duas partes. Botões e ações: - **Assinar contrato de indicação**: Gera o contrato e abre a página de assinatura eletrônica numa aba nova; fica bloqueado enquanto faltarem dados do contrato. - **Abrir contrato de indicação para assinar**: Reabre a página de assinatura do contrato já gerado. - **Já assinei — atualizar**: Recarrega a situação depois de assinar. - **Salvar dados do contrato**: Grava os dados que identificam você no contrato. - **Revisar**: Reabre os dados completos para conferir antes de assinar. Também aparece: - Dados que vão no contrato: os campos mudam conforme o documento seja de pessoa física ou de empresa. - Contrato recusado ou com link vencido: aviso para gerar um novo. Depois da sua assinatura, aviso de que falta a da plataforma. ##### Termo de Acelerador Aviso que não bloqueia o painel: aparece quando há um termo de comissão acelerada combinado com você aguardando assinatura. Botões e ações: - **Abrir termo para assinar**: Abre a página de assinatura do termo. ##### Seu link de indicação O link rastreado: toda conta criada por ele conta como indicação sua, com a regra de comissão descrita no cartão. Botões e ações: - **Copiar link**: Copia o link de indicação para compartilhar. ##### Números do mês A prévia do mês corrente. Campos e filtros: - **Vendas em ‹mês›**: Vendas reconhecidas no mês. - **Assinaturas ativas**: Contas indicadas com assinatura ativa. - **Bônus do mês**: Bônus pelas vendas reconhecidas no mês. - **Recorrência do mês**: Comissão recorrente sobre as mensalidades das contas indicadas. - **Indicações de parceiros**: O que rendeu indicar outros parceiros. - **Prévia a receber**: A soma prevista do mês, em destaque. Também aparece: - Com acelerador negociado, uma faixa mostra quantas vendas faltam para destravá-lo no mês, ou que ele já foi destravado. ##### Seus indicados As contas que entraram pelo seu link, com o total. Também aparece: - Nome da conta, plano, data de entrada e a comissão da venda, quando houver. - Situação: Assinante ativo, Pagamento pendente, Aguardando pagamento, Cancelou, Reembolsado ou Testando (sem plano). ##### Indique um parceiro Indicação de outra pessoa para o programa: a plataforma entrevista, assina o contrato e libera o acesso; o ganho vale só para quem você indica diretamente. Campos e filtros: - **Nome** (obrigatório): Nome de quem você indica. - **E-mail** (obrigatório): E-mail da pessoa; não pode ser de quem já é parceiro. - **Por que essa pessoa seria um bom parceiro?**: Opcional: experiência comercial e segmento, para acelerar a análise. Botões e ações: - **Indicar parceiro**: Registra a indicação; fica ativo com nome e e-mail válidos. Também aparece: - Lista de quem você indicou, com a data e a situação: em análise pela plataforma, Não aprovado, convite enviado, Ativo no portal, Desativado ou quantos clientes ativos a pessoa já tem. ##### Comissões e notas fiscais Os meses fechados. Envie a nota fiscal de cada um; depois da aprovação, o pagamento sai por Pix até o dia 10. Botões e ações: - **Enviar nota fiscal**: Escolhe o arquivo da nota (PDF, JPG ou PNG) e envia para análise. - **Reenviar nota fiscal**: Aparece quando a nota foi rejeitada: envia outra. Também aparece: - Cada mês mostra vendas, assinaturas ativas, a composição da comissão e o total. - Situação: Envie sua nota fiscal, Nota em análise, Aprovada — pagamento a caminho, Nota rejeitada — reenvie (com o motivo) ou Paga. - O nome do arquivo enviado aparece abaixo do mês. ##### Sua revenda (para quem também revende) Quem participa da indicação e também da revenda vê no topo do painel o contrato de revenda e as etapas até a área de revenda abrir, sem bloquear o resto. ##### Estados da tela - Carregando: Um indicador de carregamento ocupa a tela até o portal carregar. - Sem nada ainda: Seus indicados: Ninguém entrou pelo seu link ainda. Comissões: Nenhum mês fechado ainda; a prévia do mês aparece nos cartões. - Se der erro: Não foi possível carregar o painel, com o botão Tentar de novo. - Termo não aceito ou contrato não assinado: O termo ou o contrato de indicação aparece no lugar do painel até ser concluído. - Quem só revende abre este endereço: É levado ao portal do revendedor. - Sessão inexistente ou expirada: Volta para a entrada do parceiro. ### Passo a passo #### Como ativar o portal do parceiro pelo convite 1. Abra o link do e-mail de convite. 2. Preencha **Nova senha** e **Confirmar senha** e clique em **Definir senha e entrar**. 3. Aceite o termo em **Aceitar e entrar no portal** ou assine o contrato em **Assinar contrato de indicação**, conforme o que aparecer. #### Como copiar o link de indicação 1. Entre no portal do parceiro. 2. No cartão **Seu link de indicação**, clique em **Copiar link** e compartilhe. #### Como enviar a nota fiscal da comissão 1. Em **Comissões e notas fiscais**, encontre o mês com a situação **Envie sua nota fiscal**. 2. Clique em **Enviar nota fiscal** e escolha o arquivo em PDF, JPG ou PNG. 3. Acompanhe a situação: **Nota em análise**, depois **Aprovada — pagamento a caminho** e **Paga**. 4. Se aparecer **Nota rejeitada — reenvie**, leia o motivo e use **Reenviar nota fiscal**. #### Como indicar outra pessoa para ser parceira 1. No cartão **Indique um parceiro**, preencha **Nome** e **E-mail**. 2. Se quiser, conte a experiência da pessoa no campo de observação. 3. Clique em **Indicar parceiro** e acompanhe a situação na lista abaixo. ### Perguntas frequentes #### Qual a diferença entre o portal do parceiro e o portal do revendedor? O parceiro de indicação divulga um link e recebe comissão pelas contas indicadas. O revendedor vende com a própria marca e o próprio preço e recebe a parte dele dentro da cobrança do cliente. São programas e contratos diferentes. #### Quando recebo a comissão? Quando o mês fecha, você envia a nota fiscal pelo portal; depois da aprovação, o pagamento sai por Pix até o dia 10. #### Como sei quais contas vieram do meu link? Elas aparecem em Seus indicados, com o plano, a data de entrada e a situação da assinatura. #### A nota fiscal foi rejeitada. O que faço? O motivo aparece abaixo do mês. Corrija a nota e use Reenviar nota fiscal. #### Indicar outro parceiro já gera ganho? Não por si só. O ganho vem quando os clientes da pessoa indicada pagam, e vale só para quem você indicou diretamente. #### Por que o painel só mostra o contrato? Enquanto o termo não for aceito ou o contrato de indicação não for assinado pelas duas partes, o portal mostra só esse passo. Depois de assinar, use Já assinei — atualizar. Como as pessoas procuram: portal do parceiro; link de indicação; programa de indicação; comissão de indicação; enviar nota fiscal parceiro; como indicar clientes; indicar um parceiro; extrato de comissões; termo do parceiro comercial. ## Visão geral da revenda: receita do mês, meta, saúde da carteira e repasses URL: https://attendto.com.br/manual/revenda-visao-geral Menu: Portal do revendedor > Visão geral A Visão geral é o painel de abertura do portal do revendedor: mostra num olhar quanto a revenda rendeu no mês, de onde veio o dinheiro, quais contas pedem atenção e quando a sua parte cai na conta de recebimento. ### Quem pode usar - Dono: O portal tem um único acesso, o do revendedor, com o e-mail e a senha do cadastro de parceiro. Quem entra vê e usa tudo nesta tela, inclusive definir a meta do mês. - Admin: Não se aplica: os papéis da equipe de uma conta de cliente não existem no portal. O cliente final não vê o portal nem os valores da revenda. - Atendente: Atendente de uma conta de cliente não acessa o portal do revendedor; o endereço leva à tela de entrada da revenda. ### Telas #### Visão geral A tela Visão geral serve para o revendedor acompanhar a receita do mês, a meta, a saúde da carteira, o ranking das contas e os próximos repasses, tudo atualizado ao vivo. Endereço no painel: `/revenda/visao-geral` ![Captura da tela Visão geral, com nomes e valores desfocados. A tela Visão geral serve para o revendedor acompanhar a receita do mês, a meta, a saúde da carteira, o ranking das contas e os próximos repasses, tudo atualizado ao vivo.](https://attendto.com.br/prints-do-manual/revenda-visao-geral--visao-geral.png) A tela Visão geral numa conta de demonstração, com os nomes e os valores desfocados. Como chegar: É a primeira tela depois de entrar no portal do revendedor e o primeiro item do menu lateral. Links antigos do Placar também trazem para cá. ##### Cabeçalho e período A saudação com o nome da sua marca, a frase do mês e os controles que escolhem o mês mostrado na tela inteira. Botões e ações: - **Este mês**: Volta a tela para o mês em curso, com os números até hoje. - **Mês passado**: Mostra o mês anterior já fechado. - **Mês**: Lista suspensa com os últimos doze meses; o mês em curso aparece marcado como atual. A escolha fica no endereço da página. Também aparece: - Selo Ao vivo com a hora do último evento recebido; enquanto a conexão volta, ele mostra Reconectando…. - Na carteira vazia, a saudação vira as boas-vindas à sua marca e a frase explica que o resumo aparece conforme os clientes entram. ##### Sua carteira começa aqui Bloco de boas-vindas que aparece só enquanto nenhuma conta pagou: os três passos até o primeiro repasse, com os já feitos marcados. Botões e ações: - **Adicionar cliente**: Abre a página de criar a conta de um cliente na Carteira. Também aparece: - Passo Marca no ar: feito quando a sua marca já está publicada; senão, lembra de publicar nome, logo e cores em Sua marca. - Passo Conta de recebimento: feito quando a conta de recebimento está confirmada; senão, pede para informá-la em Repasses. - Passo Primeiro cliente: cadastrar a conta e enviar o link de ativação. ##### Números do topo Quatro cartões com o essencial do mês escolhido. Campos e filtros: - **Receita do mês**: Dois valores lado a lado: Clientes pagaram (o total pago pelos seus clientes) e Sua parte (o que ficou com você), cada um com o selo de variação contra o mesmo dia do mês anterior. - **Contas pagando**: Quantas contas pagaram, de quantas há na carteira, com quantas estão em atraso e quantas aguardam o primeiro pagamento. - **Ticket médio por conta**: A sua parte média por conta e quanto o cliente paga em média. - **Previsão · sem atrasos**: Quanto a sua parte deve fechar no mês em curso, sem contar as contas em atraso (que aparecem nomeadas). No mês fechado o cartão vira Fechou o mês com. Também aparece: - Selo de variação: verde quando sobe, vermelho quando desce e nova quando não há base de comparação. - Se um cartão não carregar, ele mostra um travessão, a frase Não carregou. e o botão Tentar de novo. ##### De onde vem a sua receita? Gráfico de barras dos últimos doze meses, separando mensalidades e recargas, com a previsão do mês em curso tracejada. Botões e ações: - **Sua parte**: Mostra no gráfico só a parte que ficou com você em cada mês. - **Clientes pagaram**: Mostra no gráfico o total que os clientes pagaram em cada mês. - **Ver como tabela**: Troca o gráfico por uma tabela com Mês, Clientes pagaram, Sua parte, Sua parte em mensalidades e Sua parte em recargas. O mesmo botão volta com Ver como gráfico. Também aparece: - Clicar numa barra muda o mês da tela inteira para aquele mês. - A dica de cada barra mostra o valor da outra visão (sua parte ou o que os clientes pagaram). - Legenda: Mensalidades, Recargas e a previsão do mês sem atrasos. ##### Quanto falta para a meta? Medidor da sua parte do mês contra a meta que você definiu, com um traço marcando a previsão. Botões e ações: - **Definir a meta**: Aparece quando o mês em curso ainda não tem meta e abre o diálogo para informar quanto você quer receber. - **Ajustar a meta**: Abre o mesmo diálogo com a meta atual para mudar o valor. Também aparece: - Percentual atingido e quanto já entrou de quanto foi definido. - No mês em curso: o aviso de quanto fica abaixo da meta pela previsão ou o selo Pela previsão, passa da meta, com quanto falta e em quantos dias. - No mês fechado: Meta batida ou em quanto ficou. A meta só pode ser definida para o mês em curso. ##### Diálogo da meta Onde você informa a meta da sua parte no mês, somando mensalidades e recargas. Campos e filtros: - **Meta de ‹mês›** (obrigatório): O valor em reais que você quer receber no mês. Sem meta gravada, o campo já vem com a última meta usada, como sugestão. Botões e ações: - **Voltar**: Fecha sem salvar; ao reabrir, o campo mostra a meta que está valendo. - **Salvar a meta**: Grava a meta do mês e fecha o diálogo. Se o valor for recusado, a frase do motivo aparece no diálogo. ##### A carteira está saudável? Três cartões com o que pede atenção antes de virar cancelamento; cada um abre a Carteira. Botões e ações: - **Usando bem**: Abre a Carteira filtrada nas contas pagando. Mostra quantas usam bem, quantas estão começando e quantas esfriando. - **Esfriando**: Abre a Carteira. Mostra quantas contas pararam de usar, o valor por mês em risco e os nomes delas. - **Em atraso**: Abre a Carteira filtrada nas contas em atraso, com a primeira conta vencida, desde quando e a sua parte nela. ##### Quais contas mais rendem? Ranking das contas pela sua parte no mês, com barras de mensalidade e recargas e quanto cada cliente paga. Botões e ações: - **Ver como tabela**: Troca as barras pela tabela com Conta, Situação, Cliente paga, Sua parte no mês e a variação contra o mês anterior. - **Abrir a carteira**: Leva à Carteira com todas as contas. Também aparece: - Conta em atraso aparece com o selo Em atraso ao lado do nome. - Rodapé com quanto da sua receita as primeiras contas do ranking somam. ##### Como é a sua carteira? Rosca com as contas por tipo de IA e a sua receita por mês em cada grupo. Botões e ações: - **Ver como tabela**: Mostra a mesma composição em tabela: Grupo, Contas e Sua receita por mês. Também aparece: - Grupo Nossa IA: contas que usam a IA da plataforma, com a sua receita mensal nelas. ##### Quando o dinheiro cai? Barra do mês dividida em quatro partes e a linha do tempo dos próximos repasses. Botões e ações: - **Ver os repasses**: Abre a tela Repasses com o extrato completo. Também aparece: - Já na sua conta: o que já foi liquidado. - A caminho: o que o cliente pagou e está no prazo de liberação. - Aguardando pagamento: o que depende de o cliente pagar. - Não aconteceu: divisões desfeitas por estorno, cancelamento ou bloqueio. - Próximos repasses: data, conta, se é mensalidade ou recarga, o selo A caminho ou Vence e a sua parte. ##### Precisa de você As pendências que só o revendedor resolve, da mais urgente para a menos urgente. Botões e ações: - **Abrir conta**: Abre a Carteira já com a ficha daquela conta aberta (atraso, conta perto do limite do mês ou uso esfriando). - **Reenviar link**: Para conta que ainda não fez o primeiro pagamento: pede confirmação e gera um link de acesso novo para o responsável. ##### Reenviar o link de acesso? Confirmação do reenvio feito a partir de Precisa de você. O link anterior deixa de funcionar, inclusive o que já foi mandado pelo WhatsApp. Botões e ações: - **Voltar**: Fecha sem gerar link novo. - **Reenviar link**: Gera o link novo e manda por e-mail ao responsável pela conta, com a sua marca quando o e-mail próprio está configurado. - **Copiar mensagem**: Aparece quando o e-mail não saiu: copia a mensagem pronta com o link para colar no WhatsApp do cliente. - **Fechar**: Fecha o diálogo depois do resultado. ##### Atalhos do rodapé Dois atalhos para as telas que resolvem o que falta, quando há dado para mostrar. Também aparece: - Sua marca está no ar (ou Sua marca ainda não está completa): quantas contas veem a sua marca no painel, no e-mail e no endereço próprio. Abre Sua marca. - Demonstração pronta (ou Monte a sua demonstração): a conta de vitrine, fora da carteira e dos repasses. Abre Demonstração. ##### Estados da tela - Carregando: Cada bloco mostra um esqueleto com a forma final enquanto os números chegam; os números do topo mostram Carregando…. - Sem nada ainda: Sem nenhuma conta pagando, aparece o bloco Sua carteira começa aqui e cada cartão mostra o seu próprio vazio: Nenhuma receita ainda, Sem meta para este mês, Nada para acompanhar ainda, Nenhuma conta na carteira, Carteira vazia, Nenhum repasse ainda e Nada pendente hoje. - Se der erro: Um bloco que falha mostra que foi a tela, não os seus dados, que não carregou, com o botão Tentar de novo; o resto do painel segue ao vivo. - A conexão em tempo real caiu: O selo do cabeçalho muda para Reconectando… até voltar. - Mês fechado escolhido: A previsão vira Fechou o mês com e a meta não pode mais ser ajustada. ### Passo a passo #### Como ver quanto a revenda rendeu no mês passado 1. Abra **Visão geral** no menu do portal. 2. Clique em **Mês passado** no cabeçalho, ou escolha o mês na lista **Mês**. 3. Leia **Receita do mês**: o que os clientes pagaram e a sua parte, com a comparação ao mês anterior. 4. Em **De onde vem a sua receita?**, use **Sua parte** ou **Clientes pagaram** para ver a divisão entre mensalidades e recargas. #### Como definir a meta de receita do mês 1. Na **Visão geral**, deixe o período em **Este mês**. 2. No cartão **Quanto falta para a meta?**, clique em **Definir a meta** (ou **Ajustar a meta**, se já existir uma). 3. Digite quanto você quer receber de sua parte no mês, somando mensalidades e recargas. 4. Clique em **Salvar a meta**. O medidor passa a mostrar quanto já entrou e se a previsão alcança a meta. #### Como descobrir quais clientes estão esfriando ou em atraso 1. Vá ao bloco **A carteira está saudável?** da **Visão geral**. 2. Clique em **Esfriando** para ver as contas que pararam de usar, ou em **Em atraso** para as mensalidades vencidas. 3. Na Carteira, abra a ficha da conta e use o recado pronto para falar com o cliente. #### Como reenviar o link de acesso a um cliente que não entrou 1. Em **Precisa de você**, encontre a conta que aguarda o primeiro pagamento. 2. Clique em **Reenviar link** e confirme em **Reenviar link** no diálogo. 3. Se o e-mail não sair, clique em **Copiar mensagem** e mande pelo WhatsApp do cliente. #### Como ver os números em tabela em vez de gráfico 1. No canto do cartão **De onde vem a sua receita?**, **Quais contas mais rendem?** ou **Como é a sua carteira?**, clique no ícone **Ver como tabela**. 2. Para voltar, clique no mesmo ícone, agora **Ver como gráfico**. ### Perguntas frequentes #### Qual a diferença entre Clientes pagaram e Sua parte? Clientes pagaram é o total cobrado dos seus clientes no mês (mensalidades e recargas). Sua parte é o que fica com você dentro dessas cobranças; o restante é da plataforma. #### Por que a previsão do mês não conta todas as contas? A previsão é calculada sem atrasos: as contas com mensalidade vencida ficam de fora e aparecem nomeadas no cartão, porque a sua parte delas só cai se o cliente pagar. #### Preciso recarregar a página para ver um pagamento novo? Não. A Visão geral é atualizada pelo evento que muda cada número; o selo Ao vivo mostra a hora do último evento recebido. #### Posso definir a meta de um mês que já passou? Não. A meta vale para o mês em curso; no mês fechado o cartão só mostra se ela foi batida ou em quanto ficou. #### O que significa uma conta esfriando? É uma conta que paga, mas parou de usar o atendimento ou não usa uma função-chave. É o sinal de cancelamento a caminho, e por isso aparece aqui e na fila Precisa de você. #### A conta de demonstração entra nos números? Não. A demonstração fica fora da carteira e dos repasses; ela aparece só no atalho do rodapé. Como as pessoas procuram: painel do revendedor; quanto eu ganho revendendo; receita da revenda white label; meta de receita do revendedor; contas em atraso revenda; clientes esfriando; quando cai o repasse; ticket médio por conta; previsão de receita do mês; dashboard de revenda. ## Sua marca: como montar o white label com nome, logo, cores e endereço próprio URL: https://attendto.com.br/manual/revenda-sua-marca Menu: Portal do revendedor > Sua marca Sua marca é a tela do portal do revendedor onde ele monta a marca própria que os clientes dele veem (nome, logo, cores, tela de entrada e endereço de acesso), confere tudo no espelho e coloca no ar para a carteira inteira. ### Quem pode usar - Dono: O portal tem um único acesso, o do revendedor. Quem entra edita a marca, o endereço e quem pode criar conta, e decide quando colocar no ar. - Admin: Não se aplica: os papéis da equipe de uma conta de cliente não existem no portal. O cliente final só vê o resultado (a marca no painel dele), nunca esta tela. - Atendente: Atendente de uma conta de cliente não acessa o portal do revendedor. ### Telas #### Sua marca A tela Sua marca serve para montar o nome, a logo, as cores, as frases da tela de entrada e o endereço próprio que os seus clientes veem, conferir tudo no espelho e colocar a marca no ar. Endereço no painel: `/revenda/marca` ![Captura da tela Sua marca, com nomes e valores desfocados. A tela Sua marca serve para montar o nome, a logo, as cores, as frases da tela de entrada e o endereço próprio que os seus clientes veem, conferir tudo no espelho e colocar a marca no ar.](https://attendto.com.br/prints-do-manual/revenda-sua-marca--sua-marca.png) A tela Sua marca numa conta de demonstração, com os nomes e os valores desfocados. ##### Cabeçalho O título da tela, se a marca já está no ar e o que ainda falta para vender. Botões e ações: - **Abrir Preços e margens**: Aparece no aviso do topo quando Preços e margens está liberada e abre a aba Mensalidade daquela tela. Também aparece: - Selo No ar ou Ainda não está no ar. - Hora do último salvamento automático (ou Nada salvo ainda) e quantas contas usam a sua marca. - Aviso Falta algo para vender, com a explicação ao passar o mouse, enquanto nome, logo e cores não estiverem completos e no ar. - Com a função Preços e margens liberada, um aviso no topo diz que o preço para novos clientes agora fica em Preços e margens. ##### Nome e logotipo O que o seu cliente lê antes de digitar a senha. Tudo que você muda é salvo sozinho em instantes. Campos e filtros: - **Nome que aparece para o cliente**: O nome comercial que aparece na tela de entrada e no topo do painel do cliente. Use o nome comercial, não a razão social. - **Fundo da logo**: Nenhum, Claro ou Escuro. Cada opção mostra a própria logo dentro dela; o fundo acompanha a logo no painel, na tela de entrada e nos e-mails. Botões e ações: - **Enviar logo**: Escolhe a imagem da logo (PNG ou JPG, até 1 MB). Fundo transparente e formato horizontal encaixam melhor. - **Trocar**: Envia outra imagem no lugar da logo atual. - **Remover**: Pede confirmação para tirar a logo. - **Onde isso aparece**: Ao passar o mouse, explica que o fundo vale no painel, na tela de entrada e nos e-mails. Também aparece: - Imagem acima de 1 MB é recusada com o pedido para reduzir e tentar de novo. - Logo muito clara gera o aviso de que ela some no fundo claro do painel, com a sugestão de enviar uma versão escura ou escolher um fundo. ##### Remover a sua logo? Confirmação antes de tirar a logo: as contas voltam a mostrar só o nome na barra lateral. Botões e ações: - **Manter logo**: Fecha sem mudar nada. - **Remover logo**: Tira a logo do rascunho da marca. ##### A tela de entrada A manchete, a linha abaixo dela e o selo do painel que o cliente vê antes de entrar. Campos e filtros: - **Manchete**: Uma frase curta, do jeito que você vende; é o texto maior do painel. O contador mostra quantos caracteres faltam e muda de cor perto do limite. - **Subtítulo**: Duas linhas explicando o que o cliente ganha. No celular ela não aparece, então a manchete precisa se sustentar sozinha. Botões e ações: - **Mostrar**: Mantém a linha do selo acima da manchete, que apresenta o cartão animado. - **Ocultar**: Tira o selo: a manchete abre o painel sozinha. Também aparece: - Deixar as duas frases em branco é uma escolha válida: a tela mostra uma frase neutra que descreve o produto sem falar por você, e o campo já exibe essa frase como exemplo. ##### Cores Os botões, os destaques e a tela de entrada usam um degradê que começa na sua cor. Campos e filtros: - **Cor principal**: A cor da sua marca, escolhida entre as amostras ou em Cor personalizada. - **Fim do degradê**: Onde o degradê termina. Mexa só se a combinação não agradar; a maioria mantém como está. Botões e ações: - **Cor personalizada**: Abre o seletor para escolher qualquer cor, inclusive pelo código hexadecimal. Também aparece: - Botão de exemplo com o degradê aplicado: é assim que ficam os botões da sua marca. ##### Endereço de acesso O endereço próprio por onde a sua carteira inteira entra; sem ele, os clientes entram por um endereço com o nome da plataforma. Campos e filtros: - **Endereço que seus clientes vão digitar** (obrigatório): Um endereço de um domínio da sua empresa, por exemplo app.suaempresa.com.br. A prévia mostra como fica o endereço de entrada. - **Quem cuida do seu site?**: Outra pessoa cuida: o painel monta uma mensagem pronta para mandar a quem cuida do site. Eu mesmo mexo no DNS: mostra os dois registros para você criar. Botões e ações: - **Continuar**: Aceita o endereço digitado e mostra o que precisa ser criado no DNS. - **Copiar mensagem pronta**: Copia a mensagem com os dois registros (TXT e CNAME) para mandar a quem cuida do site. - **Copiar o valor do registro ‹tipo›**: No caminho técnico, copia o valor do registro TXT ou CNAME. - **Já criaram — conferir**: Registra o endereço e confere se os registros já estão no DNS. - **Trocar endereço**: Volta para digitar outro endereço antes de registrar. - **Verificar agora**: Confere de novo o DNS de um endereço já registrado. - **Remover endereço**: Pede confirmação para tirar o endereço próprio. Também aparece: - Selo de situação: Ainda sem endereço, Procurando seu DNS ou Ativo. - O TXT prova que o endereço é seu; o CNAME traz o acesso para o painel. Na Cloudflare, o CNAME precisa ficar como Somente DNS (nuvem cinza). - Enquanto procura, o painel confere sozinho por até 24 horas e a tela muda quando o endereço estiver no ar. - Ativo: os clientes entram no endereço próprio desde a primeira tela, com o cadeado do navegador já emitido. ##### Remover o endereço? Confirmação: os clientes voltam a entrar pelo endereço da plataforma; cores e logo continuam, e quem estiver com o painel aberto nesse endereço precisa entrar de novo. Botões e ações: - **Manter endereço**: Fecha sem mudar nada. - **Remover endereço**: Tira o endereço próprio da carteira. ##### Quem pode criar conta Decide se, no seu endereço, o cliente pode criar a conta sozinho ou só entra depois de você cadastrar. Campos e filtros: - **O cliente paga por mês**: Na régua (sem Preços e margens liberada): a mensalidade de quem se cadastra sozinho. - **Você recebe por mês**: Na régua: a sua parte dentro da mesma cobrança, limitada pelo que a plataforma precisa reter. Botões e ações: - **Só quem eu cadastrar**: Fecha o cadastro: o rodapé da tela de entrada fica sem convite para criar conta. - **Qualquer um pode criar conta**: Abre o cadastro: quem chega no seu endereço cria a conta sozinho, no preço para novos clientes. - **Copiar endereço**: Com o cadastro aberto, copia o endereço de cadastro para divulgar. - **Abrir de verdade**: Abre o endereço de cadastro numa aba nova. - **Ajustar em Preços e margens**: Com Preços e margens liberada, leva à aba Mensalidade para mudar o preço de quem chega sozinho. - **Salvar este preço**: Sem Preços e margens liberada, o preço de quem se cadastra sozinho é ajustado aqui, na régua de preço, e gravado por este botão. Também aparece: - Se faltar algo para abrir (endereço ativo, marca no ar ou acordo de preço), aparece Falta um passo antes de abrir, com o motivo, um de cada vez. - Com o cadastro no ar, o cartão mostra a mensalidade e a sua parte de quem se cadastra sozinho e o endereço de cadastro. - Aviso fixo: a conta que você vende é mensalidade mais recarga; recargas extras são feitas pelo cliente e a sua parte cai na sua conta de recebimento. ##### O que seus clientes veem com a sua marca O placar item por item, montado a partir do estado real da sua conta: o que o cliente já vê com a sua marca e o que ainda vê com a da plataforma. Também aparece: - Cada item tem o selo Já é seu ou Ainda é nosso, um título e a consequência. - Se o cliente perguntar: a frase pronta para responder ao cliente sobre a marca. ##### Como seu cliente vê (espelho) A prévia, com os componentes reais, da tela de entrada e do painel do cliente com a sua marca, antes de colocar no ar. Botões e ações: - **Tela de entrada**: Mostra a tela de login do cliente com a sua marca. - **Painel**: Mostra o painel do cliente com a sua marca, numa cena de exemplo. - **Claro**: Prévia no tema claro. - **Escuro**: Prévia no tema escuro. - **Computador**: Na tela de entrada, mostra a versão de computador. - **Celular**: Na tela de entrada, mostra a versão de celular. - **Só por convite**: Prévia da tela de entrada sem o convite para criar conta. - **Cadastro aberto**: Prévia da tela de entrada com o convite Criar conta. - **Abrir de verdade**: Abre a tela de entrada no seu endereço próprio. Sem endereço ativo fica desabilitado, com a explicação ao passar o mouse. Também aparece: - A barra de endereço da prévia mostra o seu endereço próprio, ou o da plataforma enquanto ele não existe. - Quando a prévia de quem pode criar conta difere do que está valendo, um aviso explica que é só uma prévia. ##### Barra de colocar no ar Barra fixa no pé da tela que aparece quando o que está salvo difere do que está no ar, ou quando a marca nunca foi publicada. Botões e ações: - **Descartar**: Pede confirmação para voltar à marca que está no ar. - **Colocar no ar**: Publica a marca. Na primeira vez publica direto; com contas usando a marca, pede confirmação antes. - **Tentar de novo**: Aparece no lugar de Colocar no ar se a publicação falhar; o que você mexeu continua salvo. Também aparece: - Frase da barra: Você mudou coisas que seus clientes ainda não veem. ##### Colocar no ar para ‹n› contas? Confirmação de publicação com contas ativas: elas mudam de cor e de logo; quem está com o painel aberto vê ao recarregar, e a tela de entrada muda em instantes. Botões e ações: - **Cancelar**: Fecha sem publicar. - **Colocar no ar**: Publica a marca para toda a carteira. ##### Descartar as alterações? Confirmação para voltar à marca que está no ar; o que foi mexido desde então se perde. Botões e ações: - **Continuar editando**: Fecha e mantém o rascunho. - **Descartar alterações**: Apaga o rascunho e volta à marca publicada. ##### Estados da tela - Carregando: Os cartões aparecem com os títulos legíveis e o conteúdo em esqueleto, e o quadro do espelho já desenhado. - Se der erro: Não conseguimos carregar a sua marca: a tela explica que nada do que foi montado se perdeu e que a marca no ar continua igual para os clientes, com o botão Tentar de novo. Os cartões de endereço e de quem pode criar conta têm erro próprio, com a mesma garantia. - Marca nunca publicada: A barra de colocar no ar aparece mesmo sem alterações pendentes. - Endereço registrado e ainda não encontrado: Selo Procurando seu DNS e a explicação de que o DNS pode levar até 24 horas. - Falha ao publicar: A barra fica com borda de erro, a frase do problema e o botão Tentar de novo. ### Passo a passo #### Como colocar a sua marca própria no ar 1. Abra **Sua marca** no menu do portal. 2. Em **Nome e logotipo**, preencha **Nome que aparece para o cliente** e clique em **Enviar logo**. 3. Em **Cores**, escolha a **Cor principal**; ajuste **Fim do degradê** só se precisar. 4. Confira no espelho, em **Tela de entrada** e **Painel**, nos temas **Claro** e **Escuro**. 5. Na barra do pé da tela, clique em **Colocar no ar** (e confirme, se já houver contas usando a marca). #### Como configurar o endereço próprio (domínio) da revenda 1. No cartão **Endereço de acesso**, digite o endereço em **Endereço que seus clientes vão digitar** e clique em **Continuar**. 2. Em **Quem cuida do seu site?**, escolha **Outra pessoa cuida** e clique em **Copiar mensagem pronta**, ou **Eu mesmo mexo no DNS** para ver os registros TXT e CNAME. 3. Depois que os registros forem criados, clique em **Já criaram — conferir**. 4. Se o selo ficar em **Procurando seu DNS**, aguarde (o painel confere sozinho) ou clique em **Verificar agora** mais tarde. #### Como deixar o cliente criar a conta sozinho no seu endereço 1. Garanta que o endereço próprio está **Ativo** e que a marca está no ar. 2. No cartão **Quem pode criar conta**, escolha **Qualquer um pode criar conta**. 3. Se aparecer **Falta um passo antes de abrir**, resolva o motivo indicado e tente de novo. 4. Com o cadastro no ar, use **Copiar endereço** para divulgar o endereço de cadastro. #### Como trocar as frases da tela de login dos clientes 1. No cartão **A tela de entrada**, escreva a **Manchete** e, se quiser, o **Subtítulo**. 2. Escolha **Mostrar** ou **Ocultar** para o selo acima da manchete. 3. Confira no espelho e clique em **Colocar no ar**. #### Como desfazer mudanças na marca antes de publicar 1. Na barra do pé da tela, clique em **Descartar**. 2. Confirme em **Descartar alterações**: a marca volta a ser a que está no ar. ### Perguntas frequentes #### As mudanças na marca aparecem na hora para os clientes? Não. Tudo que você mexe é salvo como rascunho e só chega aos clientes quando você clica em Colocar no ar. Até lá, eles continuam vendo a marca publicada. #### Preciso configurar uma marca para cada cliente? Não. Você monta uma vez e toda a carteira herda a mesma marca; um único endereço próprio também serve todos os clientes, e cada um cai no próprio painel. #### O endereço próprio é obrigatório? Sem ele, os clientes entram por um endereço com o nome da plataforma na barra do navegador. Ele também é exigido para abrir o cadastro sozinho no seu endereço. #### Usei Cloudflare e o endereço não é verificado. O que fazer? Deixe o registro CNAME como Somente DNS (nuvem cinza), sem proxy. Com o proxy ligado a verificação não passa. #### Posso deixar a manchete da tela de entrada em branco? Pode. A tela mostra uma frase neutra que descreve o produto, sem citar a plataforma, e o placar não cobra esses campos. #### Remover o endereço próprio apaga a minha marca? Não. Cores e logo continuam; só a entrada volta a ser pelo endereço da plataforma, e quem estava com o painel aberto no seu endereço precisa entrar de novo. #### Onde mudo o preço de quem se cadastra sozinho? Com a função Preços e margens liberada, na aba Mensalidade daquela tela (o atalho Ajustar em Preços e margens leva até lá). Sem ela, na régua do próprio cartão Quem pode criar conta. Como as pessoas procuram: white label marca própria; colocar minha logo no painel; domínio próprio revenda; configurar cname e txt; cores da marca do revendedor; tela de login com minha marca; cadastro aberto no meu endereço; prévia da marca branca; revender com a minha marca; trocar logo dos clientes. ## Carteira da revenda: criar conta de cliente, definir preço e reenviar o link de acesso URL: https://attendto.com.br/manual/revenda-carteira Menu: Portal do revendedor > Carteira A Carteira é a tela do portal do revendedor que lista as contas dos clientes dele com quanto cada uma rende, quem precisa de atenção hoje e onde ele cria contas novas, define o preço, reenvia o link de acesso e encerra a revenda. ### Quem pode usar - Dono: O portal tem um único acesso, o do revendedor. Quem entra vê todas as contas da carteira, cria contas, altera preços e encerra revendas. Ninguém no portal vê as conversas nem os leads dos clientes. - Admin: Não se aplica: os papéis da equipe de uma conta de cliente não existem no portal. O dono da conta do cliente não vê a carteira nem a parte do revendedor. - Atendente: Atendente de uma conta de cliente não acessa o portal do revendedor. ### Telas #### Carteira A tela Carteira serve para acompanhar a receita de cada conta revendida, agir nas pendências do dia e abrir a ficha de cada cliente para mudar preço, dados e funções. Endereço no painel: `/revenda/contas` ![Captura da tela Carteira, com nomes e valores desfocados. A tela Carteira serve para acompanhar a receita de cada conta revendida, agir nas pendências do dia e abrir a ficha de cada cliente para mudar preço, dados e funções.](https://attendto.com.br/prints-do-manual/revenda-carteira--carteira.png) A tela Carteira numa conta de demonstração, com os nomes e os valores desfocados. Como chegar: Pelo item Carteira do menu, pelos cartões e botões da Visão geral (que já abrem a lista filtrada ou a ficha de uma conta) e pelo botão dos avisos de saldo que o revendedor recebe por e-mail, que abre direto a ficha daquela conta. ##### Números da carteira Quatro cartões com a renda da carteira hoje. Campos e filtros: - **Sua receita por mês**: A sua parte somando só as contas pagando hoje, com quantas são. - **Se todas pagarem**: Quanto seria com a carteira viva inteira pagando; quando diverge, diz quanto ainda não entra e por quê (atraso ou primeiro pagamento). - **Contas**: Total de contas ativas, separando pagando, aguardando, em atraso e encerradas. - **Esfriando**: Contas pagando sem conversa há 7 dias ou mais, ou sem uma função-chave em uso. É receita em risco no mês que vem. ##### Precisa de você A fila do dia, ordenada pelo dano: mensalidade não paga, conta perto do limite do mês, sem primeiro pagamento, sem conversas, sem WhatsApp, sem base de conhecimento, sem agenda ou sem campanha. Botões e ações: - **Copiar recado**: Copia um recado pronto, na sua voz, para colar na conversa com o cliente. Nada é enviado pelo portal. - **Ver conta**: Abre a ficha da conta. Também aparece: - Alertas de uso trazem a etiqueta ADOÇÃO. - Sem pendências, a fila não some: vira a linha Nada pendente na sua carteira hoje. ##### Contas A lista das contas da carteira, com busca, filtros por situação e paginação. Campos e filtros: - **Buscar cliente…**: Procura a conta pelo nome; a lista atualiza depois de uma pequena pausa na digitação. - **Cliente**: Nome da conta e desde quando ela está na carteira. - **Situação**: Pagando, Em atraso, Aguardando 1º pagamento ou Encerrada; ao passar o mouse, o que isso significa para a sua parte. - **Adoção**: Um selo (Em uso, Esfriando com os dias sem conversa, Sem WhatsApp, Sem base, Sem Agenda ou Sem campanha) e seis pontos: WhatsApp conectado, Base de conhecimento, Persona ajustada, Agenda conectada, Campanha disparada e Equipe convidada. - **IA**: Só com Preços e margens liberada: o tipo de IA e a margem da conta; o selo leva à conta em Preços e margens. - **Cliente paga**: A mensalidade que o cliente paga. - **Você recebe**: A sua parte por mês; travessão enquanto a conta não fez o primeiro pagamento, e sem destaque quando a revenda foi encerrada. - **Uso do mês**: Quanto do atendimento incluído no mês já foi usado; a barra fica laranja perto do fim e vermelha no limite. - **Próxima**: A data da próxima cobrança, vencida quando está em atraso, ou a data do encerramento. Botões e ações: - **Todas**: Mostra todas as contas. - **Pagando**: Filtra as contas com a mensalidade em dia. - **Em atraso**: Filtra as contas com cobrança vencida. - **Aguardando 1º pagamento**: Filtra as contas criadas que ainda não pagaram a primeira mensalidade. - **Encerradas**: Mostra o histórico das revendas encerradas. - **Adicionar cliente**: Abre a página de criar conta. Enquanto a marca não estiver pronta, o botão fica discreto e explica que os clientes veriam uma tela sem o seu nome. - **Anterior**: Volta uma página da lista. - **Próxima**: Avança uma página da lista. Também aparece: - Clicar numa linha (ou Enter com ela em foco) abre a ficha da conta. - No celular, a tabela vira um cartão por conta com Você recebe em destaque. ##### Margem sobre o uso Aparece aqui só enquanto Preços e margens não está liberada: a margem que você põe sobre a tabela de uso da plataforma, que vira a sua parte em cada recarga. Campos e filtros: - **Sua margem (%)**: O percentual acima da tabela da plataforma; zero repassa ao custo. Botões e ações: - **Gravar margem**: Grava a margem para o consumo e as recargas seguintes de todas as contas. Também aparece: - Tabela de prévia com Item, Piso da plataforma, Seu cliente paga e Fica com você, que acompanha o que você digita. - O saldo que os clientes já pagaram não muda; o preço é arredondado para cima, centavo a centavo. - O modelo de mensagem entregue só é debitado quando o número do cliente está na conta de WhatsApp da plataforma. ##### Ficha da conta Gaveta lateral com tudo da conta, aberta ao clicar numa linha. Botões e ações: - **Reenviar link de acesso**: No bloco Acesso do cliente, enquanto o cliente não criou a senha: pede confirmação e gera um link novo; o anterior deixa de funcionar. - **Alterar preço**: Abre a régua para mudar quanto o cliente paga e quanto você recebe. - **Ajustar em Preços e margens**: Com Preços e margens liberada, leva à margem desta conta naquela tela. - **Preencher dados**: Abre o formulário de CNPJ, razão social e endereço (vira Editar dados quando já há CNPJ). - **Editar dados**: Abre o mesmo formulário com os dados gravados. - **Modo atendimento**: Interruptor para venda direta (farmácia, loja, delivery): não cobra lead quente nem morno e a IA conduz o pedido sem a etapa de qualificação. O cliente vê na trilha de auditoria que foi você quem mudou. - **Transcrever áudios no atendimento humano**: Interruptor: quando a equipe do cliente atende, o áudio do lead vira texto, com custo por minuto cobrado do saldo do cliente. Desligado, o atendente ouve o áudio, sem custo. - **Copiar recado**: No bloco Adoção, copia o recado pronto do alerta mais grave da conta. - **Encerrar revenda**: Pede confirmação para encerrar a revenda desta conta. Também aparece: - Cabeçalho: nome, selo de situação e desde quando a conta é revendida por você (ou quando a revenda foi encerrada). - O acordo: Cliente paga e Você recebe por mês, com o percentual do que o cliente paga. - Margem sobre o uso (com Preços e margens liberada): Margem desta conta, Itens acima da conta e quanto fica com você em cada recarga, com a última mudança. - Dados do cliente: CNPJ, Razão social e Endereço, ou Não informado. - Este mês: Uso do mês em percentual e Próxima cobrança. - Adoção: Última conversa atendida e os seis sinais de uso, cada um com o que está em uso ou o que falta; quando a conta esfria, o Recado pronto. - Aviso fixo: você não vê as conversas nem os leads deste cliente, e a plataforma também não. ##### Reenviar o link de acesso? Confirmação do reenvio: o link novo vai por e-mail ao responsável (com a sua marca, se configurada) e o anterior deixa de funcionar, inclusive o que já foi mandado pelo WhatsApp. Botões e ações: - **Voltar**: Fecha sem gerar link novo. - **Reenviar link**: Gera o link novo e envia por e-mail. - **Copiar mensagem**: Aparece quando o e-mail não saiu: copia a mensagem com o link para mandar pelo WhatsApp. Também aparece: - Antes do reenvio, o bloco diz em que pé está o link: válido até uma data, vencido ou cancelado, e se saiu por e-mail. ##### Alterar o preço da ‹conta› Diálogo com a régua de preço e o aviso de que o novo valor vale a partir da próxima cobrança; a cobrança já gerada sai no valor de hoje, e avisar o cliente é com você. Campos e filtros: - **O cliente paga por mês**: A nova mensalidade do cliente. - **Você recebe por mês**: A sua parte dentro da mesma cobrança, no mesmo dia. Botões e ações: - **Máximo**: Põe a sua parte no máximo que o preço comporta. - **Voltar**: Fecha sem mudar o acordo. - **Salvar novo preço**: Grava o novo acordo; só fica ativo quando algo mudou e o acordo é válido. ##### Dados da ‹conta› Formulário de CNPJ, razão social e endereço, os mesmos campos que o cliente vê em Configurações; vale o que for gravado por último. Campos e filtros: - **CNPJ**: Com o CNPJ completo, razão social e endereço são preenchidos sozinhos nos campos ainda vazios. - **Razão social**: O nome jurídico da empresa do cliente. - **CEP**: O CEP do endereço. - **Rua e número**: Logradouro e número. - **Cidade**: Cidade do endereço. - **UF**: Sigla do estado, com duas letras. Botões e ações: - **Voltar**: Fecha sem gravar. - **Salvar dados**: Grava os dados na conta do cliente. ##### Encerrar a revenda da ‹conta›? Confirmação obrigatória. Nada é apagado: a conta continua no ar com o mesmo login, dados, IA e aparência; a partir da próxima cobrança a sua parte deixa de cair. Se o cliente ainda não criou a senha, o link enviado deixa de funcionar. Botões e ações: - **Voltar**: Fecha sem encerrar. - **Encerrar revenda**: Encerra o vínculo; a conta passa para o filtro Encerradas. ##### Estados da tela - Carregando: Os rótulos dos quatro números ficam legíveis e só os valores viram esqueleto, para não mostrar um zero assustador; a ficha também carrega com esqueleto. - Sem nada ainda: Sua carteira ainda está vazia, com o botão Adicionar cliente. Cada filtro tem o seu vazio (Nenhuma conta pagando ainda, Nenhuma conta em atraso, Nenhuma conta esperando o primeiro pagamento, Nenhuma revenda encerrada) e a busca sem resultado mostra Nenhuma conta com esse nome. - Se der erro: Não conseguimos abrir a sua carteira: a tela garante que nada mudou nas contas nem no dinheiro e oferece Tentar de novo. A ficha e a margem sobre o uso têm erro próprio, com o mesmo botão. - Conta sem o retrato de uso: Adoção e Uso do mês aparecem com travessão. - Revenda encerrada: A ficha mostra O acordo que valia, sem os botões de alterar, e explica que a conta segue no ar com o cliente. #### Adicionar cliente A tela Adicionar cliente serve para criar a conta de um cliente na carteira, definir a mensalidade e a sua parte e gerar o link de acesso que o responsável usa para criar a senha. Endereço no painel: `/revenda/contas/nova` ![Captura da tela Adicionar cliente, com nomes e valores desfocados. A tela Adicionar cliente serve para criar a conta de um cliente na carteira, definir a mensalidade e a sua parte e gerar o link de acesso que o responsável usa para criar a senha.](https://attendto.com.br/prints-do-manual/revenda-carteira--adicionar-cliente.png) A tela Adicionar cliente numa conta de demonstração, com os nomes e os valores desfocados. Como chegar: Pelo botão Adicionar cliente da Carteira, da Visão geral ou da aba Por conta de Preços e margens. ##### Adicionar cliente Os dados do responsável. A conta é dele: o link de acesso vai para o e-mail do responsável e ele define a própria senha. Campos e filtros: - **Nome da empresa do cliente** (obrigatório): O nome que aparece nos dados da conta; o cliente pode corrigir depois em Configurações. - **Nome do responsável** (obrigatório): Como ele vai ser chamado no painel e na mensagem com o link. - **E-mail do responsável** (obrigatório): É por ele que o cliente entra. Um e-mail só pode estar em uma conta. - **Enviar o link de acesso por e-mail agora**: Marcado por padrão: o link sai com a sua marca assim que a conta é criada. Desmarque se o acordo com o cliente ainda não foi fechado por escrito e mande o link quando for a hora. Botões e ações: - **Voltar para a carteira**: Volta à lista sem criar nada. Também aparece: - Aviso Crie a conta com o acordo fechado: o link libera o acesso do cliente, e o acordo por escrito entre vocês vem antes. ##### Dados do cliente Opcional. Entram na nota fiscal e nos documentos da conta; o cliente pode corrigir depois. Campos e filtros: - **CNPJ**: Com o CNPJ completo, razão social e endereço vêm preenchidos. - **Razão social**: O nome jurídico da empresa. - **CEP**: O CEP do endereço. - **Rua e número**: Logradouro e número. - **Cidade**: Cidade do endereço. - **UF**: Sigla do estado. ##### O preço desta conta A régua: você define quanto o cliente paga e quanto recebe. A sua parte sai do mesmo boleto, no mesmo dia; não é reembolso nem fatura à parte. Campos e filtros: - **O cliente paga por mês**: A mensalidade da conta. Ele nunca vê a parte da plataforma. - **Você recebe por mês**: A sua parte. Ao encostar no máximo, a régua oferece subir o preço para ganhar mais. - **Quanto você recebe por mês**: Controle deslizante que ajusta a sua parte até o máximo permitido pelo preço. Botões e ações: - **Máximo**: Põe a sua parte no máximo que o preço comporta. - **Subir para ‹preço› e ganhar ‹valor›**: Aparece no teto da régua: sobe o preço para o próximo degrau e aumenta a sua parte. - **Usar ‹preço›**: Aparece quando o preço digitado está abaixo do mínimo: aplica o menor preço que comporta a sua parte. Também aparece: - Atalhos com valores prontos para a sua parte. - Barra dividida em Você e Plataforma; o custo de cobrança já está dentro da parte da plataforma. - Quanto a conta rende por ano para você e o percentual do que o cliente paga. - Aviso fixo: a conta que você vende é mensalidade mais recarga. ##### Barra do pé da página O resumo do acordo (Cliente paga e Você recebe) fica fixo enquanto você mexe nos campos. Botões e ações: - **Criar conta**: Cria a conta. Só fica ativo com empresa, responsável e um e-mail válido preenchidos e um acordo de preço válido. ##### Conta criada — falta o cliente entrar O resultado: para quem o link foi (ou deve ser mandado), até quando vale e que ele só funciona uma vez, com a mensagem pronta para o WhatsApp. Botões e ações: - **Copiar mensagem**: Copia a mensagem com o link para colar no WhatsApp do cliente. - **Enviar por e-mail também**: Envia o mesmo link por e-mail, com a sua marca, quando ele ainda não foi; depois do envio vira E-mail enviado. - **Ver na sua carteira**: Volta para a Carteira. Também aparece: - Se o e-mail não sair, um aviso pede para copiar a mensagem e mandar pelo WhatsApp, ou tentar o envio de novo. - Se o link se perder ou vencer, use Reenviar link de acesso na ficha da conta. A conta entra na sua receita quando a primeira mensalidade for paga. ##### Estados da tela - Carregando: A régua de preço aparece em esqueleto até os parâmetros chegarem. - Se der erro: Se a régua não carregar, a tela pede para recarregar a página e garante que nenhuma conta foi criada. Recusas na criação (por exemplo, e-mail já usado) aparecem acima da barra do pé com a frase do motivo. ### Passo a passo #### Como criar a conta de um cliente na revenda 1. Em **Carteira**, clique em **Adicionar cliente**. 2. Preencha **Nome da empresa do cliente**, **Nome do responsável** e **E-mail do responsável**. 3. Se quiser, preencha o **CNPJ** em **Dados do cliente**: razão social e endereço vêm sozinhos. 4. Em **O preço desta conta**, ajuste **O cliente paga por mês** e **Você recebe por mês**. 5. Clique em **Criar conta** e, na confirmação, use **Copiar mensagem** para mandar o link pelo WhatsApp. #### Como criar a conta sem mandar o link ainda 1. Na página **Adicionar cliente**, desmarque **Enviar o link de acesso por e-mail agora**. 2. Clique em **Criar conta**: o link fica só na tela. 3. Quando o acordo estiver fechado, use **Copiar mensagem** ou **Enviar por e-mail também**. #### Como reenviar o link de acesso para o cliente criar a senha 1. Na **Carteira**, clique na conta para abrir a ficha. 2. No bloco **Acesso do cliente**, clique em **Reenviar link de acesso**. 3. Confirme em **Reenviar link**. Se o e-mail não sair, use **Copiar mensagem**. #### Como mudar o preço que um cliente paga 1. Abra a ficha da conta na **Carteira** e clique em **Alterar preço**. 2. Ajuste os valores na régua; leia o aviso sobre a cobrança já gerada. 3. Clique em **Salvar novo preço**. O novo valor vale a partir da próxima cobrança. #### Como ligar o modo atendimento para um cliente de venda direta 1. Abra a ficha da conta na **Carteira**. 2. No bloco **Modo atendimento**, ligue o interruptor. 3. O cliente vê na trilha de auditoria da conta dele que a mudança foi feita por você. #### Como encerrar a revenda de uma conta 1. Abra a ficha da conta e clique em **Encerrar revenda**. 2. Leia o que muda e confirme em **Encerrar revenda**. 3. A conta continua no ar com o cliente e passa a aparecer no filtro **Encerradas**. ### Perguntas frequentes #### Consigo ver as conversas e os leads dos meus clientes? Não. A conta é do cliente: você vê receita, situação de pagamento, uso do mês e sinais de adoção, mas nunca as conversas nem os leads. A plataforma também não. #### Quando a conta passa a contar na minha receita? Quando a primeira mensalidade é paga. Até lá ela aparece como Aguardando 1º pagamento e a coluna Você recebe mostra um travessão. #### Por quanto tempo vale o link de acesso? A data de validade aparece na confirmação da criação e na ficha da conta. O link só funciona uma vez; se vencer ou se perder, gere outro com Reenviar link de acesso. #### Encerrar a revenda apaga a conta do cliente? Não. A conta segue no ar com o mesmo login, dados, IA e aparência. O que muda é que a sua parte deixa de cair a partir da próxima cobrança. #### Mudei o preço. O cliente paga o novo valor já neste mês? Não. Vale a partir da próxima cobrança; a cobrança já gerada sai no valor de hoje. Avisar o cliente antes é com você. #### O que é o recado pronto? Uma mensagem na sua voz, sugerida quando uma conta esfria ou tem pendência, para você colar na conversa com o cliente. O portal não envia nada por conta própria. #### O mesmo e-mail pode ser usado em duas contas? Não. Cada e-mail de responsável só pode estar em uma conta. Como as pessoas procuram: criar conta de cliente revenda; adicionar cliente white label; reenviar link de acesso; cliente não recebeu o link; definir preço do cliente revenda; encerrar revenda de uma conta; carteira de clientes do revendedor; cliente esfriando adoção; modo atendimento venda direta; dados do cliente cnpj revenda; quanto recebo por cliente. ## Preços e margens da revenda: margem sobre o uso, margem por conta e mensalidade URL: https://attendto.com.br/manual/revenda-precos-e-margens Menu: Portal do revendedor > Preços e margens Preços e margens é a tela do portal do revendedor que reúne tudo o que define o preço do cliente e a parte do revendedor: a margem padrão sobre o uso, a margem de cada conta e a mensalidade de quem chega sozinho, sempre com prévia e confirmação antes de mudar. Quando aparece: Aparece no menu quando a função Preços e margens está liberada para a sua revenda. Sem ela, o endereço leva à Carteira, onde ficam a margem sobre o uso e o preço de cada conta. ### Quem pode usar - Dono: O portal tem um único acesso, o do revendedor. Quem entra simula, grava a margem padrão, ajusta a margem de cada conta e define a mensalidade de novos clientes. - Admin: Não se aplica: os papéis da equipe de uma conta de cliente não existem no portal. O cliente final só vê o preço final de cada item no painel dele, com a sua marca, nunca a margem. - Atendente: Atendente de uma conta de cliente não acessa o portal do revendedor. ### Telas #### Preços e margens A tela Preços e margens serve para decidir a margem sobre o uso da carteira e de cada conta e a mensalidade de novos clientes, vendo antes, item a item, o que o cliente vai pagar e o que fica com você. Endereço no painel: `/revenda/precos` ![Captura da tela Preços e margens, com nomes e valores desfocados. A tela Preços e margens serve para decidir a margem sobre o uso da carteira e de cada conta e a mensalidade de novos clientes, vendo antes, item a item, o que o cliente vai pagar e o que fica com você.](https://attendto.com.br/prints-do-manual/revenda-precos-e-margens--precos-e-margens.png) A tela Preços e margens numa conta de demonstração, com os nomes e os valores desfocados. Como chegar: Pelo menu, pelo selo de IA da Carteira e da ficha da conta (que abre a conta direto na aba Por conta), pelo atalho de margem em Módulos e pelo aviso de Sua marca (que abre a aba Mensalidade). A aba e a conta aberta ficam no endereço da página. ##### Topo da tela A frase de abertura (nenhum preço muda sem você revisar e confirmar) e os avisos gerais. Botões e ações: - **Simular uma margem**: Aparece no aviso de margem padrão zerada, na aba Margem sobre o uso: leva ao simulador e põe o foco nele. - **Ver a margem padrão**: O mesmo aviso, na aba Por conta: volta para a aba Margem sobre o uso. Também aparece: - Aviso de margem padrão zerada: com contas usando a IA da plataforma, o consumo é cobrado pelo preço da plataforma e nada das recargas fica com você. ##### O que você ganha Três cartões com a origem do seu dinheiro. Campos e filtros: - **Mensalidades**: A sua parte por mês nas mensalidades, separando contas com IA própria e com Nossa IA. Cai no dia do pagamento. - **Recargas**: A sua parte nas recargas do mês até hoje. Só contas com Nossa IA têm recarga de IA. - **Extra por item**: O ganho da margem por item, pago no fechamento. Fica disponível depois da assinatura do aditivo ao contrato. ##### Abas As três partes da tela; setas, Home e End trocam de aba pelo teclado. Botões e ações: - **Margem sobre o uso**: Abre o simulador e a margem padrão da carteira. - **Por conta**: Abre a lista das contas com a margem de cada uma; mostra quantas contas há. - **Mensalidade**: Abre o preço para novos clientes. ##### Margem sobre o uso: nota de alcance A margem sobre o uso vale só para contas com Nossa IA, em que o consumo sai do saldo pré-pago. Contas com IA própria pagam a IA direto ao provedor delas, sem consumo da plataforma para pôr margem. ##### E se a margem padrão fosse… Simulador: arraste e veja o efeito, sem mudar nada. Campos e filtros: - **Margem simulada**: Controle deslizante com o percentual simulado. Botões e ações: - **Usar ‹n›% como margem padrão**: Leva o valor simulado para o campo da margem padrão abaixo; você ainda revisa e confirma. Também aparece: - Selo simulação · nada muda. - Três comparações de hoje para a simulação: o preço de uma mensagem para o cliente, quanto fica com você numa recarga de exemplo e quanto o consumo do mês até agora teria rendido nas contas que usam a padrão. - No campo da margem padrão é possível ir além do limite do simulador. ##### Margem padrão sobre o uso A margem que vale para toda conta com Nossa IA sem margem própria e para os clientes novos. Em cada recarga, a margem é a sua parte e cai na sua conta de recebimento no ato. Campos e filtros: - **Margem padrão (%)**: O percentual sobre a tabela da plataforma; a faixa aceita aparece ao lado e um valor fora dela é recusado com o motivo. Botões e ações: - **Ver quais**: Abre a aba Por conta filtrada nas contas com margem própria. - **Gravar margem padrão**: Abre a confirmação com o alcance e os efeitos da mudança. - **Descartar**: Volta o campo para a margem gravada. - **Ver o aditivo**: Abre a cláusula do aditivo ao contrato que libera a margem por item e o pagamento do extra. Também aparece: - Selo com a margem de hoje e quantas contas usam a padrão ou têm margem própria. - Avisos ao digitar: com margem zero a sua parte some nas contas que usam a padrão; contas com margem própria não mudam, a menos que você escolha isso na confirmação. - Tabela da padrão com Item, Piso da plataforma, Margem do item (bloqueada até o aditivo), Seu cliente paga (riscando o preço de hoje quando muda) e Fica com você. - Selo margem do item bloqueada até a assinatura do aditivo. - Divisão de uma recarga de exemplo entre Plataforma e Fica com você. - A tabela nova vale para o consumo e as recargas seguintes; o saldo já pago não muda. O modelo de mensagem entregue só é debitado quando o número está na conta de WhatsApp da plataforma. ##### Mudar a margem padrão para ‹n›%? Confirmação com o antes e depois da sua parte numa recarga, quem passa a usar a margem nova, quando vale e o aviso ao cliente. Campos e filtros: - **Quem passa a usar ‹n›%**: Só quando há contas com margem própria: escolher entre as contas que usam a padrão (e os clientes novos) ou todas as contas com Nossa IA, o que faz as margens próprias deixarem de valer. - **Avisar o cliente por e-mail**: Só quando a margem baixa: manda o aviso com a sua marca. Quando algum preço sobe, o aviso sai sempre. Botões e ações: - **Agora não**: Fecha sem gravar. - **Gravar ‹n›% em ‹n› contas**: Grava a margem padrão nas contas escolhidas e nos clientes novos. Também aparece: - Aumento vale para o consumo a partir de agora; redução, a partir da próxima recarga de cada conta. - O saldo que cada cliente já tem continua sendo gasto pelo preço atual quando a margem baixa. - Os clientes veem só o preço final de cada item, com a sua marca. A mensalidade dos planos não muda. ##### Por conta A carteira com o tipo de IA, a mensalidade e a margem de uso de cada conta. Campos e filtros: - **Conta**: Nome e situação da conta. - **IA**: Nossa IA ou IA própria. - **Tamanho**: Para Nossa IA, os créditos de IA incluídos na mensalidade. - **Mensalidade**: A sua parte e quanto o cliente paga por mês. - **Margem de uso**: O selo padrão ou própria com o percentual; não se aplica a IA própria. Uma nota avisa quando o saldo já pago segue numa margem anterior. Botões e ações: - **Todas**: Mostra todas as contas, com a contagem. - **IA própria**: Filtra as contas que usam a IA do próprio cliente. - **Nossa IA**: Filtra as contas que usam a IA da plataforma. - **Margem própria**: Filtra as contas com Nossa IA que têm margem própria. - **Com itens acima**: Filtra as contas com itens acima da margem da conta (ainda sem uso nesta fase). - **Ajustar**: Abre o painel lateral da conta (só contas com Nossa IA). - **Adicionar cliente**: Na carteira vazia, abre a página de criar conta. Também aparece: - Coluna com quanto fica com você a cada recarga de exemplo. - Conta nova nasce com Nossa IA e a margem padrão. - No celular, a tabela vira um cartão por conta. ##### Painel da conta Gaveta lateral com o acordo, a margem desta conta com prévia da tabela e o histórico. Esc fecha e o foco volta ao Ajustar. Campos e filtros: - **Margem desta conta (%)**: O percentual da margem própria, quando escolhida. Botões e ações: - **Alterar preço**: Abre a régua para mudar a mensalidade e a sua parte desta conta. - **Usar a margem padrão (‹n›%)**: A conta acompanha a padrão da carteira e muda junto quando ela mudar. - **Margem própria**: A margem fica fixa nesta conta, mesmo quando a padrão mudar; o campo de percentual aparece e ganha o foco. - **Ver a tabela inteira (‹n› itens)**: Mostra todos os itens da tabela da conta. - **Mostrar só os principais**: Volta a mostrar só os itens principais. - **Revisar e salvar**: Abre a confirmação; só fica ativo quando algo mudou. - **Descartar**: Volta à escolha e ao percentual gravados. Também aparece: - O acordo: Cliente paga e Você recebe por mês, com o percentual. - Prévia Como fica a tabela desta conta, com o preço de hoje riscado e o novo, e quanto fica com você por item. - Aviso quando o saldo do cliente foi pago numa margem maior: ele segue sendo gasto por aquele preço até acabar. - Histórico da margem: cada mudança, quando e por quem (por você, automático ou pelo suporte), com a última destacada. ##### Mudar a margem de ‹conta›? Confirmação com o antes e depois dos itens principais e da sua parte numa recarga, quando vale, o saldo e a mensalidade, que não muda. Campos e filtros: - **Avisar o cliente por e-mail**: Só quando o preço que o cliente paga baixa; ao subir, o aviso sai sempre. Botões e ações: - **Agora não**: Fecha sem salvar. - **Salvar margem de ‹n›%**: Grava a margem própria da conta. - **Voltar para ‹n›%**: Tira a margem própria e a conta volta a acompanhar a padrão. ##### Mensalidade O preço para novos clientes com Nossa IA: a mensalidade e a sua parte de quem cria a conta sozinho pelo seu endereço, e o ponto de partida ao adicionar um cliente na Carteira. As contas que já existem não mudam. Campos e filtros: - **O cliente paga por mês**: A mensalidade de quem chega sozinho. - **Você recebe por mês**: A sua parte dentro da mesma cobrança. Botões e ações: - **Mudar em Sua marca**: Leva a Sua marca para abrir ou fechar o cadastro pelo seu endereço. - **Máximo**: Põe a sua parte no máximo que o preço comporta. - **Salvar este preço**: Grava o preço para novos clientes; aparece quando há mudança válida. - **Descartar**: Volta ao preço gravado. Também aparece: - Aviso de que a conta nova com Nossa IA segue o modelo atual: mensalidade com créditos de IA incluídos. - Situação do cadastro pelo seu endereço: aberto ou fechado. - A conta que você vende é mensalidade mais recarga; a sua parte de cada recarga cai na sua conta no ato. ##### Estados da tela - Carregando: Os três cartões de ganho aparecem com os rótulos legíveis e o resto em esqueleto; o painel da conta e a aba Mensalidade têm esqueleto próprio. - Sem nada ainda: Na aba Por conta, a carteira vazia mostra Sua carteira ainda está vazia com Adicionar cliente; um filtro sem resultado mostra Nenhuma conta neste filtro. - Se der erro: Não conseguimos abrir os seus preços e margens: a tela garante que nada mudou nos preços da carteira e oferece Tentar de novo. Erros ao gravar aparecem dentro da confirmação, com o motivo, e o botão vira Tentar de novo. - Margem padrão zerada com contas de Nossa IA: Faixa de aviso no topo com os atalhos para simular ou ver a margem padrão. - Função não liberada para a revenda: O endereço leva para a Carteira. ### Passo a passo #### Como simular e definir a margem padrão sobre o uso 1. Abra **Preços e margens** e fique na aba **Margem sobre o uso**. 2. Arraste **Margem simulada** e compare o preço da mensagem e a sua parte nas recargas. 3. Clique em **Usar ‹n›% como margem padrão** para levar o valor ao campo **Margem padrão (%)**. 4. Clique em **Gravar margem padrão**, revise quem passa a usar a margem nova e confirme. #### Como dar uma margem diferente para um cliente específico 1. Na aba **Por conta**, clique em **Ajustar** na linha da conta. 2. No painel, escolha **Margem própria** e digite o percentual em **Margem desta conta (%)**. 3. Confira a prévia da tabela e clique em **Revisar e salvar**. 4. Na confirmação, decida se avisa o cliente por e-mail (quando o preço baixa) e clique em **Salvar margem de ‹n›%**. #### Como voltar uma conta para a margem padrão 1. Abra a conta pela aba **Por conta** com **Ajustar**. 2. Escolha **Usar a margem padrão** e clique em **Revisar e salvar**. 3. Confirme em **Voltar para ‹n›%**. #### Como mudar o preço para novos clientes 1. Abra a aba **Mensalidade**. 2. Ajuste **O cliente paga por mês** e **Você recebe por mês** na régua. 3. Clique em **Salvar este preço**. As contas que já existem não mudam. #### Como ver o histórico de mudanças de margem de uma conta 1. Na aba **Por conta**, clique em **Ajustar** na conta. 2. Role o painel até **Histórico da margem**: cada mudança aparece com data e autor. ### Perguntas frequentes #### Mudar a margem altera o saldo que o cliente já tem? Não. O saldo que o cliente já pagou continua lá. Quando a margem baixa, o saldo pago na margem anterior segue sendo gasto por aquele preço, e o preço novo vale a partir da próxima recarga. #### O cliente é avisado quando o preço muda? Quando algum preço sobe, o cliente sempre recebe um e-mail com a sua marca antes de o preço novo valer. Quando baixa, o aviso é opcional e você escolhe na confirmação. #### A margem sobre o uso vale para contas com IA própria? Não. Contas com IA própria pagam a IA direto ao provedor delas, então não há consumo da plataforma para pôr margem; para elas o ganho é a mensalidade. #### Mudar a margem muda a mensalidade do cliente? Não. A mensalidade é o acordo de cada conta, à parte; para mudá-la use Alterar preço no painel da conta ou na ficha da Carteira. #### Por que a margem por item está bloqueada? A margem por item e o pagamento do extra passam a valer depois da assinatura do aditivo ao contrato de revenda. Até lá, a margem é uma só por conta; o botão Ver o aditivo mostra a cláusula. #### O cliente vê a minha margem? Não. Ele vê só o preço final de cada item no painel dele, com a sua marca. #### Quando a margem padrão nova passa a valer? Aumentos valem para o consumo a partir de agora; reduções, a partir da próxima recarga de cada conta. Como as pessoas procuram: margem do revendedor; margem sobre o uso; preço por mensagem para o cliente; margem por conta white label; quanto ganho nas recargas; simular margem de revenda; preço para novos clientes; aditivo margem por item; histórico de margem; tabela de preços da revenda. ## Módulos da revenda: como oferecer e habilitar módulos pagos para os seus clientes URL: https://attendto.com.br/manual/revenda-modulos Menu: Portal do revendedor > Módulos Módulos é a tela do portal do revendedor onde ele vê o catálogo de módulos pagos e, conta a conta ou para toda a carteira, oferece o módulo ao cliente por e-mail ou habilita na hora, cobrando a taxa do saldo do cliente. ### Quem pode usar - Dono: O portal tem um único acesso, o do revendedor. Quem entra oferece, habilita e desliga módulos em qualquer conta da carteira. - Admin: Não se aplica: os papéis da equipe de uma conta de cliente não existem no portal. O dono da conta do cliente vê o módulo oferecido em Configurações, com a sua marca, e pode ativá-lo por lá. - Atendente: Atendente de uma conta de cliente não acessa o portal do revendedor. ### Telas #### Módulos A tela Módulos serve para escolher um módulo do catálogo e decidir, conta a conta ou em lote, quem recebe a oferta por e-mail e em quem ele é habilitado na hora. Endereço no painel: `/revenda/modulos` ![Captura da tela Módulos, com nomes e valores desfocados. A tela Módulos serve para escolher um módulo do catálogo e decidir, conta a conta ou em lote, quem recebe a oferta por e-mail e em quem ele é habilitado na hora.](https://attendto.com.br/prints-do-manual/revenda-modulos--modulos.png) A tela Módulos numa conta de demonstração, com os nomes e os valores desfocados. ##### Catálogo Um cartão por módulo, com o nome, o resumo e a taxa por conta. O selecionado ganha a borda em degradê. Botões e ações: - **‹nome do módulo›**: Seleciona o módulo; a parte de baixo da tela passa a mostrar as contas para ele. - **Avise-me**: Em módulo marcado em breve: avisa por e-mail quando ele chegar para a sua carteira. Também aparece: - Selo com quantas contas têm o módulo ativo de quantas há, ou em breve. ##### Módulo selecionado O nome e o resumo do módulo, as ações em lote e os números da taxa. Botões e ações: - **Oferecer a todas**: Abre a confirmação para mandar o e-mail com a sua taxa a toda conta que ainda não tem o módulo nem recebeu a oferta; mostra quantas são. - **Habilitar para todas**: Abre a confirmação para ligar o módulo em toda conta com assinatura em dia; mostra quantas são. - **Ajustar margem**: No cartão da margem: com Preços e margens liberada, abre a aba Margem sobre o uso daquela tela; sem ela, leva à margem sobre o uso na Carteira. Também aparece: - Sua margem padrão (ou Sua margem de uso): o percentual que vale para a taxa dos módulos, com o aviso quando ela está zerada e a taxa fica toda com a plataforma. - Taxa de habilitação para o seu cliente: cobrada uma vez. - Fica com você por habilitação. - A regra: o cliente paga a tabela com a margem, do saldo, uma vez só ao habilitar; a sua parte chega pela divisão da recarga, em Repasses. Você nunca paga adiantado. ##### Último lote Resumo da última ação em lote: quantas contas entraram e quais ficaram de fora, cada uma com o motivo. Botões e ações: - **Fechar**: Esconde o resumo. ##### Contas da carteira Tabela (no celular, um cartão por conta) com a situação do módulo selecionado em cada conta. Campos e filtros: - **Conta**: Nome da conta; a demonstração aparece como a sua vitrine, sem cobrança. - **Margem**: Com Preços e margens liberada: o selo da margem da conta, que leva a ela em Preços e margens. - **‹nome do módulo›**: A situação: ativo, desligado (habilitação já paga), exige assinatura em dia, oferecido em uma data ou não oferecido. - **Taxa do cliente**: A taxa que o cliente paga, ou já paga quando ele já pagou a habilitação. - **Fica com você**: Com Preços e margens liberada: a sua parte na habilitação desta conta. Botões e ações: - **Oferecer**: Manda um e-mail ao dono da conta com a sua taxa; ele ativa quando quiser. - **Oferecer de novo**: Reenvia o e-mail da oferta. - **Módulo na conta ‹conta›**: Interruptor que liga (cobrando a taxa do saldo do cliente, uma vez só) ou desliga o módulo na conta. Religar não cobra de novo. Também aparece: - Conta com margem zerada mostra que a taxa fica toda com a plataforma. ##### O que o seu cliente vê e Oferecer × Habilitar Dois quadros explicativos no pé da tela. Também aparece: - O cliente vê o módulo em Configurações → Módulos, com a sua marca e a taxa, oferecido por você. O nome da plataforma não aparece. - Oferecer manda o e-mail e o cliente decide; Habilitar liga na hora e cobra do saldo dele. Sem saldo, nada é cobrado e o módulo não liga. ##### Confirmação do lote Habilitar ‹módulo› para todas ou Oferecer ‹módulo› a todas: o que vai acontecer, quantas contas são elegíveis agora e, ao habilitar, o total das taxas cobrado dos clientes. Botões e ações: - **Agora não**: Fecha sem fazer nada. - **Habilitar em ‹n› contas**: Liga o módulo nas contas elegíveis, cada uma pagando do próprio saldo. - **Oferecer a ‹n› contas**: Manda o e-mail da oferta às contas elegíveis. Também aparece: - Lista das contas elegíveis, com a taxa de cada uma ao habilitar. - Quem não puder entrar (sem plano, sem saldo, já ativo) fica de fora e aparece depois com o motivo. ##### Estados da tela - Carregando: Quatro cartões do catálogo e a tabela aparecem em esqueleto. - Sem nada ainda: Sem contas ativas: Nenhuma conta ativa na carteira ainda. Os módulos aparecem aqui conta a conta. - Se der erro: Não conseguimos abrir os módulos: a tela garante que nada mudou nas contas e oferece Tentar de novo. - Conta sem assinatura em dia: Selo exige assinatura em dia e o interruptor fica desabilitado. - Habilitação já paga e módulo desligado: Selo desligado · habilitação já paga; religar não cobra. ### Passo a passo #### Como oferecer um módulo pago a um cliente 1. Abra **Módulos** e clique no cartão do módulo no **Catálogo**. 2. Na linha da conta, clique em **Oferecer**. 3. O dono da conta recebe o e-mail com a sua taxa e ativa quando quiser, em Configurações → Módulos. #### Como habilitar um módulo direto na conta do cliente 1. Selecione o módulo no **Catálogo**. 2. Na linha da conta, ligue o interruptor do módulo. 3. A taxa é cobrada do saldo do cliente, uma vez só. Sem saldo, nada é cobrado e o módulo não liga. #### Como habilitar um módulo para toda a carteira 1. Selecione o módulo e clique em **Habilitar para todas**. 2. Confira as contas elegíveis e o total das taxas. 3. Clique em **Habilitar em ‹n› contas** e leia o resumo do **Último lote** para ver quem ficou de fora e por quê. #### Como mudar quanto eu ganho em cada módulo 1. Clique em **Ajustar margem** no cartão da margem. 2. Ajuste a margem sobre o uso: ela vale também para a taxa dos módulos. ### Perguntas frequentes #### Quem paga a taxa do módulo? O cliente, do saldo da conta dele, uma vez só ao habilitar. Você nunca paga adiantado; a sua parte chega pela divisão da recarga e aparece em Repasses. #### Desligar e religar o módulo cobra de novo? Não. Depois de paga a habilitação, a conta pode desligar e religar sem nova cobrança. #### Qual a diferença entre Oferecer e Habilitar? Oferecer só manda o e-mail com a sua taxa e o cliente decide se ativa. Habilitar liga o módulo na hora e já cobra a taxa do saldo dele. #### O cliente vê o nome da plataforma no módulo? Não. Ele vê o módulo em Configurações, com a sua marca e a indicação de que foi oferecido por você. #### Por que algumas contas ficaram de fora do lote? Contas sem plano em dia, sem saldo para a taxa ou com o módulo já ativo não entram. O resumo do último lote lista cada uma com o motivo. #### Posso habilitar módulos na conta de demonstração? Sim. Na demonstração o módulo liga sem cobrança, para você apresentar na reunião. Como as pessoas procuram: módulos da revenda; oferecer módulo ao cliente; habilitar módulo para todos os clientes; taxa de habilitação de módulo; quanto ganho por módulo; add-on white label; vender módulo pago; módulo em lote. ## Repasses da revenda: conta de recebimento e extrato do que já caiu URL: https://attendto.com.br/manual/revenda-repasses Menu: Portal do revendedor > Repasses Repasses é a tela do portal do revendedor que mostra para onde vai a parte dele em cada pagamento de cliente (a conta de recebimento) e o extrato de cada divisão: o que já caiu, o que está a caminho e o que não aconteceu. ### Quem pode usar - Dono: O portal tem um único acesso, o do revendedor. Quem entra informa ou troca a conta de recebimento e vê o extrato completo. - Admin: Não se aplica: os papéis da equipe de uma conta de cliente não existem no portal. O cliente final nunca vê a parte do revendedor. - Atendente: Atendente de uma conta de cliente não acessa o portal do revendedor. ### Telas #### Repasses A tela Repasses serve para informar a conta que recebe a sua parte e conferir, pagamento a pagamento, quanto o cliente pagou, quanto ficou com você e em que situação está cada repasse. Endereço no painel: `/revenda/repasses` ![Captura da tela Repasses, com nomes e valores desfocados. A tela Repasses serve para informar a conta que recebe a sua parte e conferir, pagamento a pagamento, quanto o cliente pagou, quanto ficou com você e em que situação está cada repasse.](https://attendto.com.br/prints-do-manual/revenda-repasses--repasses.png) A tela Repasses numa conta de demonstração, com os nomes e os valores desfocados. Como chegar: Pelo menu, pelo botão Ver os repasses da Visão geral e pelo passo Conta de recebimento das boas-vindas. ##### Sua conta de recebimento Para onde vai a sua parte, no mesmo instante em que o cliente paga. O painel pede só o identificador da conta, nunca a senha nem a chave de acesso dela. Botões e ações: - **Informar a conta**: Abre o diálogo para informar a conta de recebimento pela primeira vez. - **Trocar**: Abre o diálogo para trocar a conta de recebimento atual. Também aparece: - Selo de situação, com a explicação ao passar o mouse: Não informada, Aguardando a primeira cobrança ou Confirmada. - O identificador gravado e a data em que uma cobrança real o confirmou. - Sem conta informada: aviso de que os seus clientes não conseguem pagar, porque a cobrança não é criada sem destino para a sua parte. - Depois de uma troca: aviso de quantas contas já vendidas continuam mandando dinheiro para a conta anterior. A troca vale para as próximas vendas. ##### Informar ou trocar a conta de recebimento Diálogo com confirmação dupla: o identificador é digitado duas vezes, porque o dinheiro vai todo mês para o número digitado e não há como conferir de quem é a conta. Campos e filtros: - **Identificador da conta** (obrigatório): Copiado do painel do seu provedor de pagamento: 36 caracteres no formato 8-4-4-4-12, sem espaços. Fora do formato, o campo avisa na hora. - **Digite de novo para confirmar** (obrigatório): O mesmo identificador; se os dois forem diferentes, o campo avisa que não são iguais. Botões e ações: - **Voltar**: Fecha sem gravar. - **Guardar a conta**: Grava a conta informada pela primeira vez. - **Trocar a conta**: Grava a nova conta; só fica ativo com os dois campos iguais e diferentes da conta atual. Também aparece: - Ao trocar com contas já vendidas, o diálogo avisa que elas continuam na conta anterior. ##### Resumo do dinheiro Três números do que já se dividiu. Campos e filtros: - **Já na sua conta**: Dinheiro disponível, já liquidado. - **A caminho**: Pago pelo cliente e no prazo de liberação do meio de pagamento; diz também quanto depende de cobranças ainda não pagas. - **Não aconteceu**: Divisões desfeitas por estorno, cancelamento ou bloqueio; os motivos estão no extrato. ##### Extrato Cada divisão de pagamento, com o total de lançamentos e paginação. Campos e filtros: - **Cliente**: A conta que pagou, se foi Mensalidade ou Recarga e, quando houver, o motivo de a divisão não ter acontecido. - **Quando**: A data do lançamento. - **Situação**: Aguardando o pagamento, A caminho, Na sua conta, Não aconteceu, Recusado ou Bloqueado; ao passar o mouse, o que isso significa para o seu bolso. - **Cliente pagou**: O valor cobrado do cliente. - **Sua parte**: O que é seu nessa cobrança; aparece riscado quando o dinheiro não veio. Botões e ações: - **Anterior**: Volta uma página do extrato. - **Próxima**: Avança uma página do extrato. Também aparece: - No celular, cada lançamento vira um cartão com Sua parte em destaque. - Bloqueado indica divergência de valor: há dois dias úteis para corrigir; depois disso, o repasse é cancelado. ##### Estados da tela - Carregando: Os rótulos dos três números ficam legíveis e só os valores viram esqueleto; o cartão da conta e o extrato também aparecem em esqueleto. - Sem nada ainda: Ainda não caiu nada: sem conta informada, pede para informá-la acima; com ela, explica que a sua parte aparece na mesma hora em que a primeira mensalidade for paga. - Se der erro: Não conseguimos abrir os seus repasses: a tela garante que nada mudou no seu dinheiro nem na conta de recebimento e oferece Tentar de novo. - Conta de recebimento não informada: Selo Não informada e aviso de que os clientes não conseguem pagar. - Conta informada sem cobrança ainda: Selo Aguardando a primeira cobrança: a primeira venda confirma o número. ### Passo a passo #### Como informar a conta para receber a parte da revenda 1. Abra **Repasses** no menu do portal. 2. Em **Sua conta de recebimento**, clique em **Informar a conta**. 3. Cole o identificador da conta em **Identificador da conta** e repita em **Digite de novo para confirmar**. 4. Clique em **Guardar a conta**. A primeira cobrança paga confirma o número. #### Como trocar a conta de recebimento 1. Em **Sua conta de recebimento**, clique em **Trocar**. 2. Digite o novo identificador duas vezes e clique em **Trocar a conta**. 3. As contas já vendidas continuam mandando a sua parte para a conta anterior; a troca vale para as próximas vendas. #### Como saber por que um repasse não caiu 1. No **Extrato**, encontre o lançamento com a situação **Não aconteceu**, **Recusado** ou **Bloqueado**. 2. Leia o motivo abaixo do nome do cliente e passe o mouse no selo para ver o que a situação significa. #### Como ver quanto já caiu na minha conta 1. Abra **Repasses** e leia **Já na sua conta**. 2. Veja em **A caminho** o que o cliente já pagou e ainda está no prazo de liberação. ### Perguntas frequentes #### Preciso esperar o fim do mês ou mandar nota fiscal para receber? Não. A sua parte sai no mesmo instante em que o cliente paga, dentro da própria cobrança; não há fechamento de mês nem nota a enviar antes de receber. #### Por que o dinheiro aparece como A caminho e não na minha conta? O cliente já pagou e a sua parte está reservada, mas cai no prazo de liberação do meio de pagamento; no cartão, cerca de 30 dias. #### O que acontece se eu não informar a conta de recebimento? Os seus clientes não conseguem pagar: a cobrança não é criada quando não há para onde mandar a sua parte. #### O painel pede a senha da minha conta de pagamento? Não. Só o identificador da conta, que serve apenas para enviar dinheiro; com ele não se lê nada e não se cobra nada. #### Digitei o identificador errado. O dinheiro some? O dinheiro vai para o número digitado, e não há como conferir de quem é a conta. Por isso o diálogo pede o identificador duas vezes e confere o formato; em caso de erro, troque a conta o quanto antes. #### As recargas dos clientes também geram repasse? Sim. O extrato mostra se cada lançamento veio de uma Mensalidade ou de uma Recarga. Como as pessoas procuram: repasse do revendedor; conta de recebimento revenda; quando recebo minha parte; extrato de repasses; split de pagamento revenda; repasse não caiu; trocar conta de recebimento; dinheiro a caminho. ## Conta de demonstração da revenda: apresente a plataforma com a sua marca URL: https://attendto.com.br/manual/revenda-demonstracao Menu: Portal do revendedor > Demonstração Demonstração é a tela do portal do revendedor onde ele cria, abre, recria ou exclui uma conta de vitrine com uma empresa fictícia e a marca dele, para apresentar o produto em reunião sem expor nenhum cliente. ### Quem pode usar - Dono: O portal tem um único acesso, o do revendedor. Quem entra cria, abre, recria e exclui a conta de demonstração. - Admin: Não se aplica: os papéis da equipe de uma conta de cliente não existem no portal. Os clientes da carteira não veem nem são afetados pela demonstração. - Atendente: Atendente de uma conta de cliente não acessa o portal do revendedor. ### Telas #### Demonstração A tela Demonstração serve para manter uma conta à parte, fictícia e com a sua marca, pronta para abrir na reunião: nada é cobrado, nada dispara e nenhum cliente aparece. Endereço no painel: `/revenda/demonstracao` ![Captura da tela Demonstração, com nomes e valores desfocados. A tela Demonstração serve para manter uma conta à parte, fictícia e com a sua marca, pronta para abrir na reunião: nada é cobrado, nada dispara e nenhum cliente aparece.](https://attendto.com.br/prints-do-manual/revenda-demonstracao--demonstracao.png) A tela Demonstração numa conta de demonstração, com os nomes e os valores desfocados. Como chegar: Pelo menu e pelo atalho Demonstração pronta (ou Monte a sua demonstração) no rodapé da Visão geral. ##### Conta de demonstração O cartão que faz tudo. Sem demonstração, ele explica o que ela é e oferece criar; com ela, mostra o nome, a data de preparo e as ações. Campos e filtros: - **Nome da conta (o que a plateia vê no painel)**: O nome no topo do painel da demonstração. Vem sugerido com o nome da sua marca e pode ser trocado antes de criar. Botões e ações: - **Criar conta de demonstração**: Prepara a conta com a operação fictícia completa (leads, conversas e funil) e a sua marca; leva alguns segundos. - **Entrar na demonstração**: Abre o painel da demonstração já com a sua marca, pronto para apresentar. - **Recriar**: Pede confirmação para voltar a demonstração ao cenário original. - **Excluir**: Pede confirmação para apagar a demonstração. Também aparece: - A demonstração fica fora da carteira e dos repasses; nada é cobrado e nenhuma mensagem sai de verdade. - Dentro do painel nada indica à plateia que é uma demonstração; o aviso fica só no portal. ##### Recriar a demonstração? Confirmação: tudo o que foi mexido volta ao cenário original e as datas passam a contar de hoje, para chegar à reunião com a operação fresca. Nenhuma conta de cliente é tocada. Botões e ações: - **Voltar**: Fecha sem recriar. - **Recriar demonstração**: Recria a conta; o andamento aparece no botão do cartão e o resultado num aviso. ##### Excluir a conta de demonstração? Confirmação: a demonstração some por inteiro (leads, conversas e funil fictícios). Nenhuma conta de cliente é tocada e é possível criar outra depois. Botões e ações: - **Voltar**: Fecha sem excluir. - **Excluir demonstração**: Apaga a conta de demonstração. ##### Estados da tela - Carregando: A linha de descrição do cartão aparece em esqueleto enquanto o painel confere se já existe uma demonstração. - Sem nada ainda: Sem demonstração, o cartão explica o que ela é e mostra o campo do nome com Criar conta de demonstração. - Se der erro: Se não for possível ver se já existe uma, o cartão diz isso com o botão Tentar de novo; falhas ao abrir, recriar ou excluir aparecem num aviso. - Criando, recriando ou excluindo: O botão mostra Preparando a demonstração…, Recriando… ou Excluindo… e as outras ações ficam bloqueadas. ### Passo a passo #### Como criar uma conta de demonstração com a minha marca 1. Abra **Demonstração** no menu do portal. 2. Confira ou troque o nome em **Nome da conta (o que a plateia vê no painel)**. 3. Clique em **Criar conta de demonstração** e aguarde alguns segundos. #### Como apresentar a plataforma para um cliente em reunião 1. Em **Demonstração**, clique em **Entrar na demonstração**. 2. O painel abre com a sua marca e a operação fictícia; apresente à vontade, nada é cobrado nem disparado. #### Como deixar a demonstração como nova antes da reunião 1. Clique em **Recriar** no cartão da demonstração. 2. Confirme em **Recriar demonstração**: o cenário volta ao original, com as datas a partir de hoje. #### Como apagar a conta de demonstração 1. Clique em **Excluir** no cartão. 2. Confirme em **Excluir demonstração**. Você pode criar outra quando quiser. ### Perguntas frequentes #### A demonstração é cobrada ou entra na minha receita? Não. Ela fica fora da carteira e dos repasses e nada nela é cobrado. #### Mensagens enviadas na demonstração chegam a alguém? Não. Nenhuma mensagem sai de verdade; a operação é toda fictícia. #### A plateia percebe que é uma conta de demonstração? Dentro do painel nada denuncia a vitrine: ela aparece com a sua marca e o nome que você escolheu. O aviso de que é demonstração fica só no portal. #### Mudei coisas na demonstração durante a reunião. Como desfaço? Use Recriar: tudo volta ao cenário original, com as datas contando de hoje. #### Posso ter mais de uma demonstração? Não. A revenda tem uma conta de demonstração; para outra versão, recrie ou exclua e crie de novo. Como as pessoas procuram: conta de demonstração revenda; demo com a minha marca; apresentar a plataforma em reunião; conta de vitrine white label; recriar demonstração; demonstração sem expor clientes.