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

# How to set up Call Reason Mapping

## Overview (Call Reasons V2)

Call Reasons V2 is the current call-reason system. It is **self-servable** and **definition-first**: Avoca classifies based on the customer’s call reason definitions first, and can optionally associate “related” Avoca reasons for consistency.[\[1\]](https://avoca-workspace.slack.com/archives/C084EKP1QKC/p1766466250114349)

This guide covers:

* Enabling Call Reasons V2
* Syncing ServiceTitan (ST) call reasons into Avoca
* Adding definitions
* Setting call type filters
* (Optional) mapping “related” Avoca call reasons

## Before you start

### Requirements

* ServiceTitan call reasons are created and active in **ServiceTitan → Settings → Operations → Call Reasons**.[\[2\]](/Call-Reclassification-1caf2b56d4d5808ea8c4ebf8794948a1)

### Best practice

If you are migrating from the legacy system, do this during **low call volume**. As soon as you save Call Reasons V2, Avoca switches off the old call reason mapping system. You will need to contact your Customer Success Manager to enable Call Reasons V2[\[1\]](https://avoca-workspace.slack.com/archives/C084EKP1QKC/p1766466250114349)

## Step 1: Ask your Customer Success Manager to enable Call Reasons V2

Call Reasons V2 must be enabled for your account by your Avoca Customer Success Manager.[\[1\]](https://avoca-workspace.slack.com/archives/C084EKP1QKC/p1766466250114349)

## Step 2: Open the Call Reasons V2 UI

Once it is enabled, you will see the Call Reasons V2 UI in the dashboard under **Settings → Integrations → ServiceTitan → Call Reasons**.

<Columns cols={2}>
  <Frame>
    <img src="https://mintcdn.com/avoca-hc/aKCt1qDjplbTpJS8/images/responder/image-40.png?fit=max&auto=format&n=aKCt1qDjplbTpJS8&q=85&s=a80760601b441801b9f4836c88cbd4bf" width="556" height="480" data-path="images/responder/image-40.png" />
  </Frame>
</Columns>

## Step 3: Sync ServiceTitan call reasons into Avoca

<Frame>
  <img src="https://mintcdn.com/avoca-hc/aKCt1qDjplbTpJS8/images/responder/image-41.png?fit=max&auto=format&n=aKCt1qDjplbTpJS8&q=85&s=01c597bfb84081356f02532a22f3e423" width="1832" height="164" data-path="images/responder/image-41.png" />
</Frame>

1. In the Call Reasons V2 UI, click **Sync / Get Unsynced Reasons from ServiceTitan** (wording may vary).
2. Confirm the imported reasons match what is active in ServiceTitan.

## Step 4: Add call reason definitions

<Frame>
  <img src="https://mintcdn.com/avoca-hc/aKCt1qDjplbTpJS8/images/responder/image-42.png?fit=max&auto=format&n=aKCt1qDjplbTpJS8&q=85&s=5d8b0b7beeebd5a99b511e207aa37ce5" width="1602" height="472" data-path="images/responder/image-42.png" />
</Frame>

1. For each imported call reason, add a clear **definition/description**.
   * Write these like you are training a new CSR.
   * Include a simple example of when to use it.

**Why this matters**

Call Reasons V2 classifies based on the company’s definitions first.[\[1\]](https://avoca-workspace.slack.com/archives/C084EKP1QKC/p1766466250114349)

## Step 5: Configure key V2 settings

### A) Classify ServiceTitan Call Reason for “Booked” calls (usually OFF)

* There is a toggle to enable or disable classifying ST call reasons for **Booked** calls.

  <Frame>
    <img src="https://mintcdn.com/avoca-hc/aKCt1qDjplbTpJS8/images/responder/image-43.png?fit=max&auto=format&n=aKCt1qDjplbTpJS8&q=85&s=f69c7fb077b05520fbdf3b526bd7b331" width="834" height="214" data-path="images/responder/image-43.png" />
  </Frame>

### B) Call Type Filters

Use call type filters to prevent mismatches (for example, Unbooked calls ending up with “Excused” reasons).

Use the “Add All Call Reasons” buttons to quickly add:

* “Lead” call reasons to **Unbooked**
* “Non-lead” call reasons to **Excused**

  <Frame>
    <img src="https://mintcdn.com/avoca-hc/aKCt1qDjplbTpJS8/images/responder/image-44.png?fit=max&auto=format&n=aKCt1qDjplbTpJS8&q=85&s=efa8e58ce2c4ef1deea3441cde3784a2" width="1564" height="568" data-path="images/responder/image-44.png" />
  </Frame>

## Step 6: Associate “related” Avoca call reasons

This step is required for consistency across Avoca reporting and workflows.

In Call Reasons V2, you can associate “related” Avoca call reasons to each of the customer’s ServiceTitan call reasons. This preserves Avoca-side consistency without changing how the system selects the customer’s primary call reason.[\[1\]](slackMessage://avoca-workspace.slack.com/C084EKP1QKC/1766466250.114349/1766466250.114349)

<Frame>
  <img src="https://mintcdn.com/avoca-hc/MH4mxrDXeo8nYAg7/images/responder/image-45.png?fit=max&auto=format&n=MH4mxrDXeo8nYAg7&q=85&s=9c4510a0484d96691ee1f6ab1f439a3f" width="1616" height="508" data-path="images/responder/image-45.png" />
</Frame>

## Troubleshooting

### The synced call reasons look wrong or incomplete

* Confirm the call reasons are active in ServiceTitan first.[\[2\]](/Call-Reclassification-1caf2b56d4d5808ea8c4ebf8794948a1)