Webchat complete guide
The website chat in depth, in 32 chapters: install it, appearance, languages and AI translation, pre-chat, departments, hours, triggers, AI, the inbox and the developer side.
Video chapters
- 00:00 Introduction
- 00:41 What the Webchat is
- 01:08 Create the channel
- 01:41 Install it on your site Read this step →
- 02:21 The channel in the list
- 02:56 Embed code and installations
- 03:31 Name, color, typography and position Read this step →
- 04:05 Welcome message and avatar
- 04:38 Theme and branding
- 05:04 The chat button Read this step →
- 05:35 Widget language
- 06:10 Two-way AI translation Read this step →
- 06:42 Pre-chat form Read this step →
- 07:27 Department selector Read this step →
- 08:11 Business hours and out of hours Read this step →
- 08:50 Visitor sound and notifications
- 09:26 Auto-open
- 10:06 Proactive bubble and advisor photo
- 10:35 Triggers: the first one step by step Read this step →
- 11:25 All the conditions and AND/OR logic
- 12:06 All the actions, frequency and hiding
- 12:45 AI contextual greeting Read this step →
- 13:22 The channel's AI agent
- 14:10 What the visitor can do
- 14:45 Handle it from the inbox Read this step →
- 15:27 Resolve, survey and transcript
- 15:53 The returning visitor
- 16:23 On mobile
- 16:51 Secure user identification Read this step →
- 17:30 JavaScript API and attributes Read this step →
- 18:17 Co-browse
- 18:28 Good practices
- 18:52 Troubleshooting Read this step →
- 19:21 Wrap-up
This is the complete guide to the Omnifox Webchat, in 32 chapters: creating the channel and installing it on a real website, every appearance option, widget language and two-way AI translation, the pre-chat form, departments, business hours, auto-open and behavioral triggers, the AI greeting and the channel's AI agent, the visitor's experience, the inbox, secure identification and the JavaScript API. The PDF manual has the same chapters with screenshots, every field and every limit.
1. What the Webchat is
The Webchat is a chat button that appears on your site. The visitor clicks, writes, and their message instantly reaches your Omnifox inbox, where someone from your team or an artificial intelligence agent handles it.
Behind that button there's much more: you can ask for details before chatting, let the visitor choose the department, greet only on certain pages, answer outside business hours and recognize customers who are already signed in. The Webchat is included in every plan.
2. Create the channel
To create it go to Settings, Channels, and click Connect new channel. All the platforms you can connect appear; choose Webchat.
Give the channel a name, which is how you'll see it inside Omnifox, for example with your website's domain. Then the widget name, which is the title the visitor sees in the chat; your brand's main color; and a welcome message.
Below, in Widget language, you choose which language the visitor sees the chat texts in and which one your team writes in; automatic AI translation is turned on later, in the Languages tab. Click Save and get code.
3. Install it on your site
Omnifox gives you the embed code: a single line. Copy it with the button. It goes on every page of your site, right before the closing body tag.
This is the Volcán Outdoor store, still without a chat. Its panel has a section to add code to every page; we paste the line and save. On WordPress, Shopify, Wix or any other platform, look for the option to insert code in the footer or an extension that allows it; if you use Google Tag Manager, it also works as a custom HTML tag.
We reload the store and there's the chat button. We go back to Omnifox, click Verify installation, and Omnifox confirms it detected the widget on our domain. The channel is now active.
4. The channel in the list
In the channel list, the Webchat has its card with its status and last check. Its buttons are: the health check, Edit, which opens the same wizard as when creating it, and Embed code, which takes you to the full widget editor, where we'll spend most of this guide.
You also have the Artificial Intelligence button, with a green dot when AI answers on this channel, pause the channel, and delete it.
Pausing is useful if you want to turn the chat off for a while without losing anything: the widget stops showing and Omnifox stops monitoring the channel; when you reactivate it, it comes back exactly as it was. Deleting, on the other hand, removes the channel and its settings, and asks you to confirm.
5. Embed code and installations
The widget editor has eight tabs. Let's start with Embed code: your line of code is always here to copy again, and below it, Detected installations.
Omnifox records which domains your widget was loaded on and when it last happened. If you put it on several websites, you'll see them all, with the most recent one marked. It's the fastest way to check the code is still installed.
An important detail: the code stays the same forever. You can change colors, texts, hours or triggers as often as you like without touching your site again, because the widget reads the settings from Omnifox every time a page loads.
6. Name, color, typography and position
Let's move on to Appearance. On the left, the theme editor; on the right, the live preview, which changes with every setting.
The widget name is the chat title. The primary color paints the button, the header and the visitor's messages; the text on top turns white or black by itself so it's always readable. Choose the typography and the position, bottom right or bottom left.
The subtitle is the small line under the name; if you leave it empty it says We usually reply in minutes. We save the appearance, reload the store, and the chat now looks like Volcán Outdoor.
7. Welcome message and avatar
The welcome message is the first thing the visitor sees when opening the chat, as if your team had written it. It's shown once per visitor: if they come back another day, it isn't repeated.
The header avatar is the round photo or logo in the header: you upload it, in PNG, JPG or WebP, and Omnifox optimizes it. And with Show who is replying in the header, when someone answers, the header switches to that person's or the AI agent's photo and name.
We save, and a new visitor entering the store already sees the welcome, with the Volcán Outdoor logo in the header.
8. Theme and branding
The theme mode can be light, dark or automatic, which follows whatever the visitor has chosen on their device. The message shape chooses between rounded or squarer bubbles.
And the Show Powered by Omnifox switch controls the footer with our brand inside the chat.
Each tab of the editor has its own save button: if you change something in Appearance and go to another tab without saving, that change is lost. Always save before leaving the tab.
9. The chat button
Now the floating button. With Bubble size you choose its diameter, from forty to seventy-two pixels.
Show text next to the button turns it into a pill with text next to the icon, like Message us. You choose whether the text goes to the right or left, whether it shows on desktop, on mobile or both, and whether the visitor can minimize it with a small x.
The attention animation makes the button pulse, bounce, shake or ring every so often. And you can use the advisor's photo as the button icon. We save and look at the result in the store.
10. Widget language
In the Languages tab you choose the widget language: Spanish, English or Portuguese. With automatic detection on, each visitor sees it in their browser's language, and if it isn't one of those three, in the one you chose.
You can also show a language selector in the chat header, so the visitor can change it. And if your site has several versions, each page can force the language with the data locale attribute in the code.
The language changes all the widget texts: the form, the buttons, the notices and the out-of-hours message. What you write yourself, like the welcome, is shown as is, so write it in your customers' language.
11. Two-way AI translation
Two-way translation lets the visitor and your agent each talk in their own language: the AI translates the messages in both directions, in real time. It's available from the Crece plan.
You choose your agent's language and the visitor's default language, and you can show the Translated by AI notice inside the chat. Here you also see the month's translation usage.
Let's try it. A visitor writes in Spanish. In the inbox, Valeria reads it in English, replies in English, and the visitor gets the reply in Spanish.
12. Pre-chat form
In Pre-chat, the form asks for details before the chat starts. It's off by default; when you turn it on, you add up to ten fields.
Each field can be a standard contact field, like name, email or phone; one of your custom fields; or another free question, of type text, text area, number, email, phone or a list of options. And you mark it as required if it can't be skipped.
Standard and custom fields are saved straight to the contact record; free questions stay in the conversation. This is how the visitor sees it: first the form, then the chat.
With the form off, the widget still behaves well: the conversation starts with the first message, and the contact shows as Visitor followed by a code until you know their name.
13. Department selector
The department selector lets the visitor choose which team they want to talk to. The departments are your workspace teams: you tick which ones to show, and you can give each one a name for the visitor, a color and an icon. You reorder them by dragging.
If selection is required, the visitor can't skip it; if not, Continue without choosing appears. It comes after the form: first the details, then the department, and then the chat.
The visitor chooses After-sales support, writes, and the conversation comes in assigned to that team, distributed according to the team's strategy. Here it went to Diego.
If you don't have teams yet, the selector tells you: create them first in Settings, Teams, with their members and how they distribute work.
14. Business hours and out of hours
In Availability you set your hours: the time zone and, for each day, whether you're open and from what time to what time. Hours that cross midnight are accepted too. If you don't turn on any day, the chat always shows as available.
Outside those hours, the visitor sees your away message. And if you turn on Capture name and email, they leave their details before writing, so no contact is lost even if nobody is online.
To see it, let's say we've already closed for today. In the store, the chat says we're outside business hours and asks for name and email. The conversation still reaches the inbox, to answer the next day.
15. Visitor sound and notifications
At the top of the same tab are the visitor notifications. Play a sound plays when your team replies and the chat is minimized or the tab is in the background.
And browser notifications make the tab title blink and, if the visitor allows it, show a desktop notice. On top of that, the chat button shows a red counter with unread messages.
If the visitor closed the chat and your agent replies, the chat reopens by itself with the new message, so they don't miss it. Let's try it: the visitor asks something and minimizes the chat; Valeria replies from the inbox, and in the store the chat reopens by itself, with her reply.
16. Auto-open
The Triggers tab starts with four ready-made behaviors, all off by default. Auto-open after a delay opens the chat by itself after a few seconds. The proactive greeting bubble shows a message next to the button, in Spanish, English and Portuguese, without opening the chat.
Auto-open on these pages opens it only on the paths you write, one per line, like the cart. And Open on exit intent opens it when the cursor moves up, about to close the tab; that only happens on desktop.
Two rules so it isn't annoying: if the visitor closes the chat, it won't reopen by itself for thirty seconds, and on mobile it never opens by itself. We turn on auto-open on the cart and check it.
17. Proactive bubble and advisor photo
In Appearance, the Proactive bubble and attention block decides how those greetings look. You give it an advisor's photo and name, and the green online dot, so the greeting feels like it's from a real person.
You choose the entrance animation, whether bubbles stack or replace each other, and a subtle sound when they appear.
The advisor's photo can also replace the button icon, as we saw earlier. If you don't upload a photo here, the header avatar is used.
18. Triggers: the first one step by step
Below are the behavioral triggers: rules you build. Each one has a When, with one or more conditions, and a Then, with the action. Let's create one: when someone has been looking at the tents page for ten seconds.
We add the condition URL contains tents, and another for time on page: ten seconds. With the All conditions logic, both have to be met.
The action: show a greeting bubble, split into a sequence of two messages. And when the visitor opens the chat, we start a conversation with Vela, our AI agent, with the goal of helping them choose their tent.
We save and go to the store. We enter the tents page, wait, and the two bubbles appear. When the chat opens, Vela is already typing, and she knows which page the visitor is on.
19. All the conditions and AND/OR logic
These are all the conditions: time on page, how far they scrolled down, in percent or pixels, exit intent, the page address, inactivity, the device, whether desktop, mobile or tablet, and The visitor opens the chat.
For the address you have four operators: contains, is exactly, starts with and does not contain. For example, only the home page is the slash path with Is exactly. And with Any condition, one is enough. Each trigger allows up to ten conditions, and you can have thirty triggers.
Inactivity is met when the visitor stops moving the mouse, scrolling or typing for the seconds you set, from five. And The visitor opens the chat is for actions that should only happen once the person has shown interest.
20. All the actions, frequency and hiding
In the Then you can open the widget, show a bubble, hide the widget, send an automatic message and then assign the conversation, start an AI conversation, assign to a person, a team or an AI agent, run a workflow, or show the department selector or the form.
The frequency decides how often it repeats: once per session, on every page load, every time it's met, once a day, or only once per visitor. And Auto-hide bubbles removes them after a few seconds if nobody touches them.
Server actions, like sending a message, assigning or running a workflow, happen only once per conversation, even if the visitor reloads. And in Show a bubble you can add, under When the visitor opens the chat, several actions that run in order.
21. AI contextual greeting
The AI tab has the contextual greeting: when the visitor opens the chat, the AI reads the page they're on and writes a tailored welcome. You don't need to create any agent: it uses the platform's engine.
The cooldown decides how often it greets the same person; once per session is recommended, because each greeting uses AI. We turn it on and open the chat on the shipping page: the greeting talks precisely about shipping. If the visitor replies, that greeting is saved in the conversation.
If you have the AI greeting and also a trigger that starts an AI conversation when the chat opens, the visitor would get two greetings: use one of the two on each page.
22. The channel's AI agent
For an AI agent to answer messages, go to the channel's Artificial Intelligence screen. Choose the agent, here Vela, and the reply strategy: Disabled, Always, or New conversations only.
From now on Vela answers. A visitor asks about shipping to Cuenca and Vela replies with the store's real details. When they ask to talk to a person to buy, Vela hands the conversation over to the Sales team: it arrives in the inbox assigned, with an AI summary, and Vela pauses so a person can answer. How to create and train the agent is in the complete guide to AI Agents.
With Always, Vela answers as long as the conversation is in her hands; as soon as a person takes it or transfers it to a team, Vela stops answering. With New conversations only, she takes those that start from that moment and leaves existing ones alone.
23. What the visitor can do
On the visitor's side, the chat has everything they expect from modern messaging. With the paperclip they attach photos, PDFs, audio or video, up to twenty megabytes; images show as thumbnails and enlarge with a click.
It has its own emoji panel, and with the microphone they record a voice note of up to three minutes. Links become clickable, and your messages can include bold and lists.
While your agent types, the visitor sees the typing indicator, and your agent also sees when the visitor is typing. And each message shows when it was delivered and when it was read.
24. Handle it from the inbox
In the inbox, Webchat conversations carry the web chat icon. The green dot means the visitor is online right now, with the site open.
In the contact panel, Web visitor shows the page they wrote from, where they came from, the pages they've written from and their browser and device. And if they filled in the form, their answers are under Pre-chat.
You reply as on any channel: with quick replies, like slash shipping, internal notes for your team, or assigning to a colleague. Everything reaches the visitor instantly.
If the visitor closes the tab, the dot turns off and the header shows when they were last seen. Your reply still reaches them: they'll see it as soon as they come back to your site in that browser.
25. Resolve, survey and transcript
When the case is done, you mark the conversation as resolved. The visitor sees the notice that the conversation was resolved and, if your satisfaction survey is on, rates the service right there, with stars and a comment.
The rating reaches the conversation and your reports. If the email transcript is on, the visitor can ask for a copy of the chat to be sent to their email. And with Start new conversation they begin another one whenever they want.
26. The returning visitor
The Webchat remembers the visitor in that browser. If they reload, change page or come back later, they see their conversation just as they left it.
If they write again shortly after it was resolved, the same conversation reopens, and in your inbox it's still the same contact, with all their history.
That's why, when a customer shares a computer or switches accounts on your site, it's best to call Omnifox dot logout on sign-out: the widget forgets the previous visitor and the next one starts from scratch.
27. On mobile
On mobile, the chat opens full screen and adjusts to the keyboard. At the bottom it has a big Back to website button, so nobody gets stuck if they opened it by accident; the phone's back button works too.
The text next to the button can show only on mobile or only on desktop, and on mobile the chat never opens by itself: bubbles do appear, and the visitor decides whether to tap them.
The editor preview shows the desktop chat, so after big changes, open it from your phone too to see how it looks.
28. Secure user identification
If your site has customers who sign in, the User identification tab lets you recognize them securely. Your server signs the user's identifier with this secret key, and your page passes that identifier, the signature and their details to the widget.
Here are the examples in PHP, Node and Python, and the Omnifox dot identify call. The key never goes in the browser, and if you regenerate it, previous signatures stop working instantly.
In the store, Martina signs in and opens her account; the site identifies her with her signature. She writes, and in the inbox the conversation arrives under Martina Gómez, with her email, linked to her customer record even if she changes computers.
29. JavaScript API and attributes
For developers, the widget has a small API. Omnifox dot open opens the chat, close closes it, toggle switches it, isOpen tells you whether it's open, and logout clears the visitor's session, for example when your customer signs out.
In the store, the Talk to an advisor button opens the chat with Omnifox dot open. And the embed code accepts attributes to change, on one page, the color, the position, the name, the greeting, the language or a custom bubble.
On top of that, the widget sends events to your Google Analytics or Tag Manager: it loaded, it opened, a conversation started and a message was sent. That way you measure how many sales start in the chat.
A tip: since the code loads asynchronously, if you call the API as soon as the page loads, wait for the browser's load event, or use the command queue shown in the Identification tab.
30. Co-browse
Webchat conversations also have the Co-browse button, to see the visitor's screen and guide them inside your site, with their permission. It's an add-on, and it has its own complete guide in the help center.
31. Good practices
Some good practices: use a short, concrete greeting, and trigger it only where it helps, like on the cart or pricing pages. Don't ask for more details in the form than you need. Set your hours and an honest away message.
Connect an AI agent to reply instantly and hand over to a person what matters. And check Detected installations from time to time, to know where your chat is.
32. Troubleshooting
If the chat doesn't appear, check that the code is on every page, that the channel isn't paused, and try in an incognito window, without extensions that block scripts. If a change doesn't show, reload the page: the widget reads your settings on every load.
If the form or the departments don't show up again, that's on purpose: the widget doesn't ask twice someone who already has an open conversation. Try in incognito. And if the voice note doesn't record, the visitor has to allow the microphone in their browser.
Related articles
-
WhatsApp (Meta) error codes: what they mean and what to do
A table of the most common Meta error codes when sending on WhatsApp (131026, 131047, 131049, 130497, 141006, 131031, 131056, 132000, 190, 368…) and how to fix each one.
-
How to connect Telegram
Connect a Telegram bot to your Omnifox inbox in minutes using BotFather.
-
Instagram and Facebook comments: reply and moderate from Omnifox
See and answer comments on your Facebook and Instagram posts and ads, publicly or privately, and set up automatic replies.
-
Sending and receiving videos on each channel: formats and size limits
Which videos you can send and receive on WhatsApp, Instagram, Messenger, Telegram, web chat and email, the real size limits, and what to do with a large video.
-
Move from WhatsApp QR to Coexistence or Cloud API
Once you're done testing with the QR code, move your number to the official connection: no caps, with templates and broadcasts, and no volume-based ban risk.