- An AssemblyAI API key
- An
agent_id. Don’t have one? Create an agent first. - A phone number bound to that agent. Don’t have one? Set up an inbound phone agent via SIP.
- A Cekura account. Don’t have one? Sign up at cekura.ai.
Cekura connects to AssemblyAI agents over the phone only. It places every call, so the agent must answer inbound calls on a number you can dial by hand.
1. Check the number reaches your agent
Call the number yourself before you set anything up in Cekura. If you don’t hear your agent’s greeting, Cekura’s test calls won’t reach it either. See If it does not work.2. Connect the agent in Cekura
In Cekura, go to Agents, create an agent, and select AssemblyAI as the provider. If it isn’t in the grid, click More options. Under Integration Settings, fill in:
Under Telephony Settings, enter the phone number bound to the agent and leave Inbound on, so Cekura dials your number. Telephony is the only connection type for AssemblyAI, and it turns on by itself once the credentials are saved.
Save the agent. The key field reads API Key Configured once it’s stored. Use Update to rotate the key later.
3. Run a test
Open an evaluator in Cekura, click Run, and start the run with the Telephony connection. Cekura dials your number and plays the scenario as the caller. When the call ends, Cekura finds the matching AssemblyAI session:- It lists your recent sessions and keeps the ones your agent answered, from the number Cekura dialed from, that started within a few seconds of the test call.
- It waits for the session’s conversation record, which usually takes a few seconds after the call ends.
- It compares call duration and conversation content to confirm the match, so parallel test calls to the same agent each pair with the right session.
- It replaces its own transcript with AssemblyAI’s and attaches the session id to the result.
If it does not work
Configure through the API
To create or update the Cekura agent through Cekura’s API, set the provider toassemblyai and pass the credentials:
assistant_id is your AssemblyAI agent_id, and it’s required whenever a key is set. assemblyai_data.region defaults to us, so you can leave it out. The response never returns the key. Check the read-only assemblyai_api_key_configured field to see whether one is stored.
For the rest of Cekura’s setup, see the Cekura AssemblyAI integration guide.