Skip to content
Docs
Esc
↑↓navigate↵open⌘Jpreview
On this page

Agent Security

Protect your agent from abuse with a rate limit, and verify signed-in users with user identification.

In your agent, go to Settings and scroll to the Security section.

Rate limit

The rate limit caps how many messages one device can send in a period of time on the web widget and Public Chat. It protects your agent, and your credits, from spam and automated abuse.

  • Limit to: the number of messages allowed.
  • Every (seconds): the length of the period.
  • Message to show when limit is hit: what the visitor sees when they reach the limit, for example “Too many messages in a row”.

Select Reset to go back to the defaults: 20 messages every 240 seconds.

User identification

User identification lets your website tell Chatvox who a signed-in user is, using a token signed with a secret. Conversations are then linked to the right contact. It also unlocks signed-in-only actions and widget functions for that visitor (see Visitor access).

From this section you can:

  • Generate secret: create the agent’s secret.
  • Copy: copy it to store on your server.
  • Rotate: replace it. Tokens signed with the old secret stop working immediately, and the last verified time is reset.
  • Integration guide: see quick setup examples and how to keep visitors signed in.
  • Status and last verified: see whether the agent is waiting for its first signed-in visitor or the time the last signed-in visitor was verified.

Only team members who can edit the agent can see and manage the secret. Free plans receive no secret; downgrading preserves your existing secret.

For the full setup, see User identification.

Other ways to protect your agent