$50 free credit for new accounts - ends in

Claim $50

Setup

How to set up website widget for pt online scheduling widget

How to set up website widget for pt online scheduling widget — answered from your own docs. How Physical Therapy Clinics teams use Chatref (website widget, webs

Chatref Team6 min read / Updated June 15, 2026

To add a physical therapy scheduling widget to your clinic’s site, embed Chatref’s website widget snippet on your pages and set up custom actions that collect appointment details right in the chat. Patients can request a visit without calling, and your front desk sees every submission in the shared inbox.

Before you start

Make sure you have:

  • A Chatref account (sign up at app.chatref.ai; $50 free credit, no payment needed to start)
  • Access to your clinic’s website (ability to add a script tag in the page head or via a CMS plugin)
  • At least one agent trained on your practice information (services, hours, accepted insurance, scheduling policy)
  • If you plan to collect appointment requests, prepare the custom action flow you want (fields you’ll ask for, how you’ll route the submission)

If you're new to Chatref and want to see how it fits into a broader physical therapy front-desk strategy, read our overview for Physical Therapy Clinics.

Step-by-step setup

1. Choose or create your agent

Log in to app.chatref.ai, go to Agents, and select the agent that will serve your clinic. If you don’t have one yet, create an agent and give it a name (e.g., “PT Front Desk”). Upload your clinic’s key documents – hours, scheduling steps, intake forms FAQ, a PDF of insurance plans you accept, or point it at your existing website pages. The agent needs this content to give accurate answers later.

2. Get the widget snippet

Inside the agent’s settings, open the Widget tab. The page shows a toggle to enable the widget and a code snippet to embed. Copy the <script> tag. It looks similar to this (your actual snippet will contain a unique ID):

<script src="https://widget.chatref.ai/embed.js"
        data-chatref-id="YOUR-WIDGET-ID"
        async></script>

3. Add the snippet to your clinic’s website

Paste the snippet into the <head> or just before the closing </body> tag of every page where you want the chat to appear – typically your entire site. If you use a CMS (WordPress, Squarespace, Wix), add it through a custom HTML block in the header or footer settings. For static sites, drop it into your main layout file.

The widget will render as a floating chat bubble, usually in the bottom-right corner. It respects your site’s existing styling; you can adjust the accent color in the widget settings later.

4. Build a custom action for scheduling

Chatref’s custom actions let the agent gather information and trigger your own processes without leaving the chat. To handle appointment requests:

  1. In the agent’s Custom Actions section, create a new action (call it “Schedule appointment” or “PT visit request”).
  2. Configure the trigger: you can set it to fire on specific phrases (like “schedule”, “book”, “appointment”) or let the agent decide when to start the flow based on the conversation.
  3. Define the fields you need to collect. A realistic flow for a PT clinic might ask:
    • Patient’s full name
    • Phone number
    • Preferred date and time window
    • Visit type (initial evaluation, follow-up, specific therapy)
  4. Choose what happens with the submission. You can:
    • Send the details as an email to your front desk
    • Post them to a webhook (to push into your scheduling software)
    • Save directly to Chatref’s conversation inbox, where your team can act on them

Example: when a patient types “I need to schedule an appointment,” the bot replies with a friendly prompt asking for name and phone. After the patient provides those, it asks for preferred day/time and visit reason, then confirms “We’ll reach out to confirm. Your request has been sent.”

If you don’t yet have a scheduling system that accepts external input, the email approach is the simplest – it requires no additional integration.

5. Activate the widget and the action

Back in the Widget tab, make sure the widget toggle is on. In the Custom Actions page, ensure your scheduling action is published and linked to the same agent. The action will appear automatically once the agent determines it’s needed during a conversation.

Check it works

Before announcing it to patients, test the end‑to‑end flow:

  • Open a browser and visit a page on your live site where you embedded the widget. The chat bubble should appear.
  • Click the bubble and type a common scheduling question, for example “Can I book a follow‑up for next Tuesday?” or simply “schedule.”
  • The agent should respond with a message that includes information from your uploaded clinic docs (e.g., “Our follow‑ups are 30 minutes. I can help you request a time. May I start with your name?”) and then start the custom action flow.
  • Complete the flow as a patient would. After submission, verify that the collected details arrived where you expected – check your front‑desk email, the webhook logs, or the Chatref Conversations inbox.
  • If the widget doesn’t load, double‑check the snippet is on the page and the agent’s widget toggle is on. Origin allowlisting is handled automatically; you don’t need an extra step unless you’ve restricted domains in your agent’s widget settings.

Common issues

Widget doesn’t appear on the site

  • The snippet may be missing or incorrectly placed. Confirm it’s inside the <head> or <body> and not commented out.
  • If you’re using a content security policy (CSP), ensure widget.chatref.ai is allowed.
  • The agent must be published – a draft agent’s widget won’t load publicly.

Custom action never triggers

  • Check that the action is published and assigned to the correct agent.
  • The agent may need a clearer trigger phrase. Add a few variations like “book,” “schedule,” “appointment,” or “make a visit” if the default isn’t catching natural language.
  • If the bot keeps answering with text instead of initiating the form, review your agent’s instructions: in Settings > Behavior, add a sentence like “If a patient asks to schedule, always use the scheduling custom action.”

Answers aren’t rooted in your clinic’s details

  • The agent may need more training. Upload additional documents (e.g., a detailed scheduling policy, a PDF of accepted insurance plans, or a FAQ page). After uploading, let the agent process the content for a few minutes and test again.

Scheduling requests don’t reach your team

  • For email delivery: check the recipient address in the custom action’s “Send to email” field and look in spam.
  • For webhooks: verify the endpoint URL and test with a manual curl or request simulation to confirm it accepts the payload.
  • Use the Chatref conversation inbox as a fallback – every submission also lives there, so your team can review and act on it even if the external notification fails.

FAQ

What causes pt online scheduling widget problems for Physical Therapy Clinics?

Most issues come from four places: the widget snippet isn’t installed correctly (or is placed on the wrong pages), the scheduling custom action isn’t published or triggered by a phrase patients actually use, the agent lacks enough clinic‑specific content to answer confidently, or your website’s security settings (CSP, cookie banners) block the widget script. Check these one at a time – a quick inspection of the browser console often reveals the culprit.

How do I improve pt online scheduling widget for Physical Therapy Clinics?

Keep your agent’s knowledge current: update it whenever your clinic hours, insurance list, or scheduling process changes. Refine the custom action prompts to sound like your front‑desk staff (friendly, specific, and concise). Regularly review conversations in Chatref’s inbox to spot where patients get stuck or abandon the flow, then tweak your training docs or add clarifying instructions. Finally, train your team to use the shared inbox so they can jump in when a request needs human judgment – this keeps the widget fast for patients while giving your staff full context.

Related guides

Put this into practice

Chatref answers your customers from your own content, day and night. Add it to your site and go live in minutes – free to start.

Get started