Feature Use Case
Using custom actions to improve telehealth patient intake…
Using custom actions to improve telehealth patient intake chat — answered from your own docs. How Telehealth Platforms teams use Chatref (custom actions, custom
Custom actions turn your telehealth intake chat from a static form into a guided conversation that collects demographics, verifies insurance, and hands complete data to your EHR, all while patients stay in the chat. With automated, step‑by‑step data capture, you reduce manual entry, cut wait times, and prepare every intake before a human ever touches it.
The use case
Telehealth patient intake is a high‑friction, high‑error ritual. A typical journey asks a patient to fill a long PDF, call to confirm insurance, and wait for a follow‑up, all before the first consultation. Staff then chase missing fields, re‑key data into the EHR, and often lose the patient along the way. For growing Telehealth Platforms , the volume of intake requests outstrips the team, especially after hours and on weekends.
A live chat can accept the first question, but a generic bot that only searches for clinic hours does not solve the real intake steps. Custom actions change that. They replace static forms with a conversation that asks the right questions in sequence: full name, date of birth, insurance carrier and member ID, reason for visit. Along the way, the action validates formats (e.g., a valid insurance ID pattern) and only advances when it has usable data. At the end, it can automatically push the collected record to your scheduling tool or EHR, so an intake is complete the moment the chat ends. The result is a dramatically shorter time‑to‑visit, fewer dropped patients, and a front desk that handles exceptions instead of data entry.
How it works
A custom action is a series of prompts and validation rules you attach to your Chatref agent. When a patient’s conversation indicates they need an intake, the agent triggers the action. The agent stays grounded in your practice’s own content for context, but the action does the heavy lifting of structured data collection.
For example, you design an action named “telehealth intake.” It includes steps like:
- “What is your full name?” → validate two words minimum.
- “Date of birth (MM/DD/YYYY)” → validate date format and that the person is over 12.
- “Insurance carrier and member ID” → validate the ID pattern you expect.
- “Briefly describe the reason for your visit.”
At each step, the agent waits for the patient’s reply, checks it against the rule you set, and only moves to the next question once it passes. If a reply fails validation, the agent asks again with a friendly hint. The patient never sees a dead‑end “invalid input” error; they get a prompt that keeps the conversation flowing.
After the last answer, the action can hand off the full intake record to your systems. You configure a webhook URL inside the action, and Chatref sends a payload with the collected fields, timestamp, and conversation ID. Your EHR, scheduling platform, or internal tool can then create a patient record, book an appointment, or raise a task for a staff member to review. The entire handoff happens in real time, so by the time a human opens the file, the intake data is already there.
Set it up
Setting up a custom action in Chatref takes less than ten minutes and requires no code.
- Open your telehealth agent in the Chatref dashboard and go to the Custom Actions section.
- Click New Action and give it a name, like “Telehealth intake.”
- Add steps. For each, write the question you want the agent to ask, then set a validation rule. Chatref supports basic format checks (email, date, numbers only, length), regex patterns for things like insurance IDs, and simple “must not be blank” checks.
- Choose when to start the action. You can trigger it on a keyword (“intake,” “new patient,” “book”), or when the user clicks a specific quick‑reply button you place in the chat.
- Optional: connect a webhook. Under the action, enable Send data to a URL, paste your endpoint, and map the collected fields to the keys your system expects (e.g.,
firstName,dob,carrier). Chatref delivers a JSON payload on completion. - Save and test in the playground. Run through a few intake scenarios to make sure the validation catches common mistakes and that your webhook receives the data.
Because every Chatref account includes unlimited agents and all features, you can build separate intake actions for different services (pediatrics, cardiology, therapy) without an extra cost – only the coins for the actual conversation responses apply.
Get more from it
Custom actions work best when they sit inside a larger, well‑grounded experience. Combine them with other Chatref capabilities to strengthen the entire intake flow:
- Ground intake in your practice knowledge. Before the action fires, the agent can answer general questions about accepted plans, visit requirements, or what to expect, using your uploaded documents. That way the patient arrives informed, and the intake action only handles the structured data. Use the knowledge‑base feature to keep every answer consistent.
- Capture a lead if the patient doesn’t finish. If someone drops out mid‑intake, turn on lead‑capture so Chatref logs the name and question already collected. Your team can follow up later.
- Triage to a person when needed. Custom actions can include a final step that asks “Would you like to speak to a care coordinator?” and, if yes, route the chat with all collected details into the shared inbox. Staff see the entire intake record and pick up right where the agent left off.
- Watch what fails. Use the insights panel to see where intakes stall. If a particular insurance‑ID pattern consistently fails validation, you adjust the regex and instantly improve completion rates.
A single, well‑structured intake action can slash back‑and‑forth emails and call‑back attempts, while giving your clinicians a complete patient snapshot before the first session.
FAQ
What causes telehealth patient intake chat problems for Telehealth Platforms?
The root cause is manual, disconnected processes. Intake forms sit as PDFs that require printing, scanning, or re‑typing. Insurance verification happens in a separate step, often by phone. There is no real‑time validation, so patients submit unusable data and staff spend hours correcting it. After hours, the intake pauses entirely, and no one sees the requests until the next morning. The result is an intake that takes hours or days, high drop‑off, and overloaded front‑desk teams who cannot scale with demand.
How do I improve telehealth patient intake chat for Telehealth Platforms?
Replace static forms with a guided, validating conversation. Custom actions let your chat ask intake questions one at a time, check answers as they arrive, and hand off a complete record to your scheduling, EHR, or CRM by webhook. That keeps patients engaged, catches errors in the moment, and delivers intake data into your systems without manual entry. When a case needs a person, hand off the full context to your team. By automating the routine collection and validation, you turn a leaky, multi‑step process into an intake that finishes in minutes.
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.