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¶
- Log in to your Shopify admin
- Go to Apps
- Click Functional AI
- The settings page opens
Configuration Options¶
Assistant Selection¶
Choose which assistant handles your Shopify conversations:
- Find the Assistant dropdown
- Select from your available assistants
- 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:
- Review your settings
- Click Save or Update
- Changes apply immediately
Widget Preview¶
Use the preview feature to see how your widget will appear:
- Click Preview Widget
- A sample chat opens
- Test the appearance and behavior
Testing Your Setup¶
Before Going Live¶
- Enable the widget
- Visit your store (use incognito mode)
- Click the chat widget
- Send test messages
- 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¶
- Go to your Functional AI dashboard
- Open Conversations
- Filter by Shopify channel
- Confirm test messages appear
Multiple Stores¶
If you have multiple Shopify stores:
- Install the app on each store
- Each store can use a different assistant
- Conversations are labeled by store in your dashboard
Troubleshooting¶
Widget Not Appearing¶
Check these items:
- Is the widget enabled? Toggle ON in settings
- Is an assistant selected? Must choose an assistant
- Is the assistant public? Private assistants won't work
- 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¶
- Verify assistant is selected in settings
- Check assistant is public in Functional AI
- Test the assistant in the Chat interface
- 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¶
- Keep knowledge bases focused
- Use clear, specific instructions
- Set appropriate response delays
- Monitor and adjust based on feedback