BETA: Flo AI Phone Agent

Generic selectors
Exact matches only
Search in title
Search in content
Post Type Selectors

Overview

This guide walks through setting up the AI Voice Agent, from the calendar and business hours it uses to decide when a call can be transferred, through phone basics and routing, to launch configuration and testing. AI Voice settings are only available to clients who have AI Voice enabled.

  • Part 1: global settings: calendar, business hours, transfer logic, and departments.
  • Part 2: phone basics and the directories the agent uses to route calls.
  • Part 3: knowledge, escalation, and call center services, plus queues and launch config.
  • Part 4: launch configuration, readiness checks, and testing before go-live.
  • Part 5: a summary of the complete setup, end to end.

Part 1: Global settings and departments

Calendar, business hours, transfer logic, and school departments.

1. Start with Global Settings: Calendar Setup

  • Open Global Settings first.

  • Add a calendar by clicking the settings icon.

  • Paste the iCal link.

  • Enter a name and subscribe.

  • Once subscribed, the calendar data populates automatically.

  • The AI Voice Agent uses this calendar to detect closed days and avoid transferring calls on those days.

  • This same calendar setup can also support SLA-related absent/closed day logic.

2. Configure Business Hours

  • After calendar setup, define business hours.

  • Create a business-hours entry with a name, such as Transportation.

  • Set the applicable time range.

  • Optionally assign the business hours to specific:

    • Buildings

    • Departments

    • Call queues

    • Topics

  • This creates the rules the AI Voice Agent uses to decide whether a transfer is allowed at the current time.

3. Understand the Transfer Logic

  • When the AI Voice Agent needs to transfer a call, it checks in this order:

    • Calendar availability — is the day open?

    • Business hours — is the current time within allowed hours?

  • If the destination is closed or outside business hours:

    • The agent tells the caller the destination is unavailable.

    • The caller can leave a voicemail.

  • If both checks pass, the call is transferred normally.

4. Set Up School Departments

  • School departments were moved from the global area into this section.

  • They are now handled more directly and are not tied to topics or categories.

  • Each department should include:

    • ID number

    • Department name

    • Department phone number

    • Owner

    • Labels

    • Description

  • The phone number is important because the AI Voice Agent transfers calls to that number.

  • Labels and descriptions help the AI determine the best department to route to.

5. Use Department Details to Improve Routing Accuracy

  • The AI Voice Agent uses the department name, labels, and description to infer where a caller should go.

  • The more complete the department setup, the more accurate the routing.

  • Best practice:

    • Fill in all fields

    • Add clear labels

    • Write a useful description

  • This helps the agent make smarter transfer decisions.

6. Access the AI Voice Agent Phone Basics

  • Go to Phone Basics to access the new AI Voice Agent settings.

  • This section is only available for clients who have AI Voice enabled in the backend.

  • The phone basics area includes:

    • Flow Voice

    • Phone Line

    • Greetings

    • Texting

7. Choose a Voice in Flow Voice

  • In Flow Voice, select the voice the AI Voice Agent will use.

  • This is part of the core voice configuration for the agent.

  • From here, the rest of the phone experience is configured through the other phone basics options.

Part 2: Phone basics and call routing

Voice, phone line, greetings, texting, and routing directories.

1. Review the phone basics settings

  • Open Phone Basics to configure the core voice-agent behavior.

  • This section includes:

    • Flow Voice

    • Phone Line

    • Greetings

    • Texting

  • These settings control how the AI voice agent sounds, what number it uses, and how it responds to callers and texters.

2. Choose the AI agent’s voice

  • In Flow Voice, select the voice for the AI agent.

  • Enter a name and sample text.

  • Play the voice sample to preview different options.

  • Choose the voice that best fits the agent’s tone and use case.

3. Provision and configure the phone line

  • In Phone Line, provision a phone number for the AI voice agent.

  • Start with the main line and edit:

    • Name

    • Description

  • This is the number callers will use to reach the AI agent.

4. Add greeting messages

  • Use Greetings to create spoken welcome messages.

  • Add a greeting name and the greeting text.

  • The system will read the text in the AI agent’s voice.

  • No audio recording is needed—just type the message.

5. Enable texting behavior

  • In Texting, configure what happens when someone texts the phone number.

  • Current behavior:

    • A ticket is created

    • The system can auto-reply

  • This lets the AI phone number handle both calls and SMS.

6. Understand the Service Hub directory options

  • In Service Hub, directory settings help the AI route calls to the right person.

  • The available routing options are:

    • SIP trunking

    • Building directory

    • Department directory

    • Employee directory

  • These options determine how the AI finds the correct destination for a call.

7. Configure SIP trunking for call transfer

  • Use SIP trunking if you want calls transferred through a SIP integration.

  • Open Integrations and configure the SIP trunk in the marketplace.

  • Once connected, the flow can transfer calls through extensions and numbers via SIP trunking.

8. Set up building-based routing

  • Use Building Directory when routing depends on a physical location.

  • Click into Physical Location to view buildings.

  • Buildings can include:

    • Contact name

    • Contact number

    • Contact email

  • The AI will call the listed number for that building when needed.

9. Use department phone numbers for routing

  • Department routing uses the phone numbers already configured in Global Settings.

  • If a department has a number assigned, the AI can dial that number directly.

  • This is useful when calls should go to a specific department rather than an individual.

10. Configure the employee directory

  • The Employee Directory can be set up in two ways:

    • Import employees

    • Add entries manually

  • Import uses the same flow as ITAM:

    • Upload CSV or Excel

    • Map fields

    • Verify the data

  • Manual entry includes:

    • Name

    • Phone number

    • Mobile number

    • Title

    • Building

11. Add issue tags to improve routing intelligence

  • Issue tags help the AI decide who should receive the call.

  • Tags add context about what the caller needs.

  • Example: if someone is calling about academic intervention, the matching employee can be prioritized.

  • This helps the AI route calls more intelligently based on topic, business hours, and calendar availability.

12. Use business hours and calendars to finalize routing

  • The AI uses business hours and calendar days to decide when and where to transfer calls.

  • Combined with directories and issue tags, this helps the system choose the best available person.

  • The goal is to make sure the AI knows who is calling and who should receive the call.

Part 3: Knowledge, escalation, call center, and launch config

The S2, S3, and S4 services, call queues, and launch configuration.

1. Understand the AI service modules in S2

  • This part covers AI version part 3.

  • The transcript explains the main service modules:

    • S2 = Knowledge

    • S3 = Escalation

    • S4 = Call Center

  • It also references earlier setup areas already covered:

    • Global settings

    • Business hours

    • School departments

    • Schools

    • Phone basics

    • S1 directories

2. Configure S2 Knowledge for chatbot-style answers

  • S2 Knowledge is the AI service that answers questions from a knowledge base.

  • It works like a talking chatbot.

  • When enabled, the system recognizes that the service is active.

  • You can add material profiles for each line.

  • These profiles work like chatbot profiles:

    • Add the profile

    • Load knowledge/material into it

    • Let the AI answer questions from that content

3. Set up S3 Escalation for urgent or self-harm cases

  • S3 is the escalation service.

  • It is used when the chatbot detects something urgent, such as:

    • A crisis situation

    • Self-harm language

  • The system immediately triggers escalation.

  • It checks business hours first.

  • Based on the schedule, it routes the call to the appropriate person or agent.

  • If the agent is available, the system connects the caller directly.

  • Escalation routing can be configured for:

    • Business hours

    • Off hours

4. Use S4 Call Center to route unanswered calls to a human agent

  • S4 is the call center / caller queue service.

  • If the AI cannot answer a question, it transfers the caller to a human agent.

  • This is used when:

    • The caller wants to speak to an agent

    • The request is too generic for a specific directory/person lookup

  • The transcript explains that the AI telephony system is integrated with the AIOS agent.

  • Queue setup includes:

    • Queue name

    • Description

    • Routing criteria

    • Queue entry greetings

    • Queue members

    • Call notes

  • The AI uses this queue configuration to route callers to the right queue automatically

5. Create and configure queues so AI can route calls correctly

  • Create the queue in the system.

  • Make sure the queue details are complete so the AI can make the correct routing decision.

  • The goal is for the AI to choose the right queue based on the phone line and caller need.

  • This replaces the older manual decision-making flow with a smarter AI-driven routing flow.

6. Set up Launch Config starting with the main line

  • In Launch Config, you first set up the line, then configure its options.

  • The transcript focuses on the main line.

  • Core line settings include:

    • Coverage

    • Languages

    • Greetings

    • Recording

    • Transcript creation

    • Customer feedback

    • Voicemail

7. Define coverage, language, greetings, and call handling behavior

  • Coverage determines which buildings, departments, or districts the phone line applies to.

  • Languages are already set by default:

    • English

    • Spanish

  • Greetings can be pulled from the greetings already created in Phone Basics.

  • After greetings and business-hours greetings are set, configure:

    • Call recording

    • Call transcription

    • Ticket creation

  • These follow the same flow as the current telephony system, with no major change.

8. Keep customer feedback and voicemail aligned with the existing telephony flow

  • Customer feedback remains the same as the existing telephony system.

  • Voicemail also follows the existing setup.

  • You can enable:

    • Voicemail

    • Voicemail greeting

  • The final fallback is a failover number.

  • This is used when:

    • AI is not working

    • The whole line is not working

  • In that case, calls can still be routed through the failover path.

Part 4: Launch config and end-to-end setup

Coverage, recording, readiness, testing, and a review of the full setup.

1. Understand what the Launch Config controls

  • The Launch Config is the phone-line-level setup for the AI voice agent.

  • It defines what services are enabled for a specific phone line and how calls should behave.

  • Think of it as the place where you configure the line’s capabilities before activation.

2. Configure coverage, languages, and greetings

  • Coverage determines where calls can be routed:

    • buildings

    • departments

    • district-wide routing

  • Languages sets the supported languages for the line, such as English and Spanish.

  • Greetings lets you choose the greeting behavior used when the call starts.

3. Set recording, transcription, and call-handling features

  • Enable or review recording and transcription settings for calls.

  • Configure ticket creation if the agent should create tickets during the call.

  • Set up customer feedback options.

  • Configure voicemail behavior and add voicemail greetings if needed.

  • Add a failover number so calls can be transferred to a human if the AI flow fails.

4. Enable services and review readiness before activation

  • Use the Launch Config to activate specific services for the phone line, such as S1.

  • Check the final readiness summary to see what is complete and what still needs setup.

  • If something is missing, like greetings, go back and finish that configuration first.

  • This readiness screen helps confirm the line is prepared before testing and activation.

5. Test the phone line manually before going live

  • After setup, perform manual testing.

  • Call the configured number and verify that the expected behavior works.

  • Use this as a top-level regression test to confirm the full flow is functioning.

  • Once testing passes, the line can be activated.

6. Review the full AI voice agent setup flow

  • The transcript gives a quick recap of the overall AI voice agent setup:

    • Global settings

    • Phone basics

    • Greetings

    • Testing

    • S1 directory

    • Caller directories

    • S2 chatbot

  • These sections work together to define how the AI voice agent routes, responds, and identifies callers.

7. Configure global settings for routing and organization

  • In Global, set up:

    • Calendar

    • Business hours

    • School departments

  • These settings help determine:

    • whether a call should be transferred to a human

    • which department, building, or queue should receive the call

  • Business hours can be set per building, department, or queue.

8. Add department and directory information

  • In School Department, add the department details and phone numbers.

  • This allows the AI agent to connect calls to the correct department.

  • In the directory-related setup, the AI agent can use SIS/SAR data to identify who the caller is.

9. Set up phone basics and greetings

  • Phone Basics is where the phone lines themselves are configured.

  • Greetings is where you add:

    • opening greetings

    • repeated greetings

    • voicemail greetings

  • These greetings are used at the start of the call and in voicemail scenarios.

10. Understand testing, S1 routing, and S2 chatbot behavior

  • Testing is where replies are created and sent during validation.

  • S1 handles call transfer through SIP routing to:

    • a building

    • a department

    • an employee

  • Caller directories help the AI voice agent identify the caller using SIS and SAR data.

  • S2 works like a chatbot mode, allowing the AI voice agent to answer questions directly.

Part 5: End-to-end setup summary

A recap of every setup step from calendar to activation.

1. Set up calendar and business hours

  • Start by configuring the calendar and business hours.

  • Upload an icon link or add the icon manually.

  • This tells the AI agent whether a location or district is open or closed.

  • If it is closed, the system should not transfer the caller to a human agent.

2. Configure department routing

  • Add your departments in the system.

  • Include:

    • phone numbers

    • labels

    • descriptions

  • This gives the AI enough context to route callers to the correct department.

3. Set up phone basics

  • Go to Phone Basics to configure the core phone-line behavior.

  • Choose the voice for the AIOS agent phone line.

  • This is where the phone line itself is initially set up.

4. Add greetings and texting behavior

  • In Greetings, add:

    • initial greetings

    • repeated greetings

    • voicemail greetings

  • Enter the greeting text and the system will convert it to speech using the same voice selected earlier.

  • In Texting, configure the auto-reply behavior for text messages.

5. Configure S1 directory for transfers

  • Use the S1 directory when you want the AI to transfer a call.

  • This is tied to Zip Trunk / internal phone-line routing.

  • Connect Zip Trunk through the integration marketplace so transfers can work properly.

6. Build your directories for routing

  • Set up the different directories used for call routing:

    • Building Directory: add contact names and numbers for each building/location.

    • Department Directory: add numbers for each department so calls route correctly.

    • Employee Directory: add or import employees and include exchange numbers.

  • If exchange numbers exist, transfers go through Zip Trunk.

  • If not, calls route directly through the phone line.

  • Add tags as needed.

7. Review caller directory and knowledge profiles

  • Use the Caller Directory to understand who is calling.

  • In S2, connect your knowledge sources and map profiles to the phone line.

  • Multiple profiles can be mapped to a single phone line.

  • The AI answers questions based on the relevant profile.

8. Set up escalation handling

  • Configure H3 escalation for urgent situations.

  • If the AI detects something urgent or self-harming, it should:

    • call the right people

    • check availability

    • patch the caller through if someone is available

9. Configure call center queues

  • The Call Center works like the current telephony system.

  • The main AI-related change is that calls can transfer into a queue.

  • When creating a queue, add:

    • queue name

    • description

  • This helps the AI understand what type of queue it is and route correctly.

10. Complete launch configuration for each phone line

  • In Launch Configuration, set up the phone line details.

  • Review and configure:

    • coverage

    • languages

    • greetings

    • transfer behavior

    • ticket creation

    • voice settings

    • failover

    • turn-on services

  • Make sure each phone line has the correct coverage and behavior.

11. Run readiness testing and activate

  • Finish with readiness testing and review.

  • Perform manual testing.

  • Check the required checkbox to confirm everything is ready.

  • Activate the setup once testing is complete.

  • This completes the full AIOS agent configuration.

Related Post

New Filters for Ticket Inbox

Overview The Inbox now has a new way to filter tickets. Filters open in a single modal, organised by category, so you can see every available filter, know which ones are active, and apply them in one step. One filter

Read More ➜