All articles

Add the Website Chat widget to your site

Website Chat puts your AI assistant on your own website — a chat bubble that answers visitors from the same knowledge base and the same bot brain as your WhatsApp. Visitor conversations land in the same inbox.

Website Chat is available on every plan. On the Pro plan you can also remove the "Powered by nashir.ai" badge from the widget.

  1. Open Connect → Channels from the sidebar, find the Website Chat card, press Create widget, and pick the business it should answer for. You get one widget per business — the widget answers from that business's knowledge base.

/accounts

  1. In the builder, set your brand color, upload your logo, and write a greeting (Arabic and English). A live preview updates as you type.
  2. ⚠️ Add your website's domain to "Allowed domains" and press Save — this is the one step people miss. The widget only works on the domains you list here; it stays hidden everywhere else. Enter the exact hostname with no https:// and no path — for example shop.example.com. Add every domain the widget should appear on, each on its own line.
  3. Copy the one-line snippet and paste it into your site just before the closing </body> tag. It looks like this:

<script async src="https://nashir.ai/widget.js" data-nashir-key="wc_..."></script>

  • Plain HTML: paste it before </body> in your page template.
  • WordPress: use a "Insert Headers and Footers" plugin (or your theme's Footer Code box) and paste it in the Footer/Body section.
  • Odoo: add an Embed Code / HTML building block to your site (or Website → Settings → Custom Code, in the body) and paste the snippet.
  1. Open your website in a normal browser tab. The install check in the builder turns green automatically the first time the widget loads from an allowed domain.

Continue on WhatsApp (optional)

The widget can offer visitors a Continue on WhatsApp option: a link under the message box, where the visitor leaves their WhatsApp number to carry on the conversation there — and, where phone capture is active, the same WhatsApp form at the moments described below. It is off by default.

  • Turn it on in the builder with Show "Continue on WhatsApp", then press Save.
  • It can only be turned on when the business has a connected WhatsApp number.
  • If that number is disconnected later, the widget stops showing the option by itself, and the builder shows the setting as paused. Your choice is kept: the option comes back on its own as soon as a number is connected again.
  • While it is off or paused, the bot is also told not to suggest moving the conversation to WhatsApp.
  • WhatsApp messages you send these visitors later may be billed by Meta.

Asking visitors for a phone number

The widget can ask a visitor for a phone number at a moment that justifies it, so your team can get back to them — never as a gate before the chat starts.

  • When it asks: when the bot hands the chat to your team, or when a visitor asks about prices, ordering or booking (after the bot has answered).
  • When it doesn't: if the visitor already left a number, if the bot is already asking for one in the chat (for example to complete a booking), if the visitor typed a number themselves, or for 7 days after they tap Not now.
  • The number is saved on the visitor's contact, with a record of what they agreed to. Their deal stays on the website conversation — contact them from the contact page.
  • How visitors agree: on this form, the line under Send tells them that sending their number means you may contact them about their enquiry — there is no box to tick. The WhatsApp form (below) keeps a box they must tick themselves, because WhatsApp requires an explicit opt-in.
  • If Continue on WhatsApp is on, visitors are offered WhatsApp instead: the number joins your WhatsApp audience and the deal moves to the WhatsApp contact.
  • A number is never saved for a visitor marked do-not-contact, or one who opted out of your WhatsApp messages.
  • It's on by default. Turn it off in the builder with Ask for a phone number at the right moment.

A character, a greeting bubble and buttons (optional)

You can give your chat a character of its own that greets visitors, thinks while it answers and smiles when it has helped. You can also let it greet visitors next to the chat button and offer ready-made first messages. All of this is in the Character section of the builder, and all of it is off until you turn it on.

  • The character: it appears on the round chat button (in place of the chat icon), at the top of the open chat, and beside the assistant's replies — once per group of replies, not beside every message. It has six moods that change by themselves:
  • Hello — with the greeting bubble, and when a visitor first opens the chat.
  • Thinking — while your assistant is writing its answer.
  • Happy — right after your assistant answers.
  • Caring — when a message does not send, or the chat is handed to your team.
  • Pointing — when buttons are on screen for the visitor to tap.
  • Main picture — the rest of the time.
  • Two ways to get a character:
  • Pick a ready character, when ready characters are offered in the builder. Press one to use it; press it again to stop.
  • Upload your own: six pictures of the same character, one for each mood. Start with the main picture — it is enough on its own. Any mood you leave empty uses the main picture.
  • Picture guide:
  • The same character in all six pictures, drawn at the same size and in the same place, so it does not jump when the mood changes.
  • Square pictures, 512 × 512 pixels or larger, in PNG, JPEG or WebP.
  • A transparent background (PNG or WebP) looks best. On the round chat button and at the top of the chat, the character sits on a light circle, so it stays clear whatever brand colour you pick.
  • It is shown in a small circle, so keep the face in the centre and make each mood easy to tell apart at a small size.
  • You do not need to shrink the pictures. They are resized automatically so they load quickly on phones.
  • Replacing or removing a picture deletes the old one.
  • Launcher style: choose how the closed chat looks at the corner of your website. Round button with the character inside is the default. Character shows the character on its own, with no circle; a light edge keeps it visible on light, dark and photo backgrounds. With Character, it stays at the corner while the chat is open and shows a small × — tapping it closes the chat. The builder shows a small preview of each style.
  • Movement: the character changes gently and bobs slightly while thinking. Visitors who asked their device for less motion see it change without movement.
  • Name: write the character's name in Arabic and English. It replaces the widget name at the top of the chat. Your assistant is told this name, so it answers with it when a visitor asks who they are talking to.
  • Greeting bubble: a few seconds after your page loads, a small bubble next to the chat button shows your greeting. The chat never opens by itself. Tapping the bubble opens the chat. A visitor who closes it does not see it again for 30 days on that browser; after a visitor opens the chat, the bubble stays away for the rest of that day.
  • Starter buttons: up to 4 buttons under the greeting in a new chat, each up to 40 characters, in Arabic and English. Tapping one sends its text as the visitor's first message, so write each one as a question a customer would type, for example "What are your prices?".
  • Numbered choices as buttons: when your assistant ends a reply with a numbered list of choices, visitors can tap a choice instead of typing its number. Typing the number still works.

If your website uses a strict content security policy, allow https://nashir.ai for scripts, connections, frames and images. Without the image permission the chat still works and shows the usual chat icon instead of your character.

Not showing up?

  • The domain isn't in "Allowed domains." This is the number-one cause. The widget stays hidden on any domain you didn't list. Add it in the builder and Save, then reload your site. The nashir.ai preview always works even before you add a domain.
  • Your subscription has lapsed. If your plan expired, the widget is paused until you renew — renew your subscription and it starts serving again.

Still stuck? Reach out and we'll check your setup with you.

Add the Website Chat widget to your site — Nashir