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 escolha 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 as permissões read_themes, read_locales, read_products e o webhook de pedido pago. Sem dados de clientes, sem 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 ação necessária.
3. Adicione políticas da loja (opcional)

Cole seus textos de envio, devolução e FAQ para que a IA responda corretamente sobre políticas. Você também pode adicionar um link para uma página externa de FAQ.
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 dashboard externo, sem login extra.

Configuração

Ative o widget, escolha o modelo de IA e defina os 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 expediente. 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 usar suas próprias chaves de API para Anthropic, OpenAI ou Google na aba Avançado. Você paga o provedor diretamente 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 adicionar:

Vá até o admin do SellBot → 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 fica no servidor de 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 humano" aparece após qualquer resposta de IA com baixa confiança. O comprador também pode digitar "agente" a qualquer momento.
2. Fallback por tempo limite

Se nenhum agente responder dentro do tempo configurado (padrão 5 minutos), o SellBot pede 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 responder sem precisar acessar o Shopify, se preferir.
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/desativado e ajustado na aba Sistema.

Carrinho parado

Dispara quando o comprador tem itens no carrinho mas está 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. Sinal 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 engajar no chat.

Visitante recorrente

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 longas ou páginas de coleção — captura compradores engajados.

Visualização de PDP

Dispara na terceira página de produto aberta 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 é o 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 está incompleta. 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.

Os preços aparecem na moeda errada

O SellBot utiliza o Currency.Wiki nos bastidores. Instale o app Currency.Wiki na 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 entram em fila.

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á mais cobrado.
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.

[email protected] Voltar para SellBot