Twilio

Send SMS, MMS, WhatsApp messages, and make voice calls via Twilio API

Overview

Twilio tools enable sending and receiving messages and calls through Twilio’s communication platform. Supports SMS, MMS with media, WhatsApp messaging, and voice calls.

Key Features

Outbound Communications

• TWILIO_SEND_SMS
  • Send SMS text messages to any phone number
• TWILIO_SEND_WHATSAPP
  • Send WhatsApp messages via Twilio API for WhatsApp Business

Authentication

All tools require Twilio credentials:

• Account SID: Found in your Twilio Console
• Auth Token: Found in your Twilio Console

You can provide credentials via:

1. Environment variables: TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN
2. Tool config parameters
3. JinbaFlow secrets manager

Setup

1. Get Twilio Account

1. Sign up at Twilio
2. Verify your account and phone number
3. Copy your Account SID and Auth Token from the console

2. Get Phone Number

For first-time users, get a trial phone number by clicking Get a Trial Number in the console. This number can send and receive SMS messages.

For WhatsApp, join the Twilio Sandbox for testing.

Trial Account Limitations:

• Only 1 phone number available
• Can only send to verified phone numbers
  • IMPORTANT: Twilio virtual numbers (e.g., [phone]) CANNOT be verified
  • You must verify YOUR OWN real phone number
• Maximum 50 messages per day
• All messages include a “Sent from your Twilio trial account” signature

Examples

Note: The examples below are testable with trial accounts.

Inbound (Webhook)

Twilio inbound delivery uses webhooks. Configure your Twilio number to call the inbound URL below.

• Inbound endpoint: POST /api/v2/external/flows/:flowId/twilio-run
• Twilio sends application/x-www-form-urlencoded by default
• JinbaFlow returns an empty TwiML response (<Response></Response>)

Example 5: Receive SMS (Webhook)

- id: receive_sms
  tool: INPUT_TWILIO_SMS
  config:
    - name: validate_signature
      value: false
  input: []

Example 1: Send SMS

- id: send_sms
  tool: TWILIO_SEND_SMS
  config:
    - name: account_sid
      value: "{{secrets.TWILIO.account_sid}}"
    - name: auth_token
      value: "{{secrets.TWILIO.auth_token}}"
  input:
    - name: to
      value: "[phone]"
    - name: from
      value: "[phone]"
    - name: body
      value: "Hello from JinbaFlow!"

Example 3: Send WhatsApp Message

- id: send_whatsapp
  tool: TWILIO_SEND_WHATSAPP
  config:
    - name: account_sid
      value: "{{secrets.TWILIO.account_sid}}"
    - name: auth_token
      value: "{{secrets.TWILIO.auth_token}}"
  input:
    - name: to
      value: "[phone]"
    - name: from
      value: "[phone]"  # Twilio WhatsApp number
    - name: body
      value: "Hello via WhatsApp!"

Phone Number Format

All phone numbers must be in E.164 format:

• Include country code with + prefix
• No spaces, dashes, or parentheses
• Examples:
  • US: [phone]
  • Japan: [phone]
  • UK: [phone]

Media Support (MMS/WhatsApp)

Supported media types:

• Images: JPEG, PNG, GIF
• Videos: MP4
• Documents: PDF

Maximum 10 media URLs per message.

Resources

• Twilio Documentation
• Twilio Console
• TwiML Voice Instructions
• WhatsApp Business API