Getting Started with Supportify

Set up AI-powered customer support for your Shopify store in less than 10 minutes

Quick Start

Supportify is designed to get you up and running quickly. Follow these simple steps to install and configure your AI-powered customer support chatbot.

Estimated time: 5-10 minutes
1

Install the App

Start by installing Supportify from the Shopify App Store:

  1. Visit the Shopify App Store
  2. Search for "Supportify" or navigate directly to our app page
  3. Click the "Add app" button
  4. Review the permissions requested (read products, orders, customers; write fulfillments, orders, returns)
  5. Click "Install app" to authorize Supportify
What happens during installation:
  • Supportify connects to your Shopify store using OAuth
  • Your store credentials are securely synchronized with our backend
  • A chatbot is automatically created for your store
  • GDPR compliance webhooks are registered (customers/data_request, customers/redact, shop/redact)
  • You're redirected to the Supportify dashboard to complete setup
2

Configure Your Chatbot

After installation, you'll be taken to the Supportify app dashboard inside your Shopify admin. A chatbot has been automatically created for your store - now let's customize it:

Basic Settings

  • Chatbot Name: Give your chatbot a friendly name (default: "Customer Support Bot")
  • System Prompt: Define your chatbot's personality and behavior. This is crucial for tone and brand voice.
  • Welcome Message: Set the first message customers see when opening the chat (default: "Hi there! How can I help you today?")

AI Model Selection

  • Provider: Choose between OpenAI or Claude
  • Model: Select the specific model based on your needs:
    • GPT-4: Most capable, best for complex queries (higher cost)
    • GPT-3.5 Turbo: Fast and cost-effective (recommended for most stores)
    • Claude 3 Sonnet: Excellent balance of speed and intelligence
  • Temperature: Control creativity (0 = focused, 2 = creative). Recommended: 0.7
  • Max Tokens: Maximum response length. Recommended: 500-1000
💡 Pro Tip: Start with GPT-3.5 Turbo at temperature 0.7 for the best balance of cost and performance. You can always upgrade to GPT-4 later if you need more advanced reasoning.

Example System Prompt

You are a helpful customer support assistant for [Your Store Name].
Your goal is to help customers with their questions about products,
orders, and store policies.

Be friendly, professional, and concise. Always verify customer identity
before accessing order information. If you cannot resolve an issue,
offer to escalate to a human support agent.

Store policies:
- Free shipping on orders over $50
- 30-day return policy
- 24-hour order cancellation window
3

Configure AI Tools

Supportify provides powerful tools that allow the AI to take actions on behalf of customers. Review and enable the tools you want:

🔍 Product Search

Let customers search your product catalog by name, type, or vendor.

Recommended: ✓

đŸ“Ļ Order Lookup

Allow customers to check order status and tracking information.

Recommended: ✓

👤 Customer Lookup

Enable customers to view their order history and account details.

Recommended: ✓

âœī¸ Customer Update

Let customers update their profile, phone, and address.

Optional

🚚 Fulfillment Lookup

Show shipment tracking and delivery status.

Recommended: ✓

❌ Order Cancel

Allow customers to cancel unfulfilled orders.

Optional

â†Šī¸ Return Request

Enable customers to request returns through the chat.

Optional

📚 Knowledge Base

Search uploaded documents to answer common questions.

Recommended: ✓

đŸŽĢ Escalate to Ticket

Create support tickets for issues that need human attention.

Recommended: ✓
âš ī¸ Security Note: Tools that modify data (order cancellation, returns, profile updates) require email verification for security. Customers must verify their email before these actions are executed.
4

Upload Knowledge Base Documents

Enhance your chatbot's knowledge by uploading documents about your products, policies, and FAQs:

Supported File Types

  • PDF: Product catalogs, policy documents
  • DOCX: Word documents with FAQs or guides
  • TXT: Plain text files
  • Markdown (.md): Formatted documentation

How to Upload

  1. Navigate to Documents in your dashboard
  2. Click "Upload Documents"
  3. Select up to 10 files (max 10MB each)
  4. Add optional descriptions for better organization
  5. Click "Upload" and wait for processing

What Documents to Upload

📋 Shipping & Returns Policy

Delivery times, return windows, refund process

đŸ’ŗ Payment Information

Accepted payment methods, security information

đŸ“Ļ Product Care Instructions

Usage guides, maintenance tips

❓ Frequently Asked Questions

Common customer questions and answers

💡 Best Practice: The more relevant content you upload, the better your chatbot performs. Aim for at least 3-5 documents covering your most common customer questions.
5

Test Your Chatbot

Before making your chatbot live, test it to ensure it responds correctly:

Using the Test Feature

  1. Navigate to Chatbot Settings
  2. Click "Test Chatbot"
  3. Send sample questions like:
    • "Where is my order?"
    • "What's your return policy?"
    • "Can I cancel my order?"
    • "Tell me about [product name]"
  4. Review the responses and refine your system prompt if needed

What to Test

Tone and personality match your brand
Product search returns relevant results
Order lookup works with test order numbers
Knowledge base answers common questions
Escalation creates tickets properly
6

Enable the Chat Widget

The final step is to enable the chat widget on your Shopify store:

Enable the Theme Extension

  1. In your Shopify admin, go to Online Store → Themes
  2. Click "Customize" on your active theme
  3. In the theme editor, click "Add section" or "Add app block"
  4. Look for "Supportify Chat Widget" in the Apps section
  5. Add it to your theme (typically in the footer or as a global app block)
  6. Customize the appearance if needed (chat bubble color, header text, etc.)
  7. Click "Save" in the top right
🎉 Congratulations! Your AI-powered chatbot is now live on your store. Customers will see a chat icon in the bottom-right corner of your store pages.

Customize Widget Appearance

Back in the Supportify dashboard, you can customize:

  • Primary Color: Match your brand colors
  • Position: Bottom-right, bottom-left, etc.
  • Welcome Message: First message customers see

Next Steps

Now that your chatbot is live, here are some things to do next:

📊 Monitor Performance

Check your dashboard regularly to see chat volume, popular questions, and customer satisfaction.

đŸŽĢ Manage Tickets

Review escalated tickets and respond to customers who need human assistance.

📈 Optimize Responses

Review chat transcripts and refine your system prompt for better responses.

📚 Expand Knowledge Base

Add more documents as you identify common questions not yet covered.

âš™ī¸ Adjust Settings

Fine-tune AI model, temperature, and tool configurations based on usage patterns.

📧 Set Up Email Replies

Configure your email settings so customers can reply to ticket notifications.

Need Help?

If you run into any issues during setup, we're here to help: