Skill: make-phone-call

Overview

This skill uses the Twilio API to programmatically initiate outbound phone calls with text-to-speech messages. The call is queued immediately and the recipient will hear the message read aloud when they answer.

When to Use

Use this skill when the user asks to:

Make a phone call
Call someone
Initiate an outbound call
Send a voice message
Notify someone via phone call
Leave a voice message

Required Credentials

Retrieve these via the get_keys tool before executing:

Key Store Key	Environment Variable	Description
`twilio_account_sid`	`TWILIO_ACCOUNT_SID`	Your Twilio Account SID for API authentication
`twilio_auth_token`	`TWILIO_AUTH_TOKEN`	Your Twilio Auth Token for API authentication
`twilio_phone_number`	`TWILIO_PHONE_NUMBER`	Your Twilio phone number to send calls from

Twilio Setup

Create a Twilio account at twilio.com
Verify your identity and get your Account SID and Auth Token from the Console dashboard
Purchase or verify a phone number for making outbound calls
Store credentials in the key store: twilio_account_sid, twilio_auth_token, twilio_phone_number

Input Parameters

Parameter	Required	Description	Example
`recipient_phone_number`	Yes	The phone number to call in E.164 format	{{PHONE_NUMBER}}
`message_text`	Yes	The message to be read aloud via text-to-speech	hey buddy

Procedure

Retrieve Twilio credentials using get_keys with keys [twilio_account_sid, twilio_auth_token, twilio_phone_number]
Get the recipient phone number and message content from the user if not provided (use ask_user)
Validate phone numbers are in E.164 format (e.g., {{PHONE_NUMBER}})
Install Twilio Node.js package if not already present: npm install twilio
Create and execute the call script using bundled make_call.js with recipient number and message text
Verify the response contains a Call SID indicating successful queue
Report call status and SID to the user

Output

A confirmation message containing the Call SID, recipient number, sender number, message text, and call status (queued).

Bundled Scripts

Script	Type	Description
`scripts/make_call.js`	JS	Auto-captured from task execution

Credentials in scripts use environment variables. Set them via get_keys before running.

Reference Commands

Commands for executing this skill (adapt to actual inputs):

npm install twilio
node make_call.js {{RECIPIENT_PHONE}} {{MESSAGE_TEXT}}

Replace {{PLACEHOLDER}} values with actual credentials from the key store.

Example

Example requests that trigger this skill:

make a phone call to confirm the appointment

Notes

Phone numbers must be in E.164 format (e.g., {{PHONE_NUMBER}} for US numbers)
Twilio trial accounts can only call verified phone numbers
The call is queued immediately; actual connection may take a few seconds
Text-to-speech voice is set to 'alice' by default
Ensure the Twilio phone number has outbound calling permissions enabled

Keywords

call, phone, voice, twilio, outbound, text-to-speech, tts, notify

make-phone-call

Safety Notice

Copy this and send it to your AI assistant to learn