Romulus icon

Romulus

Consume Romulus API

Actions20

Agent → Start Agent Call Task

AI-generated

Overview

The 'Start Agent Call Task' operation initiates a phone call task using a specified agent from the Romulus API. This operation is beneficial for automating outbound calls, such as customer support or sales outreach, by leveraging AI agents to handle the calls.

Use Case Examples

  1. Automating customer support calls to provide assistance to clients.
  2. Initiating sales outreach calls to potential clients using AI agents.

Properties

Name Meaning
Agent Name or ID Specifies the agent responsible for making the call. This can be selected from a list or specified using an expression.
Contact Phone Number The phone number of the contact to be called, formatted in E.164 format (e.g., +1234567890).
Contact Email The email address associated with the contact, used in the agent's context.
Contact Name The name of the contact, used in the agent's context.
Contact Timezone The timezone of the contact, specified in standard format (e.g., UTC, Europe/Rome, America/New_York).
Options Additional settings for the call task, including optional campaign ID and custom properties in JSON format.
Retry Configuration Settings for automatic retries on failed calls, including enabling retries, maximum attempts, and interval between retries.
Availability Configuration Settings to restrict calls to specific days and times, including enabling availability windows, days of the week, and time windows.

Output

JSON

  • status - Indicates the success or failure of the call task initiation.
  • message - Provides additional information or error messages related to the operation.

Dependencies

  • Romulus API key credential

Troubleshooting

  • Ensure the agent ID is correct and the agent is available to make calls.
  • Verify that the contact's phone number is in the correct E.164 format.
  • Check that the contact's email and name are correctly specified.
  • Confirm that the contact's timezone is valid and recognized.
  • If retries are enabled, ensure that the maximum attempts and interval are set appropriately.
  • If availability windows are enabled, verify that the current time falls within the specified days and time windows.

Links

Discussion