Guidelines & Trainer: AI Voice Portal & Agent
KB Articles – AI Voice Portal
1. Creating an AI Voice Agent
Overview
This guide explains how to create a new AI Voice Agent in the portal. Agents can be created directly from the Dashboard or through the Call Flows section.
Steps to Create an Agent
Option 1 – From the Dashboard
- From the Dashboard, click Create Agent.
- The Agent Editor will open — configure the agent as required.
Option 2 – From Call Flows
- Navigate to Call Flows in the left-hand menu.
- Click New Call Flow, then select From Scratch.
- The Agent Editor will open — configure the agent as required.
Naming and Saving
- Enter a name for the agent in the name field at the top of the editor.
- Make all required edits and changes.
- Click Save.
Verify the Agent
- Return to Call Flows.
- Confirm the new agent appears in the list.
Key Notes
| Item | Details |
|---|---|
| Agent Name | Set at the top of the Agent Editor |
| Saving Changes | Always click Save before leaving the editor |
| Location | Created agents appear in the Call Flows list |
🎥 Watch the demo video below
2. Duplicating an Agent
Overview
This guide explains how to duplicate an existing AI Voice Agent (Call Flow) in the portal. Duplicating an agent creates an independent copy that can be edited without affecting the original.
Steps to Duplicate an Agent
- Navigate to Call Flows in the left-hand menu.
- Click the three dots (⋮) next to the agent you want to duplicate.
- Select Duplicate.
- Confirm that the destination workspace is the same workspace you are currently in.
- The duplicated agent will appear in the Call Flows list.
- Open the duplicated agent and make any required edits.
Key Notes
| Item | Details |
|---|---|
| Independence | Edits to the duplicate will not affect the original agent |
| Workspace | Always confirm the correct workspace is selected during duplication |
| Location | Duplicated agents appear in the Call Flows list |
🎥 Watch the demo video below
3. Post Call Analysis
Overview
This guide explains how to configure Post Call Analysis for an AI Voice Agent. Post Call Analysis allows you to define specific data points to be extracted automatically from each call, which are then available in call history, webhook payloads, post call emails, and post call SMS messages.
Steps to Configure Post Call Analysis
- Navigate to Call Flows and locate the agent you want to edit.
- Ensure you are in the Advanced View.
- Go to Data and click Post Call Analysis.
- Click Add to create a new data point.
- Enter a title for the variable (e.g., Name, Email Address).
- In the description field, write a brief instruction for what the AI should extract — treat this as a mini-prompt (e.g., The caller’s first and last name as provided during the call).
- Repeat for each data point you want to capture.
- Optionally, change the Analysis Model to select a different LLM for extraction.
- Click Save when finished.
Key Notes
| Item | Details |
|---|---|
| Description Field | Treat as a mini-prompt — be specific about what to extract |
| Analysis Model | The LLM used to extract post call data can be changed independently |
| Call History | Extracted data points appear in the call history view |
| Webhooks | Post Call Analysis data is included in webhook payloads for CRM and system integration |
| Post Call Notifications | Data points appear in post call SMS and email summaries |
| Advanced View | Must be enabled to access Post Call Analysis settings |
🎥 Watch the demo video below
4. Background Sounds & Hold Music
Overview
This guide explains how to configure background audio for an AI Voice Agent, including hold music, thinking sounds, and ambient audio. You can use the platform’s built-in audio options or upload your own.
Steps to Configure Background Audio
- Navigate to Call Flows and locate the agent you want to edit.
- Ensure you are in the Advanced View.
- Go to Voice and click Background Audio.
- From here you can configure:
- Hold Music – audio played while the caller is on hold
- Thinking Sound – audio played while the agent is processing a response
- Ambient Sound – background audio present throughout the call
- To use custom audio, click Manage and upload your own audio file.
- Adjust the volume for each audio type using the volume controls.
- Hover over the information icon (?) next to any setting for additional detail.
- Once all changes are made, click Save to Draft or Publish to Production.
Key Notes
| Item | Details |
|---|---|
| Custom Audio | Upload your own audio files via the Manage option |
| Volume Control | Each audio type has an independent volume control |
| Advanced View | Must be enabled to access Background Audio settings |
| Save Options | Use Save to Draft to test before going live, or Publish to Production to apply immediately |
🎥 Watch the demo video below
(Insert video embed here)
5. Editing Office Hours
Overview
This guide explains how to configure the office hours for an AI Voice Agent. Office hours control when the agent is active and able to make or receive calls. You can set active days and times, configure the time zone, and block out specific dates such as public holidays.
Steps to Configure Office Hours
- Navigate to Call Flows and locate the agent you want to edit.
- Ensure you are in the Advanced View.
- Go to Call Handling and click Office Hours.
- Toggle Office Hours on to enable scheduling restrictions.
- Set the active days by toggling each day on or off.
- Set the active time range for each day.
- Select the correct time zone for the agent.
- To block specific dates (e.g., public holidays), click the Custom Dates option and select the relevant dates.
- Once all changes are made, click Save to Draft or Publish to Production.
Key Notes
| Item | Details |
|---|---|
| Time Zone | Always confirm the correct time zone is selected |
| Custom Dates | Use this to block out public holidays or other non-working dates specific to your region or state |
| Advanced View | Must be enabled to access Office Hours settings |
| Toggle | Office Hours must be toggled on to apply scheduling restrictions |
🎥 Watch the demo video below
6. Agent Dictionary
Overview
This guide explains how to use the Agent Dictionary to improve transcription accuracy for your AI Voice Agent. The dictionary allows you to add industry-specific words, proper nouns, and acronyms that the agent may otherwise mishear or transcribe incorrectly.
Steps to Configure the Agent Dictionary
- Navigate to Call Flows and locate the agent you want to edit.
- Ensure you are in the Advanced View.
- Go to Voice and click Agent Dictionary.
- Type in any words or acronyms you want to add to the dictionary.
- Once all words have been entered, click Save to Draft or Publish to Production.
- Hover over the information icon (?) for additional guidance on the dictionary feature.
Key Notes
| Item | Details |
|---|---|
| Best Use | Industry-specific terms, proper nouns, and acronyms that are frequently misheard |
| Why It Matters | Incorrect transcription of key words can cause the agent to misroute or misunderstand the caller |
| Example | The acronym NBN was being transcribed as Indian, causing incorrect call routing — adding it to the dictionary resolved this |
| Advanced View | Must be enabled to access the Agent Dictionary |
🎥 Watch the demo video below
7. Editing Call Timings & Reminders
Overview
This guide explains how to configure call timing settings and silence reminders for an AI Voice Agent. These settings control how the agent handles periods of silence, how long calls can run, and what the agent says when a caller becomes unresponsive.
Steps to Configure Call Timings
- Navigate to Call Flows and locate the agent you want to edit.
- Ensure you are in the Advanced View.
- Go to Call Handling and click Call Timing.
Silence Timeout
- Set the Silence Timeout duration — this is how many seconds of silence must pass before the agent speaks a reminder (e.g., 10 seconds).
- Set the End Call After Timeout duration — this is how long the agent waits after delivering the reminder before ending the call.
- Set the Reminder Retries — the maximum number of times the agent will repeat the reminder before ending the call (maximum of 3).
- Click + to add one or more reminder messages. If multiple messages are added, the agent will cycle through them in order.
Maximum Call Duration
- Set the Maximum Call Duration to define the longest a call can run.
- Enter an end-of-call message that the agent will deliver when the maximum duration is reached.
- Hover over the information icon (?) on any field for additional detail.
- Once all changes are made, click Save to Draft or Publish to Production.
Key Notes
| Item | Details |
|---|---|
| Silence Timeout | Triggers after the set number of seconds with no caller input |
| Reminder Retries | Maximum of 3 retries before the agent ends the call |
| Multiple Reminders | Adding multiple messages causes the agent to cycle through them in sequence |
| Max Duration | Prevents agents from running indefinitely and burning unnecessary tokens |
| Advanced View | Must be enabled to access Call Timing settings |
🎥 Watch the demo video below
8. Sending Booking Links via SMS
Overview
This guide explains how to configure an AI Voice Agent to send a booking link via SMS during or after a call. The booking link is typically sourced from a third-party scheduling tool and can be triggered by the agent when relevant during a conversation.
Steps to Configure a Booking Link
- Navigate to Call Flows and locate the agent you want to edit.
- Ensure you are in the Advanced View.
- Go to Data and click SMS Actions.
- Hover over the information icon (?) for additional detail on how this feature works.
- Toggle the booking link option on.
- Paste the booking link URL into the provided field (e.g., a Calendly link or similar scheduling tool).
- Click Save.
- Once all changes are made, click Save to Draft or Publish to Production.
Key Notes
| Item | Details |
|---|---|
| Link Source | The booking link is typically provided by a third-party scheduling tool such as Calendly |
| Triggering the Link | The agent must be prompted within the call flow to send the booking link when appropriate |
| Advanced View | Must be enabled to access SMS Actions |
🎥 Watch the demo video below
9. Linking a Meta Account
Overview
This guide explains how to connect a Meta (Facebook/Instagram) account to an AI Voice Agent using the Meta Lead Callback integration. This allows the agent to automatically call new leads the moment they submit a form via a Meta ad, significantly improving conversion rates.
Steps to Link a Meta Account
- Navigate to Call Flows and locate the agent you want to connect.
- Ensure you are in the Advanced View.
- Go to Integrations.
- Locate Meta Lead Callback and click Connect.
- Follow the prompts to authenticate and connect your Meta account.
- Once connected, click Close.
- Click Save to Draft or Publish to Production.
Key Notes
| Item | Details |
|---|---|
| Supported Platforms | Facebook and Instagram lead forms |
| Why Speed Matters | Leads contacted within 5 minutes of submitting a form are over 20 times more likely to convert than those contacted after an hour |
| Use Case | Automatically trigger an outbound call from the agent the moment a Meta lead form is submitted |
| Advanced View | Must be enabled to access Integrations |
🎥 Watch the demo video below
10. Post Call SMS & Email
Overview
This guide explains how to configure an AI Voice Agent to automatically send SMS messages and emails at the end of a call. Notifications can be sent to the business, the caller, or up to three email recipients.
Steps to Configure Post Call Notifications
- Navigate to Call Flows and locate the agent you want to edit.
- Ensure you are in the Advanced View.
- Go to Data and click Post Call Actions.
- Toggle on the notification types you want to enable:
- SMS to Business – sends a summary SMS to the business owner or nominated number
- SMS to Caller – sends a summary SMS to the person who was on the call
- Email Notification – sends a summary email to up to three email addresses
- Enter the relevant contact details for each enabled notification.
- Once all changes are made, click Save to Draft or Publish to Production.
Key Notes
| Item | Details |
|---|---|
| Email Recipients | Up to three email addresses can receive post call notifications |
| SMS to Caller | Sends a summary directly to the caller’s mobile number after the call ends |
| Use Case | Allows teams to monitor call activity without needing to log into the portal or a CRM |
| Advanced View | Must be enabled to access Post Call Actions |
🎥 Watch the demo video below
11. Transfers
Overview
This guide explains how to configure call transfers for an AI Voice Agent. There are three transfer types available — Cold, Warm, and Whisper — each with different behaviour for how the receiving party is connected and informed.
Transfer Types
| Transfer Type | How It Works |
|---|---|
| Cold Transfer | The call is connected directly to the destination. The receiving party sees the end-user’s phone number on their screen. |
| Warm Transfer | The agent first speaks a brief summary to the receiving party, then connects the caller. The receiving party sees the agent’s DID on their screen. |
| Whisper Transfer | The agent speaks a brief summary to the receiving party and asks whether they want to take the call. The call only connects if the receiving party confirms. The receiving party sees the agent’s DID on their screen. |
Steps to Configure a Transfer
- Navigate to Call Flows and locate the agent you want to edit.
- Ensure you are in the Advanced View.
- Go to Call Handling and locate the Transfers section.
- Click Add Transfer and give it a name (e.g., Support).
- Select the transfer type — Cold, Warm, or Whisper.
- Enter the destination number the call should be transferred to.
- For Warm and Whisper transfers, click Advanced Settings and enter the message the agent will deliver to the receiving party before connecting (e.g., caller’s name, company, reason for calling).
- Set a timeout duration — if the receiving party does not answer within this time, the agent will return to the caller.
- Enter the timeout message the agent will deliver if no one answers (e.g., Unfortunately no one is available right now — let me continue to assist you).
- Select whether the agent should continue the call or end the call if the transfer times out.
- Configure the transfer conditions in the call flow prompt to define when the agent should invoke the transfer.
- Click Save to Draft or Publish to Production.
Key Notes
| Item | Details |
|---|---|
| Caller ID – Cold | Receiving party sees the end-user’s phone number |
| Caller ID – Warm & Whisper | Receiving party sees the agent’s DID (Direct Inward Dialling number) |
| Whisper vs Warm | Whisper requires the receiving party to confirm before the call connects; Warm connects automatically after the brief summary |
| Testing Transfers | Transfers cannot be tested via the portal web interface — they must be tested over a live phone call with the agent published to production |
| Transfer Conditions | Define the conditions in the agent prompt to control when a transfer is triggered |
🎥 Watch the demo video below
12. Toggle Prior Calls Context
Overview
This guide explains how to enable or disable Prior Calls Context (AI Memory) for an AI Voice Agent. When enabled, the agent can reference information from previous calls made from the same phone number, allowing for more personalised and context-aware conversations.
Steps to Toggle Prior Calls Context
- Navigate to Call Flows and locate the agent you want to edit.
- Ensure you are in the Advanced View.
- Go to General and click AI Memory.
- Hover over the information icons (?) to review how each setting works.
- Toggle Prior Calls Context on or off as required.
- Click Save to Draft or Publish to Production.
Key Notes
| Item | Details |
|---|---|
| How It Works | When enabled, the agent retains context from previous calls made from the same phone number |
| Web Demo | On the web demo version, the agent remembers context automatically when the same user returns |
| Inbound Use Case | If a caller previously raised an issue, the agent can reference it on a follow-up call |
| Outbound Use Case | If a sales call contact said they were unavailable, the agent can acknowledge that context when calling back |
| Advanced View | Must be enabled to access AI Memory settings |
🎥 Watch the demo video below
13. Sharing a Demo Link
Overview
This guide explains how to generate and share a demo link for an AI Voice Agent. Demo links allow anyone to interact with an agent via a web browser without needing a phone number or phone call, making them ideal for demonstrations and testing.
Steps to Create and Share a Demo Link
- Navigate to Call Flows and locate the agent you want to share.
- Click Share Demo at the top of the agent editor.
- Enter a name for the demo link.
- Expand Advanced Settings to configure optional limits:
- Expiry Date – select a preset duration or enter a custom date for when the link will expire
- Per User Limit – the maximum call duration allowed per individual user session
- Total Budget – the combined total minutes available across all users of this link
- Click Create to generate the link.
- Click Confirm and Save.
- Return to the Demo section, copy the link, and share it as required.
Key Notes
| Item | Details |
|---|---|
| No Phone Number Required | Demo links allow agents to be tested or demonstrated via a web browser |
| Per User Limit | Controls how long each individual session can run |
| Total Budget | Controls the combined total minutes available across all sessions for that link |
| Expiry | Links can be set to expire after a specific period or on a custom date |
| Use Case | Share with clients or internal team members for testing and demonstrations |
🎥 Watch the demo video below
14. Changing the LLM (AI Model)
Overview
This guide explains how to change the Large Language Model (LLM) used by an AI Voice Agent. The LLM is the core AI model that powers the agent’s understanding and responses. Different models offer different capabilities, and the choice of model also affects which voices are available.
Steps to Change the LLM
- Navigate to Call Flows and locate the agent you want to edit.
- Ensure you are in the Advanced View.
- Locate the LLM selector within the agent settings.
- Choose from the available models:
- OpenAI models (e.g., GPT series)
- Google models (e.g., Gemini)
- Open source models
- Speech-to-speech models
- Once selected, click Save to Draft or Publish to Production.
Voice Compatibility by Model Type
| Model Type | Voice Options |
|---|---|
| Text-to-speech models (e.g., OpenAI, Gemini) | Full range of available platform voices |
| Speech-to-speech – Grok | Limited to Grok-specific voices only |
| Speech-to-speech – Gemini | Limited to Google Gemini voices only |
Key Notes
| Item | Details |
|---|---|
| LLM Definition | The LLM is the AI model that powers the agent’s reasoning and responses |
| Voice Impact | Switching to a speech-to-speech model changes the available voice options |
| Speech-to-Speech | Offers more natural, lower-latency responses but has a more limited voice selection |
| Advanced View | Must be enabled to access the LLM setting |
🎥 Watch the demo video below
15. Viewing Analytics
Overview
This guide explains how to access and interpret the analytics dashboard in the portal. Analytics provide visibility into call volumes, agent activity, and call outcomes across your workspace.
Steps to View Analytics
- Navigate to Analytics in the left-hand sidebar.
- The analytics dashboard will display key metrics including:
- Call volumes by time of day
- Calls per agent (inbound and outbound)
- Use the agent filter to view data for a single agent or across all agents.
- Use the date range selector to adjust the reporting period.
- Add dispositions to categorise and track call outcomes (e.g., Completed, Transferred, Voicemail).
- Assign each agent a nickname for easier identification within the dashboard.
Key Notes
| Item | Details |
|---|---|
| Agent Filter | Toggle between individual agents or a full workspace view |
| Date Range | Adjust the reporting window to review historical or recent data |
| Dispositions | Custom labels that categorise call outcomes for reporting purposes |
| Call Volume | View peak call times to understand when agents are most active |
🎥 Watch the demo video below
16. How to Test an Agent
Overview
This guide explains how to test an AI Voice Agent directly within the portal using either voice or text. Testing allows you to interact with the agent before it goes live and identify any issues with the prompt or configuration.
Steps to Test an Agent
- Navigate to Call Flows and locate the agent you want to test.
- Click Voice to initiate a voice conversation with the agent.
- The agent will connect and you can speak with it as a caller would.
- Alternatively, use the text chat option to type messages and receive responses in text format.
- Review how the agent responds and make note of any issues.
- Return to the agent settings or prompt to make adjustments as needed.
Key Notes
| Item | Details |
|---|---|
| Voice Test | Initiates a live voice session with the agent via the web portal |
| Text Test | Allows you to type and receive responses — useful for quickly checking prompt logic |
| Transfers | Cannot be tested via the portal — must be tested over a live phone call |
| Feedback Loop | Use test sessions to identify prompt issues, incorrect routing, or unexpected responses |
🎥 Watch the demo video below
17. Dynamic Variables whilst Testing
Overview
This guide explains how to set and manage dynamic variables when testing an AI Voice Agent in the portal. Dynamic variables are values injected into the agent’s prompt at runtime — for example, a caller’s first name — and must be populated before testing to ensure the agent behaves correctly.
What Are Dynamic Variables?
Dynamic variables appear in the agent prompt as orange highlighted text enclosed in curly brackets (e.g., {first_name}). They must be:
- A single word (no spaces)
- Case sensitive
- Defined in the Variables panel before testing
Steps to Set Dynamic Variables for Testing
- Navigate to Call Flows and locate the agent you want to test.
- Confirm the agent prompt contains dynamic variables (displayed in orange with curly brackets).
- Before testing, go to the Variables panel.
- Locate the variable (e.g.,
{first_name}) and enter a test value (e.g., John). - Optionally, click Save to Library to store this variable set for future test sessions — enter a name and confirm.
- In the Library, click the star icon next to a saved set to make it the default — this means the agent will automatically load that variable set each time you test.
- Click Load to apply the variable set before testing.
- Only add variables that exist in the agent prompt — adding variables not referenced in the prompt has no effect.
- Once testing is complete, save any changes using Save to Draft.
Key Notes
| Item | Details |
|---|---|
| Format | Variables must be a single word, enclosed in curly brackets, and are case sensitive |
| Display | Dynamic variables appear highlighted in orange within the agent prompt |
| Library | Save frequently used variable sets to the library to avoid re-entering values each session |
| Default Set | Star a library entry to automatically load it each time the agent is tested |
| Unused Variables | Adding a variable that does not exist in the prompt has no effect |
🎥 Watch the demo video below
18. Changing the Agent Voice
Overview
This guide explains how to change the voice used by an AI Voice Agent. The portal includes a range of built-in voices as well as ElevenLabs voices. You can filter by characteristics such as accent, gender, or age, and preview voices before selecting.
Steps to Change the Agent Voice
- Navigate to Call Flows and locate the agent you want to edit.
- Ensure you are in the Advanced View.
- Go to Voice and click on the Voice selector.
- Browse the available voices or use the search field to filter by characteristics (e.g., Australian, Female, Young).
- Click Play next to any voice to preview it.
- To test a voice in a full conversation, click Voice and speak with the agent directly.
- Select the voice you want to use and click Close.
- Click Save to Draft or Publish to Production.
Voice Types Available
| Voice Type | Details |
|---|---|
| Platform voices | Standard voices included with the platform |
| ElevenLabs voices | Additional voices via ElevenLabs integration — pricing is included, no additional charge |
| Speech-to-speech voices | Available when a speech-to-speech LLM is selected — limited to voices specific to that model (e.g., Grok or Gemini) |
Key Notes
| Item | Details |
|---|---|
| Filtering | Search by accent, gender, or age to narrow down voice options |
| Preview | Use the Play button to hear a short sample before selecting |
| Conversation Test | Use the Voice test button to hear the voice in a full conversational context |
| Speech-to-Speech | Selecting a speech-to-speech LLM changes the available voices — only voices specific to that model are available |
| ElevenLabs Pricing | Ignore any pricing displayed — ElevenLabs voices are included in the platform |
🎥 Watch the demo video below
19. Changing the Agent Language
Overview
This guide explains how to change the language used by an AI Voice Agent. The platform supports multiple languages and, when using speech-to-speech models, can switch between languages dynamically during a call.
Steps to Change the Agent Language
- Navigate to Call Flows and locate the agent you want to edit.
- Ensure you are in the Advanced View.
- Locate the Language selector and choose the required language.
- Ensure the voice assigned to the agent matches the selected language — using an English-accent voice for a non-English language will produce unnatural results.
- Where possible, write the agent’s prompt in the same language as the selected language setting for the most natural output.
- Click Save to Draft or Publish to Production.
Key Notes
| Item | Details |
|---|---|
| Voice Matching | Always use a voice with an accent native to the selected language |
| Prompt Language | Writing the prompt in the same language as the language setting produces better, more natural responses |
| Multilingual (Speech-to-Speech) | Speech-to-speech models such as Grok can switch between languages dynamically during a call |
| Real-Time Language Switching | When enabled via speech-to-speech, the agent handles language changes mid-call smoothly and naturally |
🎥 Watch the demo video below
20. Editing Voice Speed
Overview
This guide explains how to adjust the speaking speed of an AI Voice Agent. Voice speed can be increased or decreased to better suit the agent’s use case and target audience.
Steps to Edit Voice Speed
- Navigate to Call Flows and locate the agent you want to edit.
- Ensure you are in the Advanced View.
- Go to Voice and locate the Voice Speed control.
- Adjust the speed up or down to the desired level.
- Click Save to Draft or Publish to Production.
- Use the Voice test button to speak with the agent and confirm the speed feels natural.
Key Notes
| Item | Details |
|---|---|
| Testing Speed | Use the Voice test feature to hear the adjusted speed in a real conversation before publishing |
| Advanced View | Must be enabled to access Voice Speed settings |
| Save Options | Use Save to Draft to test before going live, or Publish to Production to apply immediately |
🎥 Watch the demo video below
KB Articles – AI Voice Portal (Batch 2)
21. Editing the System Prompt
Overview
This guide explains how to access and edit the main system prompt for an AI Voice Agent. The system prompt is the core instruction set that controls how the agent behaves, what it says, and when it executes actions such as transfers or API calls.
Steps to Edit the System Prompt
- Navigate to Call Flows and locate the agent you want to edit.
- Click into the agent to open the editor.
- The system prompt is displayed in the main editor panel.
- To expand the editor to full screen, click the expand icon.
- Make any required edits to the prompt.
- To preview the prompt structure visually, switch to the Visualiser view — this shows how each section of the call links together and when different parts of the prompt are triggered.
- Once edits are complete, click Save to Draft to test before going live, or Publish to Production to apply immediately.
Key Notes
| Item | Details |
|---|---|
| Prompt Language | System prompts are written in Markdown — be careful when editing formatting, hashes, or structural annotations |
| @goto Nodes | The prompt uses a node-based structure to control call flow — sections are linked using @goto references that dictate when the agent moves between steps |
| Executions | Transfers, API calls, and other actions are triggered from within the prompt based on the conditions defined |
| Visualiser | Use the Visualiser view to see how prompt sections connect — useful for understanding complex call flows |
| Version History | If you make a mistake, use the prompt history to review and revert to a previous version |
| Safe Editing | Always save to draft and test before publishing, especially if the agent is live with active phone numbers |
🎥 Watch the demo video below
22. Changing Agent Name & Call Direction
Overview
This guide explains how to rename an AI Voice Agent and change the direction in which it can handle calls — inbound, outbound, or both.
Steps to Change Agent Name and Direction
- Navigate to Call Flows and locate the agent you want to edit.
- Ensure you are in the Advanced View.
- Click the name field at the top of the editor to rename the Call Flow.
- To assign the agent a separate display name or persona name (e.g., Alex, Samantha), enter it in the Agent Nickname field.
- Locate the Call Direction setting and select the appropriate option:
- Outbound only – the agent can only make outbound calls
- Inbound and Outbound – the agent can both make and receive calls
- Click Save to Draft or Publish to Production.
Key Notes
| Item | Details |
|---|---|
| Call Flow Name | The internal name used to identify the agent within the portal |
| Agent Nickname | The persona name used by the agent — this is separate from the Call Flow name |
| Call Direction | Controls whether the agent handles inbound calls, outbound calls, or both |
| Advanced View | Must be enabled to access these settings |
🎥 Watch the demo video below
23. Configuring In-Call API Calls
Overview
This guide explains how to configure in-call API calls for an AI Voice Agent. API calls allow the agent to retrieve or send data to external systems in real time during a conversation — for example, checking product availability, looking up a customer record, or submitting a form.
Steps to Configure an In-Call API
- Navigate to Call Flows and locate the agent you want to edit.
- Ensure you are in the Advanced View.
- Locate the API section within the agent settings.
- Click Add API and configure the following fields:
- Method – the HTTP method (e.g., GET, POST)
- Endpoint – the URL the API call will be sent to
- Name – a label used to reference this API call within the prompt
- Variables – any dynamic variables to be passed with the request
- Authentication – add authentication credentials if required
- Request Headers – add any required headers
- Optionally, configure a Text to Speak message that the agent will say while the API call is being processed (e.g., “Just give me a moment to check that for you”) — this prevents silence while the system waits for a response.
- Configure whether the API should run pre-call (before the conversation starts) or be triggered during the call based on prompt conditions.
- Reference the API by its Name within the system prompt to define when it should be invoked.
- Click Save to Draft or Publish to Production.
Key Notes
| Item | Details |
|---|---|
| Text to Speak | Always configure a holding message for APIs that may take a moment to respond — silence during an API call creates a poor caller experience |
| Pre-Call Execution | APIs can be triggered before the conversation starts to pre-load data (e.g., looking up a caller’s details) |
| In-Call Execution | APIs triggered mid-call based on prompt conditions — useful for real-time lookups |
| Use Case Example | A caller asks if a product is in stock — the agent calls the inventory API, retrieves the result, and responds in real time |
| Advanced View | Must be enabled to access API settings |
🎥 Watch the demo video below
24. Configuring Webhooks
Overview
This guide explains how to configure system webhooks for an AI Voice Agent. Webhooks allow the platform to send call data to external systems automatically — either before a call begins, after a call ends, or when the call status changes.
Webhook Types
| Webhook Type | When It Fires | Common Use Cases |
|---|---|---|
| Pre-Call Inbound Webhook | When an inbound call is received, before the agent speaks | Look up the caller’s details by phone number and inject personalised data (e.g., name, company, upcoming appointments) into the conversation |
| Post-Call Webhook | After the call ends | Trigger downstream workflows — update a CRM, send a notification email, log call data |
| Call Status Webhook | When the call status changes (e.g., transfer initiated) | Notify external systems of real-time call events |
Steps to Configure a Webhook
- Navigate to Call Flows and locate the agent you want to edit.
- Go to Data and click System Webhooks.
- Select the webhook type you want to configure.
- Enter the destination URL where the webhook payload should be sent.
- For the post-call webhook, customise the payload to include the specific data fields you need.
- Hover over the information icon (?) on each field for additional guidance.
- Click Save to Draft or Publish to Production.
Key Notes
| Item | Details |
|---|---|
| Pre-Call Use Case | Match an inbound caller’s phone number to existing records and greet them by name or surface relevant account details |
| Post-Call Use Case | Send call data to tools such as n8n, Make, or Zapier to trigger CRM updates, email notifications, or other automations |
| Compatible Platforms | Webhook data can be integrated with HubSpot, Zoho, and other CRM or ticketing platforms |
| Payload Customisation | The post-call webhook payload can be configured to include specific data fields relevant to your integration |
| Call Status Webhook | Primarily used to notify external systems when a transfer is executed or the call status changes |
🎥 Watch the demo video below
25. Recording & Security Settings
Overview
This guide explains how to configure the security and compliance settings for an AI Voice Agent, including call recording, compliance monitoring, anti-bot detection, HIPAA mode, data retention, and transcription redaction.
Steps to Access Security Settings
- Navigate to Call Flows and locate the agent you want to edit.
- Ensure you are in the Advanced View.
- Click on the Security tab.
Available Security Settings
Recording
- Toggle Recording on to enable call recording for all calls and web demo sessions.
- Toggle Public Recording Link on if you want a publicly accessible URL to be generated for each recording — this is required if you intend to pass recording links to external systems such as a CRM.
Compliance Monitoring
- Toggle Compliance on to enable compliance monitoring across inbound and outbound calls. Compliance results are visible in the call history.
Anti-Bot Detection
- Toggle Anti-Bot Detection on to detect whether an AI-generated voice is calling in. Hover over the information icon for further detail.
HIPAA Mode
- Toggle HIPAA on to enable HIPAA-compliant data handling. When enabled:
- All call data (transcripts, recordings, LLM processing history) is wiped from the platform and its underlying services immediately after the call ends and the post-call webhook fires
- Data can still be sent to an external CRM via webhook before it is wiped
- Call history and transcripts will not be accessible in the portal after the call
- Prior Calls Context (AI Memory) cannot be used, as there is no retained call data to reference
Transcription Redaction
- Toggle Transcription Redaction on and configure which data points should be redacted from transcripts (e.g., date of birth, caller name).
Data Retention
- Configure the Data Retention period for transcripts, summaries, and recordings — options range from 1 day to 1 year, after which data is automatically deleted.
- Click Save to Draft or Publish to Production.
Key Notes
| Item | Details |
|---|---|
| Public Recording Link | Must be enabled for recording URLs to be accessible via external systems |
| HIPAA Trade-Off | Enabling HIPAA mode disables call history visibility and Prior Calls Context in exchange for full data deletion post-call |
| Compliance | Compliance monitoring applies to both inbound and outbound calls |
| Data Retention | Set based on your business or regulatory requirements |
| Anti-Bot Detection | Identifies inbound calls where the caller appears to be an AI-generated voice |
🎥 Watch the demo video below
26. Connecting GoHighLevel
Overview
This guide explains how to connect a GoHighLevel (GHL) account to an AI Voice Agent. Once connected, the agent can book appointments directly into GoHighLevel, eliminating the need for third-party calendar tools.
Steps to Connect GoHighLevel
- Navigate to Call Flows and locate the agent you want to integrate.
- Ensure you are in the Advanced View.
- Go to Integrations and click GoHighLevel.
- Click the Connect button to authenticate and link your GoHighLevel account.
- If you encounter issues, refer to the Troubleshooting section on the same page for guidance on common errors.
- Once connected, go to Function Templates to view the prompt syntax required to activate the integration.
- Copy the relevant syntax and paste it into the agent’s system prompt in the appropriate location.
- Click Save to Draft or Publish to Production.
Key Notes
| Item | Details |
|---|---|
| Primary Use Case | Calendar booking — appointments made by the agent are created directly in GoHighLevel |
| Function Templates | Contains the prompt syntax needed to activate the GoHighLevel integration — copy and paste into the system prompt |
| Troubleshooting | Common connection errors and fixes are documented on the integration page |
| Alternative | Without GHL, bookings can be handled via Google Calendar or other calendar integrations |
🎥 Watch the demo video below
27. Running Batch Calls
Overview
This guide explains how to set up and send a batch outbound calling campaign using an AI Voice Agent. Batch calls allow you to upload a list of contacts and have the agent call them automatically, with options to schedule campaigns and configure retry behaviour.
Steps to Run a Batch Call Campaign
- Navigate to the Calls tab in the sidebar and open Batch Calls.
- Select the agent you want to use for the campaign.
- Confirm that the selected agent has a phone number assigned — this is required to send outbound calls.
- Download the CSV template to see the required format for your contact list.
- Prepare your CSV file with all contact numbers and any dynamic variables referenced in the agent’s prompt (e.g., first name, company).
- Upload the CSV file.
- Optionally, schedule the campaign to send at a specific date and time.
- Configure Auto-Retry settings:
- Set the number of retry attempts (e.g., up to 4 attempts)
- Set the intervals between retries (e.g., retry after 3 hours, then 1 day, then 3 days)
- Hover over the information icon (?) on each field for additional detail.
- Launch the campaign.
Key Notes
| Item | Details |
|---|---|
| Phone Number Requirement | The agent must have a phone number assigned before batch calls can be sent |
| CSV Format | Download the template to confirm the correct column structure before uploading your contact list |
| Dynamic Variables | Include columns in the CSV for any dynamic variables used in the agent’s prompt |
| Auto-Retry | Retries are only attempted if the contact did not answer — if the contact picks up or the call reaches a conclusion, no further retries are made |
| Scheduling | Campaigns can be scheduled in advance or sent immediately |
🎥 Watch the demo video below
28. Changing Batch Call Speed
Overview
This guide explains how to configure the speed at which outbound batch calling campaigns are executed. Batch call speed is a workspace-level setting that applies to all agents within the workspace.
Steps to Change Batch Call Speed
- Navigate to Settings in the sidebar.
- Click Batch Call Settings.
- Adjust the speed parameters — the calculated call rate at the bottom of the page will update in real time to reflect your changes.
- Hover over the information icon (?) next to each field for a detailed explanation of how each parameter affects the call rate.
- Click Save Settings.
Key Notes
| Item | Details |
|---|---|
| Workspace-Level Setting | Batch call speed applies to the entire workspace — individual agents cannot run at different speeds within the same workspace |
| Call Rate Indicator | The calculated call rate at the bottom of the page updates as you adjust the parameters, showing the effective outbound call rate |
🎥 Watch the demo video below
29. Managing Knowledge Bases
Overview
This guide explains how to create, manage, and attach knowledge bases to an AI Voice Agent. Knowledge bases provide the agent with reference information it can draw on during calls — such as business details, FAQs, pricing, and product information.
Steps to Create a Knowledge Base
Option 1 – From the Knowledge Base Tab
-
Open the sidebar and navigate to Knowledge Base.
-
Click Create New.
-
Choose the knowledge base type:
Basic Knowledge Base
- Enter the business name and key details
- Expand the dropdown to add: opening hours, services offered, pricing, intake questions, FAQs, and other relevant information
- Click Create when complete
Advanced Knowledge Base
- Upload a PDF, Word document, or text file, or paste raw text directly
- Use this option for large or complex knowledge bases that exceed what the basic form supports
- Click Create when complete
Option 2 – From Within an Agent
- Navigate to Call Flows and locate the agent you want to edit.
- Ensure you are in the Advanced View.
- Go to the General tab and click Knowledge Base.
- View currently attached knowledge bases, edit them, attach new ones, or detach existing ones.
- Click Create New from this panel if you want to create a knowledge base directly from the agent.
Steps to Attach or Detach a Knowledge Base
- Open the agent in Call Flows.
- Ensure you are in the Advanced View.
- Go to General → Knowledge Base.
- Use the attach/detach controls to manage which knowledge bases are active for this agent.
- Click Save to Draft or Publish to Production.
Key Notes
| Item | Details |
|---|---|
| Basic KB | Best for structured business information — name, hours, services, FAQs, pricing |
| Advanced KB | Best for large or detailed documents — supports PDF, Word, text file, or raw text input |
| Multiple Knowledge Bases | Multiple knowledge bases can be attached to a single agent |
| Editing | Existing knowledge bases can be edited from both the Knowledge Base tab and from within the agent |
| Advanced View | Must be enabled to access Knowledge Base settings within an agent |
🎥 Watch the demo video below
30. Responsiveness & Interruption Sensitivity
Overview
This guide explains how to configure the speech detection settings for an AI Voice Agent, including how quickly the agent responds after the caller stops speaking, how sensitive it is to interruptions, and how it detects turn-taking in conversation.
Steps to Configure Speech Detection
- Navigate to Call Flows and locate the agent you want to edit.
- Ensure you are in the Advanced View.
- Go to Voice and click Speech Detection.
Responsiveness
- Adjust the Responsiveness slider — this controls how quickly the agent starts speaking after the caller stops talking. A higher value means the agent responds faster.
Interruption Sensitivity
- Adjust the Interruption Sensitivity slider — this controls how many words the caller needs to say before the agent stops talking and yields the floor.
- A higher setting means the agent will stop talking even for brief acknowledgements like “yes” or “okay”
- A lower setting means the agent will continue speaking through short interjections and only yield when the caller says something more substantial — this reduces conversational overlap
Turn Detection Model
- Select the Turn Detection Model:
- STT-Based (Speech-to-Text) – uses speech-to-text processing to determine when the caller has finished speaking
- AI Detection – uses AI to predict turn-taking
Preemptive Generation
-
Toggle Preemptive Generation on or off. When enabled, the agent begins generating its response before the caller has finished speaking. This can reduce latency but may result in incorrect responses if the caller’s full intent was not yet captured. It is generally recommended to leave this off.
-
Click Save to Draft or Publish to Production.
Key Notes
| Item | Details |
|---|---|
| Responsiveness | Controls the delay between the caller stopping and the agent starting to speak |
| Interruption Sensitivity | Controls how reactive the agent is to short caller inputs — lower values reduce conversational overlap |
| STT-Based (Speech-to-Text) Turn Detection | Recommended default — more reliable for most use cases |
| Preemptive Generation | Can reduce latency but risks generating incorrect responses — leave off unless specifically needed |
| Advanced View | Must be enabled to access Speech Detection settings |
🎥 Watch the demo video below
31. Viewing Call History
Overview
This guide explains how to access and use the call history log in the portal. History provides a complete record of all calls made by your agents, including recordings, transcripts, post call analysis data, and call metadata.
Steps to View Call History
- Open the sidebar and navigate to History.
- The history log displays all calls across your workspace.
- Click into any call record to view:
- Recording – the audio recording of the call (if recording is enabled)
- Transcript – the full text transcript of the conversation
- Post Call Analysis – extracted data points configured in the Post Call Analysis settings
- Post Call Task Statuses – the outcome status of any post-call actions (e.g., SMS sent, webhook fired)
- Call Metadata – call ID, direction (inbound/outbound), source and destination numbers, Call Flow used, and call duration
Filtering the History Log
- Use the filter options to narrow results by:
- Date range
- Specific agent
- Functions called during the call
- Call dispositions
- Post Call Analysis data points (e.g., filter by a specific extracted value)
- Call direction (inbound/outbound)
- Batch campaign
- Call status
Exporting History
- Click Export to download the filtered history as a CSV file for use in spreadsheet tools or external reporting.
Key Notes
| Item | Details |
|---|---|
| Recording Access | Recordings are only available if recording is enabled in the agent’s Security settings |
| Post Call Analysis Filters | Filter history by specific extracted data points — useful for reviewing calls where a particular outcome occurred |
| CSV Export | Export filtered results to CSV for external analysis or reporting |
| Web Calls | Web demo calls are included in history and will show the session type rather than a phone number |
🎥 Watch the demo video below
32. Editing the Welcome Message
Overview
This guide explains how to configure the welcome message for an AI Voice Agent — the first thing the agent says (or does) when a call connects. Different message types are available for inbound and outbound calls.
Steps to Configure the Welcome Message
-
Navigate to Call Flows and locate the agent you want to edit.
-
Ensure you are in the Advanced View.
-
Go to the General tab and click Welcome Message.
-
Select whether you are configuring the Inbound or Outbound welcome message.
-
Set the delay — the number of seconds before the message is spoken after the call connects.
-
Toggle Interruptible on or off to control whether the caller can interrupt the welcome message before it finishes.
-
Select the message type:
AI-Generated
- Enter a prompt instruction (e.g., “Greet the caller and ask how you can help today”)
- The agent will produce a slightly different variation of the greeting each time, based on the instruction
Custom Message
- Enter the exact wording you want the agent to say
- The agent will deliver this message verbatim on every call
- Dynamic variables can be included (e.g., “Hello {first_name}, thanks for calling”)
Wait for Caller
- The agent remains silent after the call connects and waits for the caller to speak first
- Recommended for outbound calls only — on inbound calls, silence at the start of a call creates a poor caller experience
- Suited to outbound scenarios where the recipient answers and says “Hello?” before the conversation begins
-
Click Save to Draft or Publish to Production.
Key Notes
| Item | Details |
|---|---|
| AI-Generated | Produces natural variation in the greeting — best for a conversational feel |
| Custom Message | Delivers the exact same message every time — best for compliance or scripted greetings |
| Wait for Caller | Outbound use only — allows the called party to speak first |
| Dynamic Variables | Can be used in Custom Message type to personalise the greeting (e.g., include the caller’s name) |
| Interruptible | When toggled on, the caller can speak during the welcome message and the agent will respond |
🎥 Watch the demo video below
33. Integrating Google Calendar
Overview
This guide explains how to connect Google Calendar to an AI Voice Agent, allowing the agent to check availability and book appointments directly into a Google Calendar during a call.
Steps to Integrate Google Calendar
- Navigate to Call Flows and locate the agent you want to integrate.
- Ensure you are in the Advanced View.
- Go to Integrations and click Google Calendar.
- Click Connect with Google and follow the authentication prompts to link your Google account.
- Once connected, refer to the Function Templates section below the connection panel — this contains the prompt syntax required to activate calendar functionality within the agent.
- Review the syntax options to understand what each function does (e.g., check availability, create booking).
- Copy the relevant syntax and paste it into the agent’s system prompt in the appropriate location.
- Click Save to Draft or Publish to Production.
Key Notes
| Item | Details |
|---|---|
| Function Templates | Contains ready-to-use prompt syntax for calendar actions — always reference this after connecting to ensure the prompt is configured correctly |
| Prompt Configuration | The Google Calendar integration only works if the correct function syntax is included in the system prompt |
| Use Case | The agent can check calendar availability and book appointments in real time during a call |
🎥 Watch the demo video below
34. Editing Voicemail Settings
Overview
This guide explains how to configure voicemail behaviour for an AI Voice Agent during outbound calls. When the agent encounters a voicemail, you can define whether it should hang up or leave a pre-configured message.
Steps to Configure Voicemail Settings
- Navigate to Call Flows and locate the agent you want to edit.
- Ensure you are in the Advanced View.
- Go to Call Handling and click Voicemail Detection.
- Hover over the information icon (?) for additional detail on how voicemail detection works.
- Select the action to take when a voicemail is detected:
- Hang Up – the agent ends the call immediately upon detecting voicemail
- Leave Message – the agent records a message after the beep
- If Leave Message is selected, enter the message text in the provided field. The agent will deliver this message verbatim.
- Dynamic variables can be included in the message (e.g., “Hello {first_name}, I’m calling from…”) to personalise the voicemail using data from the contact list.
- Click Save to Draft or Publish to Production.
Key Notes
| Item | Details |
|---|---|
| Outbound Only | Voicemail detection applies to outbound calls only |
| Leave Message | The message is delivered verbatim — dynamic variables can be used to personalise it |
| Dynamic Variables | Variables from the batch call CSV or prompt can be referenced in the voicemail message |
| Hang Up | Use this option if leaving voicemails is not appropriate for your campaign |
🎥 Watch the demo video below
35. Editing Call Recording Settings
Overview
This guide explains how to configure call recording settings for an AI Voice Agent, including enabling or disabling recording and controlling whether recording links are publicly accessible.
Steps to Edit Call Recording Settings
- Navigate to Call Flows and locate the agent you want to edit.
- Ensure you are in the Advanced View.
- Go to Security and click Recording.
- Toggle Recording on or off to enable or disable call recording for this agent.
- Toggle Public Recording Link on or off to control whether a publicly accessible URL is generated for each recording.
- Click Save to Draft or Publish to Production.
Key Notes
| Item | Details |
|---|---|
| Recording | When enabled, all calls and web demo sessions are recorded |
| Public Recording Link | Enable this if you need to pass a recording URL to an external system such as a CRM — without this enabled, the link will not be accessible externally |
| Advanced View | Must be enabled to access Recording settings |
Note: For more comprehensive security and compliance settings including HIPAA mode, data retention, and transcription redaction, refer to the Recording & Security Settings guide.
🎥 Watch the demo video below
KB Articles – AI Voice Portal (Batch 3)
36. Portal Overview
Overview
This guide provides a high-level walkthrough of the AI Voice Portal, covering the main sections and what each one is used for. Each feature area has a dedicated guide with more detailed instructions — this article is intended as an orientation for new users.
Dashboard
The Dashboard is the default landing page when you log in. It displays recently updated Call Flows and a summary of recent calls. All detailed work is done in the individual sections accessible via the sidebar.
Call Flows
Call Flows is where all agent configuration takes place. Open the sidebar and navigate to Call Flows to access your agents.
Within each Call Flow, configuration is organised across several tabs. Switch to the Advanced View to access the full range of settings.
General Tab
| Setting | Description |
|---|---|
| Call Settings | Change the agent name, persona nickname, and call direction (inbound/outbound) |
| Welcome Message | Configure what the agent says when a call connects — AI-generated, custom, or wait for caller |
| Knowledge Base | Create new knowledge bases or attach existing ones to the agent |
| AI Memory | Toggle Prior Calls Context to allow the agent to reference previous calls from the same number |
| Persistent Recall | Background system prompts that shape agent tone and behaviour — recommended to leave on unless you have advanced prompting experience |
| Time Zone | Set the agent’s time zone for time-aware logic (e.g., only transferring during business hours) |
| Connect to Business | Configure how the agent connects and forwards calls to your team in specific scenarios |
Voice Tab
| Setting | Description |
|---|---|
| Voice | Select the agent’s voice from platform voices or ElevenLabs options |
| Voice Speed | Adjust how quickly the agent speaks |
| Speech Detection | Configure responsiveness and interruption sensitivity |
| Background Audio | Set hold music, thinking sounds, and ambient audio |
| Agent Dictionary | Add industry-specific words and acronyms to improve transcription accuracy |
Call Handling Tab
| Setting | Description |
|---|---|
| Transfers | Configure Cold, Warm, or Whisper transfers to human agents |
| Inbound Call Redirect | Redirect callbacks from outbound call numbers to your human team |
| Office Hours | Restrict when the agent can make or receive calls |
| Call Timing | Set silence timeouts, reminder retries, and maximum call duration |
| Voicemail Detection | Configure what the agent does when it reaches a voicemail on outbound calls |
| Metadata & IVR | Additional call handling configuration options |
Data Tab
| Setting | Description |
|---|---|
| Post Call Analysis | Define data points to extract from each call (e.g., caller name, intent) — included in webhook payloads |
| Post Call Actions | Configure automatic SMS and email notifications after each call |
| System Webhooks | Set up pre-call, post-call, and call status webhooks for CRM and automation integrations |
Security Tab
Security settings are particularly relevant for enterprise, medical, and legal use cases. Available settings include recording, compliance monitoring, HIPAA mode, transcription redaction, and data retention. See the dedicated Recording & Security Settings guide for full details.
Testing an Agent
To test an agent, click the Voice button to start a live voice session, or click Text to interact via text chat. Dynamic variables can be configured in the Variables panel before testing to simulate real call conditions.
A Logs panel is also available within the agent, showing all API call activity and executions for debugging purposes.
Sharing a Demo Link
To share an agent without needing a phone number, click Share Demo from the top of the agent editor. You can set an expiry date, per-user call limit, and total minute budget. Once created, the link can be shared with anyone to interact with the agent via a web browser. See the dedicated Sharing a Demo Link guide for full details.
Saving and Publishing
All changes can be saved in two ways:
| Option | When to Use |
|---|---|
| Save to Draft | Use when testing changes before going live — does not affect the live agent |
| Publish to Production | Use to push changes to the live agent |
If you make a mistake, use Prompt History within the Call Flow editor to review and revert to a previous version.
Knowledge Base
Navigate to Knowledge Base in the sidebar to create and manage knowledge bases independently of individual agents. There are two types:
- Basic – structured fields for business name, address, pricing, opening hours, FAQs, and intake questions
- Advanced – upload a PDF, Word document, or text file, or paste raw text directly
Once created, knowledge bases can be attached to agents from within the Call Flow editor. Advanced knowledge bases can be edited directly in the portal without re-uploading the source file. See the dedicated Managing Knowledge Bases guide for full details.
Phone Numbers
Navigate to Phone Numbers in the sidebar to purchase or bring your own numbers and assign them to agents. Select the country, search for an available number, claim it, and assign it to a specific Call Flow.
Calls
Navigate to Calls in the sidebar to manage outbound call campaigns.
| Section | Description |
|---|---|
| Single Call | Make a one-off outbound call — primarily used for testing |
| Batch Calls | Upload a CSV contact list and run an outbound calling campaign with optional scheduling and auto-retry |
| Call Queues | Monitor the status of batch call attempts — view retry counts, outcomes, and scheduled next attempts. Export data to CSV |
See the dedicated Running Batch Calls guide for full details.
History
Navigate to History in the sidebar to view a complete log of all calls. Each record includes the recording, transcript, post call analysis data, and call metadata. Results can be filtered by agent, date range, disposition, call direction, batch, and post call analysis values. All data can be exported to CSV. See the dedicated Viewing Call History guide for full details.
Analytics
Navigate to Analytics in the sidebar to view call performance data across your workspace. Filter by agent or date range, view call volumes by time of day, manage dispositions, and export data to CSV. See the dedicated Viewing Analytics guide for full details.
🎥 Watch the demo video below
37. Providing Feedback on Test Calls
Overview
This guide explains how to provide feedback on test calls using the call ID and the shared feedback sheet. Structured feedback helps ensure that any issues with agent behaviour are addressed accurately and efficiently.
Steps to Provide Feedback
- Navigate to History in the sidebar.
- Locate the call you want to provide feedback on and click into it.
- Find the Call ID at the top of the call record.
- Click the Call ID — it will automatically copy to your clipboard.
- Open the feedback sheet that has been shared with you.
- Paste the Call ID into the relevant field.
- Add your comments describing the issue.
How to Write Useful Feedback
Feedback is most actionable when it includes:
- What happened – describe the specific point in the call where the issue occurred
- What went wrong – explain what the agent said or did that was incorrect
- What should happen instead – provide the preferred response or behaviour
Feedback that only states something was wrong without providing context or the desired outcome is difficult to act on. Always include both the problem and the expected result.
Example of unhelpful feedback:
The agent asked the wrong questions.
Example of useful feedback:
At the point where the caller said they wanted to cancel, the agent asked for their account number before confirming whether cancellation was the right option. It should first confirm the intent and offer retention options before requesting account details.
Key Notes
| Item | Details |
|---|---|
| Call ID | Found at the top of the individual call record in History — click to copy |
| Feedback Sheet | Provided separately — contact your account manager if you have not received access |
| Specificity | Always include the desired outcome alongside the issue — vague feedback cannot be actioned |
🎥 Watch the demo video below
KB Articles – AI Voice Portal (Batch 4)
38. Integrating Cal.com
Overview
This guide explains how to integrate Cal.com with an AI Voice Agent to enable real-time calendar booking during calls. Cal.com connects with Outlook and Gmail calendars, allowing the agent to check availability and create bookings without any manual follow-up.
Before You Begin
You will need:
- A Cal.com account with at least one event configured
- A Cal.com API key
- The Event Type ID for the event you want to use
Part 1 – Set Up Cal.com
Create an Event
- Log into your Cal.com account.
- Create a new event and give it a name (e.g., Consultation, Site Visit).
- Add a description if required and set the event duration.
- Click Continue.
- Configure additional settings as needed:
- Location – in-person, Microsoft Teams, or other options
- Availability – set the windows during which bookings can be made
- Limits – cap the number of bookings per day or week if required
Get the Event Type ID
- Once the event is saved, locate the Event Type ID — this is the numeric code shown in the URL or event settings.
- Copy this ID — you will need it in the next step.
Generate an API Key
- In Cal.com, navigate to Settings → Developer → API Keys.
- Click Add New API Key and give it a name.
- Set an expiration date or select Never Expire.
- Click Save — your API key will be generated and displayed once.
- Copy the API key immediately and store it securely.
Part 2 – Connect Cal.com to the Agent
- Navigate to Call Flows and locate the agent you want to integrate.
- Ensure you are in the Advanced View.
- Go to Integrations and click Cal.com.
- Enter the following details:
- Select the Time Zone relevant to the bookings.
- Optionally, enter an Availability ID if you have configured specific availability windows in Cal.com.
- Enter a Text to Speak message — this is what the agent will say while the booking function is being executed (e.g., “Just give me a moment while I check availability for you”). This prevents silence during the lookup.
- If you want additional information captured during the call to be included in the calendar booking (e.g., a caller’s address for a site visit), map the relevant dynamic variables to the corresponding Cal.com booking fields.
Part 3 – Update the System Prompt
- Go to Function Templates within the Cal.com integration panel — this contains the prompt syntax required to activate the Cal.com functions.
- Copy the relevant syntax and paste it into the agent’s system prompt at the appropriate point in the call flow.
- The prompt should define when the agent checks availability and when it creates a booking.
- Click Save, then click Save to Draft or Publish to Production.
Key Notes
| Item | Details |
|---|---|
| Cal.com Account | Must be set up and configured before connecting to the portal |
| Event Type ID | Found in the Cal.com event URL or settings — numeric code |
| API Key | Generated once in Cal.com — copy it immediately before closing the window |
| Text to Speak | Always configure a holding message to avoid silence during the calendar lookup |
| Dynamic Variables | Call data (e.g., caller address) can be passed into the Cal.com booking at the time of creation |
| Function Templates | Must be copied into the system prompt for the integration to work |
| Advanced View | Must be enabled to access the Cal.com integration |
🎥 Watch the demo video below
39. Connecting Your Business Number (Call Forwarding)
Overview
This guide explains how to configure call forwarding from your existing business mobile to your AI Voice Agent. Once set up, calls to your number can be automatically handled by the agent based on the conditions you define — such as when you are busy, unavailable, or for all calls.
Before You Begin
- The agent must have a phone number assigned to it before connecting your business number.
- You will need access to your mobile phone to dial the forwarding codes or scan the QR code provided.
Steps to Set Up Call Forwarding
- Navigate to Call Flows and locate the agent you want to connect.
- Ensure you are in the Advanced View.
- Click Connect to Business.
- Select your country (e.g., Australia).
- Select your carrier from the list — the three major carriers are shown by default, with additional carriers available by expanding the list.
- Click Continue.
- Select your device type and click Continue.
- Choose the forwarding condition — select the scenario in which calls should be forwarded to the AI agent:
| Forwarding Condition | When It Applies |
|---|---|
| When I don’t answer | Calls forward to the agent if you do not pick up within the ring timeout |
| When I’m on a call | Calls forward to the agent when your line is busy |
| When I’m unreachable | Calls forward to the agent when your phone has no signal |
| All calls | Every incoming call is handled by the agent |
- Click Continue.
- Optionally, toggle Disable Voicemail / Message Bank if you want to turn off your carrier voicemail — recommended to avoid calls going to voicemail before reaching the agent.
- Follow the on-screen instructions — either scan the QR code or dial the provided codes on your mobile to activate forwarding.
- Click Done.
- Click Save to Draft or Publish to Production.
Key Notes
| Item | Details |
|---|---|
| Phone Number Required | The agent must have a number assigned before this feature is available |
| Carrier-Specific | Forwarding codes vary by carrier — always use the codes generated by the portal for your specific carrier |
| Voicemail | Disable carrier voicemail to ensure calls reach the agent rather than your message bank |
| Troubleshooting | If forwarding does not work as expected, refer to the troubleshooting section within the Connect to Business panel |
| Advanced View | Must be enabled to access Connect to Business settings |
🎥 Watch the demo video below
40. Managing Phone Numbers
Overview
This guide explains how to purchase a phone number and assign it to an AI Voice Agent. Phone numbers are required for agents to make or receive calls.
Steps to Purchase and Assign a Phone Number
Purchase a Number
- Open the sidebar and navigate to Phone Numbers.
- Click Buy a Number.
- Select the country you want the number to be based in.
- Click Search — available numbers will be displayed.
- Select a number and click Claim to purchase it. The number will be allocated to your account.
Configure the Number
- Click into the newly purchased number to open its settings.
- Enter a nickname to help identify the number within the portal.
- Select the agent you want to assign this number to.
- Configure any additional settings as required.
- Click Save Configuration.
Key Notes
| Item | Details |
|---|---|
| Country Selection | Numbers are available across multiple countries — select the relevant country before searching |
| Nickname | Use a descriptive nickname to make numbers easy to identify, especially if managing multiple numbers |
| Agent Assignment | A number can be assigned to one agent at a time |
| Bring Your Own Number | If you want to use an existing number rather than purchasing one, use the Connect to Business feature — see the Connecting Your Business Number guide |
🎥 Watch the demo video below
41. Integrating Slack
Overview
This guide explains how to connect Slack to the portal and enable Slack notifications for an AI Voice Agent. Once configured, the agent will send a notification to your Slack workspace at the end of each call.
Steps to Integrate Slack
Step 1 – Connect Slack at the Workspace Level
- Navigate to Settings in the sidebar.
- Click Slack and follow the prompts to connect your Slack workspace.
Step 2 – Enable Slack Notifications on an Agent
- Navigate to Call Flows and locate the agent you want to configure.
- Ensure you are in the Advanced View.
- Go to Data and click Slack Integration.
- Toggle Slack Notifications on to enable notifications for this agent, or off to disable them.
- Click Save to Draft or Publish to Production.
Key Notes
| Item | Details |
|---|---|
| Workspace Connection | Slack must be connected at the workspace level in Settings before it can be enabled on individual agents |
| Per-Agent Control | Slack notifications can be toggled on or off independently for each agent |
| Advanced View | Must be enabled to access the Slack Integration setting |