$50 free credit for new accounts - ends in

Claim $50

Workflow

How to handle crisis routing widget questions for Mental …

How to handle crisis routing widget questions for Mental Health Services — answered from your own docs. How Mental Health Services teams use Chatref (custom act

Chatref Team5 min read / Updated June 15, 2026

Crisis routing in Chatref uses custom actions to detect urgent messages and either show immediate crisis resources in the widget or hand off the conversation to your team through the shared inbox. By training your agent on your mental health service protocols, you can ensure anyone in crisis gets a prompt, appropriate response at any hour.

What you need

  • A Chatref account with your website’s widget snippet already installed. The widget needs to be placed on pages where a person in crisis might land (homepage, contact, crisis-resource page).
  • Your mental health service’s up-to-date crisis resources in a knowledge source – emergency numbers, text lines, your own on-call procedure, and any local crisis-center details. Feed these to Chatref as a document or URL so the agent can answer from them.
  • Familiarity with your team’s escalation flow: who gets paged, what tool they share, and how fast they can respond. The shared inbox becomes the handoff point, so you need the team on standby during operating hours.
  • The decision logic for what counts as a crisis. Is it explicit words (“suicide,” “self-harm,” “overdose”)? Or more nuanced phrases (“can’t go on,” “feeling unsafe”)? You will encode this in custom actions.
  • Access to the Mental Health Services industry hub if you want additional practice-level guidance.

Step by step

  1. Add your crisis content
    Upload a document or point Chatref at a page that lists your official crisis resources: the 988 Suicide & Crisis Lifeline, the Crisis Text Line (text HOME to 741741), your own emergency protocol, and any local numbers. This is the ground truth the agent will use when responding to crisis messages.

  2. Configure the widget to surface immediate help
    In your Chatref agent settings, set the widget’s welcome message or pre-chat prompt to include: “If you are in crisis, call 988 or text HOME to 741741 now. If you still want to talk, we’ll connect you with someone here.” This runs before the first message, giving a person an instant off-ramp.

  3. Build the crisis-detection custom action
    Create a custom action that triggers on a list of keywords or phrases: “suicide,” “hurt myself,” “overdose,” “self-harm,” “can’t go on,” and any others from your clinical intake forms.

    • Set the action to reply with your crisis resource message (the 988/741741 info) and automatically hand off the conversation to the shared inbox.
    • Optionally, the action can collect the visitor’s name or a minimal safety concern note before handoff.
  4. Set up the shared inbox for crisis triage
    Assign a group of team members (clinician, crisis counselor, front-desk lead) to the inbox. When a conversation is flagged by the custom action, it appears in the shared inbox with a “crisis” tag and the full chat history. The first available person takes it over. Chatref preserves the thread, so you don’t lose what the visitor already shared.

  5. Test the full path end to end
    Use a test visitor identity and send exactly the crisis phrases you defined. Confirm:

    • The widget shows the pre-chat crisis prompt.
    • The crisis message triggers the custom action reply.
    • The conversation appears in the shared inbox with the proper tag.
    • A team member can take over and reply from the same thread.
  6. Train the agent on your standard triage questions
    Even before a crisis-tagged message reaches a human, the agent can ask one or two clarifying questions grounded in your protocols (e.g., “Are you in immediate danger right now?” or “Do you have a safety plan?”). Add those to your knowledge source so the agent does not go silent while waiting for handoff.

  7. Monitor and tune the detection
    After a week, check the conversation tags and see which phrases actually signal a crisis. Add new ones you missed, remove over-broad triggers (e.g., “anxiety” might be too generic), and adjust the custom action response if needed.

How Chatref automates it

Chatref’s custom actions watch the chat stream for your defined crisis signals. When one matches, the agent replies with the pre-written safety message and flags the conversation for the shared inbox – no separate escalation tool needed. The website widget stays consistent across your site; you set the pre-chat crisis prompt once and it shows on every page, so anyone reaching your service gets the same immediate off-ramp. The shared inbox hands the crisis thread to your team with the entire context and a clear crisis tag, so the handoff is immediate and informed. Because everything runs from the content you uploaded, the emergency numbers and protocols stay grounded in your own policies, not generic guesses.

Tips that help

  • Keep your crisis resource document revision-tracked. When your on-call number or local text line changes, update the source immediately. Chatref’s answers will shift with the content on the next refresh.
  • Use a dedicated “crisis” tag in conversations. It lets you filter the inbox for audit, training, and reporting, and helps you spot if a handoff was missed.
  • Don’t rely on keywords alone for subtle distress. Augment with a second custom action that triggers on broader phrases like “everything feels heavy” or “nobody cares.” Route these to a lower-priority triage inbox where a human decides the next step.
  • Place the widget on pages where someone is already reaching for help. A crisis-intervention landing page, “Get Help Now” button, or appointment booking page will catch more people at the moment of need than a hidden footer icon.
  • Test quarterly. Invite a colleague to send crisis-test messages outside business hours and confirm the widget prompt appears, the action fires, and the inbox shows the alert. This exercises your after-hours protocol too.
  • Train the team on shared-inbox behavior. The person taking over should introduce themselves, acknowledge the crisis, and move the conversation to a secure channel if your state regulations require it. The inbox is the handoff, not the final clinical platform.

FAQ

What causes crisis routing widget problems for Mental Health Services?

The most common cause is incomplete or stale crisis content: the agent doesn’t know your local resources, so it gives generic advice. Missing or poorly configured custom actions also break routing – the action may not fire on the right keywords, or the shared inbox isn’t monitored. Another failure point is that the widget’s pre-chat prompt doesn’t surface crisis numbers, leaving someone in distress to wait for the chat to start.

How do I improve crisis routing widget for Mental Health Services?

Update your knowledge source with every change to your crisis protocol, and add community-specific resources (youth, veterans, LGBTQ+ centers) that might not be in the national lines. Refine your custom action triggers by reviewing real conversation transcripts for missed phrases. Confirm the shared inbox has a designated owner during all operating hours, and set up the widget’s welcome message to display crisis numbers as the very first thing a visitor sees before typing anything.

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