All docs Channels
Website chat widget
Install the chat on your store, test it before shoppers see it, and every widget setting — branding, hours, offline form, ratings, returns, texts.
The chat widget is the chat bubble on your store. Its settings are on Store → Widget (title Chat widget, with a Live or Test mode badge). Only Owners and Admins can change them.
Install
- Magento / other platforms: copy the one-line script tag from the Install card and paste it on every page, just before
</body>. In Magento: Content → Design → Configuration → your store view → Footer → Miscellaneous HTML, then flush the cache. - Shopify: no snippet; switch on the Arasta support chat app embed in the theme editor.
The widget loads only on the Allowed domains you set.
Who sees the widget (test mode)
Try the widget on your live store before shoppers see it.
| Option | Effect |
|---|---|
| Everyone | Live: every shopper sees the widget. |
| Testers only | Test mode: only visitors from the Tester IP addresses see it. |
Enter one IPv4/IPv6 address or CIDR range per line (up to 50). Save and add my address adds the address you are using now. In test mode without any address nobody sees the widget. Switch to Everyone to go live.
Branding
| Setting | What it does |
|---|---|
| Allowed domains | Host names where the widget may load (up to 20). |
| Primary colour | Colour of the button and your messages (default #3e5170). |
| Position | Bottom right (default) or bottom left. |
| Logo URL (https) | Logo in the chat header. |
| Greeting | First message visitors see (up to 300 characters). |
| AI disclosure text | Shown whenever Kalfa AI is answering (10–300 characters). Leave empty for the default: "You're chatting with an AI assistant. A team member can join at any time." |
| Remove the "Powered by" line | Available on plans that include branding removal. |
Click Save widget settings — it saves branding, business hours, satisfaction and returns together.
Business hours
Enter times in the store's time zone, for example 09:00-17:30, or several ranges like 09:00-12:00, 13:00-17:00 (up to four per day). Leave a day empty when you are closed; leave all days empty to be always open. Holidays take dates as YYYY-MM-DD, comma-separated.
| Setting | What it does |
|---|---|
| Time zone | The store's time zone for the hours above. |
| Let the AI answer outside business hours | On: Kalfa AI answers at any time. Off: outside hours new conversations go to your team. |
| Show the offline form outside business hours | When nobody can answer, visitors can leave their name, email and message; your reply is emailed to them. |
When Kalfa AI cannot answer and your team must reply, the customer sees, in this order:
- "A team member will reply here as soon as possible." — when an agent is online (and it is within business hours).
- On WhatsApp: "Our team is offline right now. We'll reply to you here on WhatsApp as soon as we're back."
- The offline form, if it is on (or a note that the team will email them, when their email is already known).
- Otherwise a short message with your support contact.
Customer satisfaction
Ask for a rating after resolved conversations (off by default): after a conversation is resolved, visitors who still have the chat open are asked for a thumbs up or down and an optional 1–5 rating. Results appear in Analytics.
Returns
Kalfa AI checks whether a verified order can still be returned and sends the customer to your store's own return flow. Return window (days) (1–365) sets the window; leave it empty to use the number of days in your returns policy (knowledge), or the 30-day default.
Texts per language
The widget is translated automatically into Turkish, German, French, Spanish, Italian, Dutch, Portuguese, Polish, Swedish, Danish, Norwegian and Finnish; other languages use English. Pick a language and click Show to override any text (up to 1,000 characters each). Empty fields use the default. Save texts or Reset all to defaults.
Signed customer identity
Lets your store tell the widget which customer is logged in, so logged-in customers do not need a verification code. Create signing secret (or Rotate signing secret) and paste it into the Magento connector module — see Connect Adobe Commerce / Magento. The secret is shown once. Shopify does this automatically.