DeskAdmin and settings
Keys, bans and the activity log
My keys #
Settings › My keys has these groups:
| Group | Who sees it | What it is for |
|---|---|---|
| Mine | Every member | Your personal access keys, for the API and the CLI |
| Members' keys | Admins | See which keys members have and revoke them; the keys themselves are never shown |
| Site keys | Admins | For your website to sign player tokens for the widget |
| Banned customers | Admins | Customers who are banned, with unban |
Personal access keys #
Select New key, then choose Read-only and an expiry (30, 90, 180 or 365 days). The key is shown only this once and cannot be viewed again. Each person can have up to 20 active keys. Revoke key cannot be undone, and calls using that key fail at once. Usage is in Authentication and conventions.
Site keys #
Site keys sign player tokens for your website; see Installing the web widget.
- Up to two can be active: after Rotate key the new key works at once, and the old one keeps working until you disable it. With two active keys, use Disable old key first.
- Disable key makes identity verification signed with it stop working at once.
Banning visitors #
In ⋯ in the conversation header, or in the customer profile, select Ban this customer…:
- Duration: 1 day, 7 days or permanent. Permanent bans and unbanning need an admin.
- The reason is optional, visible only to the team, up to 200 characters.
- You can tick to close the conversation at the same time.
A banned customer sees only "Chat isn't available right now." in the widget and cannot send messages. The banned list is in Settings › My keys, where admins can unban and change the default duration (1 day by default).
Activity log #
Settings › Activity log is for admins. It records who did each action, when, and through which route, including what customers and Ailo did.
- Filter by time (today, 7 days, 30 days, custom), member, action, result and sign-in events.
- Routes: Desk, API, CLI, Orbit, System.
- Export downloads a CSV with the current filters, up to 50,000 rows at a time.
- Records are kept for 365 days.
Sign-in and security #
Under "Sign-in & security" in Settings › My account:
- Signed-in devices lists browser and CLI sign-ins; sign out of one, or Sign out of other devices.
- Browser sign-ins end after 2 hours of inactivity and last at most 12 hours; CLI sign-ins end after 7 days of inactivity and last at most 30 days.
- Change password: enter your current password and a new one. Your other devices are signed out; this browser stays signed in.
- After 10 wrong passwords in a row the account is locked for 15 minutes. Passwords need at least 12 characters.