Skip to main content
Integrations

Connect Your OpenAI Key

Add your organization's OpenAI API key to turn on smart callback times on provider campaigns and unlimited agent creation with VAW Assistant.

Written By voiceaiwrapper

Last updated 26 days ago

Connecting your own OpenAI API key unlocks two things in VoiceAIWrapper. Smart callback can turn "call me tomorrow evening" into an exact time on campaigns that run on Vapi, Retell AI, ElevenLabs or Bolna. And VAW Assistant can build as many agents as you like in your provider accounts, with no included limit. OpenAI bills these requests to your own OpenAI account.

Connecting takes a minute if you already have a key.

What the key is used for

FeatureWithout your keyWith your key
Smart callback on Vapi, Retell AI, ElevenLabs and Bolna campaignsCallback requests aren't converted into a time, so the lead isn't rescheduled for when they asked.After each call, the time the caller asked for is turned into an exact time in the campaign's timezone, and the lead's next call is scheduled for then.
VAW Assistant (building agents in Vapi, Retell AI and ElevenLabs)Your organization's first 3 agents are included on VoiceAIWrapper's OpenAI key, with a daily limit on generations. After that, you can't create more until you add a key.No limit on agents or generations. You also get Regenerate on the greeting and prompt.
VAW Assistant for clientsClients can't build agents in their portal.You can let clients build agents in their portal with VAW Assistant. Generation runs on your key.

The card in the webapp says the key "Runs on gpt-5-mini". The key isn't used for calls themselves.

VAW Native doesn't need an OpenAI key. Smart callback works on VAW Native without one, and Create using VAW Assistant on a VAW Native Pod uses AI credits instead. See Smart Callback and Smart Do-Not-Call.

The key doesn't unlock features your plan doesn't include. Smart callback needs a plan that includes Smart callback, and VAW Assistant needs a plan that includes VAW Assistant.

Before you start

  • Owner or Admin role. Members who open Settings see Access Restricted.
  • An OpenAI API key. Create one in your OpenAI account's API key settings. It starts with sk-.
  • Billing set up in OpenAI. Requests on your key are charged by OpenAI, not by VoiceAIWrapper. Each one is small, but they add up with the number of calls and agents.

Connect your key

  1. In the sidebar, click Settings.
  2. Scroll to Integrations ("Connect external services to power your workflows.").
  3. On the OpenAI card, click Connect.
  4. In the Connect OpenAI sheet, paste your key into OpenAI Key.
  5. Click Connect.
The Connect OpenAI sheet open on the right of the Settings page: the description about the caller_asked_for_callback_relative_time key and VAW Assistant, the OpenAI Key field with the sk-... placeholder, and Cancel and Connect at the bottom. Leave the field empty or blur any key typed.

VoiceAIWrapper checks the key with OpenAI before saving it. If the key works, you'll see OpenAI key updated successfully, and the card shows Connected. If OpenAI rejects it, you'll see Failed to update OpenAI key and nothing is saved.

Settings page scrolled to the Integrations section ('Connect external services to power your workflows.'). The OpenAI card in its connected state: the Connected badge, the description 'Used to analyze callback intent in voice transcripts and to generate agents with VAW Assistant. Runs on gpt-5-mini.', the masked API key box with the show and copy icons, and the Disconnect button. Keep the key masked.

On the connected card you can:

  • Show the full key with the eye icon, and hide it again.
  • Copy the key with the copy icon. You'll see OpenAI key copied to clipboard.

Use the key for smart callback

Connecting the key is step 1 of smart callback on Vapi, Retell AI, ElevenLabs and Bolna campaigns. You also add a field to the agent in your provider account, and a line to its prompt. The campaign's callback setup dialog shows a green tick on its first step once the key is connected. For the full setup, see Smart Callback and Smart Do-Not-Call.

Your plan also needs to include Smart callback. Without it, callback requests are ignored even with a key.

Use the key for VAW Assistant

Nothing else to set up. The next time someone opens VAW Assistant, it uses your key. If VAW Assistant showed "Add your OpenAI key to keep creating agents", it works again once the key is connected.

To let a client build agents in their portal, turn on Can create agents with VAW Assistant in the client's workspace permissions. See Set Client Permissions on Vapi, Retell and ElevenLabs Workspaces.

Change your key

There's no separate update button. To switch to a different key, disconnect the current one, then connect the new one. While no key is connected, smart callback times aren't converted, so do this outside your campaigns' calling hours if you can.

Disconnect your key

  1. On the OpenAI card, click Disconnect.
  2. Confirm with Disconnect.

The confirmation reads: "This will remove your OpenAI key, disabling AI-powered callback analysis. VAW Assistant will fall back to the limited free allowance." You'll see OpenAI disconnected.

After you disconnect, callback requests on Vapi, Retell AI, ElevenLabs and Bolna campaigns are no longer converted into times. VAW Assistant goes back to the included allowance: only those of the 3 included agents your organization hasn't used yet. Once they're used, nobody can create agents with it until you connect a key again. Clients lose the ability to build agents in their portal. Agents you already created stay as they are.

If you're also deleting the key in OpenAI, disconnect it here first.

Frequently asked questions

OpenAI didn't accept the key. Check that you copied all of it, that it hasn't been revoked, and that your OpenAI account has billing set up. Then try again.

Per organization. Only agents that were actually created count. Unfinished drafts in VAW Assistant don't.

No. Calls on Vapi, Retell AI and ElevenLabs run on those providers and are billed by them. Calls on VAW Native use AI credits. The OpenAI key is only used for the features in the table at the top.

Owners and Admins can see and copy it on the Settings page. Members see Access Restricted there instead.