Users

Know who you are talking to before the chat starts

A pre-chat form asks visitors for their details before they can send a message. You decide what you ask for, and whether people register, log in, or both.

This is for you if replies keep going nowhere because you have no email address to answer on, or if your chat is only meant for people who already have an account with you. Everything lives under Settings > Users.

Step by step

1

Decide what the form should do

Go to Settings > Users and open Require registration. You can choose a Registration form, a Registration and login form, or a Login form on its own. Pick the one that matches how you want people to reach you.

2

Choose what you ask for

Under Registration fields, enable only the fields you actually need. If you limit it to name, or to email alone, the form becomes a light pre-chat form rather than a full sign-up.

3

Enable the email field if you want a login form

The login form only appears when the email field is enabled under Registration fields. Without it, returning visitors have no way to identify themselves.

4

Set the wording of the login link email

Forgot password sends people a login link by email. Edit that message at Settings > Users > Login link email; it uses the email template. This option is available only when Require registration includes a login form.

5

Connect your own accounts if you have them

Fill in Login verification URL under Settings > Users to check sign-ins against your own system. We send email and password as URL parameters, and expect a JSON object back containing at least first_name.

Settings reference

SettingWhat it does
Require registration Turns the pre-chat form on and sets which form visitors see: Registration form, Registration and login form, or Login form.
Registration fields Chooses which details a visitor is asked for before the chat begins.
Login verification URL Checks the email and password against your own system and reads the user's details back from your response.
Login link email The wording of the email sent when someone uses Forgot password.

Good to know

No email field, no login form

The login form is tied to the email field. If that field is switched off under Registration fields, the login form will not appear at all.

An email already on file becomes a login

If someone registers with an email address that is already registered, a one-time code is sent so they can log in to the existing account instead of creating a second one.

Forgot password depends on the login form

The Forgot password link only exists when Require registration includes a login form. On a registration-only form there is nothing to recover.

People can arrive already logged in

Users can be logged in automatically through URL parameters, so returning customers do not have to fill the form again.

What your verification URL must return

The response has to be a JSON object with at least first_name in it. It can also carry last_name, email, profile_image, department, password and details.

You can skip the form on one page

Add var SB_REGISTRATION_REQUIRED = false; to a page to drop the mandatory registration there. Setting it to true forces the form on that page instead.

Common questions

Do I have to ask for a full set of details?
No. Enable only the fields you want under Settings > Users > Registration fields. Cutting it back to just a name, or just an email, gives you a light pre-chat form.
Why can nobody log in to the chat?
Check that the email field is enabled under Registration fields. The login form only appears when it is.
What happens if a visitor registers with an email we already have?
A one-time code is sent to that address so they can log in to their existing account rather than register again.
Can I use the accounts from my own website?
Yes, through Login verification URL at Settings > Users. We send email and password as URL parameters, and your system returns a JSON object containing at least first_name, and optionally last_name, email, profile_image, department, password and details.
Can I turn the form off on a single page?
Add var SB_REGISTRATION_REQUIRED = false; to that page. Use true on a page where you want registration forced.
How do I change the Forgot password email?
Edit it at Settings > Users > Login link email. It uses the email template, and it is only sent when Require registration includes a login form.

Ready to end the chaos?

Unify your messages, automate the repetitive questions, and turn conversations into revenue — starting today.

Get Started
Plans from $7/month · Cancel anytime