Skip to content

Customise the chat widget

Updated 1 min read
On this page/ Configure it in code

The chat widget works out of the box, but you can change how it looks, when it appears and what it knows about the visitor.

Configure it in code

Set options before the widget script loads:

<script>
  window.relaypointSettings = {
    workspace: 'acme-support',
    position: 'bottom-right',
    greeting: 'Hi! How can we help?',
    hideOnPaths: ['/checkout'],
  };
</script>
<script src="https://widget.relaypoint.example/v1.js" async></script>

Identify signed-in users

Pass the visitor's details so agents see who they're talking to. Sign the email on your server so nobody can impersonate a customer:

$hash = hash_hmac('sha256', $user->email, config('services.relaypoint.identity_secret'));
window.relaypointSettings.user = {
  email: 'alex@example.com',
  name: 'Alex Rivera',
  hash: '<the value from your server>',
};

Options

Option Type Default
position bottom-right | bottom-left bottom-right
greeting string Your workspace greeting
hideOnPaths string[] []
openOnLoad boolean false
Was this page helpful?