Configuration

Configure the widget by setting properties on window.receiveo before the loader script runs.

<script>
    window.receiveo = window.receiveo || {};
    window.receiveo.publicKey = "pk_live_YOUR_KEY_HERE";
    window.receiveo.showBubbleOnLoad = false;
    window.receiveo.hideBubbleOnClose = true;
</script>
<script src="https://widget.receiveo.com/loader.js" async></script>

Options Reference

publicKey (required)

Type	string
Default	—

Your workspace’s public key. Found in Settings → Widget Installation.

window.receiveo.publicKey = "pk_live_ABC123";

showBubbleOnLoad

Type	boolean
Default	true

Whether the chat bubble is visible when the widget loads. Set to false to start the widget completely hidden — useful for headless mode where you control visibility with your own UI.

window.receiveo.showBubbleOnLoad = false;

Tip

Even when showBubbleOnLoad is false, the widget fully initializes in the background. You can call receiveo.api.open() at any time to show the chat window.

hideBubbleOnClose

Type	boolean
Default	false

When true, closing the chat window also hides the chat bubble. The bubble won’t reappear until you call receiveo.api.showBubble().

window.receiveo.hideBubbleOnClose = true;

openOnLoad

Type	boolean
Default	false

Automatically opens the chat window when the widget finishes loading.

window.receiveo.openOnLoad = true;

demo

Type	boolean
Default	false

Marks all conversations as demo mode. Useful for testing.

window.receiveo.demo = true;

debug

Type	boolean
Default	false

Enables console logging for debugging widget issues.

window.receiveo.debug = true;

apiUrl

Type	string
Default	Production URL

Override the API endpoint. Only needed for self-hosted or development setups.

window.receiveo.apiUrl = "https://api.your-domain.com";