Skip to content
Fogbender Docs

Visitor

If you’d like to let visitors chat with your team before creating an account, you can enable visitor mode in the Fogbender widget. To do this, you’ll need to slightly adjust your token format:

#Visitor Token Format

const token = {
  widgetId: "your-widget-id", // from https://fogbender.com/admin/-/-/settings/embed
  visitorKey: "your-visitor-key", // from https://fogbender.com/admin/-/-/settings/embed
  visitor: true,
};

#Enable Visitor Widget

You can find your visitorKey and enable visitor mode in the same place—under embedding settings. The key is always available, but the feature must be enabled for it to work.

Enable Vistior key in embedding instructions

#Visitor Widget Security

Visitor mode is designed to allow anonymous users to start chatting with your team without creating an account. Since the visitorKey is exposed on the client side, it’s technically possible for someone to script visitor creation as a form of denial-of-service. To mitigate this, visitor mode can be disabled at any time from your embedding settings, and you can regenerate the visitorKey as needed.

To reduce unnecessary visitor creation—for example, when a user reloads the page—Fogbender stores the visitor ID in localStorage. This applies to both embedded widgets (via <iframe>) and hyperlink widgets.

Visitor names are automatically generated in a human-readable format like Fierce Cricket from Diomira, and all visitor messages appear in private rooms (never shared between visitors) that are accessible to all agents on your team, plus the visitor themselves.

Visitors can optionally enter and verify their email address. When they do, Fogbender creates a permanent user account associated with that email and adds that user to the same private room. Under the hood, these rooms are multi-user private conversations—so agents will see both the anonymous visitor and the verified user as separate participants. If the same person verifies their email across multiple anonymous sessions, they’ll see the full history of those conversations as soon as their email is verified.

Visitor not so anonymous anymore

Note: Email enrichment info unavailable appears because our account with apollo.io was deleted, apparently for fun. If you know of a reverse email lookup service that doesn’t require an investment from a16z, a marriage proposal or a kidney donation, we’re all ears!