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

# Call Analytics WF Import (Type 17)

> Import call recordings in bulk for assessment by uploading a Google Sheet with agent and recording details.

## Overview

Call Analytics WF Import lets you bring in a batch of call recordings for quality assessment. You prepare a Google Sheet with the recording details, run the import, and then trigger the assessment workflow — NeuronCx processes each recording and makes the results available in the audit console.

This is a two-step process: first you import the sheet, then you trigger the assessment workflow separately.

> [!NOTE]
>
> The import only reads four columns from your sheet — `Agent`, `callRecording`, `Direction`, and `PhoneNumber`. Any other columns in your sheet are ignored, so you don't need to remove them before importing.

***

## Prerequisites

Before running this import, your recordings need to be prepared and your sheet needs to be ready:

* Each call recording (mp3 or wav) must be uploaded to an S3 bucket and made publicly accessible. The public URL is what goes into the sheet.
* Agent IDs must be the numeric IDs from the system — not agent names. Check with your administrator if you're unsure which ID corresponds to which agent.
* Every phone number in the sheet must be unique. Duplicate phone numbers in the same sheet may cause rows to be skipped.

***

## Preparing Your Sheet

Your sheet can contain as many columns as you like — for example, agent names, dates, drive links, or internal references. NeuronCx only reads the four columns below. Everything else is ignored.

| Column | Required | Notes |
| - | - | - |
| `Agent` | ✅ Yes | The numeric Agent ID — not the agent's name |
| `callRecording` | ✅ Yes | The public S3 URL of the audio file (mp3 or wav) |
| `Direction` | ✅ Yes | `OUTBOUND` or `INBOUND` |
| `PhoneNumber` | ✅ Yes | Must be unique for each row in the sheet |

![Screenshot 2026 08 29 140654](https://mintcdn.com/neuroncx/HdYTHESpflEAbZiI/images/Screenshot-2026-08-29-140654.png?fit=max\&auto=format\&n=HdYTHESpflEAbZiI\&q=85\&s=99886ea456e4679cfcbc257bed3a74e1)

> [!TIP]
>
> You don't need to clean up your sheet before importing — extra columns like agent names, dates, or drive links are simply ignored. Keep them in for your own reference.

> [!WARNING]
>
> Make sure the `callRecording` URL is the public S3 link — not a Google Drive link or a private URL. NeuronCx needs to be able to access the file directly to process it.

***

## Step 1 — Running the Import

### Setting up a new import

**1. Open Imports**

Navigate to **Home > Ontology > Attribute Settings & Bulk Edit**, then click the **Imports** tab.

**2. Click + Import**

Click the **+ Import** button in the top right to open the New Import modal.

![Import Button 9](https://mintcdn.com/neuroncx/HdYTHESpflEAbZiI/images/import_button-9.png?fit=max\&auto=format\&n=HdYTHESpflEAbZiI\&q=85\&s=0af59ab846b6cfc66efa1dd7c7a8e33e)

**3. Give it a label**

Enter a name that describes this import — for example, "Aug 28 Call Assessment Import."

![Label 9](https://mintcdn.com/neuroncx/HdYTHESpflEAbZiI/images/label-9.png?fit=max\&auto=format\&n=HdYTHESpflEAbZiI\&q=85\&s=8eaf231bf41433adf906e6f34d0cf1b4)

**4. Add the Google Sheet ID**

Paste the sheet ID or the full Google Sheets URL — NeuronCx will extract the ID automatically.

![Sheet Id 4](https://mintcdn.com/neuroncx/HdYTHESpflEAbZiI/images/sheet-id-4.png?fit=max\&auto=format\&n=HdYTHESpflEAbZiI\&q=85\&s=3ce7f7982142157466385f95a3eee142)

**5. Verify**

Click **Verify**. NeuronCx confirms it can read the sheet and shows you the row and column count — use this to catch an empty or wrong sheet before continuing.

![Verify 11](https://mintcdn.com/neuroncx/HdYTHESpflEAbZiI/images/verify-11.png?fit=max\&auto=format\&n=HdYTHESpflEAbZiI\&q=85\&s=37bbe400eaeb9b27bbc62b075827f1bb)

**6. Select the import type**

In the Import type panel on the left, select **Content & Knowledge**. Then choose **Call Analytics WF** (`#17`) from the list on the right.

![Import Type Select](https://mintcdn.com/neuroncx/HdYTHESpflEAbZiI/images/import-type-select.png?fit=max\&auto=format\&n=HdYTHESpflEAbZiI\&q=85\&s=86fb20ccafa3410022082ae89436b9e7)

**7. Create the import**

Click **Create import**. The import now appears in your list under Content & Knowledge, ready to run.

![Create Import 1](https://mintcdn.com/neuroncx/HdYTHESpflEAbZiI/images/create-import-1.png?fit=max\&auto=format\&n=HdYTHESpflEAbZiI\&q=85\&s=e853534423b28bd8f2817a52c239bc7c)

### Running the import

**1. Find the import**

From the Data Import list, locate the import you just created. You can filter by **Content & Knowledge** to narrow the list.

**2. Open the import**

Click the arrow icon on the import row to open it.

**3. Click Import**

Click **Import** to run it. NeuronCx will read each row and queue the recordings for assessment.

***

## Step 2 — Triggering the Assessment Workflow

Once the import completes successfully, you need to trigger the assessment workflow to start processing the recordings. The workflow ID varies by institution — check with your administrator for the correct one.

**1. Go to Bulk WF Trigger**

Navigate to **Home > Ontology > Attribute Settings & Bulk Edit**, then click the **Bulk External Source Trigger Logs** tab.

![Bulk External Tab](https://mintcdn.com/neuroncx/HdYTHESpflEAbZiI/images/bulk-external-tab.png?fit=max\&auto=format\&n=HdYTHESpflEAbZiI\&q=85\&s=a119824dd8c2e98e14791e1c1f22c9ea)

**2. Select the trigger type**

From the trigger type options, select **Assessment Sampling WF Trigger**.

![Trigger Type](https://mintcdn.com/neuroncx/HdYTHESpflEAbZiI/images/trigger_type.png?fit=max\&auto=format\&n=HdYTHESpflEAbZiI\&q=85\&s=13618d4782d5f4c320d807853f47d5f7)

**3. Select the workflow**

Choose the assessment workflow configured for your institution.

![Choose Workflow](https://mintcdn.com/neuroncx/HdYTHESpflEAbZiI/images/choose_workflow.png?fit=max\&auto=format\&n=HdYTHESpflEAbZiI\&q=85\&s=b8fbb94f6d549754ffdb68935a094d9b)

**4. Fire the trigger**

Click **Trigger** to start the assessment. NeuronCx will begin processing the recordings from your import.

![Select Trigger](https://mintcdn.com/neuroncx/HdYTHESpflEAbZiI/images/select_trigger.png?fit=max\&auto=format\&n=HdYTHESpflEAbZiI\&q=85\&s=1ba9468ba170757a5182af92cf219e5f)

***

## Checking the Results

Once the assessment workflow has run, go to **SLI > Audit > Phone** to view the call assessment results for each recording.

You can also filter the audit view by import name to see only the calls from a specific import run.

> [!TIP]
>
> If a recording doesn't appear in the audit view after triggering the workflow, check that the `callRecording` URL in your sheet is publicly accessible and in a supported format (mp3 or wav).

***

## Limits to Keep in Mind

* Audio files must be uploaded to S3 and made public before running the import. Private URLs or Google Drive links will not work.
* `PhoneNumber` must be unique for each row. Duplicate numbers in the same sheet may cause rows to be skipped.
* `Agent` must be the numeric Agent ID — not the agent's name. Using a name instead of an ID will cause that row to fail.
* `Direction` only accepts `OUTBOUND` or `INBOUND`. Any other value may cause the row to be skipped.
* The assessment workflow must be triggered separately after the import — the import alone does not start the assessment.
* Only one import runs at a time. If another import is already running, this one will queue and wait its turn.


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