Um manual SEMJAT baseado em captura de tela criado a partir do fluxo real do painel sem.chat. Cada guia informa em que clicar, o que deve acontecer após o clique, como testá-lo, como solucionar o problema e o que fazer a seguir.
Nenhum guia correspondente encontrado. Experimente uma palavra-chave mais curta, como widget, API, voz, faturamento, webhook, WordPress, SendPulse ou agendamento.
Nota de captura de tela: cada imagem deste manual foi capturada do app real sem.chat usando um espaço de trabalho de demonstração. Detalhes sensíveis da conta, dados de clientes, chaves API, detalhes de pagamento e conteúdo de conversas privadas são mascarados antes da publicação.
01
Primeiros passos
Crie a conta, conclua a integração, entenda o painel, crie o primeiro bot, teste-o de forma privada, instale-o e escolha o plano certo.
/autenticaçãoInscrição, avaliação e primeiro bot
1Comece com Cadastre-se ou Faça login no site ou aplicativo público.
2Verifique o endereço de e-mail antes de confiar em notificações ou mensagens de cobrança.
3Use a integração para criar o primeiro bot antes de abrir o painel.
/visão geralVisão geral após login
1Use ações rápidas para criar um bot, visualizar bots, abrir análises ou gerenciar o faturamento.
2Revise os bots ativos, conversations, minutos de voz e satisfação antes de fazer alterações.
3Verifique a atividade recente após cada teste de configuração.
Primeiro lançamento
Cadastre-se, inicie o teste e entenda o painel
Para que serve isso: Use este fluxo de trabalho para um espaço de trabalho totalmente novo ou ao integrar um colega de equipe que nunca usou sem.chat.
Antes de começar
Use um e-mail comercial que possa receber e-mails de verificação e cobrança.
Decida quem deve ser o proprietário do espaço de trabalho antes de convidar o restante da equipe.
Mantenha um site de teste seguro ou uma página de teste pronta para a instalação do widget.
1
Abra a página de inscrição do aplicativo
Vá para app.sem.chat/auth no botão Entrar/Inscrever-se no site.
Resultado esperado: A página de autenticação mostra opções de login e criação de conta.
2
Crie a conta
Digite o e-mail comercial, crie a senha e envie o formulário de inscrição.
Resultado esperado: O aplicativo solicita verificação ou passa para integração depois que a conta é aceita.
3
Verifique o e-mail
Abra o e-mail de verificação e clique no link de confirmação.
Resultado esperado: A conta pode receber mensagens de cobrança, convite, relatório e alerta.
4
Integração completa
Insira o nome da empresa, descreva o objetivo do assistente, escolha uma cor inicial e crie o primeiro bot.
Resultado esperado: O espaço de trabalho é aberto com um rascunho de bot e um estado de avaliação ativo.
5
Visão geral aberta
Clique em Visão geral na barra lateral esquerda.
Resultado esperado: O painel mostra cartões usage, ações rápidas e atividades recentes.
6
Escolha a próxima ação
Use Criar novo bot para configuração, Visualizar todos os bots para gerenciamento, Análise para desempenho ou Faturamento para limites do plano.
Resultado esperado: Você sabe onde continuar com base no estado do espaço de trabalho.
Como testar: Crie um bot de teste privado e envie uma mensagem de teste antes de convidar colegas de equipe. Confirme as alterações da atividade Visão Geral após o teste.
Problema
Correção
E-mail de verificação não chega
Verifique o spam, confirme a ortografia do e-mail e solicite outro e-mail de verificação.
O painel é aberto no Faturamento
O espaço de trabalho pode precisar de uma avaliação ou plano ativo. Inicie a avaliação ou escolha o plano correto antes da configuração.
Um colega de equipe não pode acessar o espaço de trabalho
Convide-os em Configurações, Equipe, em vez de compartilhar o login do proprietário.
O que fazer a seguir: Crie o primeiro bot, teste-o de forma privada e instale o widget em uma página de teste.
Teste de lançamento privado
Crie o primeiro teste de bot privado antes de ir ao ar
Para que serve isso: Use isso para verificar o rastreamento de conta, bot, widget e histórico antes que os clientes vejam o assistente.
Antes de começar
Tenha um exemplo de pergunta do cliente pronto.
Tenha uma página de teste ou página de teste local HTML pronta.
Não use dados reais de clientes no primeiro teste.
1
Abra My Bots
Clique em My Bots na barra lateral ou use Visualizar todos os bots na visão geral.
Resultado esperado: Você pode ver o bot criado durante a integração ou um estado vazio com um botão Novo Bot.
2
Abra o construtor de bots
Clique em Novo Bot ou Editar no bot existente.
Resultado esperado: O Bot Builder abre com controles básicos, widget, conhecimento, voz e integração.
3
Salve o bot uma vez
Preencha o nome do bot e a primeira mensagem necessários e clique em Salvar.
Resultado esperado: O bot recebe um ID válido e pode gerar código incorporado.
4
Visualizar em particular
Use o painel de visualização e faça seu exemplo de pergunta.
Resultado esperado: A resposta deve corresponder às suas instruções ou revelar que conhecimento está faltando.
5
Instalar no teste
Abra Embed, copie o snippet HTML e cole-o antes da tag de fechamento do corpo na página de teste.
Resultado esperado: O widget aparece no canto configurado no desktop e no celular.
6
Confirmar rastreamento
Abra a Caixa de entrada ou Chat History após a conversa de teste.
Resultado esperado: A conversa de teste aparece com o bot, canal e histórico de mensagens corretos.
Como testar: Envie uma mensagem de texto e um teste de voz se a voz estiver ativada. Confirme se ambos aparecem em Chat History.
Problema
Correção
O código incorporado não está disponível
Salve o bot primeiro. Se a sincronização de voz ainda estiver pendente, aguarde a sincronização ou salve novamente após o preenchimento dos campos obrigatórios.
O widget mostra o bot errado
Confirme se data-bot-id no snippet corresponde ao ID do bot do modal Incorporado.
Nenhuma conversa aparece no histórico
Atualize Chat History, confirme se o bot está ativo e certifique-se de que o teste aconteceu no widget instalado, não em uma página obsoleta.
O que fazer a seguir: Vá para a configuração de Bot Builder e treinamento de conhecimento.
02
Crie e configure um bot
Crie, edite, visualize, ative, transfira ou remova bots de My Bots e Bot Builder.
/painelCentro de controle My Bots
1Clique em Novo Bot para iniciar um novo assistente.
2Use Editar, Incorporar, Transferir, Ativar ou Excluir em cada cartão de bot.
3Verifique o estado ativo e a hora da última atualização antes do teste.
/bots/:id/editarBot Builder guia básica
1Preencha o nome do bot, avatar, primeira mensagem e instruções do sistema.
2Use o Preview para testar antes de publicar.
3Salve e sincronize antes de copiar o código incorporado.
Criar bot
Crie um novo bot de My Bots
Para que serve isso: Use este fluxo de trabalho quando uma nova marca, site, fila de suporte ou campanha precisar de seu próprio assistente.
Antes de começar
Prepare o nome do bot, o objetivo, a primeira mensagem e dois ou três exemplos de perguntas.
Colete o site público URL se você planeja importar conteúdo.
Confirme se o plano permite o número de bots e recursos de voz/avatar que você precisa.
1
Abra My Bots
Clique em My Bots na barra lateral.
Resultado esperado: Os bots existentes e o botão Novo Bot ficam visíveis.
2
Clique em Novo bot
Inicie um novo bot na página My Bots.
Resultado esperado: Bot Builder abre com um assistente de rascunho.
3
Definir identidade do bot
Insira o nome do bot, carregue ou escolha um avatar e escreva a primeira mensagem que os visitantes verão.
Resultado esperado: O painel de visualização reflete o nome, o avatar e a saudação do assistente.
4
Escreva instruções do sistema
Descreva o que o bot deve fazer, como deve falar, o que deve evitar e quando deve pedir ajuda humana.
Resultado esperado: O assistente tem regras de comportamento claras antes que o conhecimento seja adicionado.
5
Adicione conhecimento básico
Cole informações essenciais sobre empresa, produto, suporte, preços e contato na área de conhecimento.
Resultado esperado: O bot pode responder perguntas comuns sem precisar importar o site ainda.
6
Salve o bot
Clique em Salvar e aguarde a confirmação de salvo ou sincronizado.
Resultado esperado: O bot tem um ID estável, a visualização pode ser testada e as opções de incorporação ficam disponíveis.
7
Visualize o resultado
Faça os exemplos de perguntas preparadas na Pré-visualização.
Resultado esperado: As respostas devem seguir as instruções e usar o conhecimento inserido.
8
Ative somente quando estiver pronto
Ative o bot depois que o teste privado for aprovado.
Resultado esperado: O bot está pronto para tráfego de widget ou canal.
Como testar: Faça pelo menos cinco perguntas realistas. Verifique se a resposta está correta, se permanece na marca e se pede ajuda humana quando necessário.
Problema
Correção
A resposta é muito genérica
Adicione conhecimentos mais específicos e reescreva as instruções com exemplos de boas respostas.
O bot recusa perguntas que deveria responder
Remova instruções excessivamente rígidas e adicione conhecimento confiável para esse tópico.
Salvar não gera código incorporado
Verifique os campos obrigatórios e salve novamente após a conclusão da sincronização do provedor de voz.
O que fazer a seguir: Defina as configurações do widget, adicione conhecimento do site e instale o bot.
Gerenciar bots
Editar, clonar fluxo de trabalho, transferir, desativar ou excluir um bot
Para que serve isso: Use este fluxo de trabalho quando um bot precisar de atualizações, alterações de propriedade, pausa temporária ou remoção permanente.
Antes de começar
Exporte qualquer conversa ou dados de contato que você deva manter antes de excluir um bot.
Confirme se o bot não está incorporado em um site ativo antes de excluí-lo ou transferi-lo.
Informe os colegas de equipe antes de desativar um bot de produção.
1
Abra My Bots
Encontre o cartão bot por nome ou status.
Resultado esperado: O cartão mostra o estado atual e as ações disponíveis.
2
Clique em Editar
Abra o construtor de bots e faça as alterações necessárias.
Resultado esperado: O editor carrega a configuração atual.
3
Salvar e testar novamente
Clique em Salvar após cada alteração de material e execute perguntas de visualização.
Resultado esperado: A configuração salva é usada pela visualização e pelo widget instalado.
4
Desativar temporariamente
Use a alternância ativa se o bot parar de lidar com visitantes por enquanto.
Resultado esperado: O bot para de servir o tráfego ao vivo enquanto preserva a configuração.
5
Transferir propriedade
Use Transferir, insira o e-mail do destinatário e confirme.
Resultado esperado: A conta selecionada recebe propriedade de acordo com o fluxo de transferência do aplicativo.
6
Excluir somente após verificações
Use Delete, leia o aviso e confirme somente quando o bot não for mais necessário.
Resultado esperado: O bot e a configuração relacionada são removidos de acordo com o aviso.
Como testar: Após a edição, abra o widget instalado e faça exatamente a pergunta que motivou a mudança. Confirme se a resposta ao vivo foi alterada.
Problema
Correção
A resposta antiga ainda aparece
Atualize a página do site, confirme se você salvou o bot correto e verifique se os dados importados precisam de sincronização.
A transferência falha
Confirme se o e-mail do destinatário é válido e se a conta de destino pode aceitar o bot.
Excluir foi clicado por engano
Pare antes da confirmação final. Existem avisos de exclusão porque a ação pode remover dados do bot permanentemente.
O que fazer a seguir: Revise as análises e o histórico após as alterações ao vivo para garantir que a experiência do visitante melhore.
03
Instale o widget
Copie o código de incorporação correto, instale-o em contextos HTML, WordPress, React ou SDK avançados e verifique o comportamento do desktop e do celular.
Incorporar modalCopie o snippet de instalação do site
1Escolha HTML, WordPress, React ou NPM/SDK com base na pilha do site.
2Copie o código depois que o bot for salvo e sincronizado.
3Cole o snippet antes da tag body de fechamento ou no layout da estrutura.
HTML instalar
Instale o widget em um site HTML padrão
Para que serve isso: Use isto quando você puder editar o modelo de página, o rodapé do tema ou o layout global HTML.
Antes de começar
Salve o bot primeiro para que o modal incorporado tenha um ID de bot real.
Use um site de teste antes da produção.
Mantenha a versão exata do script e data-bot-id do modal.
1
Abra My Bots
Encontre o bot que deseja instalar e clique em Incorporar.
Resultado esperado: O modal Incorporar abre com guias de instalação.
2
Selecione HTML
Escolha a guia HTML e clique em Copiar código.
Resultado esperado: O script do widget é copiado com o ID do bot anexado.
3
Abra o modelo do site
Edite o rodapé global ou arquivo de layout que é renderizado em cada página onde o widget deve aparecer.
Resultado esperado: Você está editando o shell do site compartilhado, e não uma única página isolada, a menos que seja intencional.
4
Cole antes de fechar o corpo
Cole o snippet imediatamente antes da tag body de fechamento.
Resultado esperado: O script é carregado após o conteúdo da página e pode montar o contêiner do widget.
5
Publicar ou implantar
Salve o modelo e implante o site.
Resultado esperado: O script do widget está ativo nas páginas de destino.
6
Teste desktop e celular
Abra o site em uma nova janela do navegador e em uma janela de visualização móvel.
Resultado esperado: O widget aparece na posição configurada e abre sem erros do console.
Como testar: Envie uma mensagem da página ativa e abra a Caixa de entrada e Chat History para confirmar se a conversa pertence ao bot correto.
Problema
Correção
O widget está faltando
Confirme se o código está antes da tag body de fechamento, se os scripts não estão bloqueados pelo construtor do site e se o bot está ativo.
Aparece um bot errado
Copie o snippet novamente e compare data-bot-id com o bot desejado.
O widget se sobrepõe aos controles da página
Altere a posição ou o tamanho nas configurações do widget e teste novamente no celular.
O que fazer a seguir: Ajuste as configurações do widget e captura de leads após a instalação.
npm install @vapi-ai/web
import Vapi from '@vapi-ai/web';
const vapi = new Vapi('YOUR_VAPI_PUBLIC_KEY');
await vapi.start('YOUR_ASSISTANT_ID');
vapi.on('call-start', () => console.log('Call started'));
vapi.on('call-end', () => console.log('Call ended'));
04
Configurações de widget
Configure modo, tema, tamanho, posição, cor, marca, reações, som, consentimento, captura de leads, classificações, e-mail de acompanhamento e estado de ativação.
Bot Builder / WidgetAparência do widget e comportamento do visitante
1Escolha chat, voz ou modo híbrido.
2Defina tema, cor, posição, tamanho, marca, consentimento e som.
3Configure a captura de leads, classificações, reações e comportamento de acompanhamento.
Comportamento do widget
Configurar o comportamento do widget voltado para o visitante
Para que serve isso: Use-o após a primeira instalação ou sempre que o widget precisar corresponder ao site e capturar melhores leads.
Antes de começar
Instale o widget em uma página de teste.
Saiba se os visitantes devem começar com chat, voz ou ambos.
Prepare o consentimento e a cópia da captura de leads, se necessário para a região.
1
Abra o construtor de bots
Abra My Bots, clique em Editar e escolha a guia Widget.
Resultado esperado: Os controles de widget aparecem para o bot selecionado.
2
Escolha o modo
Selecione Chat, Voz ou Híbrido com base na experiência do visitante desejada.
Resultado esperado: A visualização muda para mostrar o modo escolhido.
3
Definir aparência
Escolha tema, cor, tamanho, posição do botão e opções de marca.
Resultado esperado: O widget corresponde ao site sem cobrir conteúdo importante.
4
Habilite controles de visitantes
Ative ou desative reações, sons, classificações e solicitações de consentimento.
Resultado esperado: Os visitantes veem apenas os controles que você deseja que eles usem.
5
Configurar captura de leads
Escolha os campos obrigatórios, o campo de descrição opcional e quando o formulário será exibido.
Resultado esperado: Os contatos são coletados antes ou durante conversations de acordo com sua configuração.
6
Definir e-mail de acompanhamento
Configure o comportamento do e-mail de acompanhamento se o seu plano incluir isso.
Resultado esperado: Os visitantes podem receber mensagens de acompanhamento após a resolução de conversations.
7
Salve e teste
Clique em Salvar, recarregue a página de teste e abra o widget.
Resultado esperado: O widget ao vivo corresponde às configurações salvas.
Como testar: Abra o widget no desktop e no celular, envie um formulário de lead, deixe uma avaliação e confirme se o contato e a conversa foram gravados.
Problema
Correção
A cor não foi atualizada
Salve o bot, atualize o site e confirme se o widget instalado usa o mesmo ID do bot.
Os campos de lead estão faltando
Confirme se a captura de lead está habilitada e se a condição de acionamento selecionada foi atendida.
Os visitantes não podem usar voz
Verifique as configurações de voz, permissão de microfone do navegador, plano de acesso e limites de minutos de voz.
O que fazer a seguir: Adicione configurações de voz/avatar e fontes de conhecimento antes do lançamento da produção.
05
Voz e avatares
Selecione vozes de estoque, configure modos e limites de voz, leia transcrições, clone vozes, atribua vozes clonadas e gerencie avatares de estoque ou personalizados.
Bot Builder / VozVoz, limites, transcrições e avatares
1Escolha uma voz padrão ou uma voz clonada salva.
2Defina limites de minutos de voz e salve transcrições.
3Escolha avatares padrão ou carregue um avatar personalizado se o plano permitir.
Configuração de voz
Configurar chamadas de voz e transcrições
Para que serve isso: Use isto quando os visitantes precisarem falar com o bot em vez de apenas digitar.
Antes de começar
Confirme se o plano inclui minutos de voz e as opções de voz/avatar desejadas.
Use um ambiente de navegador silencioso para testes.
Prepare uma pergunta realista de suporte ou vendas para testar por voz.
1
Abra as configurações de voz
Abra o criador de bots e selecione a área Voz ou Voz e Avatares.
Resultado esperado: Os controles de voz e a seleção de voz atual ficam visíveis.
2
Selecione uma voz padrão
Visualize as vozes disponíveis, escolha a que melhor se adapta e salve a seleção.
Resultado esperado: O bot usa a voz escolhida para chamadas.
3
Configurar modo de voz
Use as configurações do widget para escolher Voz ou Híbrido quando a voz estiver disponível para os visitantes.
Resultado esperado: Os visitantes veem uma opção de voz no widget.
4
Definir limites de voz
Defina limites por usuário ou espaço de trabalho, se disponíveis.
Resultado esperado: Chamadas longas ou repetidas não podem consumir mais minutos do que o pretendido.
5
Habilitar transcrições
Ative o salvamento de transcrição se precisar de revisão de chamadas no histórico.
Resultado esperado: As chamadas de voz criam transcrições legíveis após a sessão.
6
Testar uma chamada
Abra o widget, permita o acesso ao microfone, inicie uma chamada e faça a pergunta preparada.
Resultado esperado: O bot responde por voz e a chamada termina de forma limpa.
7
Leia a transcrição
Abra Chat History e encontre a conversa de voz.
Resultado esperado: A transcrição mostra o que o visitante e o bot disseram.
Como testar: Conclua uma chamada curta e confirme se os minutos de voz, a transcrição e o modo de conversa foram gravados.
Problema
Correção
Navegador bloqueia microfone
Permita permissão de microfone no navegador e recarregue a página.
A opção de voz está bloqueada
Abra o Faturamento e confirme se o plano do espaço de trabalho inclui recursos de voz.
A transcrição está vazia
Confirme se o salvamento da transcrição está ativado e se a chamada foi encerrada normalmente.
O que fazer a seguir: Adicione ou refine o conhecimento para que as respostas por voz sejam precisas.
Clone de voz e avatar
Clone uma voz e atribua um avatar personalizado
Para que serve isso: Use-o quando o assistente precisar de uma voz de marca ou de uma experiência de avatar falante.
Antes de começar
Use apenas áudio e imagens que você tem permissão para usar.
Grave amostras de voz limpas com baixo ruído de fundo.
Confirme os limites do plano para vozes clonadas e avatares personalizados.
1
Clonagem de voz aberta
Clique em Clonar voz na área Voz.
Resultado esperado: A caixa de diálogo de upload mostra os requisitos de amostra aceitos.
2
Carregar amostras
Carregue de uma a cinco gravações limpas e envie a solicitação de clonagem.
Resultado esperado: A voz clonada aparece após o processamento ou a caixa de diálogo mostra o próximo requisito.
3
Atribuir a voz clonada
Selecione a voz clonada no seletor de voz e salve.
Resultado esperado: As chamadas futuras usarão a voz clonada.
4
Escolha um avatar padrão
Escolha um avatar incluído se o upload de avatar personalizado não for necessário.
Resultado esperado: A experiência de voz tem uma identidade visual.
5
Carregar avatar personalizado
Carregue uma imagem nítida do rosto ou um vídeo curto, se o seu plano permitir.
Resultado esperado: O avatar é processado e fica disponível para seleção.
6
Execute uma visualização completa
Inicie uma chamada de voz e confirme o comportamento de voz, avatar e transcrição juntos.
Resultado esperado: A experiência do visitante corresponde à marca configurada.
Como testar: Faça uma pergunta curta com a voz clonada selecionada e confirme se a chamada usa a voz/avatar esperado.
Problema
Correção
A qualidade do clone é ruim
Grave amostras mais limpas com um alto-falante, volume estável e sem música.
O upload de avatar personalizado não está disponível
Verifique o faturamento para saber os limites de avatar limitados pelo plano.
A voz antiga ainda toca
Salve o bot após selecionar a nova voz e recarregue a página do widget.
O que fazer a seguir: Prossiga para Conhecimento e Dados para que a experiência de voz tenha respostas precisas.
06
Conhecimento e dados
Adicione conhecimento manual, importe conteúdo do site, aplique resultados de rastreamento, sincronize conteúdo importado, adicione feed de produtos URLs, atualize ou remova feeds e verifique as respostas com perguntas de teste.
Bot Builder / ConhecimentoFontes de conhecimento e testes de resposta
1Adicione conhecimento manual sobre políticas, preços e regras de marca.
2Importe páginas do site e aplique resultados de rastreamento.
3Adicione feeds de produtos e sincronize-os quando o inventário mudar.
Fontes de conhecimento
Treine o bot com conhecimento manual, importação de sites e feeds de produtos
Para que serve isso: Use-o sempre que o assistente der respostas incompletas ou precisar de novas informações sobre produtos, políticas ou sites.
Antes de começar
Prepare URLs de origem e feed de produto URLs.
Decida quais páginas não devem ser importadas, como páginas administrativas ou privadas.
Crie perguntas de teste para cada tópico adicionado.
1
Conhecimento Aberto
Abra Bot Builder e escolha a guia Conhecimento ou Dados.
Resultado esperado: Conhecimento manual, importação de site e ferramentas de feed de produtos são visíveis.
2
Adicione conhecimento manual
Cole fatos concisos, políticas, preços, detalhes de contato e notas de estilo de resposta.
Resultado esperado: O bot tem uma fonte confiável imediata para respostas de alta prioridade.
3
Importar conteúdo do site
Cole o site público URL e inicie o rastreamento/importação.
Resultado esperado: Os resultados do rastreamento mostram páginas descobertas ou status de importação.
4
Revise e aplique os resultados
Mantenha páginas úteis, remova páginas irrelevantes e aplique o conteúdo selecionado.
Resultado esperado: Somente o conteúdo aprovado do site entra na base de conhecimento.
5
Adicionar feed de produto URLs
Cole Google Merchant Center ou feed compatível URLs e importe.
Resultado esperado: Produtos, preços, disponibilidade e atributos ficam disponíveis para o bot.
6
Atualizar ou remover feeds
Use a atualização quando os dados do catálogo forem alterados e remova os feeds que não são mais usados.
Resultado esperado: O bot evita dados de produtos obsoletos ou duplicados.
7
Salvar e sincronizar
Salve o bot e aguarde a conclusão da sincronização.
Resultado esperado: O conhecimento mais recente é usado pelas respostas do widget ao vivo e de visualização.
8
Faça perguntas de verificação
Faça uma pergunta de teste por fonte adicionada.
Resultado esperado: A resposta cita ou reflete o conteúdo atualizado com precisão.
Como testar: Faça perguntas sobre preços, devoluções, disponibilidade, informações da empresa e tópicos sem suporte. Confirme se o bot responde a tópicos conhecidos e não inventa detalhes desconhecidos.
Problema
Correção
O rastreador importa páginas irrelevantes
Remova essas páginas dos resultados selecionados e adicione instruções manuais mais claras.
Os preços dos produtos estão obsoletos
Atualize o feed e confirme se o próprio feed URL contém os valores atuais.
Bot inventa respostas
Adicione uma regra para que o bot diga que não tem certeza e ofereça suporte humano quando faltar conhecimento.
O que fazer a seguir: Retorne à Visualização, teste novamente e instale ou atualize o widget.
07
Caixa de entrada, Live Support, Histórico, Contatos
Lide com conversations diariamente, solicite solicitações de suporte ao vivo, devolva o controle à IA, exporte o histórico, gerencie contatos e sincronize contatos com SendPulse.
/caixa de entradaFluxo de trabalho de conversa na caixa de entrada
1Filtre por bot ou canal.
2Abra uma conversa e responda como humano quando necessário.
3Use os controles de tradução, resolução e transferência com cuidado.
/suporte ao vivoControle de transferência de suporte ao vivo
1Solicite transferências em espera rapidamente.
2Responda como agente ou devolva a conversa à IA.
3Resolva quando o visitante não precisar mais de ajuda humana.
/chat-históricoHistórico de conversas e exportações
1Pesquise por visitante, bot, canal ou data.
2Abra transcrições completas para sessões de texto e voz.
3Exporte CSV ou JSON quando necessário.
/contatosContatos e exportação de SendPulse
1Filtre contatos por bot ou fonte.
2Abra os detalhes do contato e o contexto da conversa.
3Exporte ou sincronize os contatos selecionados para SendPulse.
Resposta na caixa de entrada
Abra uma conversa e envie uma resposta humana
Para que serve isso: Use isto quando um operador precisar responder a um cliente de sem.chat em vez de deixar a IA continuar sozinha.
Antes de começar
Confirme se o operador tem acesso ao bot ou ao espaço de trabalho.
Leia a conversa antes de responder.
Saiba se o visitante espera a mesma linguagem.
1
Abrir caixa de entrada
Clique em Caixa de entrada na barra lateral.
Resultado esperado: conversations recentes aparecem com bot, canal, visitante, status e hora.
2
Filtre se necessário
Use filtros de canal, bot, não lido ou status para encontrar a conversa.
Resultado esperado: A lista se restringe ao conjunto de conversas que você precisa.
3
Abra a conversa
Clique na linha do visitante.
Resultado esperado: O tópico completo, as informações do visitante e os controles de resposta estão visíveis.
4
Traduza se necessário
Use controles de tradução quando o idioma do visitante for diferente do idioma do agente.
Resultado esperado: O agente pode compreender e responder adequadamente.
5
Enviar uma resposta
Escreva a resposta humana e envie-a.
Resultado esperado: A mensagem é adicionada ao thread como uma resposta de agente/humano.
6
Resolver ou manter aberto
Resolva a conversa, se concluída, ou deixe-a aberta para acompanhamento.
Resultado esperado: O status da caixa de entrada corresponde ao estado real do cliente.
Como testar: Envie uma resposta de teste segura para uma conversa de teste e confirme se ela aparece no widget do visitante e em Chat History.
Problema
Correção
A resposta não é enviada
Verifique o estado da rede, o status da conversa e se o suporte ao vivo foi solicitado.
O idioma do visitante está errado
Use a tradução ou atualize as configurações de idioma do bot antes de responder.
A conversa não está na Caixa de entrada
Pesquise Chat History e confirme se o teste do widget usou o bot correto.
O que fazer a seguir: Use Live Support para filas de transferência ativas e Chat History para auditorias.
Suporte ao vivo
Reivindique, responda, devolva à IA e resolva uma transferência
Para que serve isso: Use isto quando a IA solicitar que um humano ou um visitante precise explicitamente de um agente.
Antes de começar
Tenha um agente disponível antes de ativar o suporte ao vivo.
Defina quando a IA deve solicitar a transferência nas instruções do bot.
Mantenha as configurações de notificação ativadas para alertas de transferência.
1
Abra Live Support
Clique em Live Support na barra lateral.
Resultado esperado: A espera e a transferência ativa conversations estão visíveis.
2
Reivindique o pedido
Clique em Reivindicar na conversa em espera.
Resultado esperado: Outros agentes podem ver que a conversa está sendo tratada ativamente.
3
Ler contexto
Abra mensagens e detalhes do visitante antes de responder.
Resultado esperado: O agente entende por que a transferência aconteceu.
4
Envie a resposta humana
Responda com clareza e mantenha o tópico atualizado.
Resultado esperado: O visitante recebe uma resposta humana.
5
Devolva à IA, se apropriado
Use a devolução quando o problema for resolvido e a IA puder continuar.
Resultado esperado: AI retoma o tratamento da conversa.
6
Resolva quando terminar
Clique em Resolver quando o visitante não precisar mais de ajuda.
Resultado esperado: A transferência é fechada e removida da fila ativa.
Como testar: Crie uma transferência de teste, solicite-a, responda uma vez, devolva-a e confirme as alterações de status em Live Support e Chat History.
Problema
Correção
Agentes perdem solicitações
Habilite notificações por navegador/e-mail/push e adicione um processo para propriedade da fila.
A IA continua assumindo o controle muito cedo
Ajuste as instruções e regras de transferência para que o controle humano permaneça ativo até ser resolvido ou devolvido.
CRM externo está fora de sincronia
Use webhooks ou pesquisas na seção Receitas do desenvolvedor.
O que fazer a seguir: Conecte CRM/webhooks se as equipes de suporte trabalharem fora de sem.chat.
História e contatos
Pesquise, exporte e use registros de conversas/contatos
Para que serve isso: Use isso para auditorias, revisão de leads, exportação de CSV e sincronização de SendPulse.
Antes de começar
Decida se você precisa de conversations, contatos ou ambos.
Aplique o intervalo de datas correto antes de exportar.
Não exporte mais dados pessoais do que o necessário.
1
Abra Chat History
Clique em Chat History na barra lateral.
Resultado esperado: Filtros de conversa, estatísticas e a lista de transcrições ficam visíveis.
2
Pesquisar e filtrar
Filtre por bot, canal, modo, visitante ou intervalo de datas.
Resultado esperado: Somente conversations correspondentes permanecem visíveis.
3
Abra uma transcrição
Clique em uma conversa para ler o tópico completo da mensagem.
Resultado esperado: O contexto completo, os detalhes do contato e os metadados da conversa ficam visíveis.
4
Exportar conversations
Clique em Exportar e escolha o formato necessário, se disponível.
Resultado esperado: A exportação contém os dados de conversa filtrados.
5
Abrir Contatos
Clique em Contatos na barra lateral.
Resultado esperado: Os registros de lead/contato aparecem com origem, bot e status.
6
Filtrar e exportar contatos
Pesquise contatos, selecione os registros desejados e exporte ou sincronize para SendPulse.
Resultado esperado: Os contatos selecionados ficam disponíveis fora de sem.chat de acordo com a ação escolhida.
Como testar: Exporte um pequeno CSV filtrado e abra-o localmente para confirmar se as colunas e o intervalo de datas estão corretos.
Problema
Correção
Contato ausente em Contatos
Confirme se a captura de leads está habilitada e se o visitante enviou o formulário.
A exportação é muito grande
Limite o intervalo de datas ou filtro de bot antes de exportar.
SendPulse sincronização indisponível
Conecte SendPulse primeiro em Integrações e depois retorne para Contatos.
O que fazer a seguir: Revise o Analytics para entender as tendências de desempenho após a execução das operações.
08
Canais e integrações
Conecte Slack, Facebook, Instagram, WhatsApp, Telegram por meio de BotFather, credenciais manuais, links alternativos chat, integrações SendPulse e CRM.
/integraçõesCanais, CRM e conexões de e-mail
1Escolha o canal ou cartão de integração CRM.
2Siga as etapas de OAuth ou de credenciais para cada provedor.
3Desconecte ou teste novamente as integrações da mesma página.
Conectar canais
Conecte um canal de mensagens ou integração CRM
Para que serve isso: Use isto quando sem.chat receber conversations fora do widget do site ou enviar contatos para outras ferramentas.
Antes de começar
Tenha acesso de administrador à plataforma externa.
Saiba qual bot deve receber mensagens do canal.
Use canais de teste antes de conectar contas de produção.
1
Integrações abertas
Clique em Integrações na barra lateral.
Resultado esperado: Canais disponíveis, ferramentas CRM, SendPulse e opções de widget de site estão visíveis.
2
Escolha a integração
Clique em Conectar em Slack, Metacanais, Telegram, SendPulse, CRM ou credenciais manuais.
Resultado esperado: A caixa de diálogo de configuração ou fluxo OAuth é aberta.
3
Configuração completa do provedor
Para canais OAuth, aprove as permissões solicitadas. Para canais manuais, cole o token, segredo, ID da conta ou webhook necessário URL.
Resultado esperado: sem.chat armazena a conexão e mostra a integração como conectada.
4
Atribuir o bot
Escolha qual bot deve lidar com as mensagens desse canal quando a caixa de diálogo perguntar.
Resultado esperado: As mensagens recebidas são encaminhadas para o assistente correto.
5
Teste o canal
Envie uma mensagem de teste do canal externo.
Resultado esperado: A mensagem aparece na Caixa de entrada ou Chat History no canal correto.
6
Desconecte se necessário
Use Desconectar do cartão de integração quando o canal for interrompido.
Resultado esperado: sem.chat para de receber ou enviar por meio dessa integração.
Como testar: Envie uma mensagem de teste através do canal conectado e confirme a resposta do bot, a linha da caixa de entrada e o registro do histórico.
Problema
Correção
O token Telegram falha
Crie ou redefina o token no BotFather e cole-o novamente.
Slack mensagens não chegam
Verifique os escopos do aplicativo, assinatura do evento URL, token do bot, segredo de assinatura e associação ao canal.
A conexão do metacanal falha
Confirme se a conta Facebook/Instagram/WhatsApp tem permissões de administrador e acesso comercial necessário.
A sincronização de SendPulse falha
Reconecte SendPulse e confirme se os campos de contato estão mapeados.
O que fazer a seguir: Documente a propriedade do canal para a equipe e monitore a Caixa de entrada após o lançamento.
09
Agendamento
Crie tipos de eventos, configure a disponibilidade, conecte calendários, gerencie reservas, crie links únicos, configure e-mails de reserva, revise análises, defina eventos pagos e teste links de reservas públicas.
/agendamentoAgendamento de espaço de trabalho
1Use guias para tipos de eventos, reservas, análises, links únicos, calendários, e-mails e configurações.
2Edite, copie, incorpore, ative ou pause tipos de eventos.
3Copie o link público e execute um teste de reserva privada.
Editor de eventosConfiguração do tipo de evento
1Insira nome, descrição, duração, localização e buffers.
2Defina disponibilidade, janelas de reserva, perguntas, opções de eventos pagos e regras de cancelamento.
3Salve o evento antes de compartilhar o link.
/book/:nomedeusuário/:eventSlugPágina de reserva pública
1Os visitantes escolhem uma data na página de reserva pública.
2Os visitantes escolhem um horário disponível.
3Os visitantes confirmam a reserva e recebem e-mails de confirmação.
Tipo de evento
Crie um tipo de evento e publique um link de reserva
Para que serve isso: Use-o quando os visitantes precisarem agendar demonstrações, consultas, ligações de vendas, integração ou sessões de suporte.
Antes de começar
Escolha o nome do evento, duração, tipo de reunião e proprietário.
Defina o fuso horário e a disponibilidade antes de compartilhar links.
Conecte calendários se a reserva dupla for importante.
1
Agendamento aberto
Clique em Agendamento na barra lateral.
Resultado esperado: O espaço de trabalho de agendamento mostra guias para tipos de eventos, reservas, análises, links únicos, calendários, e-mails e configurações.
2
Crie um tipo de evento
Clique em Criar e adicione nome, descrição, duração, local, buffer e regras de reserva.
Resultado esperado: O evento possui informações públicas suficientes para que os visitantes possam entendê-lo.
3
Definir disponibilidade
Configure horários semanais, substituições de datas, janelas de aviso e janela de reserva.
Resultado esperado: Os visitantes veem apenas os horários que você está disposto a oferecer.
4
Adicionar perguntas
Adicione perguntas obrigatórias, como telefone, empresa, site ou meta da reunião.
Resultado esperado: As reservas coletam o contexto que sua equipe precisa antes da ligação.
5
Conectar calendários
Abra Calendários e conecte Google, Outlook ou iCal, se disponível.
Resultado esperado: Os horários de pico podem ser bloqueados e as reservas confirmadas podem ser gravadas no calendário.
6
Defina e-mails e lembretes
Abra e-mails e configure mensagens de confirmação, lembrete, cancelamento e reagendamento.
Resultado esperado: Os visitantes recebem a comunicação correta da reserva.
7
Compartilhe e teste o link público
Copie o link do evento, abra-o em uma janela privada, escolha um horário e conclua uma reserva de teste.
Resultado esperado: A reserva aparece na aba Reservas e mensagens de confirmação são enviadas.
Como testar: Conclua uma reserva de teste, um reagendamento e um cancelamento. Confirme se cada evento aparece em Agendamento e calendários conectados.
Problema
Correção
Nenhum horário aparece na página pública
Verifique o fuso horário, a disponibilidade semanal, as substituições de datas, a janela de aviso e os conflitos de calendário conectados.
E-mail de reserva ausente
Verifique as configurações de e-mail e a pasta de spam e envie outra reserva de teste.
Falha no pagamento em evento pago
Confirme se as configurações de integração de faturamento/pagamento e a moeda são válidas antes da publicação.
O que fazer a seguir: Incorpore links de reserva no bot, site ou e-mails de acompanhamento.
Agendamento avançado
Use links únicos, análises, incorporações e eventos pagos
Para que serve isso: Use isto quando o agendamento precisar de disponibilidade temporária, relatórios, reserva incorporada ou pagamento.
Antes de começar
Crie pelo menos um tipo de evento primeiro.
Conecte calendários antes de usar muito links únicos.
Defina a política de reembolso/cancelamento antes de ativar eventos pagos.
1
Crie um link único
Abra Links Únicos, selecione os slots ou regras oferecidos e gere o link.
Resultado esperado: O destinatário pode reservar apenas a partir da disponibilidade selecionada.
2
Incorporar agendamento
Use a opção de incorporação de cartão de evento se o fluxo de reserva aparecer em seu site.
Resultado esperado: A IU de reserva pode ser colocada na página onde os visitantes realizam a conversão.
3
Revise a análise de agendamento
Abra o Analytics dentro do Scheduling.
Resultado esperado: Você pode ver reservas, tendências de conclusão e desempenho do tipo de evento.
4
Habilitar eventos pagos
Abra o editor de eventos, defina o preço, a moeda e o comportamento de pagamento.
Resultado esperado: Os visitantes deverão completar a etapa de pagamento de acordo com a configuração do evento.
5
Reservas de auditoria
Abra reservas e analise entradas futuras, concluídas, canceladas e reprogramadas.
Resultado esperado: A equipe pode gerenciar atendimento e acompanhamento.
Como testar: Reserve através da página pública e através de uma página incorporada, se usada. Confirme se ambos criam o mesmo tipo de registro de reserva.
Problema
Correção
Link único expõe slots errados
Gere novamente o link com um conjunto de slots menor ou um intervalo de datas mais restrito.
A reserva incorporada é muito restrita
Coloque a incorporação em um contêiner de conteúdo mais amplo e verifique o layout móvel.
Analytics parece vazio
Crie ou aguarde reservas reais; a análise depende dos registros de reserva.
O que fazer a seguir: Conecte os resultados do agendamento a relatórios e análises.
10
Análises e relatórios
Escolha intervalos de datas, use datas personalizadas, leia as principais métricas, exporte CSV, revise a satisfação e as tendências de conversação, configure relatórios de e-mail e verifique a entrega.
/análisesPainel de análise
1Escolha intervalos de datas ou datas personalizadas.
2Leia métricas de conversação, satisfação, idioma, canal e conversão.
3Exporte CSV para análise offline.
Configurações/RelatóriosConfiguração do relatório por e-mail
1Escolha a cadência do relatório diário, semanal ou mensal.
2Adicione destinatários do relatório.
3Envie um relatório instantâneo para testar a entrega.
Revisão analítica
Leia análises e exporte dados de desempenho
Para que serve isso: Use isso para revisões semanais, verificações de lançamento, revisão de qualidade de suporte e análise de conversão.
Antes de começar
Escolha o período antes de ler as métricas.
Saiba qual bot ou canal você está avaliando.
Exclua datas de testes privados ao relatar o desempenho da produção.
1
Análise aberta
Clique em Analytics na barra lateral.
Resultado esperado: As métricas do painel e os painéis do gráfico ficam visíveis.
2
Escolha o período
Selecione hoje, 7 dias, 30 dias ou datas personalizadas.
Resultado esperado: Todos os gráficos são atualizados para o período selecionado.
3
Leia as principais métricas
Revise conversations, minutos de voz, satisfação, conversão e mix de canais.
Resultado esperado: Você entende o volume e a qualidade das interações com o cliente.
4
Rever tendências
Observe as tendências de conversação, mudanças de satisfação, principais perguntas e padrões de idioma/canal.
Resultado esperado: Você pode identificar onde melhorar as instruções ou a equipe do bot.
5
Exportar CSV
Use Exportar CSV quando a equipe precisar de análise de planilha.
Resultado esperado: O CSV contém o período e as métricas selecionados.
6
Transforme descobertas em mudanças
Atualize instruções do bot, conhecimento, configurações de widget ou cobertura de suporte com base nos dados.
Resultado esperado: A análise leva a melhorias concretas no produto.
Como testar: Exporte uma pequena data personalizada CSV e verifique se o intervalo de datas e as métricas correspondem ao que o painel mostra.
Problema
Correção
As métricas parecem muito altas
Verifique se a preparação/teste conversations está incluída no período selecionado.
A satisfação está vazia
Ative as avaliações nas configurações do widget e espere que os visitantes deixem as avaliações.
Os minutos de voz não correspondem às expectativas
Confirme se o modo de voz está ativado apenas nos bots pretendidos.
O que fazer a seguir: Agende relatórios por e-mail para visibilidade recorrente.
Relatórios
Configure relatórios de e-mail recorrentes e teste a entrega
Para que serve isso: Use isto quando proprietários, gerentes ou clientes precisarem de resumos automáticos de desempenho.
Antes de começar
Decida quem deve receber relatórios.
Use endereços de e-mail verificados.
Escolha uma cadência que corresponda aos ritmos de revisão de negócios.
1
Abra Configurações e depois Relatórios
Vá para Configurações e selecione a guia Relatórios ou use o redirecionamento de Relatórios, se disponível.
Resultado esperado: A cadência do relatório, os destinatários e o histórico são visíveis.
2
Escolha a cadência
Ative relatórios diários, semanais ou mensais.
Resultado esperado: A programação do relatório é armazenada para a área de trabalho.
3
Adicionar destinatários
Insira os endereços de e-mail que devem receber relatórios.
Resultado esperado: Os relatórios são enviados às partes interessadas corretas.
4
Envie relatório instantâneo
Clique em Enviar agora ou ação de relatório instantâneo equivalente.
Resultado esperado: Um e-mail de relatório é enviado imediatamente para verificação.
5
Revise o histórico do relatório
Verifique o painel de histórico após o envio dos relatórios.
Resultado esperado: Você pode confirmar o status e o prazo da entrega.
Como testar: Envie um relatório instantâneo para um destinatário de teste e confirme o recebimento e a formatação.
Problema
Correção
E-mail de relatório não chega
Verifique a ortografia do destinatário, a pasta de spam e o status do histórico de relatórios.
Pessoas erradas recebem denúncias
Atualize os destinatários e salve antes do próximo envio agendado.
O conteúdo do relatório parece barulhento
Ajuste as expectativas do intervalo de datas e use o Analytics para uma revisão manual mais aprofundada.
O que fazer a seguir: Use a cadência do relatório como ritmo operacional para melhorias no bot.
Inicie ou atualize planos, gerencie o portal de cobrança, convide colegas de equipe, defina funções, edite perfil/idioma, configure notificações, habilite 2FA, use ações de zona de perigo e execute o fluxo de trabalho do afiliado.
/faturamentoControles de planejamento e faturamento
1Revise o plano atual, o estado de teste e os limites usage.
2Compare os recursos do plano antes de atualizar.
3Abra o portal de cobrança para faturas, formas de pagamento, cancelamento ou reativação.
/configuraçõesConfigurações, equipe e segurança
1Use Geral para perfil e idioma.
2Use Equipe para convites e funções.
3Use segurança para 2FA, chaves API e ações de zona de perigo.
/afiliadoControles do programa de afiliados
1Participe do programa para criar um link de referência.
2Copie o link de referência para campanhas.
3Defina o e-mail de pagamento e solicite pagamentos qualificados.
Faturamento
Iniciar, atualizar, cancelar ou reativar um plano
Para que serve isso: Use isto quando o espaço de trabalho precisar de ativação de avaliação, mais limites, faturas, atualizações de pagamento ou alterações de assinatura.
Antes de começar
O proprietário da conta ou administrador de cobrança deve realizar ações de cobrança.
Confirme quais recursos são planejados: voz, vozes clonadas, avatares personalizados, API, equipe, CRM e canais.
Use o portal de cobrança seguro para alterações na forma de pagamento e na fatura.
1
Abrir faturamento
Clique em Faturamento na barra lateral.
Resultado esperado: O plano atual, o estado de avaliação, os limites usage e os cartões de plano ficam visíveis.
2
Comparar planos
Revise chat, voz, equipe, API, avatar, integração, agendamento e limites de suporte.
Resultado esperado: Você sabe qual plano desbloqueia o recurso necessário.
3
Escolha o intervalo de cobrança
Selecione mensalmente ou anualmente se a alternância estiver disponível.
Resultado esperado: Atualização de preços e economia para o intervalo selecionado.
4
Atualize ou inicie a finalização da compra
Escolha o plano desejado e finalize a compra.
Resultado esperado: A assinatura fica ativa após a confirmação do pagamento.
5
Abra o portal do cliente
Use o portal de cobrança para forma de pagamento, faturas, cancelamento ou reativação.
Resultado esperado: Ações de cobrança confidenciais acontecem no portal seguro do provedor.
6
Verifique o acesso ao recurso
Volte ao recurso que estava bloqueado e recarregue o aplicativo.
Resultado esperado: O recurso desbloqueado agora está disponível se o plano o incluir.
Como testar: Após a atualização, abra o recurso bloqueado anteriormente, como clone de voz ou teclas API, e confirme que o bloqueio foi removido.
Problema
Correção
O recurso permanece bloqueado após a atualização
Atualize o aplicativo, aguarde um momento pela sincronização da assinatura e verifique Cobrança novamente.
A finalização da compra foi cancelada
Volte para Faturamento e reinicie a finalização da compra; nenhuma mudança de plano acontece após um checkout cancelado.
Precisa de fatura ou alteração de cartão
Abra o portal do cliente em vez de editar os detalhes de pagamento dentro do aplicativo.
O que fazer a seguir: Convide colegas de equipe e proteja a conta do proprietário.
Equipe e segurança
Convide colegas de equipe, defina funções, edite perfis, habilite 2FA e gerencie configurações
Para que serve isso: Use isto quando o espaço de trabalho passar da configuração individual para a operação em equipe.
Antes de começar
Conheça a função de cada colega de equipe antes de enviar convites.
Use o acesso com privilégios mínimos: Proprietário, Administrador, Editor, Visualizador.
Tenha um aplicativo autenticador pronto para 2FA.
1
Abra Configurações
Clique em Configurações na barra lateral.
Resultado esperado: Geral, notificações, equipe, relatórios, desenvolvedores, segurança e guias relacionadas são visíveis.
2
Editar perfil e idioma
Atualize o nome de exibição, as informações do perfil e o idioma preferido em geral.
Resultado esperado: O aplicativo identifica o usuário corretamente e usa o idioma escolhido quando disponível.
3
Convide membros da equipe
Abra Equipe, insira um e-mail, escolha uma função e envie o convite.
Resultado esperado: O colega de equipe recebe um link de convite e aparece como pendente até ser aceito.
4
Definir permissões de função
Use Proprietário para controle total, Administrador para gerenciamento, Editor para alterações de conteúdo e Visualizador para acesso somente leitura.
Resultado esperado: Cada usuário tem acesso adequado à sua responsabilidade.
5
Configurar notificações
Escolha notificações por e-mail, navegador, push, suporte ao vivo, cobrança e relatório.
Resultado esperado: As pessoas certas recebem alertas sem ruídos desnecessários.
6
Habilitar 2FA
Abra o Security, habilite a autenticação de dois fatores, escaneie o código e armazene os detalhes da recuperação.
Resultado esperado: A conta requer um segundo fator após o login com senha.
7
Use as ações na zona de perigo com cuidado
Exporte os dados necessários e confirme widgets/integrações ativos antes de ações destrutivas na conta.
Resultado esperado: O espaço de trabalho evita perda acidental de dados.
Como testar: Convide um colega de equipe de teste, aceite o convite em um navegador separado e confirme se a função expõe apenas os recursos pretendidos.
Problema
Correção
E-mail de convite ausente
Verifique o spam, reenvie o convite e verifique o endereço.
Colega de equipe vê demais
Reduza sua função e revise as configurações de acesso do bot.
A configuração 2FA falha
Verifique a hora do dispositivo, verifique novamente o código QR e armazene os detalhes da recuperação antes de confiar nele.
O que fazer a seguir: Configure chaves API apenas para usuários e serviços que precisam delas.
Afiliado
Junte-se ao afiliado, copie o link de referência, defina o e-mail de pagamento e solicite o pagamento
Para que serve isso: Use isto quando um parceiro ou cliente quiser indicar novos usuários sem.chat e rastrear atividades de comissões.
Antes de começar
Use a conta que deve possuir a atribuição de referência.
Prepare o e-mail de pagamento antes de solicitar o pagamento.
Verifique as regras do programa antes de publicar campanhas de referência.
1
Afiliado aberto
Clique em Afiliado na barra lateral ou abra a guia de afiliado em Configurações, se estiver vinculado a ela.
Resultado esperado: A página do programa de afiliados mostra as áreas de adesão, referência, pagamento e histórico.
2
Participe do programa
Clique em Ingressar se a conta ainda não tiver ingressado.
Resultado esperado: Um código de referência e um link de referência são criados.
3
Copiar link de referência
Copie o link exclusivo e use-o em conteúdo, campanhas ou mensagens de parceiros.
Resultado esperado: As inscrições através do link podem ser atribuídas à conta de afiliado.
4
Definir e-mail de pagamento
Digite o e-mail de pagamento e salve-o.
Resultado esperado: Os pagamentos elegíveis podem ser encaminhados corretamente.
5
Revise referências e comissões
Verifique a lista de referências, o status da comissão e o histórico de pagamentos.
Resultado esperado: Você sabe o que está pendente, elegível ou já pago.
6
Solicitar pagamento
Clique em Solicitar pagamento quando as regras e os mínimos do programa forem atendidos.
Resultado esperado: A solicitação de pagamento é registrada para processamento.
Como testar: Abra o link de referência em um navegador privado e confirme se ele chega ao fluxo de inscrição esperado com rastreamento de referência.
Problema
Correção
O link de referência está faltando
Participe do programa primeiro ou atualize a página de afiliados após ingressar.
Solicitação de pagamento indisponível
Verifique o limite mínimo de pagamento, o estado da comissão elegível e o e-mail de pagamento.
Referência não atribuída
Confirme se o visitante usou o link de referência exato e não retirou os parâmetros de rastreamento.
O que fazer a seguir: Use análises e relatórios para monitorar o impacto referido no cliente, se aplicável.
12
Notificações e App Updates
Revise alertas, marque notificações como lidas, filtre eventos importantes e use atualizações de aplicativos para entender novas alterações de produtos.
/notificaçõesCentral de notificações
1Use Marcar tudo como lido após revisar alertas não lidos.
2Filtre por não lidos, cobrança, suporte ao vivo ou eventos do sistema.
3Abra o recurso relacionado após ler o alerta.
/atualizações de aplicativosFeed de atualizações de aplicativos
1Leia as notas de versão para novos recursos e correções.
2Use detalhes para treinar colegas de equipe antes de mudanças no fluxo de trabalho.
3Verifique as atualizações depois de perceber mudanças na interface do usuário ou no comportamento.
Notificações
Revise notificações e aja de acordo com alertas
Para que serve isso: Use-o quando o aplicativo relatar transferências, estado de cobrança, eventos do sistema, entrega de relatórios ou atividades importantes no espaço de trabalho.
Antes de começar
Certifique-se de que as preferências de notificação estejam definidas em Configurações.
Tenha cobertura de suporte ao vivo se os alertas de transferência estiverem ativados.
Revise os alertas não lidos antes de marcá-los como lidos.
1
Abrir notificações
Clique em Notificações na barra lateral ou na entrada de notificação do cabeçalho do aplicativo.
Resultado esperado: A central de notificações lista alertas recentes.
2
Filtrar alertas
Use filtros não lidos ou de categoria para se concentrar em faturamento, suporte ao vivo, bot, relatório ou eventos do sistema.
Resultado esperado: Apenas os alertas correspondentes permanecem visíveis.
3
Abra a página relacionada
Clique no alerta ou use seu contexto para abrir Faturamento, Live Support, Relatórios ou o bot relevante.
Resultado esperado: Você age de acordo com a notificação em vez de apenas lê-la.
4
Marcar como lido
Marcar um único alerta como lido ou usar Marcar todos como lidos após revisão.
Resultado esperado: A contagem de itens não lidos cai e os itens revisados não são mais destacados.
5
Ajustar preferências
Abra Configurações, Notificações se chegarem muitos ou poucos alertas.
Resultado esperado: O fluxo de notificação corresponde às necessidades da equipe.
Como testar: Crie um evento de teste seguro, como uma solicitação de suporte ao vivo ou um relatório instantâneo, e confirme se a notificação aparece e pode ser marcada como lida.
Problema
Correção
Nenhuma notificação chega
Verifique as configurações de preferências de notificação, permissão do navegador e se o evento realmente aconteceu.
Muitos alertas
Desative categorias barulhentas ou envie-as apenas para os membros responsáveis da equipe.
A contagem de não lidos parece travada
Atualize o aplicativo depois de marcar todos os filtros lidos e confirme se não estão ocultando itens não lidos.
O que fazer a seguir: Revise App Updates quando mudanças de comportamento ou novos controles aparecerem.
Atualizações de aplicativos
Use atualizações de aplicativos para entender as alterações do produto
Para que serve isso: Use isso quando os colegas de equipe precisarem saber o que mudou antes de usar um novo recurso.
Antes de começar
Abra atualizações após lançamentos principais ou quando a IU for alterada.
Compartilhe notas de atualização relevantes com usuários de suporte e vendas.
Teste novamente os fluxos de trabalho críticos após grandes alterações.
1
Abra App Updates
Clique em App Updates na barra lateral.
Resultado esperado: O feed de atualização mostra novos recursos, correções e notas de versão.
2
Leia a última atualização
Abra o cartão de atualização mais recente ou a visualização detalhada.
Resultado esperado: Você vê o que mudou e qual fluxo de trabalho isso afeta.
3
Mapeie a mudança para o seu fluxo de trabalho
Identifique se a atualização afeta bots, widget, suporte, agendamento, cobrança ou desenvolvedores.
Resultado esperado: Os membros certos da equipe sabem o que verificar.
4
Testar novamente os caminhos críticos
Se a atualização afetar um fluxo de trabalho de produção, repita as etapas manuais relevantes desta documentação.
Resultado esperado: A equipe confirma que o fluxo de trabalho alterado ainda funciona.
5
Compartilhe internamente
Envie o resumo da atualização aos usuários proprietários da área afetada.
Resultado esperado: A adoção pela equipe é mais tranquila e as dúvidas de suporte diminuem.
Como testar: Após uma atualização relevante, repita o guia para o recurso afetado e confirme se as capturas de tela ou os nomes das etapas ainda correspondem.
Problema
Correção
A atualização menciona um recurso bloqueado
Abra o Faturamento para confirmar se o plano atual o inclui.
A equipe perdeu uma mudança
Adicionar revisão App Updates às rotinas de lançamento ou operações semanais.
A documentação parece obsoleta após uma atualização
Use o Guia do engenheiro para atualizar capturas de tela e etapas.
O que fazer a seguir: Mantenha a documentação pública atualizada à medida que os recursos evoluem.
13
Receitas para desenvolvedores
Gere chaves API, use autenticação x-api-key, chame endpoints baseados em ação, conecte o suporte ao vivo a um CRM, registre webhooks, verifique assinaturas e incorpore o widget no código.
Configurações/DesenvolvedoresTeclas API, início rápido e guias usage
1Gere e revogue chaves API na guia Chaves API.
2Use Quick Start para os primeiros exemplos de curl.
3Revise o uso antes de ativar a automação de alto volume.
API início rápido
Gere uma chave API e faça as primeiras chamadas API
Para que serve isso: Use isso para scripts de relatórios, aplicativos personalizados, pontes CRM, suporte externo ao vivo ou automação.
Antes de começar
Use um ambiente do lado do servidor. Não exponha as chaves API no navegador JavaScript.
Gere uma chave separada para cada integração.
Copie a chave imediatamente porque os segredos são mostrados uma vez.
1
Desenvolvedores abertos
Abra Configurações e selecione Desenvolvedores ou use o redirecionamento de Desenvolvedores, se disponível.
Resultado esperado: As guias API Chaves, Quick Start, Documentação e Uso estão visíveis.
2
Gerar uma chave
Clique em Gerar chave, atribua um rótulo claro e copie-o imediatamente.
Resultado esperado: A chave começa com sk_live_ e está disponível para solicitações do lado do servidor.
3
Enviar cabeçalho x-api-key
Inclua x-api-key em cada solicitação API pública.
Resultado esperado: O API público pode autenticar a solicitação e enviá-la ao proprietário.
4
Listar bots
Chame action=list-bots para encontrar o ID do bot que você precisa.
Resultado esperado: A resposta retorna IDs de bot, nomes, estado ativo e resumo de configuração.
5
Envie uma mensagem chat
POST ação chat com botId e mensagem.
Resultado esperado: A resposta retorna informações de resposta, modelo e usage.
6
Verifique usage
Chame action=usage antes de executar trabalhos de alto volume.
Resultado esperado: Você conhece o plano atual e o estado usage antes da execução da automação.
7
Gire as teclas quando necessário
Revogue chaves não utilizadas e gere novas para fornecedores ou serviços alterados.
Resultado esperado: Os serviços antigos não podem continuar usando credenciais obsoletas.
Como testar: Execute list-bots e chat em um terminal local ou ambiente de servidor e confirme se a conversa aparece em Chat History se chat foi enviado.
Problema
Correção
401 ou resposta não autorizada
Verifique a ortografia de x-api-key, copie a chave completa e confirme se ela não foi revogada.
Bot não encontrado
Use list-bots novamente e confirme se o bot pertence ao proprietário da chave API.
Problema de CORS do navegador
Mova a chamada API para seu back-end; As chaves API destinam-se ao uso no servidor.
O que fazer a seguir: Use /api-docs para referência de endpoint focada e mantenha esta página como orientação de fluxo de trabalho.
Listar bots
curl -X GET "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api?action=list-bots" \
-H "x-api-key: sk_live_your_key_here"
Envie uma mensagem chat
curl -X POST "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api" \
-H "x-api-key: sk_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"action": "chat",
"botId": "YOUR_BOT_ID",
"message": "What can you help me with?"
}'
Ponte CRM com suporte ao vivo
Pesquise ou envie solicitações de suporte ao vivo para um CRM
Para que serve isso: Use isto quando os agentes trabalham em outro sistema, mas sem.chat recebe a conversa do visitante.
Antes de começar
Crie uma chave API dedicada nomeada para a ponte CRM.
Decida se a votação ou os webhooks se adequam à sua infraestrutura.
Certifique-se de que CRM armazene IDs de conversa para respostas/resoluções futuras.
1
Listar transferências em espera
GET ação=live-support-list com status=solicitado ou status=todos.
Resultado esperado: O CRM recebe conversations aberto exigindo atenção humana.
2
Buscar mensagens
GET ação=live-support-messages com conversationId.
Resultado esperado: O CRM possui contexto completo do thread e detalhes do visitante.
3
Reivindique antes de responder
POST ação=live-support-claim.
Resultado esperado: sem.chat marca a conversa como tratada ativamente.
4
Enviar resposta do agente
POST ação=live-support-reply com conversationId, mensagem e agentName.
Resultado esperado: O visitante recebe a resposta humana e as atualizações do tópico.
5
Resolver ou devolver
POST action=live-support-resolve com resolução, resolução ou devolução.
Resultado esperado: A conversa sai da fila de espera ou a IA retoma o controle.
6
Status do registro em CRM
Armazene o status de transferência mais recente, o ID da mensagem e os carimbos de data/hora.
Resultado esperado: CRM e sem.chat permanecem auditáveis.
Como testar: Crie uma transferência segura, espelhe-a em CRM, responda da ponte e confirme as atualizações do thread do visitante.
Problema
Correção
Tickets CRM duplicados
Use conversationId como chave de idempotência em sua ponte CRM.
As respostas chegam fora de ordem
Armazene carimbos de data/hora de mensagens e evite respostas simultâneas de vários sistemas.
A IA responde enquanto o agente está trabalhando
Reivindique a transferência primeiro e só devolva quando o agente terminar.
O que fazer a seguir: Registre webhooks se a pesquisa for muito lenta ou muito cara.
Webhooks
Registre webhooks e verifique X-SemChat-Signature
Para que serve isso: Use isto quando seu sistema precisar de eventos em tempo real para transferências, mensagens e atualizações de resolução.
Antes de começar
O webhook URL deve ser HTTPS e acessível pela Internet pública.
Armazene o segredo do webhook imediatamente; é mostrado uma vez.
Verifique as assinaturas antes de processar eventos.
1
Registre o webhook
POST ação webhook-register com URL e eventos.
Resultado esperado: A resposta inclui detalhes do webhook e um segredo de assinatura único.
2
Guarde o segredo
Salve o segredo em seu ambiente de servidor ou gerenciador de segredos.
Resultado esperado: Entregas futuras podem ser verificadas.
3
Verifique a assinatura
Leia X-SemChat-Signature e compare-o com um HMAC SHA-256 no corpo bruto da solicitação.
Resultado esperado: Somente entregas sem.chat genuínas são aceitas.
4
Lidar com novas tentativas de forma idempotente
Use o ID do evento ou o ID da conversa/mensagem para evitar processamento duplicado.
Resultado esperado: As novas tentativas não criam registros CRM duplicados.
5
Listar webhooks
GET ação webhook-list para auditar endpoints configurados.
Resultado esperado: Você pode ver URLs, eventos, estado ativado e estado de entrega recente.
6
Excluir webhooks obsoletos
POST ação webhook-delete com ID do webhook.
Resultado esperado: Os endpoints antigos param de receber eventos.
Como testar: Registre um endpoint de teste, acione um evento de suporte ao vivo, verifique a assinatura e confirme se seu manipulador retorna 2xx.
Problema
Correção
A assinatura não corresponde
Use o corpo bruto, não analisado JSON, e confirme o segredo do webhook correto.
Webhook não recebe eventos
Confirme se a lista de eventos inclui o evento que você está testando e se o endpoint é HTTPS.
Tempo limite do webhook
Reconheça rapidamente e processe trabalhos longos de forma assíncrona.
O que fazer a seguir: Vincule os engenheiros a /api-docs para obter detalhes e exemplos de endpoint.
Para que serve isso: Use isto ao escolher a ação certa para um recurso.
Antes de começar
Cada solicitação usa a mesma função de API pública URL.
As ações GET usam parâmetros de consulta. As ações POST usam o corpo JSON.
Envie x-api-key em todas as solicitações.
Como testar: Chame usage e list-bots como um teste de fumaça após qualquer alteração de chave ou endpoint de API.
Problema
Correção
Incompatibilidade de método
Use o método mostrado na tabela de endpoints. Algumas ações são somente GET ou somente POST.
Valor obrigatório ausente
Verifique botId, conversationId, ID do webhook e ortografia da ação.
O que fazer a seguir: Use Quick Start para as primeiras solicitações e depois /api-docs para a referência completa.
Método
Ação
Objetivo
GET
list-bots
Liste todos os bots disponíveis para o proprietário da chave API.
GET
get-bot
Busque uma configuração de bot por ID de bot.
POST
chat
Envie uma mensagem de visitante para um bot e retorne a resposta da IA.
GET
conversations
Lista conversations recente para um bot, até 100 registros.
GET
usage
Plano de retorno, créditos, contagem de bots, conversations e API chave usage.
GET
live-support-list
Lista conversations aguardando ou tratada por um agente humano.
GET
live-support-messages
Obtenha um tópico de transferência com mensagens e informações do visitante.
POST
live-support-reply
Envie uma resposta de agente humano de um sistema externo.
POST
live-support-claim
Reivindique uma conversa de transferência em espera.
POST
live-support-resolve
Resolva a transferência ou devolva o controle à IA.
POST
webhook-register
Registre um endpoint de webhook HTTPS.
GET
webhook-list
Liste registros de webhook sem retornar segredos.
POST
webhook-delete
Exclua um registro de webhook por ID.
14
Guia do engenheiro: adicionar recursos
Adicione rotas, navegação no painel, configurações do criador de bot, tabelas/funções/migrações Supabase, documentos API, documentação pública, verificações de SEO e verificação local.
Fluxo de trabalho de recursos do aplicativo
Adicione uma rota de aplicativo, página, item de navegação e entrada de documentos
Para que serve isso: Use isto ao adicionar um novo recurso de painel voltado para o cliente.
Antes de começar
Crie um branch antes de editar.
Identifique se o recurso pertence ao repositório de aplicativos ou ao repositório de front-end público sem.chat.
Inspecione os padrões existentes de rota, barra lateral, i18n e configurações antes de adicionar uma nova estrutura.
1
Adicione a rota
Atualize src/App.tsx com uma rota protegida para páginas de clientes ou uma rota pública somente quando a página precisar ser pública.
Resultado esperado: O URL é resolvido no aplicativo sem atingir o NotFound.
2
Crie ou atualize o componente da página
Use padrões de página existentes, carregamento de dados, estados vazios, estados de carregamento e permissões.
Resultado esperado: O recurso se comporta de forma consistente com o painel.
3
Adicionar navegação no painel
Atualize a barra lateral/fonte de navegação com rótulo, ícone, rota e portas de plano, se necessário.
Resultado esperado: Os usuários podem descobrir a nova página no shell do aplicativo.
4
Adicionar guia ou configuração do bot-builder
Se o recurso pertencer a um bot, adicione-o nas guias Bot Builder e persista-o por meio dos fluxos de salvamento existentes.
Resultado esperado: A configuração específica do bot é salva com o bot, e não fica presa no estado local.
5
Adicionar alterações de esquema/função Supabase
Crie migrações para tabelas/políticas e funções de borda para trabalho no servidor.
Resultado esperado: O comportamento do banco de dados e do servidor pode ser implantado repetidamente.
6
Atualize a forma API se for pública
Adicione ou estenda o tratamento de ações em supabase/functions/public-api/index.ts e documente o comportamento x-api-key.
Resultado esperado: As integrações podem usar o recurso com segurança.
7
Atualizar documentos de aplicativos e documentação pública
Atualize os documentos do desenvolvedor no aplicativo e esta página de documentação com capturas de tela e etapas clique a clique.
Resultado esperado: Usuários e engenheiros veem o recurso em ambos os lugares.
8
Executar verificações
Execute testes/construção de aplicativos, otimizador de SEO no site público, verificações de mapa do site e verificação do navegador.
Resultado esperado: O recurso funciona localmente e o site público permanece rastreável.
Como testar: Abra a nova rota, use o recurso de ponta a ponta, inspecione erros de console/rede e verifique quaisquer alterações no banco de dados na IU.
Problema
Correção
A rota funciona, mas a navegação não destaca
Verifique a correspondência de rotas da barra lateral e os caminhos de redirecionamento.
Os dados funcionam localmente, mas não são implantados
Confirme a migração, as políticas RLS e as variáveis de ambiente da função de borda.
Documentos públicos ausentes no mapa do site
Execute o otimizador de SEO e inspecione sitemap.xml para o URL canônico.
O que fazer a seguir: Capture ou gere novamente capturas de tela da documentação sempre que a IU for alterada.
Fluxo de trabalho de manutenção de documentos
Atualizar esta página de documentação pública após alterações no produto
Para que serve isso: Use isto quando capturas de tela, fluxos de trabalho, comportamento API ou alterações de navegação.
Antes de começar
Use apenas dados de demonstração seguros.
Nunca exponha clientes reais, e-mails, detalhes de pagamento, chaves API ou conversations privados.
Atualize primeiro o manual em inglês e depois atualize cada página de documentação localizada antes das verificações de SEO.
1
Audite a rota alterada
Abra a rota do aplicativo e identifique o que mudou visual e processualmente.
Resultado esperado: Você sabe quais linhas de guia, captura de tela e solução de problemas precisam de edição.
2
Capture ou gere uma captura de tela segura
Use um espaço de trabalho de demonstração e mascare segredos antes de salvar ativos WebP em ativos/documentação.
Resultado esperado: A captura de tela é precisa e segura para publicação.
3
Atualizar o guia
Edite as seções relevantes Para que serve, Antes de começar, Etapas, Resultados esperados, Teste, Solução de problemas e Próximas.
Resultado esperado: O guia informa aos usuários o que clicar e o que deve acontecer após cada clique.
4
Atualize a navegação, se necessário
Adicione a seção ao índice fixo, ao seletor de seção móvel e ao índice visual se for uma página principal.
Resultado esperado: Os leitores podem encontrar o novo conteúdo rapidamente.
5
Execute ferramentas de SEO
Execute node tools/seo-optimize-static-pages.js e node tools/seo-optimize-static-pages.js --check.
Resultado esperado: A saída canônica, de metadados, de mapa do site e de robôs permanece correta.
6
Execute verificações de limpeza e comparação
Execute node tools/static-translation-cleanup.js --audit e git diff --check.
Resultado esperado: As traduções estáticas e os espaços em branco estão limpos.
7
Verificação do navegador
Servir o site localmente e testar/documentação em desktop e dispositivos móveis.
Resultado esperado: As imagens são carregadas, a pesquisa funciona, os botões de cópia funcionam, os destaques do sumário e o layout não se sobrepõe ao banner do cookie.
Como testar: Procure o nome do recurso alterado em /documentation e confirme se o bloco de guia correto aparece.
Problema
Correção
Os marcadores de captura de tela flutuam no celular
Mantenha os marcadores dentro da imagem da captura de tela ou use coordenadas de marcador responsivas.
Pesquisa perde o novo guia
Adicione palavras-chave úteis ao título dos dados e inclua os termos exatos do produto que os usuários procuram.
A documentação localizada fica desatualizada
Depois de editar o manual em inglês, atualize cada página de documentação localizada, execute novamente o otimizador de SEO e confirme que sitemap.xml inclui todos os URLs de documentação.
O que fazer a seguir: Confirme a página de documentos, ativos, links de cabeçalho/rodapé, .htaccess e alterações no mapa do site juntos.
Precisa da referência API focada?
A página /api-docs mais antiga permanece disponível para detalhes de API no nível do endpoint.