Creating Your Chat Widget
Setting up a chat widget in Recepta.ai is quick and straightforward. This guide will walk you through the entire process from creation to deployment.1
Access Chat Widget Page
Navigate to the Chat Widget section in your Recepta.ai dashboard
2
Configure Widget Settings
Customize the appearance and behavior of your widget
3
Generate Embed Code
Get the HTML code to add to your website
4
Deploy to Your Website
Add the embed code to your website and test functionality
Widget Configuration
Basic Settings
Widget Title
Default: “Chat with us”
- Appears in the chat header
- Keep it friendly and inviting
- Examples: “Need Help?”, “Ask us anything”, “Live Support”
Primary Color
Default: #667EEA
- Main color for buttons and accents
- Should match your brand colors
- Use hex color codes (e.g., #FF5733)
Position Settings
Choose where the chat widget appears on your website:- Bottom Right
- Bottom Left
Step-by-Step Setup Guide
Step 1: Configure Widget Appearance

-
Widget Title: Enter a welcoming title for your chat widget
-
Primary Color: Choose your brand color
- Use the color picker for visual selection
- Or enter a hex code directly
- Preview updates in real-time
-
Position: Select widget placement
- Bottom-right (recommended for most sites)
- Bottom-left (alternative placement)
Step 2: Preview Your Widget
The preview section shows exactly how your widget will appear:Minimized View
- Floating button in selected corner
- Shows your chosen color scheme
- Displays hover effects
Widget Details
- Title display
- Color scheme preview
- Position confirmation
Step 3: Generate and Copy Embed Code
Once you’re satisfied with your configuration:- Create/Update Widget: Click the action button
- Copy Embed Code: Use the “Copy Code” button
- Copy Script URL: Alternative installation method
The embed code is unique to your account and widget configuration. Keep it secure and only use it on your authorized domains.
Embed Code Implementation
Standard Implementation
Add this code just before the closing</body> tag on your website:
Advanced Implementation Options
- WordPress
- Shopify
- React/Next.js
- Google Tag Manager
Method 1: Theme FunctionsMethod 2: Plugin
- Install a custom code plugin
- Add embed code to footer scripts
- Configure on specific pages if needed
Testing Your Widget
After implementation, thoroughly test your widget:Functionality Checklist
Visual Appearance
Visual Appearance
- Widget appears in correct position
- Colors match your brand
- Title displays correctly
- Responsive on mobile devices
- No layout conflicts with existing elements
Conversation Testing
Conversation Testing
- Chat opens when clicked
- AI responds to messages
- Conversation flows naturally
- Typing indicators work
- Messages display properly
Performance Testing
Performance Testing
- Page load time not affected
- Widget loads asynchronously
- No JavaScript errors
- Works on different browsers
- Mobile performance is good
Test Conversation Examples
Try these conversation starters to test your widget:Configuration Updates
Updating Existing Widgets
To modify your widget configuration:- Access Widget Settings: Return to the Chat Widget page
- Make Changes: Update title, color, or position
- Update Widget: Click the update button
- Automatic Deployment: Changes apply automatically (no code changes needed)
Managing Multiple Widgets
Troubleshooting
Common Issues and Solutions
Widget Not Appearing
Widget Not Appearing
Possible Causes:
- Embed code not added correctly
- JavaScript blocked by browser/ad blocker
- CSS conflicts hiding the widget
- Script loading errors
- Verify embed code placement before
</body> - Check browser console for errors
- Test in incognito/private mode
- Ensure script URL is accessible
Widget Appears But Doesn't Respond
Widget Appears But Doesn't Respond
Possible Causes:
- Network connectivity issues
- API key problems
- Agent not configured properly
- Service downtime
- Check internet connection
- Verify widget ID is correct
- Ensure AI agent is active
- Contact support if persistent
Styling Conflicts
Styling Conflicts
Possible Causes:
- CSS conflicts with existing styles
- Z-index issues
- Mobile responsiveness problems
- Use browser developer tools to inspect
- Adjust CSS priorities if needed
- Test on different screen sizes
- Consider position alternatives
Performance Optimization
Best Practices
Loading Performance
- Load widget asynchronously
- Use defer attribute
- Minimize initial payload
- Lazy load when needed
User Experience
- Position thoughtfully
- Use brand-consistent colors
- Test on mobile devices
- Monitor response times
Monitoring and Analytics
Track widget performance through your dashboard:- Conversation Volume: Daily/weekly chat counts
- Response Times: Average AI response speed
- User Satisfaction: Post-chat feedback scores
- Conversion Tracking: Leads generated through chat
Next Steps
Customize Appearance
Learn advanced customization options for your widget
Integration Guide
Explore platform-specific integration tutorials
Analytics & Insights
Track and analyze your chat widget performance
Advanced Features
Set up webhooks and advanced integrations
Your chat widget is now live! Monitor its performance and iterate based on customer feedback and analytics data.

