Skip to Content
Docs are being rebuilt — start at Introduction → How it works.

Vapi

Connect an agent to phone calls through Vapi’s Voice AI platform. Vapi is connected per agent in the Channels tab of the agent builder. Vapi handles speech-to-text and text-to-speech, while your TeamMate agent powers the conversation in Custom LLM mode.

Prerequisites

  • A saved agent (the Channels tab is locked until the agent is saved).
  • A Vapi account and an API key from the Vapi dashboard .
  • Optionally, a phone number in Vapi (or one brought in via Twilio/Vonage).

Fields

FieldNotesRequired
Vapi API KeyVapi Dashboard → API KeysYes
Phone NumberE.164 format, for displayNo
Greeting MessageSpoken first when a call is answeredYes
Voice ProviderElevenLabs, PlayHT, Deepgram, or OpenAINo (defaults provided)
Voice IDSpecific voice from your providerNo
Speech-to-Text ProviderDeepgram, Gladia, or TalkscriberNo (defaults provided)

How to connect

  1. Enter the API key
    In the agent’s Channels tab, open Vapi → Configure and paste your Vapi API key.
  2. Set voice and greeting
    Choose the greeting, voice provider, and speech-to-text provider.
  3. Configure the Vapi assistant
    In the Vapi dashboard, create or edit an assistant, set the model provider to Custom LLM, and paste TeamMate’s Custom LLM URL.
  4. Set the server URL
    In the assistant’s advanced settings, paste TeamMate’s Server URL for call events.
  5. Assign a phone number
    Link a phone number to the assistant in Vapi’s Phone Numbers section.
  6. Test the call
    Use Call Me in the Testing step, or call your Vapi number directly.

URLs TeamMate provides:

  • Custom LLM URL (required): https://tmmate.ai/api/webhook/vapi/<agentId>/chat/completions — receives transcribed speech and returns the agent’s responses.
  • Server URL (events): https://tmmate.ai/api/webhook/vapi/<agentId> — receives call lifecycle events.
  • Dynamic Assistant URL (optional): https://tmmate.ai/api/webhook/vapi/<agentId>/assistant-request.

What the agent can do

  • Answer inbound calls and place outbound calls.
  • Hold a natural voice conversation, powered by your agent’s model.

Troubleshooting

  • No conversation on the call. Confirm the assistant’s model provider is set to Custom LLM and the Custom LLM URL is pasted exactly.
  • Test call fails. Re-check the API key, and make sure a phone number is assigned to the assistant in Vapi.