twilio

name	twilio
description	Twilio messaging, voice, phone number management, and verification workflows. Use when the user wants to send SMS or WhatsApp messages, make voice calls, buy or configure phone numbers, or run OTP verification.
use_cases	["Send SMS messages","Send WhatsApp messages","Make phone calls","Manage Twilio phone numbers","Build OTP verification flows"]
triggers	["twilio","sms","whatsapp","phone verification","otp","send message"]
requires_toolkits	["twilio_toolkit"]
suggested_toolkits	["file_manager"]
icon	twilio
short_description	Send SMS and WhatsApp messages and manage Twilio messaging workflows.

Twilio Communications

Use this skill for all Twilio tasks including SMS, WhatsApp, voice calls, and verification.

Requirements

• Hyper MCP installed and connected. https://app.hyperfx.ai/mcp
• Twilio integration enabled at https://app.hyperfx.ai/apps.

WhatsApp Sandbox Setup (Required for Testing)

Before sending WhatsApp messages in sandbox/testing mode, users must join the sandbox:

1. User goes to: https://console.twilio.com/us1/develop/sms/try-it-out/whatsapp-learn
2. They find their unique join code (e.g., "join happy-turtle")
3. They send that message from WhatsApp to [phone]
4. Once confirmed, use twilio_whatsapp_send with from_number set to "[phone]"

If WhatsApp message fails with "not a valid WhatsApp-enabled number" or similar:

• The user likely hasn't joined the sandbox yet
• Guide them through the steps above

Tool Quick Reference

Messaging

• twilio_sms_send - Send SMS/MMS messages
• twilio_whatsapp_send - Send WhatsApp messages (sandbox: use [phone] as from_number)
• twilio_messages_list - List message history
• twilio_messages_delivery_status_check - Check if message was delivered

Voice Calls

• twilio_calls_create - Initiate outbound call (requires TwiML URL or inline TwiML)
• twilio_calls_list - List call history
• twilio_recordings_list - List call recordings

Phone Numbers

• twilio_phone_numbers_list - List numbers in account (use to find valid from_number)
• twilio_phone_numbers_lookup - Validate phone number and get carrier info

Verification (OTP)

• twilio_verification_services_create - Create verification service first
• twilio_verifications_send - Send OTP code
• twilio_verifications_check - Verify user's code

Common Patterns

Before sending SMS/WhatsApp: Call twilio_phone_numbers_list first to find a valid sender number.

WhatsApp sandbox flow:

1. Confirm user has joined sandbox (provide instructions if not)
2. Call twilio_whatsapp_send with:

{
  "to": "+1XXXXXXXXXX",
  "body": "Hello from the assistant",
  "from_number": "[phone]"
}

Phone verification flow:

Step 1 -- Call twilio_verification_services_create with:

{
  "friendly_name": "My App"
}

Step 2 -- Call twilio_verifications_send with:

{
  "service_sid": "<service_sid_from_step_1>",
  "to": "+1XXXXXXXXXX",
  "channel": "sms"
}

Step 3 -- Call twilio_verifications_check with:

{
  "service_sid": "<service_sid>",
  "to": "+1XXXXXXXXXX",
  "code": "<user_provided_code>"
}

Safety Rules

• Never assume a valid sender number; always verify with twilio_phone_numbers_list.
• Do not continue silently after failures; report exact error and ask user how to proceed.
• For verification flows, keep service SIDs and code checks explicit and auditable.