Live chat
Live chat (async-first message-us widget)
This manual is a draft and may change.
What it does
Live chat adds a "message us" box to chosen pages of your website. Visitors leave a question, and your team answers from one inbox, even if the visitor has left and comes back later.
Who uses it
Operators (your front desk or support people) read and answer conversations in the Live chat tab. Viewers can read conversations but not answer. Customers who are signed in can look back at their conversations in My chats.
Setup
- Ask your 1vsM contact to install Live chat (async-first message-us widget) on your site.
- It installs these first, automatically: Contacts, Activity, Discuss, Outbox + bridge dispatcher.
- In the app's settings, enter the private security key for chat (your developer supplies a long random value).
- Set New conversations per visitor IP per hour (default 5) and Visitor messages per conversation per minute (default 6).
- Enter your office hours with your time zone. If you leave them empty, chat never claims to be online.
- Leave Compose offline email replies off unless you want replies to be prepared for email to people who have agreed to receive email.
- Ask your developer to choose which pages show the box, then give your team the Live chat operator role.
Admin tasks
Live chat
- Open Live chat. Use Open, Assigned to me or Closed to choose a list. Conversations waiting for an answer show Needs reply.
- Open a conversation to see the visitor's email, phone, email consent, status, the page they were on, and who it is assigned to.
- Type your answer in Reply to the visitor and press Send reply.
- Use Internal note and Add note for things only your team should see.
- Press Assign to me to take the conversation.
- Press Close conversation when finished; Reopen brings it back.
- Use All conversations to go back to the list.
Member view
Visitors see the message box, which tells them whether you are online ("We're here...") or offline ("Leave a message..."). They give a name, an email or phone number, and a message. Signed-in members have a My chats tab listing their past conversations with your team. Internal notes are never shown.
Styling it to your brand
Your site takes its colours, fonts and corners from the brand profile you enter once in 1vsm.com's Brand intake, and that applies to every app automatically. A few parts of this app still use fixed colours and will match your brand after the next update.
Troubleshooting
- The message box does not appear. It only shows on the pages chosen for it; ask your developer to check the page list.
- A visitor sees "Leave an email address or a phone number so we can reply." They need to give at least one way to reach them.
- "Please write a message." The message was empty or too long.
- A visitor is told too many attempts. The hourly limit per visitor was reached; wait or raise the limit in settings.
- "Your role cannot do that." Only operators can reply, assign or close; ask for the Live chat operator role.
- "Invalid or missing CSRF token." The page sat open too long; reload and try again.
FAQ
Does it work when nobody is online? Yes. Messages wait in the inbox.
Is it instant like a phone call? No. It checks for new messages regularly rather than instantly.
Does a chat sign someone up to emails? No. They become a contact whose email permission stays "unknown".
Can the visitor see my notes? No, internal notes stay private.
What to connect
Nothing to connect: this app works with what is already on your site. Your brand colours, contact details and social links come from Set up your site.