$50 free credit for new accounts - ends in

Claim $50

Integration

How to connect solo therapist virtual receptionist help t…

How to connect solo therapist virtual receptionist help to a chat widget — answered from your own docs. How Mental Health Services teams use Chatref (website wi

Chatref Team4 min read / Updated June 15, 2026

You connect a solo therapist virtual receptionist to a chat widget by pasting Chatref’s website widget snippet onto your practice’s website. Once live, patients see a chat bubble that answers scheduling, intake, and office questions directly from your own practice details. No custom coding or separate hosting required.

What connects to what

The virtual receptionist is a Chatref AI agent trained on your mental health practice’s documents—office hours, accepted insurance, intake forms, telehealth instructions, and more. That agent is served through the Chatref website widget, a small chat interface that drops onto your site with a single snippet. The widget is the visible front end; the agent is the brain that replies from your knowledge base. There is no extra middleware or plugin. For an overview of how this fits into a mental health workflow, see Mental Health Services.

How to set it up

  1. Create a Chatref account
    Go to app.chatref.ai. Every new account starts with $50 in free credit—no credit card required.

  2. Train the agent with your practice information
    In the Chatref dashboard, create an agent and upload documents that represent your practice: a one‑pager of services, a list of accepted insurance plans, intake form instructions, cancellation policy, and common patient FAQs. You can also add your practice’s website URL to let the agent ingest public pages automatically.

  3. Customize the widget
    Give your widget a primary color that matches your practice’s branding. Write a short greeting message like “Ask us about scheduling, insurance, or what to bring to your first visit.” This greeting appears when a patient opens the chat.

  4. Get the snippet
    From the agent’s settings, copy the JavaScript snippet. It is a few lines of code that load the widget on your domain.

  5. Add the snippet to your website
    Paste the snippet right before the closing </body> tag on every page of your site. If you use a site builder (Squarespace, Wix, etc.), the custom code area works. If you manage a static site, add it to the global footer template.

  6. Test
    Open your site in an incognito window, click the bubble, and ask a question like “Do you accept Aetna?” or “How do I prepare for my first session?” The agent should reply from your uploaded material. Use the playground in the dashboard to verify answers before going live.

The widget appears anywhere the snippet is present; you don’t need to embed it per page.

What users see

When a patient visits your practice’s site, a small chat bubble appears at the bottom corner. Clicking it opens a chat panel with your custom greeting. The patient types a question. The virtual receptionist answers immediately from your practice’s documents—no generic web search.

The conversation stays in the widget. If you have set up custom actions, the agent might ask “Would you like me to collect your name and reason for the visit?” and forward those details to you. The patient never leaves your site.

On the practice side, you can monitor conversations in the Chatref inbox. If a question arises that needs a human therapist, you can step in and take over the chat with full context. The base connection, however, is entirely automatic: the widget speaks for the agent.

Troubleshooting

Widget doesn’t appear

  • Check that the snippet is placed right before </body> on every page and that your site loads over HTTPS.
  • Some ad‑blockers or privacy extensions block third‑party scripts; test in a clean browser or incognito window.
  • If you recently added a new domain, verify it is allowlisted in the agent settings (Chatref auto‑detects the domain, but confirm it matches exactly).

Agent gives wrong or “I don’t know” answers

  • The knowledge base may be missing the specific detail the patient asked for. Return to the dashboard, add the missing information (for example, a line about a particular insurance plan), and retrain the agent.
  • Use the test playground to preview what the agent would reply for a given question. Tune your source documents until the answer is correct.
  • The fallback response when the agent has no answer is configurable; you could set it to collect an email or invite the patient to call instead of showing an empty message.

Snippet is in place but widget only loads on the homepage

  • You added the snippet only to the homepage template. Move it to a global include so it loads everywhere.

Widget feels slow or doesn’t load on mobile

  • The snippet is lightweight; delays usually come from other scripts on the page. Check the browser console for errors that block execution.
  • If your site is behind a strict Content Security Policy, you may need to adjust directives for chatref.ai domains. Contact support for the exact sources.

FAQ

What causes solo therapist virtual receptionist problems for Mental Health Services?

Problems almost always stem from a sparse knowledge base. If your practice details do not cover the exact questions patients ask—like sliding‑scale fee structures, telehealth platform links, or unusual insurance queries—the agent can’t answer accurately. Other common issues: the widget snippet only on one page, a misconfigured fallback action that doesn’t capture patient info, or the agent not being set to a language patients actually use.

How do I improve solo therapist virtual receptionist for Mental Health Services?

Add more context to the knowledge base: upload a dedicated FAQ document, intake forms, cancellation policies, and accepted insurance lists. Test the agent in the playground with realistic patient phrasing. Enable multilingual if you serve a non‑English community, and set up custom actions to collect a name and visit reason so nothing gets lost. Use the insights feature to see which questions repeat and fill those gaps. See Mental Health Services for practice‑specific ideas.

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