Squads
Switched off until an operator turns it on
Put several AI agents on one call: the first answers, and hands the caller to another agent, for example for complaints or bookings.
Where to find it
AI agents › Squads
Open this screen
Steps
- Open AI agents › Squads.
- Press New squad (or Build one with Composer when there is none yet).
- Add at least two agents, in the order they should answer, and add handoffs between them.
- Press Save, then Sync to Vapi on the squad.
- Press Web test call to try it.
Settings on this screen
| Setting | What it does | Default |
|---|---|---|
| New squad | Opens the squad editor. Managers, once Vapi is connected. | — |
| Import from Vapi | Brings in the Vapi account’s squads that are made of your own assistants. | — |
| Sync to Vapi | Sends the squad and its members’ assistants to Vapi. | — |
| Web test call | Opens a test call with the squad in a new browser tab. Needs a synced squad. | — |
| Edit | Opens the squad editor. | — |
| Delete | Removes the squad from Call. The squad in Vapi is kept. | — |
Troubleshooting
“Vapi is not connected. The platform operator adds the Vapi API key on the System tab.”
Squads cannot be built until the operator adds the key.
A squad card shows Sync failed.
Check the members are still on the Vapi engine, then press Sync to Vapi again.
Tips
- A card says Synced with the time, or Not synced to Vapi yet. Imported marks squads brought in from Vapi.
Good to know
- Squads run on Vapi. They stay switched off until the platform operator adds the Vapi API key; until then the page says Vapi is not connected.
- Only agents on the Vapi engine can be members; agents on the Grok engine cannot join.
Related how-tos
- Build a squad with handoffs Switched off until an operator turns it on Choose the agents of a squad, which one answers first, and when each hands the caller to another.
- Sync, test, import or delete a squad Switched off until an operator turns it on Send a squad to Vapi, try it on a web call, bring in squads from Vapi, or remove one.
- Squads: messages and fixes Switched off until an operator turns it on Understand the messages the Squads page can show, and what to do about each.
- Composer Describe the phone agent you want; Composer asks what it needs, then proposes each change for you to approve.
- Run an agent's calls on Vapi Switched off until an operator turns it on Switch an agent's calls from Grok to the Vapi engine, set up its Vapi assistant and test it.