Base avançada: memória da empresa, consultas ao seu sistema, webhooks de entrada e fluxos da IA

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.

• 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 agoraDono

No período de teste, quando as consultas incluídas acabam, confirma a assinatura e as sincronizações voltam a rodar.

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

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

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

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

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

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

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.

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

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

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

• 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 fatoobrigató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.

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

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.

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

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

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.

• Dica fixa: dá para usar os dois juntos, sincronizar o catálogo e consultar na hora só o estoque da loja.

Cabeçalho

Campos e filtros

Nome da sincronizaçãoobrigató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 agoraDono

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.

• 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çoobrigató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.

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

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

• 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”).”

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.

• 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 assimDono

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.

• 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

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

• 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 planilhaDono

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.

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

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 agoraDono

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.

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

A troca

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

• 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çãoDono

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 enquantoDono

Deixa a sincronização em rascunho e volta para Ações.

Nova sincronização

No caminho do topo, volta à criação da sincronização.

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

Cabeçalho

Campos e filtros

Nome da açãoobrigató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.

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

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

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

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

• 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 estaDono

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.

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

PublicarDono

Publica a nova versão; a IA usa a partir da próxima mensagem.

Publicar assim mesmoDono

Com avaliação falhando, publica mesmo assim e fica registrado.

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

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 sistemaDono

Na ação que grava, a confirmação obrigatória, junto com o código de duas etapas.

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

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

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.

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

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.

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

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

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.

PublicarDono

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.

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

• Arraste um nó para o canvas, dê dois cliques ou pressione Enter para adicionar.

Canvas

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

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

• 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 curtoobrigatório

O nome da conversa de exemplo.

Conversa de exemploobrigató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.

• 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

PublicarDono

Publica a versão; a IA usa a partir da próxima mensagem.

Publicar assim mesmoDono

Com avaliação falhando, publica e fica registrado.

Corrigir antes

Fecha para corrigir (com avaliação falhando).

Tirar do arDono

Na versão em uso, tira o fluxo do ar e libera o gatilho para outro fluxo.

Voltar para estaDono

A versão antiga vira a próxima, publicada agora, e substitui o rascunho.

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

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.

TrocarDono

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 agoraDono

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 novoDono

Com o endereço arquivado, gera outro endereço e outro segredo.

• 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 eventoobrigatório

O que vai no campo “evento” do corpo (letras, números, ponto, traço ou sublinhado).

Nome em portuguêsobrigató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.

• Clicar num evento mostra a regra dele à direita; cada um mostra quantos chegaram no mês.

Últimas entregas

• 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 regraDono

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.

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