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

# evaluagent

> Send every recorded Allo call to evaluagent, under the right agent, so evaluagent transcribes and scores it

Connect evaluagent and every recorded call your team makes or takes in Allo lands in evaluagent as a conversation, filed under the agent who handled it. evaluagent gets the recording and the call details, then transcribes the call and scores it with your own scorecards.

## How to connect

### Create an evaluagent API key

Only an evaluagent admin can create an API key.

**1. Open the API settings**

In evaluagent, go to **Conversations** > **Integrations** > **API**.

**2. Create a key for Allo**

Create a new API key and keep it for Allo only. Don't reuse a key another tool already uses.

**3. Copy both parts**

Copy the **Access Key ID** and the **Secret Key**.

> [!WARNING]
>
> Never generate a bearer token with the key you give Allo. Once a token has been generated for a key, evaluagent turns off the authentication Allo uses for it, and every call push fails until you connect a new key.

### Connect in Allo

**1. Open integrations**

Go to [**web.withallo.com**](https://web.withallo.com) and navigate to **Settings** > **Integrations**.

**2. Find evaluagent**

Find **evaluagent** in the list and click **Connect**.

**3. Pick your region**

Choose the region your evaluagent account is hosted in: **Europe**, **North America** or **Australia**. Your data stays in that region, so the region must match your account.

**4. Paste your key**

Paste the **Access Key ID** and the **Secret Key**.

**5. Set the channel (optional)**

evaluagent files every conversation under a channel. Allo uses the channel named **Telephony** unless you type the exact name of another voice channel from your evaluagent account.

**6. Save and connect**

Click **Save & Connect**. One connection covers your whole Allo team.

### Before your first call

Allo finds the evaluagent agent by email. Each teammate whose calls should reach evaluagent needs:

* An **active** evaluagent user with the same email they use in Allo
* That user assigned to a **group** and a **contract** in evaluagent

Allo never creates evaluagent users, because each seat is billed by evaluagent. If a teammate has no matching user, their calls are not sent.

## What gets sent to evaluagent

After each recorded call, Allo uploads the recording to evaluagent and creates a conversation with:

* The call recording, which evaluagent transcribes and scores
* The agent who handled the call, matched by email
* The date and time of the call, and its duration
* The other person's phone number, unless the number was hidden
* The channel set on the connection (**Telephony** by default)
* A link back to the call in Allo, when the call has a share link
* Call details as conversation fields you can filter on in evaluagent:
  * **Direction**: inbound or outbound
  * **Allo line**: the Allo number that made or took the call
  * **Allo result**: for example Answered or Voicemail
  * **Allo tags**: the tags on the call in Allo
  * **Customer name**: the other person's name, when Allo knows it
  * **Allo call id**: helps Allo support trace a call

Retrying a call never creates a second copy in evaluagent.

**Sync direction:** One-way (Allo → evaluagent). Scores and evaluations stay in evaluagent and don't come back into Allo.

### What is not sent

* Calls without a recording, such as missed calls
* Calls from numbers that match no contact in Allo
* Allo's call summary and transcript: evaluagent transcribes the recording itself
* SMS
* Contacts: evaluagent has no customer records, so Allo doesn't look up, create or sync contacts there

### Changes after the upload

Allo doesn't update a conversation once it's in evaluagent. If you add or change tags on a call after it reached evaluagent, the change stays in Allo.

## Troubleshooting

Check the sync status of any call from the **call list on [web.withallo.com](https://web.withallo.com)**. Each call has an integration indicator showing its sync state.

> [accordion] I cannot connect my integration
>
> Only **admins** and **managers** of an Allo workspace can connect integrations. If you don't see the option, ask your workspace admin or manager to set it up.
>
> If Allo refuses the key, check that:
>
> * The region matches your evaluagent account. A key from a European account doesn't work with the North America or Australia region, and the other way round.
> * You pasted the **Access Key ID** and the **Secret Key** in the right fields.
> * No bearer token was ever generated with this key. If one was, create a new key.

> [accordion] A call is not in evaluagent
>
> Check the integration indicator on the call in the web app. The most common causes:
>
> * **No evaluagent user for this teammate.** The teammate's Allo email doesn't match any evaluagent user. Add them in evaluagent with the same email they use in Allo.
> * **The evaluagent user is inactive.** An evaluagent admin must reactivate them.
> * **The agent is not in a group or contract.** In evaluagent, assign the agent to a group and a contract.
> * **The channel doesn't exist.** The channel name on the connection must match a channel in your evaluagent account exactly. Disconnect evaluagent in Allo and connect again with the right channel name.
> * **The call has no recording.** evaluagent only scores audio, so missed or unrecorded calls are never sent.
> * **The number matches no contact in Allo.** Add the caller as a contact in Allo.
>
> Once you fix the cause, retry the sync from the call in the web app.

> [accordion] Every call fails after it used to work
>
> The key Allo uses no longer works. It was deleted in evaluagent, or someone generated a bearer token with it, which turns off the authentication Allo uses. Create a new key for Allo only, then disconnect and reconnect evaluagent in Allo.

> [accordion] The call is in evaluagent but not scored yet
>
> evaluagent transcribes and scores the recording on its side, so the transcript and the score appear once evaluagent has processed the conversation. Calls are only auto-scored if a scorecard in evaluagent runs on the channel Allo uses.

> [accordion] The call is on the wrong agent in evaluagent
>
> Allo picks the evaluagent agent from the teammate who handled the call, matched by email. Make sure each teammate's Allo email belongs to their own evaluagent user, and not to a shared or admin account.


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