> ## Documentation Index
> Fetch the complete documentation index at: https://docs.talkchief.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Review and acknowledge escalated calls in TalkChief

> See transcribed calls that need a supervisor, sorted by severity with reasons. Acknowledge them with a note and send alerts by email or to CoWork channels.

TalkChief flags transcribed calls that need a supervisor. For example, the customer asked for a manager, was very upset, or threatened action. The member was rude, or a complaint or cancellation was left unresolved. You review these calls on the **Escalations** page and acknowledge them when handled.

<Note>
  Escalations need [AI transcription](/ai/ai-transcription). Admins see escalations for the whole company. Supervisors see their own teams. Agents do not see escalations.
</Note>

## Severity and reasons

Each escalated call has a severity and one or more reasons.

| Severity | Reasons |
| - | - |
| **High** | **Asked for a manager**, **Legal or public threat**, **Customer very upset** |
| **Medium** | **Member rude or dismissive**, **Wants to cancel, not resolved**, **Complaint not resolved**, **Repeat contact, not resolved**, **Upset customer, not resolved** |
| **Low** | **Hinted at wanting a manager**, **Mild threat**, **Upset customer, issue resolved**, **Problem raised and resolved** |

A call is **Low** only when it has no high or medium reason. Low calls are worth a look but rarely urgent.

## The sidebar badge

Admins and supervisors see **Escalations** under **Insights** in the sidebar. A red badge shows the number of open **High** and **Medium** escalations. It refreshes every minute. Low escalations are not counted in the badge.

## Review an escalation

<Steps>
  <Step title="Open the page">
    Go to **Insights** > **Escalations**. The **Open** tab lists calls that are waiting, newest first.
  </Step>

  <Step title="Filter by severity">
    Use the severity filter to show **All severities**, **High**, **Medium**, or **Low**.
  </Step>

  <Step title="Read the card">
    Each card shows the member, the severity badge, the customer number, the call date and type, and the reason chips. It also shows a short summary and the line where the escalation happened.
  </Step>

  <Step title="Open the call">
    Select **Open call**. The transcript drawer opens and scrolls to the escalation line, which is highlighted in red. See [Transcripts and summaries](/ai/transcripts-and-summaries).
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/talkchief/t7PqWxB7x25SLoj2/images/docs/escalations-open-list.png?fit=max&auto=format&n=t7PqWxB7x25SLoj2&q=85&s=fa9c1e2af0010cf2e77e6594d9383c3e" alt="Insights > Escalations, Open tab with the open-count badge, severity filter, and cards showing a High badge, reason chips such as 'Asked for a manager', a summary, the quoted escalation line, and Open call and Acknowledge buttons" data-og-width="1440" width="1440" data-og-height="1000" height="1000" data-path="images/docs/escalations-open-list.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/talkchief/t7PqWxB7x25SLoj2/images/docs/escalations-open-list.png?w=280&fit=max&auto=format&n=t7PqWxB7x25SLoj2&q=85&s=6368a9359be0adfc91d4bec87e94eedf 280w, https://mintcdn.com/talkchief/t7PqWxB7x25SLoj2/images/docs/escalations-open-list.png?w=560&fit=max&auto=format&n=t7PqWxB7x25SLoj2&q=85&s=45e4542b398c7c4a5a3c7ee4d235ddb5 560w, https://mintcdn.com/talkchief/t7PqWxB7x25SLoj2/images/docs/escalations-open-list.png?w=840&fit=max&auto=format&n=t7PqWxB7x25SLoj2&q=85&s=f17b06e400f21f96f9625bc8f353ff6d 840w, https://mintcdn.com/talkchief/t7PqWxB7x25SLoj2/images/docs/escalations-open-list.png?w=1100&fit=max&auto=format&n=t7PqWxB7x25SLoj2&q=85&s=7b1c123de1d5bdf428250c13a7050f5f 1100w, https://mintcdn.com/talkchief/t7PqWxB7x25SLoj2/images/docs/escalations-open-list.png?w=1650&fit=max&auto=format&n=t7PqWxB7x25SLoj2&q=85&s=2ab32736a57d9024ab7d953715c02267 1650w, https://mintcdn.com/talkchief/t7PqWxB7x25SLoj2/images/docs/escalations-open-list.png?w=2500&fit=max&auto=format&n=t7PqWxB7x25SLoj2&q=85&s=1e0e264492bf01a57de294a1992b2b1b 2500w" />
</Frame>

<Tip>
  You can share a link to one escalation. Opening a call adds it to the page address, so a colleague with access sees the same call.
</Tip>

## Acknowledge an escalation

When the issue is handled, acknowledge it so it leaves the open list.

<Steps>
  <Step title="Select Acknowledge">
    On the card, select **Acknowledge**.
  </Step>

  <Step title="Add a note">
    In **Note (optional)**, write what you did, for example "Called the customer back, issue resolved". Notes can be up to 500 characters.
  </Step>

  <Step title="Confirm">
    Select **Acknowledge**. The call moves to the **Acknowledged** tab, and the badge count drops.
  </Step>
</Steps>

The **Acknowledged** tab shows who acknowledged each call, when, and their note.

<Frame>
  <img src="https://mintcdn.com/talkchief/t7PqWxB7x25SLoj2/images/docs/escalations-acknowledge-dialog.png?fit=max&auto=format&n=t7PqWxB7x25SLoj2&q=85&s=7898055824d736b91c5a3bee31a1aae4" alt="Acknowledge this escalation dialog with the Note (optional) field filled in and the Acknowledge button" width="512" height="290" data-path="images/docs/escalations-acknowledge-dialog.png" />
</Frame>

## Get notified

You choose notifications per team on the **Notifications** tab. You can also reach it from **Settings** > **AI transcription** > **Open notifications**.

Each team you manage has its own card. Admins see every team. Supervisors see the teams they supervise.

### Email

Each person sets their own email alerts.

<Steps>
  <Step title="Open Notifications">
    Go to **Insights** > **Escalations** > **Notifications**.
  </Step>

  <Step title="Turn on email">
    On the team's card, turn on **Email me**.
  </Step>

  <Step title="Pick a minimum severity">
    Choose **High only**, **High and medium**, or **All, including low**. The change saves right away.
  </Step>
</Steps>

By default, supervisors get emails for **High** escalations on their teams. Admins get no emails until they turn them on. If you get more than 10 escalation emails in an hour, the rest arrive together in one digest email.

### CoWork channels

Post escalated calls to a CoWork channel so the whole team sees them right away. Each post includes the call summary when it is ready.

<Steps>
  <Step title="Create a webhook in CoWork">
    In CoWork, open the channel menu > **Integrations** > **Incoming webhooks**. Create a webhook for the channel and copy its URL.
  </Step>

  <Step title="Add the channel in TalkChief">
    On the team's card in **Notifications**, under **Escalation alerts in CoWork channels**, select **Add channel**.
  </Step>

  <Step title="Fill in the details">
    Enter a **Name**, for example "Support escalations", and paste the **Webhook URL**. Under **Post to this channel**, choose the minimum severity.
  </Step>

  <Step title="Decide on customer numbers">
    Leave **Show full customer numbers** off to show only the last 4 digits. Turn it on only if everyone in the channel may see customer numbers.
  </Step>

  <Step title="Connect and test">
    Select **Connect**. Then select **Send test** to post a test message to the channel.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/talkchief/t7PqWxB7x25SLoj2/images/docs/escalations-notifications-tab.png?fit=max&auto=format&n=t7PqWxB7x25SLoj2&q=85&s=d1943bd0378922c0cdcf3ce9c6a9ba53" alt="Escalations > Notifications tab, one team card with the Email me switch and 'High only' selector, and a connected CoWork channel row with a Working status, severity selector, on switch, Send test and Disconnect" data-og-width="1440" width="1440" data-og-height="1000" height="1000" data-path="images/docs/escalations-notifications-tab.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/talkchief/t7PqWxB7x25SLoj2/images/docs/escalations-notifications-tab.png?w=280&fit=max&auto=format&n=t7PqWxB7x25SLoj2&q=85&s=c62f82cbd5df9918c237fe41678df174 280w, https://mintcdn.com/talkchief/t7PqWxB7x25SLoj2/images/docs/escalations-notifications-tab.png?w=560&fit=max&auto=format&n=t7PqWxB7x25SLoj2&q=85&s=9cba193463ef2c5a855287d8dc154a42 560w, https://mintcdn.com/talkchief/t7PqWxB7x25SLoj2/images/docs/escalations-notifications-tab.png?w=840&fit=max&auto=format&n=t7PqWxB7x25SLoj2&q=85&s=8ffbe0dea2115190285af28024a5b299 840w, https://mintcdn.com/talkchief/t7PqWxB7x25SLoj2/images/docs/escalations-notifications-tab.png?w=1100&fit=max&auto=format&n=t7PqWxB7x25SLoj2&q=85&s=27d39b65d921d1d40725575c07f1ec8a 1100w, https://mintcdn.com/talkchief/t7PqWxB7x25SLoj2/images/docs/escalations-notifications-tab.png?w=1650&fit=max&auto=format&n=t7PqWxB7x25SLoj2&q=85&s=152d165f76a7caa88b1d5223411bfbb4 1650w, https://mintcdn.com/talkchief/t7PqWxB7x25SLoj2/images/docs/escalations-notifications-tab.png?w=2500&fit=max&auto=format&n=t7PqWxB7x25SLoj2&q=85&s=5f10317a6b71d1591510092b646619c4 2500w" />
</Frame>

Each channel row shows its status:

| Status | Meaning |
| - | - |
| **Working** | Messages are posting |
| **Not used yet** | No escalation has been posted yet |
| **Check needed** | The last post had a problem. TalkChief keeps trying. |
| **Failing** | Posts are failing. Check the webhook in CoWork. |
| **Needs a new owner** | The person who added it no longer manages the team. Select **Take over** to turn it back on. |
| **Off** | You turned the channel off |

To stop posting, turn the channel's switch off, or select **Disconnect**. The channel and its messages stay in CoWork.

<Warning>
  Keep the webhook URL private. Anyone who has it can post to the channel.
</Warning>

## Troubleshooting

<AccordionGroup>
  <Accordion title="&#x22;Escalations are available to admins and supervisors&#x22;">
    Your role does not have access. Ask an admin.
  </Accordion>

  <Accordion title="&#x22;This channel is not in your company's CoWork workspace&#x22;">
    Use an incoming webhook from your own company's CoWork workspace.
  </Accordion>

  <Accordion title="&#x22;You have reached the maximum number of connected channels&#x22;">
    Each team can have up to 10 channels. Disconnect one you no longer use.
  </Accordion>

  <Accordion title="The test message did not arrive">
    Check that the webhook still exists in CoWork. If it was deleted, create a new one and connect it again.
  </Accordion>

  <Accordion title="&#x22;You don't manage any team yet&#x22;">
    Notifications are set per team. Ask an admin to make you a supervisor of a team.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Transcripts and summaries" icon="message-lines" href="/ai/transcripts-and-summaries">
    Read the full call and its summary.
  </Card>

  <Card title="AI insights" icon="chart-mixed" href="/ai/ai-insights">
    Track escalation trends over time.
  </Card>

  <Card title="CoWork channels" icon="hashtag" href="/cowork/channels-and-spaces">
    Organize team conversations in CoWork.
  </Card>

  <Card title="AI transcription setup" icon="sliders" href="/ai/ai-transcription">
    Choose which calls are transcribed.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.