DocumentationAPI ReferenceRelease Notes
ScaleAI

Getting Started

IntroductionTemplates

Build Agents

Agent ConfigurationAgent VersioningAgent Behaviour & PromptKnowledge Base & GuardrailsAnalysis & Structured OutputsLLM SettingsAudio & VoiceCall ConfigurationTools ConfigurationCall HistoryGuardrailsTest Your AgentIntegrations

Telephony & Batch Calls

Phone NumbersOutbound CallBatch Call

Monitoring & Evals

Call LogsFunction LogsWebhook LogsTranscripts & Monitoring
EvalsScenariosRunsOptimizing a Prompt
Go to platform

Outbound Call

The Outbound Call feature lets you start calls with your AI agent. You can place calls using either a SIP Trunk connection or a Telephony Provider integration.

This feature is useful for:

  • Testing agent conversations
  • Placing outgoing calls
  • Simulating real-world call flows
  • Passing runtime variables to the agent

You can open the Initiate Call window from the Agents page (the agent is pre-selected) or from the Agent Batches page header.

Prerequisite: the agent must be active. If the agent is inactive, the button is disabled until you activate it.


SIP Trunk Call

A SIP trunk call places calls through your connected SIP numbers. SIP is the standard that carries phone calls over the internet. The call comes from a configured phone number and connects to the destination number.

SIP Trunk Call

Call Configuration

When starting a SIP trunk call, configure the following fields:

  • From Phone Number
    Choose the phone number that will place the call. Selecting it auto-selects the agent bound to that number (the outbound agent, or the inbound agent if no outbound agent is set).

  • Agent
    Choose the agent that will handle the conversation. It unlocks after you pick a from-number. Only active agents are listed.

  • To Phone Number
    Enter the destination phone number where the call should go.

  • Agent Variables
    Enter values for any dynamic variables used in the agent's prompt or welcome message. These are filled in when the call runs.

Initiating the Call

Click Initiate Call to start the call.
The system dials the destination number through the selected SIP trunk and connects it to the agent.


Telephony Provider Call

You can also place calls through a supported telephony provider such as Twilio. A provider is the phone company that carries your calls.

Telephony Provider Call

Call Configuration

When using a telephony provider, configure the following options:

  • Telephony Provider
    Choose the provider that routes the call (for example, Twilio). This field is required. If you haven't connected a provider yet, use the Add Provider Key link to connect one from the Integrations page.

  • Agent
    Choose the agent that will handle the conversation. Only active agents are listed.

  • Use Platform Number
    Turned on by default. The call goes out from a ScaleAI-managed number, so you don't need to choose a from-number. Turn it off to pick your own number below.

  • From Phone Number
    Shown only when Use Platform Number is off. Pick from the provider's active numbers. Use the refresh icon to pull in the latest numbers from the provider.

  • Your Phone Number
    Enter the phone number where you want to receive the call.

  • Country Selector
    Use the flag dropdown to apply the correct country dialing code automatically.

  • Agent Variables
    Enter values for any dynamic variables used by the agent during the conversation.

Initiating the Call

Click Initiate Call to place the call.
The call is made through the selected provider, from the platform-managed number (or your chosen number) and connected to your device. On success, you are taken to the Call Logs page filtered to that call.


Agent Variables

Dynamic variables detected during Initiate calls

If the selected agent uses dynamic variables in its configuration (for example in the Prompt or Welcome Message), those variables appear automatically in the Agent Variables section.

Variables come in two kinds:

  • System variables: filled in automatically by the system (for example, the source number, destination number, or call direction). No action needed.
  • User variables: your own placeholders (for example {{customer_name}}). You must enter a value for each one before starting the call so the agent can personalize the conversation.

Notes

  • Make sure the destination phone number is valid and active.
  • Check that your telephony provider account has enough credits.
  • Make sure the selected agent is set up with voice and prompt settings before starting a call.

Phone Numbers

Previous Page

Batch Call

Next Page

On this page

SIP Trunk CallCall ConfigurationInitiating the CallTelephony Provider CallCall ConfigurationInitiating the CallAgent VariablesNotes