How to set up website widget for comprehensive eye exam b…

You will need a Chatref account with your practice content loaded – office hours, accepted insurance plans, exam types, and scheduling policies. The widget answers questions from that information and can collect booking details through custom actions.

If you are new to Chatref, start by pointing the platform at your practice documents or website. It reads your content and builds an agent that answers with your own details, not generic information. The setup works the same across all plans; every account includes the widget, custom actions, and lead capture with no feature gates.

Have your website ready. You will add one snippet to the pages where patients book exams – usually your homepage, contact page, or a dedicated appointments page. The widget is origin-allowlisted, so it only loads on domains you authorize.

Deploy the widget snippet

From your Chatref dashboard, navigate to the agent you want to embed. Open the Widget tab and copy the provided code snippet. Paste it immediately before the closing </body> tag on every page where you want the widget to appear.

The snippet loads asynchronously – it will not slow down your page. Once deployed, the widget button appears in the corner you selected. For an eye exam booking flow, a bottom-right placement works well because it aligns with where patients look for contact options.

Design the booking custom action

The widget itself answers questions; a custom action collects structured booking details. In your agent’s Actions section, create a new action named something clear like “Book an eye exam.”

Define the fields a scheduler or front-desk person actually needs to call the patient back and reserve a slot:

• Full name
• Phone number
• Preferred date and time window
• Exam type (comprehensive, contact lens fitting, medical visit)
• Insurance provider (optional)
• Notes or special requests

Chatref triggers this action when a patient expresses intent to schedule. The agent asks for each field conversationally, one at a time, rather than showing a long form. This keeps the interaction natural. The platform sends the collected details wherever you configure – email, a webhook to your practice management system, or both.

Match the widget to your practice brand

In the Customization tab, set the widget’s primary color to your practice brand color and upload your logo. Adjust the greeting text to say something specific like “Ask us about eye exams, insurance, or hours.” A specific greeting signals to patients that this chat understands eye care, which increases engagement over a generic “How can I help?”

The look stays consistent across desktop and mobile. Test on both before going live – mobile booking often accounts for a large share of eye exam appointments.

Before announcing the widget to patients, test it end-to-end from a real visitor perspective.

1. Open your website in an incognito or private browser window. The agent treats each session as a new visitor, so this gives you the fresh patient experience.
2. Ask a common patient question: “Do you take my insurance for an eye exam?”
3. Verify the agent answers from your practice details, not a generic response.
4. Say “I want to book a comprehensive eye exam.” The agent should initiate the booking custom action and ask for the first field.
5. Walk through every field. Submit the action and confirm you receive the collected information at the destination you configured.

Use the Conversation Inbox in Chatref to review the test chat. This is also where your team monitors live conversations and can take over for a human handoff when a patient asks something that needs a person.

Widget does not appear on the website

The most frequent cause is placing the snippet inside a tag that does not load on every page, like a template partial that only fires conditionally. Place the code directly in your site’s main layout or footer template. If you use a tag manager, ensure it fires on all pages.

Also check your Allowed Origins in the Widget settings. If your staging domain is not listed, the widget will not load there. Add both your production and staging domains during setup.

Agent does not trigger the booking action

This usually happens when the agent does not recognize the patient’s intent to book. Improve this by editing your agent’s instructions: add explicit language like “When a visitor asks about scheduling an eye exam, immediately begin the Book an eye exam action.” Test with real-world phrasing patients actually use – “I need an eye appointment,” “Can I book an exam?,” “How do I schedule?”

If the action triggers but the agent asks for all fields at once instead of one at a time, review the action configuration. The conversational flow works best with fewer fields in a single action rather than cramming every possible question into one form.

Wrong or generic answers about your practice

The widget answers from the content you provide. If answers are off, your source material likely has gaps. Add a plain-text document with your exact policies: accepted plans, exam types with typical durations, walk-in policy, new patient requirements, and cancellation terms. The more specific your content, the more precise the answers.

High abandoned bookings

If patients start the booking flow but do not complete it, check two things. First, the number of fields – more than five or six can cause drop-off. Second, whether the agent explains why it needs each piece of information. A sentence like “I’ll need your phone number so our team can confirm your exact appointment time” before asking increases completion rates.

What causes comprehensive eye exam booking widget problems for Optometry & Eye Care?

Most problems trace back to incomplete practice content or action fields that ask for too much detail at once. When your source material lists only general categories without specifics – “we accept most plans” rather than naming carriers – the agent gives vague answers. For actions, asking a patient to provide insurance member ID, group number, and primary care physician all in one step leads to abandonment. Break information collection into smaller, conversational steps.

How do I improve comprehensive eye exam booking widget for Optometry & Eye Care?

Review the conversation logs in your Chatref inbox weekly. Look for where patients drop off or where the agent gives a generic answer instead of booking. Update your source content to fill those gaps and tighten your agent instructions. Shorten the action to only the fields your staff genuinely need to call the patient and reserve a slot. If you later want to capture leads from patients who are not ready to book, enable lead capture alongside the booking action to collect contact information for follow-up without forcing a full appointment form.