How to connect
Before you start
- Chorus includes API access in its Enterprise package. On other packages, API access is a paid add-on. Check with your ZoomInfo account team if you’re not sure.
- The Chorus user who creates the token needs a role with API permission. A Chorus admin can check it under Settings > Roles & Permissions.
- Use the token of a Chorus admin. The token only sees what its user can see, and Allo needs to find the Chorus user of every teammate.
Generate a Chorus API token
1
Open your personal settings
In Chorus, open your profile, then go to Settings > Personal Settings > API Access.
2
Generate the token
Click Generate API Token and copy it.
Connect in Allo
1
Open integrations
Go to web.withallo.com and navigate to Settings > Integrations.
2
Find Chorus
Find Chorus in the list and click Connect.
3
Paste your API token
Paste the Chorus API token.
4
Save and connect
Click Save & Connect. One connection covers your whole Allo team.
Before your first call
Allo finds the Chorus user by email. Each teammate whose calls should reach Chorus needs a Chorus user with the same email they use in Allo. Chorus may also require that user to hold a license that can own recordings (a Recorder license). If the emails differ, or Chorus refuses the user, the call doesn’t reach Chorus.What gets sent to Chorus
After each recorded call, Allo uploads a new conversation to Chorus with:- The call recording, as an audio file
- The teammate who handled the call, as the Chorus user who owns the conversation
- A name that holds the call details: the direction, the other person (their name, or their phone number when Allo has no name), the start time in UTC, and the call’s tags
What is not sent
- Calls without a recording, such as missed calls
- Calls from numbers that match no contact in Allo
- Calls with a contact you marked as favorite in Allo
- Allo’s transcript and call summary: Chorus builds its own from the audio
- SMS and contacts
What is not linked
Chorus links a conversation to a CRM account or opportunity from the participants’ emails. An uploaded Allo call has no participant list, so Chorus doesn’t link it to an account or a deal. You find it under the teammate who owns it, not on the account page. The date Chorus shows can be the time of the upload, a few minutes after the call ended. The real start time is in the conversation name.Changes after the upload
Allo doesn’t update a call once it’s in Chorus. If you add or change tags on a call after it reached Chorus, 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 token, check that:
- You pasted the whole token, with no extra spaces.
- The Chorus user who generated it has a role with API permission.
- The token wasn’t regenerated or revoked in Chorus since you copied it.
A call is not in Chorus
A call is not in Chorus
Check the integration indicator on the call in the web app. The most common causes:
- No Chorus user for this teammate. The teammate’s Allo email doesn’t match any Chorus user that the token can see. Invite them to Chorus with the same email they use in Allo, and use a Chorus admin’s token.
- Chorus refused the user as owner. The teammate’s Chorus user may need a license that can own recordings. Ask your Chorus admin to check their license.
- The call has no recording. Chorus only takes calls with audio, so missed or unrecorded calls are never sent.
- The number matches no contact in Allo. Add the caller as a contact in Allo.
- The token no longer works. It was regenerated or revoked in Chorus, or its user lost API permission. Generate a new one, then disconnect and reconnect Chorus in Allo.
The call is in Chorus without a transcript
The call is in Chorus without a transcript
Chorus transcribes and analyzes the recording on its side, so the transcript and insights appear once Chorus has finished processing the conversation.
The call is not on the account in Chorus
The call is not on the account in Chorus
Chorus matches conversations to accounts from participant emails, and an uploaded call has none. Allo calls stay under the teammate who owns them. Search Chorus for the contact name or phone number, which are in the conversation name.