📘

Developers

Widget Docs

Embed the GlobeMeet widget in 5 minutes

Drop a single script tag on any page. Configure colors, queues, pre-call forms, and event hooks via data-attributes or the JS API.

5 min

Average integration time

12 KB

Gzipped bundle

TS types

@globemeet/widget-types

Stable v1

No breaking changes since launch

01

Quick start

Add the script tag with your tenant ID and queue ID. The widget renders a floating button that opens into a full WebRTC call when clicked. The customer sees a 'Talk to Us' button; clicking opens an in-page modal with a pre-call form and queue position.

02

JS API

Beyond the script tag, the widget exposes a global window.GlobeMeet object for programmatic control: open the modal, listen for events, push custom metadata into the session, and ask for CSAT after hangup.

  • GlobeMeet.open() — open the call modal programmatically
  • GlobeMeet.on('connected', cb) — fire when WebRTC connects
  • GlobeMeet.on('hangup', cb) — fire when call ends
  • GlobeMeet.setMetadata({ ticketId, customerId }) — pre-fill server-side context
  • GlobeMeet.askCSAT() — show a post-call rating prompt
  • GlobeMeet.theme({ primary, font }) — runtime theme updates
03

Framework recipes

Drop-in examples for Next.js, Vite + React, Vue 3, Angular, Svelte, plain HTML, WordPress, Shopify, and Webflow are in the developer portal. Each recipe is a 30-line wrapper around the script tag with framework-idiomatic event handling.

EX

Embed in any HTML page

html
<script
  src="https://cdn.globemeet.in/widget/v1/widget.js"
  data-tenant="acme-corp"
  data-queue="support"
  data-color="#1D4ED8"
  data-position="bottom-right"
  data-button-text="Talk to us"
  async
></script>

<script>
  window.addEventListener('globemeet:ready', () => {
    GlobeMeet.on('connected', (sessionId) => {
      console.log('Call connected:', sessionId);
    });
    GlobeMeet.setMetadata({ ticketId: 'T-1042' });
  });
</script>
SPEC

Technical specifications

Bundle size
12 KB gzipped
Browsers
Chrome 90+ · Safari 14+ · Firefox 88+ · Edge 90+
TypeScript
@globemeet/widget-types — full type defs
Event bus
Standard EventTarget — works with addEventListener
CSP
Self-hosted bundle option for strict CSPs
FAQ

Frequently asked questions

Download the bundle from your admin dashboard and serve it from your own CDN. Update the script src to your URL — everything else stays the same.

Yes. Use the JS API to register custom DOM partials for the pre-call form, queue display, or hangup screen. CSS variables cover most theming needs without DOM overrides.

Back to homeBook a free demo