Step-by-step
🤖 Qwen Chat
Alibaba
📘 Step-by-step guide 📘 Alibaba · Qwen Chatbeginner 💼 Business

Set Up Qwen Chat for Automated E-commerce FAQs

Learn how to connect Alibaba's Qwen Chat to your online shop’s help centre, so it can instantly answer common questions about shipping, returns, and products, saving you time and improving customer experience.

By the end of this guide, you’ll have a Qwen Chat assistant ready to automatically handle frequently asked questions about shipping, returns, and product information for your online store. This means your customers get instant answers, and your team can focus on more complex issues. This guide is perfect for anyone running an online shop, even if you're completely new to AI.

✅ Before you start
  • Alibaba Cloud Account: You'll need an active Alibaba Cloud account (free or paid) to access and manage Qwen Chat. Ensure you have your login details handy.
  • Admin Access to Your E-commerce Platform: You’ll be adding a small piece of code, called a "widget," to your website. This typically requires administrative access to your shop's website builder (like Shopify, WooCommerce, Squarespace, or BigCommerce).
  • A Stable Internet Connection: To smoothly access online tools and set up your chatbot.
  • Roughly 15-20 Minutes: The initial setup is straightforward, but allow some extra time for testing and fine-tuning your new assistant.
1

Log in and find Qwen Chat

First, open your web browser and navigate to the Alibaba Cloud console. Think of this console as a central control panel where you manage all your Alibaba Cloud services. On the login page, enter your username and password, then click to sign in. Once logged in, you'll see a dashboard that provides an overview of your services. Look for a prominent search bar or a menu, often labelled "Products & Services" or "Console," and type "Qwen Chat" into it.

If it looks different: The layout of the Alibaba Cloud console can vary slightly or change over time. If you don't immediately see a search bar, check the left-hand navigation menu for categories like "AI Services" or "Machine Learning." You'll know it worked when: "Qwen Chat" appears in the search results or is clearly listed under the AI services. Click on it to open the Qwen Chat service page.

2

Create a new project for your bot

Once you're on the Qwen Chat service page, you'll see an overview or a list of any existing AI projects you might have. A "project" here is like a dedicated workspace where you'll build and manage your specific AI assistant. Look for a button or link that says "Create New Project," "New Instance," or "Get Started." Clicking this will usually prompt you to give your new project a name. Choose something clear and descriptive for your e-commerce store's FAQ bot.

If it looks different: You might be taken directly to a page with a large "Create Project" button if it's your first time using Qwen Chat. The next screen should definitely ask for a project name.

💬 ExampleIn the name field, type `MyOnlineShop-FAQ Bot`, then click the confirmation button, which is usually labelled "Create" or "OK."

You'll know it worked when: You are taken to a new dashboard or overview page that specifically shows MyOnlineShop-FAQ Bot as the current project, ready for you to add content.

3

Add your first FAQ prompt

Inside your new Qwen Chat project, you need to teach the AI what to say when customers ask questions. The specific instructions you give the AI are called "prompts" – they're like little lessons for your bot. Look for a section or tab labelled "Prompt Library," "Knowledge Base," or simply "Prompts" within your project's dashboard. This is where you'll store all the answers for your frequently asked questions. Click on a button like "Add New Prompt" or "Create New Question." You'll typically see fields to enter a title for your prompt and a larger text area for the actual prompt content.

If it looks different: You might see a blank canvas with a prominent "Add your first prompt" button. Click that. Ensure the "Prompt text" field is ready for you to input both the customer's typical question and your desired answer.

💬 ExampleFor the "Prompt title" field, type `Shipping Time Query`. In the larger "Prompt text" area, type: `When a customer asks "How long will my order take to arrive?" or "What are your shipping times?", respond with: "Most orders to mainland Australia arrive within 3-5 business days. We also offer express shipping options for faster delivery, which usually take 1-2 business days. You'll receive a tracking link via email once your order has been dispatched." After typing, click "Save" or "Add Prompt."`

You'll know it worked when: Your new prompt, "Shipping Time Query," appears in a list within the "Prompt Library" section.

4

Generate your API key

To allow your Qwen Chat project to "talk" to your e-commerce website and display the chat assistant, you need an "API key." Think of an API (Application Programming Interface) as a secure, unique passcode that lets two different software programs, like Qwen Chat and your website, share information and work together. From your Qwen Chat project dashboard, navigate to a section often called "API Keys," "Integrations," or "Settings." Here, you'll find an option to generate a new key.

If it looks different: You might need to click on a "Developer" or "Deployment" tab first. Look for a clear button labelled "Generate Key," "Create API Key," or "New Token."

💬 ExampleClick the "Generate Key" button. A long string of characters (your API key, which might look like `sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`) will instantly appear on your screen. Crucially, click the "Copy" icon (it often looks like two overlapping squares) next to this key to save it to your clipboard.

You'll know it worked when: A small pop-up message confirms "Copied to clipboard," or the API key string is visibly highlighted. Keep this key safe and don't share it publicly, as you'll need it in the next step.

5

Retrieve the chat widget embed code

Before you go to your e-commerce platform, Qwen Chat will provide you with the specific piece of code you need to embed. This code, often called a "widget" or "embed script," is a small snippet of HTML and JavaScript that will create and display the chat bubble on your website. From your Qwen Chat project dashboard, look for a section related to "Deployment," "Integrations," or "Website Embed." Within this section, you'll find the pre-written code snippet that's tailored to your Qwen Chat project.

If it looks different: The section might be under "Settings" > "Web Widget" or "Channels." Look for instructions on "How to embed on your website." You're looking for a box containing code that typically starts with <script> tags.

💬 ExampleLocate the code box and click the "Copy Code" button, which saves the entire snippet to your clipboard. The code should look similar to the example provided in the "Embed" step, but will include placeholders for your specific API key and project ID.

You'll know it worked when: You have the complete HTML/JavaScript code snippet safely copied to your clipboard, ready to be pasted onto your website.

6

Embed the chat widget on your help centre

Now it’s time to add the Qwen Chat widget to your shop. Open your e-commerce platform's administration panel (e.g., Shopify admin, WooCommerce dashboard, Squarespace editor). You need to find where you can add custom code to your website, specifically to your help centre or FAQ page. Most platforms have a "Custom Code," "HTML/CSS Editor," "Theme Customisation," or "Widgets" section. This is where you will paste the code snippet you copied from Qwen Chat.

If it looks different: The exact location varies significantly between e-commerce platforms and themes. You might need to edit a specific "Page Template," look under "Online Store" > "Themes" > "Edit Code" (for Shopify), or find a "Header/Footer Scripts" area. If your platform doesn't directly support custom code, you might need to install a dedicated app or upgrade your plan. The free version of Qwen Chat may have usage limits; check Alibaba Cloud's current terms for any potential costs with high API usage.

💬 ExampleNavigate to the custom code area (e.g., in a "Custom HTML" block on your FAQ page). Paste the entire code snippet you copied from Qwen Chat. Crucially, ensure that `YOUR_API_KEY` within the snippet is replaced with the *actual API key* you generated in Step 4. Then, click "Save," "Update," or "Publish" to make your changes live.

You'll know it worked when: You open your live help centre page in a new browser tab or incognito window, and a small chat bubble or icon (usually in the bottom-right corner) appears on the screen.

7

Test and refine your chatbot

With the chat widget now embedded, it’s time to see your Qwen Chat assistant in action. Open your e-commerce website's help centre page in a separate browser tab, where you can see the chat bubble. Click on the chat bubble to open the conversation window, just as a customer would. Type in one of the common questions you added as a prompt (e.g., "How long does shipping take?" or "What is your return policy?"). Observe how Qwen Chat replies.

If it looks different: If the bot doesn't appear, doesn't reply, or gives a generic answer, double-check your API key in the embedded code and ensure your prompt text in Qwen Chat is clear and covers the question. Sometimes, it takes a minute or two for changes to publish across your site.

💬 ExampleIf the bot replies, "Most orders arrive within 3-5 business days," but you want it to also mention international shipping, return to the "Prompt Library" in your Qwen Chat project. Find your "Shipping Time Query" prompt, click "Edit," and add: `We also offer international shipping to select countries; delivery times vary, typically 7-14 business days.`. Click "Save," then test again on your live site.

You'll know it worked when: The chatbot consistently provides clear, helpful, and accurate answers that directly reflect the specific information you provided in your prompts. Remember, Qwen Chat can draft a response, but it cannot actually look up individual customer order details from your database without further, more complex integration work.

⚠️ Common mistakes
  • Incorrect or Missing API Key: Even a single missing character, an extra space, or forgetting to replace the placeholder YOUR_API_KEY will stop the chat widget from loading or functioning correctly.
    • Fix: Go back to Qwen Chat's "API Keys" section (Step 4), copy the key again, and carefully paste it into your website code (Step 6), replacing the old one entirely. Double-check for extra spaces.
  • Vague or Short Prompts: If your prompts are too brief or unclear in Qwen Chat, the AI might give generic or unhelpful answers because it doesn't have enough specific information to work with.
    • Fix: Return to your "Prompt Library" in Qwen Chat (Step 3) and expand your prompt text. Include precise details, desired phrasing, and examples of how a customer might phrase their question to guide the AI better.
  • Forgetting to Publish Changes: Many e-commerce platforms and website builders require you to explicitly "Save," "Update," or "Publish" a page after making changes in the editor for them to appear live to customers.
    • Fix: After pasting your code or editing prompts, always ensure you've saved and published the changes within both Qwen Chat (if applicable) and your e-commerce platform's content editor.
🚀 Try it now

Open your web browser, go to the Alibaba Cloud console, navigate to Qwen Chat, and click "Create New Project" to start setting up your first FAQ bot.

✦ Original step-by-step guide by AI World Co.'s AI editorial team. Written in plain language, reviewed for accuracy.

← Back to all stories