Skip to main content

​
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., +18777804236) 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: "+819012345678"
    - name: from
      value: "+15017122661"
    - 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: "+819012345678"
    - name: from
      value: "+14155238886"  # 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: +15551234567
    • Japan: +819012345678
    • UK: +447911123456

​
Media Support (MMS/WhatsApp)

Supported media types:
  • Images: JPEG, PNG, GIF
  • Videos: MP4
  • Documents: PDF
Maximum 10 media URLs per message.

​
Resources