MyVisitorsDocs

Live chat & Inbox

The Message widget type adds a live chat bubble to your website. Visitors can start conversations and your team responds from the Inbox.

Setting up chat

On Campaigns, choose Talk to visitors → Live chat. With Show everything on, you can also create a widget with channel type Message in Widgets.

Configure the welcome message and pre-chat form (optional — you can ask for name/email before the chat starts).

Publish the widget. A chat bubble appears on your site.

Add your team members as chat agents under Settings → Team.

How conversations work

When a visitor opens the chat bubble for the first time, a Conversationis created. The visitor's external ID (stored in their browser's localStorage) ties all their messages together across page refreshes. If the visitor provides an email or name in the pre-chat form, it is stored on their profile.

The visitor polls for new messages every ~3 seconds. Agents reply from the Inbox in the dashboard.

When the visitor has left, your reply still reaches them. If they gave their email, it's emailed to them. When they come back to your site in the same browser, within 30 days, the reply shows as a card above the chat bubble, and the bubble keeps a red dot until they open the chat.

Inbox

The Inbox (Inbox in the sidebar, in both views) shows all conversations across all sites in your org, filtered by status:

  • Open — active conversations waiting for or currently receiving responses.
  • Pending — conversations flagged as pending further action.
  • Closed — resolved conversations, kept for reference.

Click any conversation to open the full thread and reply. The Inbox shows 50 conversations per page. Use the status tabs and search to find specific threads.

Unread indicators

Messages sent by visitors are marked as unread by agent until an agent opens the conversation thread. Messages sent by agents are marked as read by visitoronce the visitor opens the chat. The card that shows a waiting reply doesn't count.

Assigning conversations

Open a conversation and use the Assigndropdown to assign it to a specific agent. Assigned conversations appear prominently in that agent's view.

Closing conversations

Click Close on a conversation to mark it as resolved. Closed conversations move to the Closed tab. If the visitor sends another message, the conversation automatically re-opens.

Push notifications for agents

Agents who have the MyVisitors mobile appinstalled will receive a push notification whenever a visitor sends a new message. The notification shows the visitor's name and the first line of their message.

Mobile app required for push notifications

Push notifications are only delivered to agents who have logged in on the mobile app and granted notification permissions. Desktop browser notifications are not supported yet.

Chat availability

You can configure the chat widget to show a custom message when no agents are available (e.g. outside business hours). Set this in the widget's settings under Offline message.

Visitor identity

Visitors are identified by a UUID generated and stored in their browser's localStorage. If a visitor clears their storage, they start a new conversation. If the pre-chat form captures their email, subsequent conversations from the same email can be correlated manually in the Inbox.

Conversation ownership

The chat API verifies that the visitor sending a message actually owns the conversation. A visitor cannot read or write to another visitor's conversation even if they know the conversation ID.