Documentação

Esta referência descreve a arquitetura de produção atual e os contratos visíveis para o comerciante do IFG AI Chat.

Arquitetura

Runtime

Google Cloud Run — europe-west1

Base de dados

Google Cloud Firestore — europe-west1

Modelo de IA

OpenAI GPT-5 nano

Embeddings

Vertex AI — gemini-embedding-001

App proxy

/apps/ai-chat

Extensão de tema

Shopify Theme App Extension — App Embed

Permissões Shopify

read_products · read_legal_policies · read_online_store_pages · read_themes

A app usa apenas permissões de leitura para produtos, políticas legais, páginas da loja online e temas. Não pede encomendas, pagamentos nem registos de clientes.

Ativar no tema em 3 passos

Abra o editor de tema com o botão abaixo: abrirá diretamente no painel App embeds.
Ative o interruptor IFG AI Chat Widget.
Depois volte a esta página: ative o WhatsApp e/ou o Telegram, insira o número ou o nome de utilizador, escolha a posição e a cor e clique em Guardar. Todas as definições são geridas apenas nesta app.

Fluxo de dados de IA e RAG

Gera rascunhos de perguntas e respostas a partir dos produtos e das políticas da loja, para rever e publicar. O catálogo já é indexado automaticamente para o chatbot em todos os planos pagos.

Produtos publicados, coleções, políticas da loja, páginas publicadas da loja online e entradas publicadas da Knowledge Base são indexados para recuperação. Os artigos do blog não são lidos. Preço e disponibilidade não são confiados aos embeddings: são verificados ao vivo quando o bot responde.

Preço e stock ao vivo

Preço e disponibilidade mostrados pelo bot são verificados no momento da resposta: informações pré-contratuais, não uma promessa garantida.

Faturação e período de teste

O período de teste gratuito de 7 dias aplica-se uma vez por loja. Se cancelar e voltar a subscrever dentro desses 7 dias, mantém os dias que ainda não utilizou; depois disso, a subscrição passa imediatamente a ser paga.

Dados e privacidade

As conversas são conservadas por 30 dias, depois deletadas permanentemente — nunca anonimizadas e conservadas além.
O motor AI (OpenAI GPT-5 nano) processa dados também fora da União Europeia, com Cláusulas Contratuais Padrão.
Você pode solicitar a exportação ou deleção dos dados de sua loja a qualquer momento através do Shopify.

Idiomas

O admin e a documentação pública suportam os mesmos 30 idiomas; árabe e hebraico usam layout da direita para a esquerda.

Limites e comportamento em falha

O chatbot é apenas informativo: não pode alterar encomendas, emitir reembolsos nem executar ações transacionais. Dados desconhecidos ou indisponíveis não são tratados como uma resposta bem-sucedida.