Help center
Quick guides for installing and customising Overcap. Need help with something specific? Email us.
Install on WordPressWPCode plugin, functions.php, or any header-and-footer plugin. Step-by-step.
1. Sign up and create a website in /dashboard/websites.
2. Copy the WordPress snippet (the <script> tag).
3. Install the WPCode plugin (or any 'Insert headers and footers' plugin).
4. Add a new HTML snippet → location: Site Wide Footer → paste → Save.
5. Clear your cache plugin (WP Rocket / W3 Total Cache / etc).
6. Hard-reload your site (Ctrl + Shift + R). The chat button should appear.
Install on plain HTML or TildaJust one <script> tag before </body>. Works on any static site.
Copy the HTML snippet from /dashboard/websites.
Paste it before </body> in your template.
If you use a builder (Tilda, Webflow, Wix), look for the 'Custom HTML' or 'Embed code' setting and paste there.
Install on ShopifyOnline Store → Themes → Edit code → theme.liquid.
Online Store → Themes → click 'Actions' → Edit code.
Open Layout → theme.liquid.
Paste the snippet immediately before the </body> tag.
Save. The widget appears on all pages.
Install on React / Next.jsMount once in your root layout — no SSR conflicts.
Drop the <OmnichatWidget /> component (provided in the React snippet) into your root layout or _app.tsx.
It mounts the script tag once on first render and skips on the server side.
If you use Tag Manager, prefer the GTM tag over inlining in React.
Configure heatmap trackingHeatmap is on by default. How to tune it for privacy and performance.
/dashboard/websites/{id}/customize → Tracking tab.
sample rate: drop to 0.2 to reduce events on high-traffic sites.
respect DNT: enable to skip visitors with Do-Not-Track on.
mask inputs: ON by default — keystrokes inside form fields are never recorded.
Customize the widgetColors, logo, position, working hours, pre-chat form.
Quick presets: 6 ready-made color combinations one click away.
Logo: paste a URL — appears in widget header.
Position: 4 corners.
Working hours: when offline, the widget shows an offline message and queues messages.
Pre-chat form: collect name + email before chat starts.
Auto-responses & canned repliesReply to common questions automatically.
/customize → Auto-Responses: trigger phrase → reply.
First-response delay: e.g. send a welcome message 2 seconds after chat opens.
Canned responses (saved in Settings): operators can insert with /shortcut while typing.
API referenceEmbed widget on advanced setups, programmatic conversation creation.
Widget API: window.Omnichat.open(), .close(), .toggle(), .identify({name,email}), .setContext({...}).
REST: POST /api/widget/conversation, POST /api/widget/message.
Server-Sent Events for realtime: GET /api/widget/realtime?conversationId=...