Skip to main content

​
Outbound Calls

Movoice AI can place calls on your behalf — for appointment reminders, lead follow-ups, payment nudges, and more.

​
Trigger a Single Call

​
Via Dashboard

  1. Go to Calls → New Call.
  2. Select your agent.
  3. Enter the recipient’s phone number.
  4. (Optional) Fill in variables the agent will use (e.g., customer name, appointment time).
  5. Click Call Now.

​
Via API

curl -X POST https://api.movoice.ai/v1/call \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agent_12345",
    "recipient_phone": "+919876543210",
    "variables": {
      "name": "Rahul",
      "amount_due": "₹2,500",
      "due_date": "April 25"
    }
  }'
The agent’s prompt can reference variables with {{variable_name}}: 
You are calling {{name}} to remind them about their payment of {{amount_due}} due on {{due_date}}.

​
Variable Substitution

Variables are injected into your agent’s system prompt at call time, letting you personalize each call with caller-specific data:
VariableExample valueUse case
{{name}}Rahul SharmaPersonalize greeting
{{appointment_time}}Tomorrow at 3 PMAppointment reminder
{{amount_due}}₹2,500Payment collection
{{order_id}}ORD-4521Order status update
{{clinic_name}}Sharma DentalMulti-tenant agents

​
Schedule a Call

To schedule a call for a future time: 
curl -X POST https://api.movoice.ai/v1/call \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agent_12345",
    "recipient_phone": "+919876543210",
    "schedule_at": 1714000000,
    "variables": { "name": "Priya" }
  }'
schedule_at is a Unix timestamp. Calls are placed within 30 seconds of the scheduled time.

​
Handle Call Outcomes

After each call, Movoice sends a call.completed webhook with:
  • summary — AI-generated summary of the conversation
  • sentiment — positive, neutral, or negative
  • outcome — custom tag set by the agent (e.g., BOOKED, REFUSED, CALLBACK)
  • transcript_url — full transcript JSON
  • recording_url — MP3 recording
Use these to update your CRM, trigger follow-up workflows, or feed into your analytics. See Webhooks for the full payload schema.

​
For Bulk Outbound Campaigns

If you need to call hundreds or thousands of people, see Batch Calls.
Outbound calls require the recipient’s phone number to be in E.164 format (e.g., +919876543210 — country code + number, no spaces or dashes).