Widget & QR

The Widget & QR lets visitors start a WhatsApp conversation with you from your website (or from a QR code in emails, popups, or printed flyers).

What you get

When you configure your widget in Connectora, Connectora generates:

• A public chat link (deep link)
• A QR code for that chat link
• A JavaScript embed that places a floating WhatsApp button on your pages

Step-by-step

1. Open Widget & QR in the Connectora admin.

2. Fill in Widget settings:

   • Button label (text shown on your widget button)
   • Prefilled message (the text customers send first, like "Hi! I have a question")
   • Position (top-left, top-right, bottom-left, bottom-right)
   • Brand color
   • Show on public embed (toggle to pause without deleting your config)

3. Save your widget.

4. Copy one of the deploy options:

   • Embed script (recommended for most sites)
   • Direct link (for simple CTA buttons)
   • QR code (download as an image)

5. Test on your website:

   • ensure the floating button loads
   • click it and confirm it opens WhatsApp with your prefilled message

Embed script (what to paste)

Connectora hosts a public JavaScript file at:

• GET /api/v1/public/widget/:organization_id.js

The embed snippet looks like:

<script src="<YOUR_API_BASE>/api/v1/public/widget/<organization_id>.js" async></script>

Replace:

• <YOUR_API_BASE> with your Connectora API base URL
• <organization_id> with your org id shown in admin/local storage

QR code usage

Use the QR code in:

• landing pages and checkout pages
• emails and signatures
• store receipts

When customers scan the code, they open the same deep link and prefilled message.

Troubleshooting

If the button shows but clicking does not open WhatsApp correctly:

• confirm you connected WhatsApp in Connectora first
• confirm the widget is enabled
• check that your browser allows popups for the chat link

Next: Message templates to make sure automated sends can work outside the 24-hour window.