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.
Connect in Allo
1
Open integrations
Go to 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
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
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. Each call has an integration indicator showing its sync state.I cannot connect my integration
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.
A call is not in evaluagent
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.
Every call fails after it used to work
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.
The call is in evaluagent but not scored yet
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.
The call is on the wrong agent in evaluagent
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.