Help center
Frequently asked questions
Find answers about installation, market targeting, chat channels, analytics, privacy, troubleshooting, and support.
Getting started
What does Social Chat Toolkit do?
It adds a floating storefront launcher that directs shoppers to channels such as WhatsApp, Messenger, Telegram, LINE, Viber, email, phone, or a custom link. The app does not host the conversation itself.
How do I make the chat button appear on my store?
Create or edit a rule, add at least one valid enabled channel, save it, then select Open Theme App Embed. Enable Social Chat Toolkit in the SHOPLINE theme editor and save the theme.
Do I need to edit theme code?
No. The storefront widget is delivered through a SHOPLINE Theme App Extension and is enabled as an App Embed.
Why does the app request store, content, and market permissions?
Store information identifies the installed store, content access is used to locate the active theme and open the Theme App Embed, and market access is used to read SHOPLINE markets for rule targeting. Starting with Customer Support, the app also requests order-read access so Pro merchants can offer secure order lookup using the order number and checkout email. It does not provide unrestricted customer-list access to storefront visitors.
Rules and channels
Which chat channels are supported?
Supported options include WhatsApp, Messenger, Telegram, LINE, Instagram, WeChat, Viber, Zalo, Discord, KakaoTalk, TikTok, X, email, phone, and custom links. Availability depends on whether a valid destination can be created for the selected channel.
Can I show different channels in different markets?
Yes. Assign a rule to one or more SHOPLINE markets. Visitors are matched using the country or region selected in the storefront. Markets without a dedicated assignment use the default rule.
What is the difference between market and language?
A market decides which rule, channels, and contact destinations are used. Store language only decides which storefront copy is shown when language-specific copy is enabled. Switching to the France market does not automatically switch the store to French.
Can a channel appear only on mobile or desktop?
Yes. Each channel can be shown on all devices, desktop only, or mobile only. The rule itself also has desktop and mobile visibility controls.
What happens when several channels are enabled?
On desktop, hovering or focusing the main launcher expands a vertical channel rail. On mobile, tapping the launcher opens the available channels. A single enabled channel may open directly.
What is the pre-chat form?
It is an optional form shown before a shopper opens a configured channel. Merchants can collect a request type, order reference, and short description, then use those values to build a prefilled message. WhatsApp and email support direct message prefilling; other compatible channels copy the message before opening. Phone and WeChat use direct opening only.
Does Social Chat Toolkit store pre-chat answers?
No. The shopper’s answers and generated message are processed in the browser and are not sent to the Social Chat Toolkit server. If anonymous analytics are enabled, only form interaction counters such as open, submit, skip, and cancel are recorded.
Analytics and privacy
Is analytics enabled automatically?
No. Anonymous analytics are disabled by default and must be enabled by the merchant.
What is Customer Support?
Customer Support is a Pro feature that combines merchant-managed FAQ, secure order lookup, order tracking, and a handoff to the ChatLink channel the merchant already configured. It does not store shopper-to-merchant chat messages. Existing Free merchants may receive a one-time internal feature trial when the unified storefront experience is released.
Does recent order history save the checkout email?
No. After a successful verification, the browser can save a limited order-status snapshot and a signed refresh credential for that specific store and order. The checkout email is not persisted in browser storage. The refresh credential expires, after which the shopper must verify the order again.
What does analytics collect?
When enabled, it records aggregated widget views, launcher clicks, channel clicks, and browser handoff results. It does not record chat content, names, phone numbers, destination URLs, page content, orders, or customer profiles.
What does “action handoff rate” mean?
It is the percentage of channel clicks that the browser accepted as a navigation, copy, email, or phone action. It does not prove that the external app loaded or that a shopper sent a message.
Can analytics data be exported or deleted?
Yes. Merchants can export aggregated data as CSV, choose a 30, 90, or 180-day retention period, or permanently delete all analytics from the app.
Troubleshooting
Why is the widget missing after I saved a rule?
Check that the rule and widget are enabled, at least one channel has a valid destination, the current market matches the intended rule, the current device is allowed, and the Theme App Embed is enabled. Then refresh the storefront.
Why does a mobile-only channel not appear?
Confirm that both the rule and channel allow mobile display, that the current market matches the rule, and that the destination is valid. Also check whether the phone is requesting the desktop version of the site.
How quickly do saved changes appear?
Most changes appear after a storefront refresh. Short-lived browser or edge caching can cause a brief delay, so close and reopen the page or use a private window when testing.
Why can the widget be unavailable on some networks?
The widget needs to reach the app's public configuration endpoint. Cross-border routing, DNS, TLS filtering, VPNs, ad blockers, or local network policies can affect that request. If the endpoint cannot be reached, the widget hides itself so it does not disrupt the storefront.
Support and data
How do I report a bug or contact the developer?
Open Social Chat Toolkit in SHOPLINE Admin and select Feedback & Support. Create a ticket and continue the conversation there. Developer replies appear as unread notifications in the app.
Can I reply to a closed ticket?
No. A closed ticket is permanently locked for both parties. Create a new ticket for a new or continuing issue. A resolved ticket may be reopened unless it has been closed.
What happens when the app is uninstalled?
The storefront widget stops receiving active configuration and access credentials are deactivated. When SHOPLINE sends the merchant data deletion request, the app removes the store's configuration, tokens, analytics, and support records.
How can I contact support by email?
Email support@toolkit.fans. For privacy requests, email privacy@toolkit.fans.