Use the SDK to place a test outbound call from a specific agent to a phone number. This is the same endpoint used by the Test Call button in the Menace Voice UI.
Prerequisites#
- A Menace Voice API key exported as
DOGRAH_API_KEY - A published agent (you need the agent ID)
- A configured telephony provider — see Telephony for Twilio, Vonage, and other setups
Place the call#
Inspect the run#
Every call creates a run you can inspect afterwards. See Calls & runs for what's tracked, or use the Runs API to list and fetch runs programmatically.
Bulk campaigns#
For placing many calls at once (say, from a CSV), use Campaigns rather than looping over test_phone_call — campaigns handle pacing, retries, and progress tracking.