Skip to main content

Outbound Calls

Use the Makecall API to programmatically initiate outbound calls using Revmo's agent system. You can create individual outbound calls or manage large-scale outbound campaigns through this API.

Below, learn the basic methods of managing outbound calls through the API. To view all available endpoints and their requirements, check out the API reference documentation.

note

Outbound calling is available on a per-account basis. If you need access to outbound calling capabilities, please contact support@revmo.ai.

Create an Outbound Call​

To create an outbound call, make a POST request to /v1/makecall/.

In the request body, add call details and any required metadata. You'll need to authenticate your request using your API key, which you can find in your account settings.

Properties​

In the request body, you can include the following fields:

FieldDescription
agentIdRequired. Your Agent ID from the Revmo platform.
toRequired. The destination phone number in E.164 format (e.g., +1234567890).
triggerThe trigger phrase that launches the appropriate task for your agent.
metadataAdditional key-value pairs for custom data you want to pass to the agent.
initial_silence_timeoutTimeout in milliseconds for initial silence detection.

Example Request​

import requests

HEADERS = {
    "Authorization": "Bearer YOUR_API_KEY"
}

DATA = {
    "agentId": "YOUR_AGENT_ID",
    "to": "+1234567890",
    "trigger": "sales_followup",
    "metadata": {
        "customer_name": "John Doe",
        "account_type": "premium"
    }
}

response = requests.post(
    "https://api.revmo.ai/v1/makecall/",
    json=DATA,
    headers=HEADERS
)

Response​

A successful call creation will return a JSON response containing:

{
    "result": "Ok",
    "external_id": "unique_call_identifier",
    "calls_remaining": "unique_call_identifier"
}

Outbound Campaigns​

For users who need to make multiple outbound calls, Revmo offers Outbound Jobs functionality. This feature allows you to:

  • Upload multiple phone numbers for batch processing
  • Set automatic call spacing (default: 5 seconds between calls)
  • Download comprehensive campaign reports
  • Monitor campaign progress in real-time
tip

Outbound campaigns require special account permissions. Contact your account representative to enable this feature.

Best Practices​

  1. Phone Number Formatting: Always use E.164 format for phone numbers (+1XXXXXXXXXX)
  2. Rate Limiting: Implement retry logic with exponential backoff
  3. Error Handling: Monitor and log all status callbacks
  4. Testing: Use the test environment before production deployment

Additional Resources​