Add and manage chat users

A chat user is the username and password one person uses to sign in to Faustine Chat. Create one for each person. A new user reaches every gateway that is turned on for the chat.

Before you begin

Add a chat user

To add a user:

  1. In the portal, go to Faustine Chat and select Configuration.
  2. Under Access, select Users.
  3. Select Add user.
  4. Enter a Display name. It is optional and appears in the app.
  5. Check the Username. It is filled in from the display name and takes lowercase letters, digits, ., _ and -.
  6. Under Password, keep Generate for a random password of 20 characters, or select Type one and enter at least 12 characters.
  7. Select Create user.

The Chat user created dialog shows the username and the password. Copy them and send them to the person, with the address of the app shown in the dialog. The password is not shown again.

Reset a password

Resetting a password signs the user out everywhere.

  1. On the user's row, open the actions menu and select Reset password.
  2. Generate or type the new password.
  3. Select Reset password.

The Password reset dialog shows the new password once.

Let a locked user sign in

Five failed sign-ins in a row lock a user for 15 minutes, and the row shows a Locked badge. To let the user sign in before that, select Unlock on the row.

Sign out, disable or delete a user

The other actions are in the actions menu on each row.

Action What it does
Sign out everywhere Ends every active session of the user. The user can sign in again with the same password. The action appears when the user has an active session.
Disable Refuses sign-in and ends the user's sessions. Nothing is deleted. Enable reverses it.
Delete user Removes the user and ends every session. The user's conversations are not deleted.

Each row shows the user's state (Active, Locked or Disabled), the gateways the user reaches, the number of active sessions and the last sign-in.

Troubleshooting

Symptom Cause Fix
The Users tab warns "No gateway is enabled for the chat" Users can sign in, and the assistant has no gateway to call. Select Go to Gateways and turn on a gateway.
The user sees "Wrong username or password." The password was reset, or it was mistyped. Reset the password and send the new one.
The user sees "Too many attempts. Try again in … seconds." 10 failed sign-ins in one minute from the same address or for the same username. Wait for the time shown, which is 60 seconds at most.

Next steps

Last updated November 13, 2026