Skip to content

Shopify Configuration

Configure your Functional AI chatbot settings within Shopify admin.

Essential Settings

Setting What to Do
Assistant Select an assistant with Use Case = "ECOMMERCE"
Widget Toggle ON to show chatbot on your store
Visibility Ensure assistant is set to public

Accessing Settings

From Shopify Admin

  1. Log in to your Shopify admin
  2. Go to Apps
  3. Click Functional AI
  4. The settings page opens

Configuration Options

Assistant Selection

Choose which assistant handles your Shopify conversations:

  1. Find the Assistant dropdown
  2. Select from your available assistants
  3. The selected assistant will respond to all Shopify messages

E-commerce Assistant

For best results, use an assistant with Use Case set to "ECOMMERCE" and product-specific instructions.

Widget Visibility

Toggle the chatbot widget on or off:

Setting Behavior
ON Widget appears on your store
OFF Widget hidden from customers

Use this to: - Temporarily disable while updating - Enable only during certain periods - Test before going live

Webhook Settings

Configure message handling:

Setting Description
Enable webhooks Allow real-time message delivery
Response delay Optional delay before responding

Advanced Settings

Response Delay

Add a delay before the assistant responds:

  • None: Instant response (default)
  • Short: 5-10 second delay
  • Medium: 15-30 second delay

Delays can make responses feel more natural and human-like.

Business Hours

If available, configure when the assistant is active:

  • Always on: 24/7 response
  • Business hours: Only during set hours
  • Custom schedule: Define specific times

Saving Changes

After making changes:

  1. Review your settings
  2. Click Save or Update
  3. Changes apply immediately

Widget Preview

Use the preview feature to see how your widget will appear:

  1. Click Preview Widget
  2. A sample chat opens
  3. Test the appearance and behavior

Testing Your Setup

Before Going Live

  1. Enable the widget
  2. Visit your store (use incognito mode)
  3. Click the chat widget
  4. Send test messages
  5. Verify responses are accurate

Test Scenarios

  • Product question: "What materials is [product] made of?"
  • Shipping inquiry: "How long does shipping take?"
  • Availability: "Do you have [product] in size X?"
  • Support: "I have a question about my order"

Verify in Dashboard

  1. Go to your Functional AI dashboard
  2. Open Conversations
  3. Filter by Shopify channel
  4. Confirm test messages appear

Multiple Stores

If you have multiple Shopify stores:

  1. Install the app on each store
  2. Each store can use a different assistant
  3. Conversations are labeled by store in your dashboard

Troubleshooting

Widget Not Appearing

Check these items:

  1. Is the widget enabled? Toggle ON in settings
  2. Is an assistant selected? Must choose an assistant
  3. Is the assistant public? Private assistants won't work
  4. Cache issues? Try incognito mode

If still not working:

  • Check your Shopify theme for conflicts
  • Verify the app is installed correctly
  • Contact support with details

Assistant Not Responding

  1. Verify assistant is selected in settings
  2. Check assistant is public in Functional AI
  3. Test the assistant in the Chat interface
  4. Review any error messages

Slow Responses

  • Check if response delay is set
  • Verify internet connectivity
  • Large knowledge bases may slow response

Wrong Assistant Responding

  • Double-check assistant selection in Shopify settings
  • Save settings after changing
  • Refresh your store page

Best Practices

Before Launch

  • Test thoroughly with various questions
  • Review assistant instructions for accuracy
  • Ensure knowledge base is up-to-date
  • Customize widget appearance

Regular Maintenance

  • Review conversations periodically
  • Update assistant instructions based on feedback
  • Keep knowledge base current
  • Monitor for common issues

Performance Tips

  1. Keep knowledge bases focused
  2. Use clear, specific instructions
  3. Set appropriate response delays
  4. Monitor and adjust based on feedback

Next Steps