> For the complete documentation index, see [llms.txt](https://docs.welkinhealth.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.welkinhealth.com/care/communication/inbox/quick-start-for-care-team.md).

# Quick Start for Care Team

This page covers the everyday Inbox tasks for care team members. Read it once (about 5 minutes), then use the checklist at the bottom as a daily reference.

## The main idea: get to zero unanswered messages

The goal of the Inbox is to make sure every patient message gets a response. In practice this means keeping the number of **Open** communications as close to zero as possible: every conversation that has been handled is **Closed**.

Every new incoming message follows one of two paths:

* **It is assigned to a specific person.** It lands in that person's **My Inbox**, and that person is responsible for replying.
* **It is not assigned.** It lands in the shared Care Team Inbox, and the care team is responsible for making sure someone is assigned to it. An unassigned Open conversation is not yet anyone's responsibility, so it is the one most likely to be missed.

When the Open list is empty, nothing is waiting for a response.

{% hint style="info" %}
Which inboxes and actions you see depends on your role and permissions. If something described here is missing in your Care Portal, ask your administrator to check your access.
{% endhint %}

## 1. Know your inboxes

Open **Inbox** from the Care Portal navigation. Communications are grouped into up to three inboxes, depending on your role:

| Inbox                  | What you see                                                                                                                        | Typical use                                                                    |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
| **My Inbox**           | Communications assigned to you, patients where you are the Primary Contact, your unrecognized communications, and messages you sent | Your personal daily work                                                       |
| **Care Team Inbox**    | Communications from patients where you are on the care team, whether or not anyone has been assigned                                | Shared team work: picking up unassigned conversations, covering for colleagues |
| **All Patients Inbox** | All incoming communications within your access scope                                                                                | Management-level oversight                                                     |

<div data-with-frame="true"><figure><img src="https://1217226817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQvXoGL7kKvEhUWEGGIAn%2Fuploads%2Fy45bJ19IK9UN6fC9y9KH%2Fimage.png?alt=media&amp;token=cd75761e-ac5a-44f2-95f3-3811f1d97c2b" alt=""><figcaption></figcaption></figure></div>

My Inbox is always available once Inbox is enabled for your role. Care Team Inbox and All Patients Inbox are available only if your administrator granted the matching access.

## 2. Your daily routine (5 minutes)

1. Open **My Inbox** and filter by **Status: Open**. Open conversations are waiting for a response.
2. Check the **Mentions** tab for new mentions from colleagues.
3. Open the **Care Team Inbox**, switch to the view of communications **not assigned to any user**, and make sure each one gets an owner.
4. Check **Unrecognized** communications and link them to patients (see section 6).
5. Reply to each Open conversation, or close it if nothing is pending.

The target at the end of the routine: no Open conversations assigned to you, and no unassigned Open conversations on your team.

<div data-with-frame="true"><figure><img src="https://1217226817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQvXoGL7kKvEhUWEGGIAn%2Fuploads%2FdXTRwNny6s7YLFXRuOJP%2Fimage.png?alt=media&amp;token=2f9ac4d5-02d6-4a81-bd57-36dd7f8ef1fb" alt="" width="375"><figcaption></figcaption></figure></div>

## 3. Open, Closed, and Assigned: how they fit together

Every communication has two independent properties: its **status** and its **assignee**.

**Status (Open / Closed)** shows whether staff action is needed.

* Any incoming message sets the status to **Open**, even if the conversation was previously Closed.
* After you reply, the conversation is automatically marked **Closed** and appears in gray.
* The current status is shown next to the message input and can be changed manually at any time.

**Assignee** shows who owns the conversation.

* Some incoming communications are assigned automatically when the system can match the recipient address or number to a specific user.
* Everything else stays **unassigned** until someone assigns it.
* Assigned conversations appear in the assignee's **My Inbox**.

In practice:

| Status | Assignee                 | What it means                                                     | What to do                                                                           |
| ------ | ------------------------ | ----------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
| Open   | Assigned to you          | Your patient is waiting for your reply                            | Reply, then Send and Close or Send and keep Open                                     |
| Open   | Assigned to someone else | A colleague owns it                                               | Leave it, or reassign it if the colleague is out                                     |
| Open   | Unassigned               | Nobody owns it yet, so it is the easiest to miss                  | Take it with **Assign**, or assign it to the right person and leave an internal note |
| Closed | Any                      | No action needed. It reopens automatically if the patient replies | Nothing, unless you need to follow up                                                |

{% hint style="warning" %}
Unassigned Open conversations in the Care Team Inbox are the most common source of missed communication, because nobody owns them yet. Check them every day.
{% endhint %}

## 4. Work with the Care Team Inbox

The Care Team Inbox is shared by everyone on the patient's care team. Use it to make sure no communication falls between colleagues.

1. Open the **Care Team Inbox**.
2. Use the filter to show only communications **not assigned to any user**.
3. Filter by **Status: Open** to hide conversations that are already handled.
4. Open a conversation and review it. If it is yours, click **Assign** in the header and select yourself. If it belongs to a colleague, assign it to them and add an [internal note](https://docs.welkinhealth.com/care/communication/inbox/inbox-internal-notes.md) with context.
5. Reply, or close the conversation if no response is needed.

The list in **Assign** includes only users who have access to the related patient.

<div data-with-frame="true"><figure><img src="https://1217226817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQvXoGL7kKvEhUWEGGIAn%2Fuploads%2FKXXgGSex2IXE89qs6LDV%2Fimage.png?alt=media&amp;token=68291eb4-8dc6-4a89-af4c-9466127d8b2c" alt="" width="375"><figcaption></figcaption></figure></div>

## 5. Reply to a patient

1. Open the conversation.
2. Type your message in the composer. You can use a template, add emoji, attach a file, and (for email) format the text.
3. Choose how to send:
   * **Send and Close** (default) — sends the message and marks the conversation Closed.
   * **Send and keep Open** — sends the message and leaves the conversation Open, for example when you are waiting on something.

<div data-with-frame="true"><figure><img src="https://1217226817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQvXoGL7kKvEhUWEGGIAn%2Fuploads%2FZgz9069bgZHQRt11CcwE%2Fimage.png?alt=media&amp;token=61f6574e-404e-47ea-a108-8d8408c5788f" alt=""><figcaption></figcaption></figure></div>

{% hint style="warning" %}
Before replying, check the Status and Channel of the conversation. If follow-up is still needed, use **Send and keep Open** so the conversation does not disappear from your Open list.
{% endhint %}

## 6. Unrecognized communications

A communication is **Unrecognized** when the sender cannot be matched to a single patient. This happens, for example, when the email address or phone number is not on file, or when it belongs to several patients (such as a parent writing about more than one child).

Where you see them:

* **My Inbox → Unrecognized** — communications assigned to you where no matching patient exists on your care team.
* **Care Team Inbox → Unrecognized** — the email belongs to several patients, and you are on the care team for some or all of them.
* **All Patients Inbox → Unrecognized** — all unrecognized communications.

How to handle one:

1. Open the unrecognized communication and read it.
2. Click **Link** to connect it to a patient.
3. If several patients share the email address or phone number, all matching records are shown. Select the correct one. If the right patient is not listed, search for other records and link manually.
4. Once it is linked, reply as usual. A reply cannot be sent until the communication is linked to a patient.

{% hint style="info" %}
Email threads are remembered. After you link the first email, later replies in the same thread are attached to the same patient automatically. A new email outside that thread, and every incoming SMS, is treated as unrecognized again and must be linked.
{% endhint %}

See also [Manage Unrecognized Communication](https://docs.welkinhealth.com/care/communication/manage-unrecognized-communication.md).

## 7. Start a new conversation

1. Click **+ New** in the Inbox navigation.
2. Select the channel: **Email**, **SMS**, or **Chat**.
3. Choose the recipient and write your message. Email also needs a subject, and SMS needs the outbound line.

If a conversation with that recipient already exists on the same SMS line or chat, it reopens instead of creating a duplicate. See [Initiating New Conversations](https://docs.welkinhealth.com/care/communication/inbox/inbox-new-conversation.md).

<div data-with-frame="true"><figure><img src="https://1217226817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQvXoGL7kKvEhUWEGGIAn%2Fuploads%2FV7iFePvGGTyaax6LFXab%2Fimage.png?alt=media&amp;token=30b4e4a0-630f-415e-a46c-fc74e2cee4c0" alt=""><figcaption></figcaption></figure></div>

## 8. Calls and voicemail

The **Phone** channel shows SMS, incoming and outgoing calls, missed calls, and voicemails in one thread with the patient. A call record shows the call type and duration, with playback for recordings and voicemails.

* A **missed call** automatically sets the conversation to Open.
* A completed call does not change the status.

See [Phone Channel](https://docs.welkinhealth.com/care/communication/inbox/inbox-phone-channel.md).

## 9. Internal notes and @mentions

Use internal notes to leave information for colleagues without the patient seeing it.

1. In the composer, switch to **Add internal note**.
2. Type `@` and a colleague's name to mention them.
3. Send the note. It appears highlighted in purple and is visible only to users with access.

Mentioned colleagues see the conversation in their **Mentions** tab. If the person you mention does not have access to the patient, you will see a warning.

See [Internal Notes](https://docs.welkinhealth.com/care/communication/inbox/inbox-internal-notes.md) and [@Mentions](https://docs.welkinhealth.com/care/communication/inbox/inbox-mentions.md).

## 10. Shared inboxes (shared email addresses)

If your team uses a shared inbox (for example, a general support address):

* The inbox name and color badge in the conversation header show which inbox you are in.
* Use the **Send as** selector to choose between the shared address and your personal address.
* Secure Email is not available when sending from a shared inbox.
* If **Assign on First Reply** is on, the conversation is automatically assigned to the first person who replies.

See [Shared Inboxes](https://docs.welkinhealth.com/care/communication/inbox/shared-inboxes.md).

## 11. Delete a message by mistake

Hover over the message, click **Delete**, and confirm **Delete Message?**. You have 15 seconds to undo. After that, a placeholder remains in the thread and the deletion is recorded in the audit log. See [Deleting Records](https://docs.welkinhealth.com/care/communication/inbox/inbox-delete-records.md).

## What to do if…

1. **I missed a message and the conversation looks Closed.** Search for the patient by name, phone, or email, open the conversation, and check the latest messages. Reply and use **Send and keep Open** if follow-up is needed.
2. **A conversation is Open but nobody is working on it.** Check whether it is assigned. If it is not, assign it to the right person or take it yourself.
3. **I'm not receiving notifications.** Notifications for new messages and mentions are configured by your administrator and are off by default. Ask your administrator to review the **Inbox Message** and **Inbox Mentions** automations. See [Setting Up Inbox Notifications](https://docs.welkinhealth.com/care/communication/inbox.md#setting-up-inbox-notifications).
4. **A message came from an unknown number or email.** Open it from the Unrecognized list and link it to the right patient.
5. **I need a colleague's input.** Add an internal note and @mention them.
6. **A colleague is out and their conversations are unattended.** Open the Care Team Inbox, filter for unassigned conversations, and assign them. Conversations already assigned to the colleague can be reassigned from the **Assign** option in the header.

## Daily checklist

* [ ] &#x20;Check **My Inbox** with **Status: Open**.
* [ ] Check the **Mentions** tab.
* [ ] Check the **Care Team Inbox** for unassigned Open conversations and make sure each has an owner.
* [ ] Link any **Unrecognized** communications to patients.
* [ ] Use **Send and keep Open** when follow-up is still needed.
* [ ] Close conversations only when nothing is pending.

## Related Topics

* [Inbox](https://docs.welkinhealth.com/care/communication/inbox.md) — full reference
* [Manage Unrecognized Communication](https://docs.welkinhealth.com/care/communication/manage-unrecognized-communication.md)
* [Initiating New Conversations](https://docs.welkinhealth.com/care/communication/inbox/inbox-new-conversation.md)
* [Phone Channel](https://docs.welkinhealth.com/care/communication/inbox/inbox-phone-channel.md)
* [Internal Notes](https://docs.welkinhealth.com/care/communication/inbox/inbox-internal-notes.md)
* [@Mentions](https://docs.welkinhealth.com/care/communication/inbox/inbox-mentions.md)
* [Shared Inboxes](https://docs.welkinhealth.com/care/communication/inbox/shared-inboxes.md)
* [Deleting Records](https://docs.welkinhealth.com/care/communication/inbox/inbox-delete-records.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.welkinhealth.com/care/communication/inbox/quick-start-for-care-team.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
