Overview
You can open the chat with a prefilled message by adding URL parameters to any page on your website. This is perfect for:
- Marketing campaigns with pre-written questions
- Email links that open chat with context
- QR codes that start specific conversations
- Social media links with call-to-action messages
- Support links with predefined inquiries
This feature requires no JavaScript code. Just add parameters to your existing URLs.
URL builder
Use this tool to generate URLs for your campaigns:
Parameters
| Parameter | Required | Description |
|---|
molin_message | Yes | The message to prefill in the chat input (URL-encoded) |
molin_autosend | No | Set to 1 to automatically send the message |
URL encoding
Special characters must be URL-encoded. Common encodings:
| Character | Encoded |
|---|
| Space | %20 |
? | %3F |
& | %26 |
= | %3D |
! | %21 |
' | %27 |
The URL builder above handles encoding automatically. For manual encoding, use JavaScript’s encodeURIComponent() function.
Examples
Product inquiry
Direct users to ask about a specific product:
https://yourstore.com/products/blue-sneakers?molin_message=Tell%20me%20more%20about%20these%20sneakers
Support request
Create a support link in your email footer:
https://yourstore.com?molin_message=I%20need%20help%20with%20my%20order
Campaign landing page
Add to marketing campaigns with a specific question:
https://yourstore.com/summer-sale?molin_message=What%20deals%20are%20available%20today%3F
Order tracking
Link from order confirmation emails:
https://yourstore.com/account?molin_message=Where%20is%20my%20order%3F&molin_autosend=1
Use cases
Email marketing
Add prefilled chat links to your email campaigns:
<a href="https://yourstore.com?molin_message=I%20saw%20your%20email%20about%20the%20sale"> Chat with us about deals </a>
QR codes
Generate QR codes that link to URLs with prefilled messages. When scanned, customers immediately start a relevant conversation.
Use prefilled URLs in your ad campaigns to start targeted conversations:
- Facebook ads → product-specific questions
- Instagram bio → general inquiries
- Twitter links → support requests
Create buttons that open chat with context:
<a href="?molin_message=I%20want%20to%20learn%20more">Ask a question</a>
Combining with existing URLs
The parameters work with any existing URL on your site:
# Homepage
https://yourstore.com?molin_message=Hello
# Product page
https://yourstore.com/products/item-123?molin_message=Is%20this%20in%20stock
# With existing parameters
https://yourstore.com/search?q=shoes&molin_message=Help%20me%20find%20shoes
Technical notes
- Parameters are parsed when the widget script loads
- The chat opens automatically when a valid
molin_message is detected
- After the chat opens,
molin_* parameters are automatically removed from the URL (using history.replaceState) to keep URLs clean
- Works with all widget embed methods (script tag, Shopify app, etc.)
