Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.molin.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
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

ParameterRequiredDescription
molin_messageYesThe message to prefill in the chat input (URL-encoded)
molin_autosendNoSet to 1 to automatically send the message

​
URL encoding

Special characters must be URL-encoded. Common encodings:
CharacterEncoded
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.

​
Social media ads

Use prefilled URLs in your ad campaigns to start targeted conversations:
  • Facebook ads → product-specific questions
  • Instagram bio → general inquiries
  • Twitter links → support requests

​
Website buttons

Create buttons that open chat with context: 
<a href="?molin_message=I%20want%20to%20learn%20more">Ask a question</a>
For more control over chat behavior, see Send message programmatically for the JavaScript API.

​
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.)