Documentation

This reference describes the current production architecture and merchant-visible contracts of IFG AI Chat.

Architecture

Runtime

Google Cloud Run — europe-west1

Database

Google Cloud Firestore — europe-west1

AI model

OpenAI GPT-5 nano

Embeddings

Vertex AI — gemini-embedding-001

App proxy

/apps/ai-chat

Theme extension

Shopify Theme App Extension — App Embed

Shopify permissions

read_products · read_legal_policies · read_online_store_pages · read_themes

The app uses read-only scopes for products, legal policies, online store pages and themes. It does not request orders, payments or customer records.

Activate in the theme in 3 steps

Open the theme editor with the button below: it opens directly on the App embeds panel.
Turn on the IFG AI Chat Widget toggle.
Then come back to this page: turn on WhatsApp and/or Telegram, enter the number or username, choose position and colour, and press Save. Every setting is managed only in this app.

AI and RAG data flow

Generates draft questions and answers from the store’s products and policies, for you to review and publish. The catalog is already indexed automatically for the chatbot on every paid plan.

Published products, collections, store policies, published online store pages and published Knowledge Base entries are indexed for retrieval. Blog articles are not read. Price and availability are not trusted from embeddings: they are checked live when the bot answers.

Live price and stock facts

Price and availability shown by the bot are verified at answer time: precontractual information, not a guaranteed promise.

Billing and trial

The 7-day free trial applies once per store. If you cancel and resubscribe within those 7 days, you keep the days you haven’t used yet; after that, the subscription starts as paid straight away.

Data and privacy

Conversations are kept for 30 days, then permanently deleted — never anonymized and kept beyond that.
The AI engine (OpenAI GPT-5 nano) processes data outside the European Union too, under Standard Contractual Clauses.
You can request export or deletion of your store’s data at any time through Shopify.

Languages

The admin and public documentation support the same 30 languages; Arabic and Hebrew use right-to-left layout.

Limits and failure behavior

The chatbot is informational only: it cannot modify orders, issue refunds or perform transactional actions. Unknown or unavailable data is not treated as a successful answer.