Skip to main content
The Settings > Widget page creates and manages keys for the receptionist widget. Visitors can chat, leave contact details, and start a browser call from the widget.

​
Configure the widget

1

Open Widget settings

Go to Settings > Widget.
2

Configure its appearance

Choose the color, position, title, subtitle, greeting, and language behavior.
3

Configure lead capture

Enable the lead form, choose required contact fields, and decide whether it appears before chat.
4

Set allowed websites

Enter each exact public origin that can embed the widget, such as https://www.example.com.
5

Copy the installation snippet

Copy the generated loader snippet and add it before the closing </body> tag on your website.

​
Protect web calls

LobbyStack signs widget sessions and checks the visitor’s parent origin. Your self-hosted voice gateway must also include the website origin in WEB_CALL_ALLOWED_ORIGINS. Use an HTTPS website in production. Keep WIDGET_SESSION_SECRET and other signing credentials on the server.

​
Manage widget keys

Each key has its own origin allowlist and configuration. You can edit an active key, pause it temporarily, or revoke it permanently. Revoking a key stops every embed that uses it.

​
Verify the installation

Open the public website in a private browser window. Confirm that the widget loads, starts a chat, and displays the contact form. If web calls are enabled, grant microphone access and place a test call.