Documentação SellBot
Instale, configure e aproveite ao máximo seu assistente de vendas com IA.
Nesta página
1 Instalação
Instalação com um clique pela Shopify App Store
- Abra a página do SellBot na Shopify App Store.
- Clique em "Adicionar app" e aprove as permissões mínimas solicitadas pelo SellBot.
- Escolha um plano — comece no Grátis ou selecione um nível pago (Starter, Growth ou Scale). Todo plano pago começa com teste grátis de 14 dias.
- Você será direcionado para o checklist de onboarding do SellBot — leve dois minutos para concluir.
Dica: O SellBot solicita apenas read_themes, read_locales, read_products e o webhook de pedido pago. Nenhum dado de cliente, nenhum histórico de pedidos.
2 Configuração inicial
Na primeira vez que abrir o SellBot, o checklist de onboarding te guia por quatro passos rápidos:
-
1. Ative o widget
Ative ou desative o widget de chat. Você pode escolher a posição (canto inferior direito ou esquerdo) e um esquema de cores que combine com seu tema.
-
2. Sincronize seu catálogo
O SellBot puxa produtos, variantes e estoque via API da Shopify. Isso acontece automaticamente — acompanhe a barra de progresso, sem necessidade de ação.
-
3. Adicione políticas da loja (opcional)
Cole suas políticas de envio, devolução e FAQ para que a IA responda corretamente às perguntas de política. Você também pode adicionar um link para uma página FAQ externa.
-
4. Escolha um plano
O plano grátis inclui 50 chats/mês. Níveis pagos usam chaves de IA gerenciadas pelo SellBot com limite mensal maior — 500 (Starter), 3.000 (Growth) ou 10.000 (Scale). Precisa de mais? Ative o Traga-Sua-Própria-Chave na aba Avançado para usar suas próprias chaves Claude / GPT / Gemini para chats ilimitados.
3 Configurando recursos
O painel do SellBot é organizado em seis abas dentro do seu admin Shopify — sem painel externo, sem login extra.
Configuração
Ative o widget, escolha o modelo de IA e defina seus canais de transferência.
Design
Personalize cores, posição do widget, avatar e mensagem de boas-vindas.
Mensagens
Configure mensagens de boas-vindas, fallback e fora do horário. Suporta 15 idiomas.
Sistema
Adicione políticas da loja, ative Gatilhos Inteligentes, defina regras de transferência.
Caixa de Entrada
Revise cada conversa, corrija respostas erradas e marque-as para que o SellBot aprenda.
Insights
Contagem de conversas, avaliações de satisfação, receita estimada atribuída ao chat.
4 Usando suas próprias chaves de API
Em qualquer nível pago, você pode trazer suas próprias chaves de API para Anthropic, OpenAI ou Google na aba Avançado. Você paga diretamente ao provedor pelo uso, seus chats se tornam ilimitados e sua assinatura SellBot permanece fixa.
Onde obter as chaves:
- Anthropic (Claude): console.anthropic.com
- OpenAI (GPT): platform.openai.com
- Google (Gemini): aistudio.google.com
Como adicioná-las:
- Vá para SellBot admin → Configuração → Chaves de API.
- Cole cada chave no campo correspondente e clique em Salvar.
- Escolha um provedor padrão. Você pode trocar de provedor por conversa depois na Caixa de Entrada.
Segurança: As chaves são criptografadas em repouso com AES-256-GCM antes de serem gravadas no banco de dados. A chave de descriptografia permanece no servidor da aplicação e nunca é armazenada de forma persistente. Você pode rotacionar ou excluir as chaves a qualquer momento.
5 Transferência para agente humano
A transferência para agente humano preenche a lacuna quando a IA não consegue responder. Veja como funciona o fluxo:
-
1. Comprador pede um humano
Um botão "Falar com um humano" aparece após qualquer resposta de IA com baixa confiança. O comprador também pode digitar "agente" a qualquer momento.
-
2. Fallback de tempo limite
Se nenhum agente responder dentro do tempo configurado (padrão 5 minutos), o SellBot solicita o e-mail do comprador e promete um retorno — o comprador nunca fica sem resposta.
-
3. Notificação ao lojista
Você recebe um e-mail com o contexto da conversa para poder responder sem precisar acessar o Shopify, se quiser.
-
4. Responda pela Caixa de Entrada
Responda diretamente da Caixa de Entrada do SellBot. O comprador vê sua mensagem no chat ao vivo; quando terminar, a IA assume novamente.
6 Gatilhos Inteligentes
O SellBot oferece sete tipos de Gatilhos Inteligentes. Quantos você pode ativar depende do seu plano — de 1 no Grátis até ilimitados no Scale. Cada um pode ser ativado ou desativado e ajustado na aba Sistema.
Carrinho Inativo
Dispara quando o comprador tem itens no carrinho e fica inativo por 60 segundos. Oferece ajuda ou um cupom de desconto.
Tempo na Página
Dispara quando o comprador está lendo uma página de produto por mais de 45 segundos. Incentivo proativo: "Dúvidas sobre este produto?"
Intenção de Saída
Somente desktop. Dispara quando o cursor vai para o botão de fechar/voltar. Última chance para iniciar o chat.
Visitante Retornando
Dispara em uma visita repetida dentro de 7 dias. Cumprimenta o comprador e oferece continuar de onde parou.
Rolagem Profunda
Dispara em 75% da rolagem da página. Perfeito para PDPs longos ou páginas de coleção — captura compradores engajados.
Visualização de PDP
Dispara na terceira página de produto aberta pelo comprador em uma sessão. Sugere o Smart Match para ajudar na escolha.
Abandono de Checkout
Dispara se um comprador visita o checkout e retorna à loja sem comprar. Oferece responder dúvidas de última hora.
7 Solução de problemas
O widget de chat não aparece na minha loja
Certifique-se de que o widget está ativado na aba Design e que seu tema é Online Store 2.0. Se você usa um tema personalizado, verifique se as incorporações de apps não estão desativadas no nível do tema.
A IA continua dizendo "Não sei"
Geralmente significa que o catálogo ainda não terminou de sincronizar ou a descrição do produto é insuficiente. Aguarde a barra de progresso da sincronização terminar, depois adicione políticas e FAQ na aba Sistema para que a IA tenha contexto para responder.
Preços aparecem na moeda errada
O SellBot utiliza o Currency.Wiki nos bastidores. Instale o app Currency.Wiki para Shopify junto com o SellBot e a IA irá automaticamente cotar preços na moeda do comprador.
Respostas da IA estão lentas
Altere para um modelo mais rápido em Configuração → Modelo de IA (Gemini Flash costuma ser o mais rápido). Com Traga-Sua-Própria-Chave, certifique-se de que suas chaves de API têm cota mensal suficiente — solicitações limitadas são enfileiradas.
A IA recomenda produtos errados
Abra a Caixa de Entrada, encontre a conversa e clique em "Corrigir esta resposta". Escreva a resposta correta uma vez e o SellBot não repetirá o erro.
8 Desinstalação e exclusão de dados
Você pode desinstalar o SellBot a qualquer momento pelo seu admin Shopify. Veja o que acontece:
- A cobrança para imediatamente — você não será cobrado novamente.
- A Shopify envia nosso webhook shop/redact. Excluímos todos os dados de lojista e comprador em até 30 dias.
- Se você reinstalar depois, começará do zero — não há retenção oculta de conversas antigas.
Nota: Quer seus dados antes? Envie um e-mail para o suporte antes de desinstalar e enviaremos uma exportação JSON das suas conversas e configurações.
Ainda com dúvidas?
Nossa equipe de suporte responde a todos os e-mails em até um dia útil.
