Question 1

What is ChatMadi?

Accepted Answer

ChatMadi is a lightweight WhatsApp chat widget for websites. It adds a floating bubble that opens WhatsApp with your business number and a pre-filled message. You can customize the look, choose languages, set business hours for off-hours replies, and track impressions/clicks in Analytics. Start at /docs/install, then visit the Dashboard for Widget settings and Templates.

Question 2

What do I need before installing?

Accepted Answer

You need your WhatsApp number in full international format (e.g., +91XXXXXXXXXX), access to your site’s HTML (or theme editor on WordPress/Webflow/Shopify), and your unique Widget ID from Dashboard → Overview. Copy the embed snippet from /docs/install and paste it right before .

Question 3

Where do I find my Widget ID?

Accepted Answer

Open Dashboard → Overview. You’ll see your Widget ID and quick Copy buttons for Embed and Auto-trigger snippets. You can also confirm it in Dashboard → Widget settings. If you have multiple widgets, prefer the newest linked to your business.

Question 4

Does ChatMadi work on all sites?

Accepted Answer

Yes. It works on static HTML sites and popular platforms like WordPress, Webflow, Shopify, Wix, Squarespace, and Next.js. See /docs/install for platform-specific notes and /docs/troubleshooting if your theme blocks external scripts (CSP).

Question 5

Will it slow my website?

Accepted Answer

No. The script loads asynchronously after the main page has rendered. It’s a small, cacheable file served by Vercel. You can verify load timing in your browser DevTools Network tab and in Lighthouse audits.

Question 6

How do I test it quickly?

Accepted Answer

Install the embed snippet, then open your site in an incognito window. You should see the floating bubble. Click it to confirm WhatsApp opens with your number and prefill. Also check Dashboard → Analytics to see impressions and clicks appear.

Question 7

Where exactly do I paste the embed code?

Accepted Answer

Place the snippet just before the closing tag in your site’s main layout or theme file. On WordPress, use theme header/footer injection or a code snippet plugin. On Shopify, edit theme.liquid. On Webflow, go to Project Settings → Custom Code → Footer.

Question 8

How do I add Auto-trigger?

Accepted Answer

Copy the Auto-trigger snippet from Dashboard → Overview and paste it after the main widget snippet. Auto-trigger can open the chat bubble automatically based on timing and simple rules. See /docs/dashboard → Widget behavior & customization.

Question 9

How do I change the bubble color or position?

Accepted Answer

Go to Dashboard → Widget settings. You can set theme color, bottom offset, side (left/right), icon style, call-to-action text, and more. Save your changes, then refresh your site to see the update.

Question 10

Do I need to redeploy my site after changes?

Accepted Answer

Usually no. Settings and templates are fetched dynamically. After saving in the Dashboard, reload your site page; the widget reads live config from the API. If a CDN caches your HTML aggressively, flush that cache.

Question 11

What about Content Security Policy (CSP)?

Accepted Answer

If your site uses CSP, allow the script origin (your Vercel domain) and WhatsApp links. See /docs/troubleshooting → CSP section for exact directives to add to script-src and connect-src.

Question 12

What are templates?

Accepted Answer

Templates are saved messages (e.g., Greeting, Off-hours, Sales) used by the widget and by your team for fast, consistent replies. Create them in Dashboard → Templates. Support multiple locales like en/hi/kn/ta with the same kind.

Question 13

How do business hours affect templates?

Accepted Answer

When a visitor pings you outside your business hours, the system picks an Off-hours template for the chosen locale (with fallback to English). During business hours, it prefers a Greeting template.

Question 14

What are custom kinds?

Accepted Answer

Besides system kinds (greeting, off_hours, etc.), you can add custom kinds like promo, upsell. Use Dashboard → Templates → Manage kinds to create or delete custom categories.

Question 15

How do I test the template chooser?

Accepted Answer

Use the endpoint shown in /docs/dashboard → Templates QA (Include inline business hours). For example: /api/templates/choose?wid=<id>&locale=en&h=11&m=15 to simulate business hours vs off-hours decisions.

Question 16

What are triggers?

Accepted Answer

Triggers are rules that auto-open the chat bubble (e.g., after X seconds, exit-intent, or specific pages). The basic auto-trigger snippet is provided on Dashboard → Overview. More advanced triggers are planned as future updates.

Question 17

How is the user’s language chosen?

Accepted Answer

The widget tries the requested locale first (e.g., ?locale=hi), then falls back: requested → site preference → English. If no template exists for the chosen kind in that locale, it uses a default message.

Question 18

Can I force a locale?

Accepted Answer

Yes. Pass ?locale=xx in your page URL or set an explicit preference in your site integration. For backend QA, call /api/templates/choose with a locale param to confirm template selection.

Question 19

Which languages are supported out of the box?

Accepted Answer

Docs and examples highlight English (en), Hindi (hi), Kannada (kn), and Tamil (ta). You can add any BCP-47 code and create matching templates; the chooser will honor them if present.

Question 20

How do I set business hours?

Accepted Answer

Open Dashboard → Business hours. Define Mon–Sat windows and mark closed days. The chooser uses these ranges to switch between Greeting (open) and Off-hours (closed) automatically.

Question 21

What timezone is used?

Accepted Answer

You can set your business timezone (e.g., Asia/Kolkata). The chooser evaluates the local time in that timezone against your schedule when deciding off-hours vs greeting.

Question 22

How do I QA hours quickly?

Accepted Answer

Use the chooser endpoint with inline hours parameters as shown in /docs/dashboard → Templates QA. You can simulate 11:15 (open) vs 23:30 (closed) without changing saved hours.

Question 23

What data do you track?

Accepted Answer

Impressions (widget renders), Opens (user opens bubble), Closes, and Clicks (CTA). CTR is Clicks ÷ Impressions. See Dashboard → Analytics for daily totals and page breakdown.

Question 24

How do I smoke-test analytics?

Accepted Answer

Use the public endpoints documented in /docs/troubleshooting to post test events and confirm the dashboard updates. If numbers stay zero, verify env variables and that the admin key is configured.

Question 25

Can I export analytics?

Accepted Answer

Yes. Dashboard → Analytics → Export provides CSV download for selected periods. You can filter by day or page to analyze performance.

Question 26

Is there a free plan?

Accepted Answer

Yes. We plan to publish a Free plan tier that lets you install and test the widget on your site. Follow the newsletter on the landing page and /docs/faq for plan details as they go live.

Question 27

How do upgrades work?

Accepted Answer

Use Dashboard → Billing to choose a plan. Upgrades take effect immediately; downgrades at the next cycle. Webhooks keep subscription status in sync, and features are gated accordingly.

Question 28

Which payment methods are supported?

Accepted Answer

Cards, UPI, and other popular options via our gateway. Invoices and tax details appear in your Billing page.

Question 29

Do you store chat content?

Accepted Answer

No, WhatsApp chats happen in WhatsApp. We only log widget events (impressions/opens/closes/clicks) and optional leads you intentionally submit. See the Privacy FAQ for details.

Question 30

Is my data secure?

Accepted Answer

We use Supabase with role-based access, server-side admin APIs where required, and Vercel for infrastructure. Sensitive environment variables are kept in Vercel project settings.

Question 31

I pasted the code but the bubble doesn’t show.

Accepted Answer

Check that you pasted the snippet before , that your theme isn’t stripping scripts, and that your CSP allows our script origin. See /docs/troubleshooting → Rendering & CSP for exact fixes.

Question 32

Clicks aren’t tracked.

Accepted Answer

Open your browser console and confirm no network/API errors. Make sure SUPABASE_SERVICE_ROLE is set in Vercel. Use the smoke-test endpoints in /docs/troubleshooting to verify inserts.

Question 33

Templates chooser always returns off_hours.

Accepted Answer

Make sure business hours are saved and the timezone is correct. For QA, pass inline hours to /api/templates/choose as shown in /docs/dashboard → Templates QA.

Question 34

WordPress: Where do I paste the code?

Accepted Answer

Use a header/footer injection plugin (e.g., Insert Headers and Footers) and paste the snippet into Footer. Or edit your theme’s footer.php and place it before . See /docs/install for notes.

Question 35

Webflow: What’s the right place for the snippet?

Accepted Answer

Project Settings → Custom Code → Footer Code. Publish the site and check the live domain. If you use per-page custom code, prefer the global Footer so it loads on all pages.

Question 36

Shopify: How do I edit theme.liquid?

Accepted Answer

Online Store → Themes → Edit code → layout/theme.liquid. Paste the snippet before . If using a JSON theme, ensure it’s the main layout file.

Question 37

Wix/Squarespace: Does it work?

Accepted Answer

Yes. Use code injection in site-wide footer or the custom code settings. If the platform sanitizes scripts, use the official code injection feature rather than raw HTML blocks.

Question 38

Next.js: Any special steps?

Accepted Answer

Add the snippet in app/layout.tsx (inside , right before ). Use the /api/auto-trigger URL directly—no need to import the script at build time.

Frequently Asked Questions

Getting started

Installation & setup

Templates & triggers

Languages

Business hours

Analytics

Billing & plans

Privacy & security

Troubleshooting

Platform mini-FAQs