Doost Doost

Manual do Usuário

Versão: v0.1 Atualizado em 29/08/2025

Widget de Chat (embed)

Incorpore o assistente virtual no seu site com um único script. A conversa é mantida entre páginas e o widget envia o contexto da página (URL/título) para atender melhor.

<script
  src="https://SEU-DOMINIO/webchat/public/embed.js"
  data-company-id="COMPANY_ID"
  data-chatbot-id="CHATBOT_ID"
  data-position="bottom-right"
  defer
></script>

Atributos

  • data-position: bottom-right | bottom-left | top-right | top-left
  • data-width / data-height: tamanho da janela
  • data-base-url: base do app (opcional)
  • data-open ou data-auto-open: "true" para abrir automaticamente

Experiência do usuário

  • Texto sempre alinhado à esquerda (desktop e mobile)
  • Placeholder no celular: “Digite aqui...”
  • Foco automático no campo ao abrir
  • Emojis nativos (Apple/Segoe/Noto Color Emoji)
  • Exibe “Atendimento 24/7” no cabeçalho

Sessão persistente

  • Cria um sid estável por assistente e salva em localStorage
  • O sid é enviado ao widget para manter a mesma conversa entre páginas
  • Se o chat estava aberto, reabre automaticamente após navegar; fecha apenas quando você clica em “fechar”

Contexto da página

  • Envia URL e título da página ao widget (querystring)
  • Reenvia contexto via postMessage quando a URL muda (inclusive SPA)
  • O agente pode usar isso para responder com mais precisão ao contexto da página
Privacidade: o contexto enviado não inclui cookies nem dados sensíveis. O agente deve tratar esse contexto como informação privada, sem expor ao usuário salvo solicitação.

Bem-vindo(a) à plataforma Doost. Este manual reúne as principais funcionalidades disponíveis para empresas e seus times. Recursos exclusivos do Super Admin (como configurações avançadas da plataforma e gerenciamento de planos internos) não estão descritos aqui.

Funcionalidades

  • Dashboard: visão geral rápida. Acesse em /dashboard.
  • Assistentes Virtuais: crie e gerencie assistentes nos modos DooGPT, Sistema LLM, Dify ou Humano. Acesse em /chatbots.
  • Doost Sites: gere e gerencie sites com base em IA e presets. Acesse em /sites (alguns recursos requerem plano PRO).
  • Gerenciamento de Empresas: visualizar/editar sua empresa (para administradores). Acesse em /companies (escopo da sua empresa).
  • Gerenciamento de Usuários: convide, edite e gerencie permissões do time (administrador/gerente). Acesse em /users.
  • Estatísticas: métricas de conversas, bots e sites. Acesse em /stats.
  • Avaliações: acompanhe satisfação de atendimentos. Acesse em /ratings.
  • Formulários: acompanhe o módulo inicial de formulários (MVP). Acesse em /forms.
  • Suporte: central de ajuda e contato. Acesse em /support.

Assistentes Virtuais

  • Escolha o modo: DooGPT, Sistema LLM, Dify ou Atendimento Humano.
  • Configure identidade: nome do agente, cores, ícone/avatar.
  • Personalize mensagens: boas-vindas, placeholder, encerramento.
  • Integração com LLMs e Dify quando aplicável (endpoint/chave/modelo).
  • Embed fácil: use o public/embed.js para inserir no seu site.
Dica: crie diferentes bots para diferentes páginas/segmentos e compare resultados nas métricas.

DooGPT, Sistema LLM e Dify — quando usar cada um

DooGPT (LLM próprio da Doo)

  • Infra e modelos gerenciados pela Doo, com foco em simplicidade, desempenho e custo previsível.
  • Sem necessidade de chave externa: escolha apenas o Plano/Modelo interno.
  • Indicado para a maioria dos casos de atendimento e FAQ com baixa latência.
  • Boas opções de modelos eficientes (ex.: famílias 7–9B) com qualidade/velocidade equilibradas.

Sistema LLM (provedores externos)

  • Conecta com provedores como OpenAI ou Gemini usando sua API Key.
  • Você escolhe o modelo (ex.: focado em qualidade, velocidade, multimodalidade ou custo).
  • Custo por token: varia por provedor e modelo; em geral, tokens de saída custam mais que os de entrada. Modelos maiores e multimodais tendem a ser mais caros.
  • Use quando precisar de um modelo específico, recursos avançados do provedor ou compliance próprio.

Dify (orquestrador de IA)

  • Plataforma de construção orquestrada de apps de IA (workflows, ferramentas, memórias, RAG).
  • Integração via endpoint/chave do seu projeto Dify para usar fluxos prontos no chatbot.
  • Indicado para lógicas complexas, integração com bases de conhecimento e pipelines de IA.
  • Custos dependem do LLM subjacente e do uso do seu projeto Dify.
Dica de custo: para controlar gastos, reduza comprimento das respostas, use modelos mais eficientes, e configure limites de tokens máximos por resposta. Meça e ajuste.

Passo a passo: Criar um Assistente Virtual

  1. Acesse /chatbots.
  2. Clique no botão Novo Assistente (canto superior direito).
  3. Preencha o formulário:
    • Nome: como o assistente será identificado (ex.: "Assistente do Site").
    • Modo:
      • DooGPT (recomendado): usa modelos internos otimizados. Selecione o Plano (ex.: llama-3.1-8b-instant ou gemma2-9b-it).
      • Sistema LLM: escolha Provider (OpenAI / Gemini), o Modelo (ex.: gpt-4o-mini, gemini-1.5-flash) e informe sua API Key.
      • Dify: modo para integrar sua própria instância Dify.
      • Humano: roteamento direto para atendimento humano (sem IA).
  4. Clique em Criar.
  5. (Opcional) Personalize a identidade clicando em Personalizar no card do assistente:
    • Nome do Agente, Cores, Ícone e Avatar.
    • Posição do widget: inferior direita ou inferior esquerda.
    • Placeholder do input e efeito de pulso do botão.
  6. (Opcional) Ajuste mensagens e integrações em Ajustes:
    • Mensagem de Boas‑vindas e Despedida.
    • Dify API URL e API Key (se usar Dify).
  7. (Opcional) Pré-visualize o assistente com Pré‑visualizar e faça testes rápidos.
  8. Para publicar no seu site, clique em Obter script e copie o snippet. Cole antes do fechamento de </body> no seu site.

Observação: você pode Ativar/Desativar o bot a qualquer momento pelo botão no card.

Passo a passo: Gerar um Site

  1. Acesse /sites.
  2. No passo 1) Selecione um site ou crie um novo:
    • Para criar, clique em Novo Site e preencha o modal:
      • Título e Slug (ex.: produtox).
      • Empresa (opcional, se você gerencia várias).
      • Cores primária/secundária.
      • Logo (upload opcional).
      • URL para coletar (opcional) e Briefing (prompt) com instruções.
      • Embeds opcionais: Script do Chatbot, Google Analytics, Embed de Formulários.
      • Finalize em Criar novo site.
    • Selecione um card de site para avançar ou dê duplo clique para abrir o editor.
    • Clique em Avançar (o botão muda entre “Gerar com IA” e “Gerar novamente” se já houver HTML).
  3. No passo 2) Observações/Ajustes antes de gerar:
    • Escreva Observações (ex.: menu fixo, CTA, evitar textos longos).
    • Tema do Cabeçalho: Claro, Escuro, Randômico ou Personalizado (com Cor/gradiente e Modo).
    • Recursos: Efeito Glass, Animações on‑scroll, Voltar ao topo, FAQ.
    • Use as Dicas de configuração como referência de UX/estrutura.
    • Clique em Gerar agora.
  4. Passo 3) Gerando: aguarde o carregamento. Em caso de falha, use Tentar novamente ou Cancelar.
  5. Passo 4) Pronto: clique em Ver novo site para abrir /pages/{slug} ou vá em Gerenciar sites.

Atenção: ao Gerar novamente um site já gerado, o conteúdo anterior será substituído.

Passo a passo: Gerenciar Usuários

  1. Acesse /users (requer papel Administrador ou Gerente da empresa).
  2. Use os filtros no topo: Pesquisa (nome, email, telefone) e Empresa, depois clique em Filtrar.
  3. Para adicionar alguém, clique em Novo usuário:
    • Preencha Nome, Email, Telefone (opcional) e Cargo (opcional).
    • Defina Senha inicial e selecione a Empresa.
    • Marque Ativo e selecione os Papéis permitidos (admin, gerente, atendente).
    • Clique em Cadastrar.
  4. Na lista, em Ações você pode Editar, Bloquear/Desbloquear e Excluir usuários.
  5. Ao clicar no nome do usuário, abre um modal com detalhes rápidos.
  6. Ao Editar um usuário, é possível enviar/remover Avatar, alterar dados, trocar Senha, empresa e papéis. Não esqueça de Salvar.

Observação: em planos Free, a criação/gestão de usuários pode estar limitada. Veja planos.

Passo a passo: Gerenciar Empresa

  1. Acesse /companies.
  2. Na tabela, clique em Editar para ajustar Nome e Status (Ativa/Bloqueada) e Salvar.
  3. Use Perfil para ver detalhes públicos e Ver usuários para abrir a lista filtrada dessa empresa.

Recursos como criar nova empresa, bloquear/desbloquear e excluir são privilégios do Super Admin e não estão cobertos neste manual.

Doost Sites

  • Gere páginas com IA a partir de descrições curtas do seu negócio.
  • Escolha presets de layout, paleta e componentes.
  • Gerencie conteúdo e SEO básico; publique versões rapidamente.
  • Plano PRO: desbloqueia o gerador completo e editor visual.

Acesso: /sites e gerenciamento dedicado em /sites/manage (para admins).

Empresas e Usuários

  • Empresa: nome, status, plano e informações gerais.
  • Usuários: cargos e permissões por papéis (admin, gerente, atendente).
  • Segurança: login por e-mail/senha, sessão segura e logs.
  • Boas práticas: mantenha times atualizados e desative acessos antigos.

Em breve

  • Sistema de Formulário:
    • Tipos de formulários
    • Modelo conversation
    • Presets de formulários prontos
    • Tabela de registro de pedidos do formulário
    • Visualização e gerenciamento por kanban dos formulários
    • Webhook dos formulários

Na sequência

  • Sistema de pesquisa e compra de domínio

Próxima versão

  • Sistema de criação e gerenciamento de Formulários
  • Sistema de Busca de imagens no Pixabay
  • Sistema de Geração de Imagens ChatGPT
  • Sistema de Geração de Vídeos com Veo3
  • Sistema de API
  • Sistema de Afiliado
  • No Super Admin: editar a landing page inicial com o mesmo editor

Dicas de Prompts — Websites

  • "Gere um herói de site para [setor] com headline forte, subtítulo de valor e CTA para WhatsApp."
  • "Crie uma seção de benefícios em 3 colunas para [produto/serviço], com títulos curtos e ícones sugestivos."
  • "Escreva uma seção 'Por que escolher' com 4 bullets, linguagem simples e foco em resultados mensuráveis."
  • "Sugira 5 CTAs diferentes para captação de leads em [segmento]."
  • "Gere meta title e meta description para SEO visando a palavra-chave '[keyword]' na cidade [cidade]."
  • "Monte uma página de preços com 3 planos (Starter, Pro, Enterprise) destacando o Pro."

Dicas de Prompts — Assistentes Virtuais

  • "Defina a persona do assistente: amigável, objetiva e fluente em [idioma], especialista em [tema]."
  • "Escreva mensagens de boas-vindas variando tom (formal e descontraído) e peça nome/contato após valor entregue."
  • "Crie 10 respostas rápidas para dúvidas frequentes sobre [produto/serviço]."
  • "Desenhe um fluxo de qualificação (orçamento) pedindo informações-chave em 4 passos."
  • "Liste 5 mensagens de recuperação quando o usuário não responder por 5 minutos."
  • "Sugira políticas para repasse de atendimento humano quando [condição]."
Precisa de ajuda? Visite /support ou fale com nosso time.