Skip to main content

Creating a Phone Call Action on a Workflow Task

A Phone Call action initiates an AI-powered phone call to a member as part of an automated workflow. When the action fires, a voice conversation is created using the selected workflow — the AI agent calls the member and follows the workflow's conversation logic.

How it fits together: "Phone Call" is an Action type in Gravity Rail. Attach it to a workflow task as an entry action — when a member enters the task, the phone call is initiated automatically. The call uses the workflow you select to guide the AI agent through the conversation.

Prerequisites​

  • A workflow with at least one task designed for voice conversations (see Workflows)
  • A phone number configured in your workspace (see Phone & Voice) — this is the number the call is placed from
  • Your workspace must have a phone number configured for voice calls

Steps​

1. Open your workflow​

Navigate to Workflows and open the workflow you will use for the phone call. If you don't have one yet, create a new workflow with tasks designed for voice interaction.

2. Navigate to the Actions page​

Go to Actions in your workspace.

3. Create a new action​

Click New Action.

4. Configure the trigger​

Set the trigger to Task Entered and select the task from your workflow. The phone call is initiated when a member enters this task.

5. Select "Phone Call" as the action type​

In the action type dropdown, select Phone Call. The phone call configuration form will appear.

6. Select the phone number​

Choose the phone number that will place the call from the Phone Number dropdown. This determines the caller ID that the member sees. If no phone numbers are listed, you need to configure one first in your workspace's phone settings.

7. Select the workflow​

Choose the Workflow that will handle the phone call conversation. This workflow controls what the AI agent says during the call — its tasks, prompts, data collection, and branching logic all apply.

The workflow should be designed for voice interactions. The AI agent will follow the workflow's conversation flow during the call.

8. Save the action​

Click Save. The action is now linked to your workflow task and will initiate a phone call whenever a member enters that task.

Queued and not placed calls​

Automated calls may wait briefly in a queue before they are placed. Queued means Gravity Rail has accepted the call and it is waiting to be placed. Not placed means that attempt did not call the member: no phone rang. The Chat's activity shows both. A call that ran out of time while still waiting appears only there; one that was stopped just before dialing also shows Not placed in the Chat details and in the phone number's call list.

If a call in a Journey could not be placed, because it ran out of time in the queue or was stopped just before dialing, the Journey tries it again in its next calling window, after the usual calling checks. A Journey with no calling hours tries again once the call's 24-hour waiting time has passed. Only Journey calls are retried this way. A call that failed or was cancelled is not retried, and a call started by an Action or a Routine outside a Journey is not retried either.

Phone Call Tips​

  • Design for voice — Set Response length, One question at a time and AI disclosure under Agent behavior instead of writing them into the prompt. Test interruptions and transfers. Configure fields with Context and Collect.
  • Test with your own number — Create a test member with your own phone number and trigger the action to verify the call flow before using it with real members.
  • Consider timing — Phone calls are more intrusive than SMS or email. Combine with CEL conditions like is_business_hours to avoid calling at inappropriate times. The available variables depend on the condition context; see the Developer CEL reference.
  • Pair with a routine — Use a Routine to call groups of members on a recurring schedule, such as daily appointment reminders.
  • A texted STOP blocks the call — If the member replied STOP to your SMS texts and has not replied START since, the call is not placed: under US rules, opting out by text also opts them out of automated calls. The call is also not placed when their Voice notification preference is off.