Manual visual passo a passo

Documentação sem.chat

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
Captura real do espaço de trabalho de demonstração sem.chat
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
Captura real do espaço de trabalho de demonstração sem.chat
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.
ProblemaCorreção
E-mail de verificação não chegaVerifique o spam, confirme a ortografia do e-mail e solicite outro e-mail de verificação.
O painel é aberto no FaturamentoO 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 trabalhoConvide-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.
ProblemaCorreção
O código incorporado não está disponívelSalve 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 erradoConfirme se data-bot-id no snippet corresponde ao ID do bot do modal Incorporado.
Nenhuma conversa aparece no históricoAtualize 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
Captura real do espaço de trabalho de demonstração sem.chat
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
Captura real do espaço de trabalho de demonstração sem.chat
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.
ProblemaCorreção
A resposta é muito genéricaAdicione conhecimentos mais específicos e reescreva as instruções com exemplos de boas respostas.
O bot recusa perguntas que deveria responderRemova instruções excessivamente rígidas e adicione conhecimento confiável para esse tópico.
Salvar não gera código incorporadoVerifique 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.
ProblemaCorreção
A resposta antiga ainda apareceAtualize 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 falhaConfirme se o e-mail do destinatário é válido e se a conta de destino pode aceitar o bot.
Excluir foi clicado por enganoPare 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
Captura real do espaço de trabalho de demonstração sem.chat
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.
ProblemaCorreção
O widget está faltandoConfirme 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 erradoCopie o snippet novamente e compare data-bot-id com o bot desejado.
O widget se sobrepõe aos controles da páginaAltere 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.

HTML incorporar
<!-- sem.chat Voice & Text Widget -->
<script
  src="https://app.sem.chat/widget-v2.js?v=16"
  data-bot-id="YOUR_BOT_ID"
></script>
Instalação da plataforma

Instalar em fluxos WordPress, React ou voz avançada SDK

Para que serve isso: Use isto quando o site for gerenciado por um CMS, aplicativo React ou integração de voz personalizada.

Antes de começar
  • Saiba qual pilha possui o layout compartilhado.
  • Use o snippet exato mostrado em sem.chat para o bot selecionado.
  • Para uso avançado de SDK, confirme se você possui a chave pública Vapi e o ID do assistente necessários.
1

Opção WordPress

Use Appearance, Theme Editor, footer.php ou um plugin confiável de cabeçalhos e rodapés.

Resultado esperado: O snippet é carregado em páginas WordPress públicas.
2

Opção React

Crie um pequeno componente ChatWidget, anexe o script em useEffect e renderize-o no layout raiz.

Resultado esperado: O widget é carregado uma vez e limpo se o layout for desmontado.
3

Opção avançada SDK

Use a guia NPM/SDK somente quando precisar de controles personalizados de chamada de voz além do widget padrão.

Resultado esperado: Seu aplicativo controla a sessão de voz enquanto sem.chat continua sendo a origem do assistente configurada.
4

Verifique o ID do bot

Confirme se o código instalado faz referência ao ID do bot do modal Incorporar.

Resultado esperado: O widget ao vivo se conecta ao assistente pretendido.
5

Verifique o console

Abra as ferramentas de desenvolvedor do navegador e recarregue.

Resultado esperado: Não há erros de script bloqueado, contêiner duplicado ou rede.
Como testar: Preencha uma mensagem de teste do site instalado e confirme se ela aparece na Caixa de entrada com a página esperada URL.
ProblemaCorreção
React carrega widgets duplicadosProteja a inserção do script com uma referência ou renderize o componente apenas no layout raiz.
WordPress remove tags de scriptUse um plugin de injeção de rodapé ou arquivo de tema que permita scripts.
A chamada SDK não pode ser iniciadaVerifique a chave pública, ID do assistente, permissões do navegador e planeje o acesso por voz.

O que fazer a seguir: Vá para as configurações do widget para controlar o comportamento, a marca e a captura de leads.

WordPress trecho de rodapé
<!-- sem.chat Widget (WordPress Compatible) -->
<script>
window.SEMCHAT_CONFIG = { botId: "YOUR_BOT_ID" };
</script>
<script src="https://app.sem.chat/widget-v2.js?v=16"></script>
Componente React
import { useEffect, useRef } from 'react';

export function ChatWidget() {
  const loaded = useRef(false);

  useEffect(() => {
    if (loaded.current) return;
    loaded.current = true;

    const script = document.createElement('script');
    script.src = 'https://app.sem.chat/widget-v2.js?v=16';
    script.setAttribute('data-bot-id', 'YOUR_BOT_ID');
    script.async = true;
    document.body.appendChild(script);

    return () => {
      const container = document.getElementById('semchat-widget-container');
      if (container) container.remove();
      script.remove();
    };
  }, []);

  return null;
}
Voz avançada SDK
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
Captura real do espaço de trabalho de demonstração sem.chat
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.
ProblemaCorreção
A cor não foi atualizadaSalve o bot, atualize o site e confirme se o widget instalado usa o mesmo ID do bot.
Os campos de lead estão faltandoConfirme se a captura de lead está habilitada e se a condição de acionamento selecionada foi atendida.
Os visitantes não podem usar vozVerifique 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
Captura real do espaço de trabalho de demonstração sem.chat
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.
ProblemaCorreção
Navegador bloqueia microfonePermita permissão de microfone no navegador e recarregue a página.
A opção de voz está bloqueadaAbra o Faturamento e confirme se o plano do espaço de trabalho inclui recursos de voz.
A transcrição está vaziaConfirme 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.
ProblemaCorreção
A qualidade do clone é ruimGrave amostras mais limpas com um alto-falante, volume estável e sem música.
O upload de avatar personalizado não está disponívelVerifique o faturamento para saber os limites de avatar limitados pelo plano.
A voz antiga ainda tocaSalve 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
Captura real do espaço de trabalho de demonstração sem.chat
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.
ProblemaCorreção
O rastreador importa páginas irrelevantesRemova essas páginas dos resultados selecionados e adicione instruções manuais mais claras.
Os preços dos produtos estão obsoletosAtualize o feed e confirme se o próprio feed URL contém os valores atuais.
Bot inventa respostasAdicione 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
Captura real do espaço de trabalho de demonstração sem.chat
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
Captura real do espaço de trabalho de demonstração sem.chat
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
Captura real do espaço de trabalho de demonstração sem.chat
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
Captura real do espaço de trabalho de demonstração sem.chat
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.
ProblemaCorreção
A resposta não é enviadaVerifique o estado da rede, o status da conversa e se o suporte ao vivo foi solicitado.
O idioma do visitante está erradoUse a tradução ou atualize as configurações de idioma do bot antes de responder.
A conversa não está na Caixa de entradaPesquise 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.
ProblemaCorreção
Agentes perdem solicitaçõesHabilite notificações por navegador/e-mail/push e adicione um processo para propriedade da fila.
A IA continua assumindo o controle muito cedoAjuste 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 sincroniaUse 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.
ProblemaCorreção
Contato ausente em ContatosConfirme se a captura de leads está habilitada e se o visitante enviou o formulário.
A exportação é muito grandeLimite o intervalo de datas ou filtro de bot antes de exportar.
SendPulse sincronização indisponívelConecte 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
Captura real do espaço de trabalho de demonstração sem.chat
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.
ProblemaCorreção
O token Telegram falhaCrie ou redefina o token no BotFather e cole-o novamente.
Slack mensagens não chegamVerifique os escopos do aplicativo, assinatura do evento URL, token do bot, segredo de assinatura e associação ao canal.
A conexão do metacanal falhaConfirme se a conta Facebook/Instagram/WhatsApp tem permissões de administrador e acesso comercial necessário.
A sincronização de SendPulse falhaReconecte 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
Captura real do espaço de trabalho de demonstração sem.chat
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
Captura real do espaço de trabalho de demonstração sem.chat
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
Captura real do espaço de trabalho de demonstração sem.chat
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.
ProblemaCorreção
Nenhum horário aparece na página públicaVerifique 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 ausenteVerifique as configurações de e-mail e a pasta de spam e envie outra reserva de teste.
Falha no pagamento em evento pagoConfirme 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.
ProblemaCorreção
Link único expõe slots erradosGere novamente o link com um conjunto de slots menor ou um intervalo de datas mais restrito.
A reserva incorporada é muito restritaColoque a incorporação em um contêiner de conteúdo mais amplo e verifique o layout móvel.
Analytics parece vazioCrie 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
Captura real do espaço de trabalho de demonstração sem.chat
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
Captura real do espaço de trabalho de demonstração sem.chat
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.
ProblemaCorreção
As métricas parecem muito altasVerifique se a preparação/teste conversations está incluída no período selecionado.
A satisfação está vaziaAtive 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 expectativasConfirme 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.
ProblemaCorreção
E-mail de relatório não chegaVerifique a ortografia do destinatário, a pasta de spam e o status do histórico de relatórios.
Pessoas erradas recebem denúnciasAtualize os destinatários e salve antes do próximo envio agendado.
O conteúdo do relatório parece barulhentoAjuste 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.

11

Faturamento, Equipe, Segurança, Configurações, Afiliado

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
Captura real do espaço de trabalho de demonstração sem.chat
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
Captura real do espaço de trabalho de demonstração sem.chat
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
Captura real do espaço de trabalho de demonstração sem.chat
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.
ProblemaCorreção
O recurso permanece bloqueado após a atualizaçãoAtualize o aplicativo, aguarde um momento pela sincronização da assinatura e verifique Cobrança novamente.
A finalização da compra foi canceladaVolte 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ãoAbra 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.
ProblemaCorreção
E-mail de convite ausenteVerifique o spam, reenvie o convite e verifique o endereço.
Colega de equipe vê demaisReduza sua função e revise as configurações de acesso do bot.
A configuração 2FA falhaVerifique 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.
ProblemaCorreção
O link de referência está faltandoParticipe do programa primeiro ou atualize a página de afiliados após ingressar.
Solicitação de pagamento indisponívelVerifique o limite mínimo de pagamento, o estado da comissão elegível e o e-mail de pagamento.
Referência não atribuídaConfirme 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
Captura real do espaço de trabalho de demonstração sem.chat
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
Captura real do espaço de trabalho de demonstração sem.chat
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.
ProblemaCorreção
Nenhuma notificação chegaVerifique as configurações de preferências de notificação, permissão do navegador e se o evento realmente aconteceu.
Muitos alertasDesative categorias barulhentas ou envie-as apenas para os membros responsáveis da equipe.
A contagem de não lidos parece travadaAtualize 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.
ProblemaCorreção
A atualização menciona um recurso bloqueadoAbra o Faturamento para confirmar se o plano atual o inclui.
A equipe perdeu uma mudançaAdicionar revisão App Updates às rotinas de lançamento ou operações semanais.
A documentação parece obsoleta após uma atualizaçãoUse 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
Captura real do espaço de trabalho de demonstração sem.chat
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.
ProblemaCorreção
401 ou resposta não autorizadaVerifique a ortografia de x-api-key, copie a chave completa e confirme se ela não foi revogada.
Bot não encontradoUse list-bots novamente e confirme se o bot pertence ao proprietário da chave API.
Problema de CORS do navegadorMova 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.
ProblemaCorreção
Tickets CRM duplicadosUse conversationId como chave de idempotência em sua ponte CRM.
As respostas chegam fora de ordemArmazene carimbos de data/hora de mensagens e evite respostas simultâneas de vários sistemas.
A IA responde enquanto o agente está trabalhandoReivindique 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.
ProblemaCorreção
A assinatura não correspondeUse o corpo bruto, não analisado JSON, e confirme o segredo do webhook correto.
Webhook não recebe eventosConfirme se a lista de eventos inclui o evento que você está testando e se o endpoint é HTTPS.
Tempo limite do webhookReconheç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.

Registrar webhook
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": "webhook-register",
    "url": "https://your-crm.example.com/semchat/webhook",
    "events": ["handoff.requested", "message.user", "handoff.resolved"]
  }'
Verifique a assinatura do webhook
import crypto from 'node:crypto';

function verifySemChatSignature(rawBody, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(rawBody)
    .digest('hex');

  return crypto.timingSafeEqual(
    Buffer.from(signature || ''),
    Buffer.from(expected)
  );
}
Mapa de pontos finais

Use o público baseado em ação API corretamente

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.
ProblemaCorreção
Incompatibilidade de métodoUse o método mostrado na tabela de endpoints. Algumas ações são somente GET ou somente POST.
Valor obrigatório ausenteVerifique 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étodoAçãoObjetivo
GETlist-botsListe todos os bots disponíveis para o proprietário da chave API.
GETget-botBusque uma configuração de bot por ID de bot.
POSTchatEnvie uma mensagem de visitante para um bot e retorne a resposta da IA.
GETconversationsLista conversations recente para um bot, até 100 registros.
GETusagePlano de retorno, créditos, contagem de bots, conversations e API chave usage.
GETlive-support-listLista conversations aguardando ou tratada por um agente humano.
GETlive-support-messagesObtenha um tópico de transferência com mensagens e informações do visitante.
POSTlive-support-replyEnvie uma resposta de agente humano de um sistema externo.
POSTlive-support-claimReivindique uma conversa de transferência em espera.
POSTlive-support-resolveResolva a transferência ou devolva o controle à IA.
POSTwebhook-registerRegistre um endpoint de webhook HTTPS.
GETwebhook-listListe registros de webhook sem retornar segredos.
POSTwebhook-deleteExclua 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.
ProblemaCorreção
A rota funciona, mas a navegação não destacaVerifique a correspondência de rotas da barra lateral e os caminhos de redirecionamento.
Os dados funcionam localmente, mas não são implantadosConfirme 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 siteExecute 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.
ProblemaCorreção
Os marcadores de captura de tela flutuam no celularMantenha os marcadores dentro da imagem da captura de tela ou use coordenadas de marcador responsivas.
Pesquisa perde o novo guiaAdicione 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 desatualizadaDepois 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.

Abra API Documentos