AGENT SKILL

twilio-messaging-overview

Twilio Messaging channel overview and onboarding guide. Covers all channels (SMS, WhatsApp, RCS, Facebook Messenger), the unified Messages API, channel selection guidance, and the recommended setup sequence from first message to production monitoring. Start here before choosing a specific messaging channel.

License 许可
MIT
最近更新
2026-07-19
Stars
★ 1
Forks
1

01 前言 Front Matter

name
twilio-messaging-overview
description
Twilio Messaging channel overview and onboarding guide. Covers all channels (SMS, WhatsApp, RCS, Facebook Messenger), the unified Messages API, channel selection guidance, and the recommended setup sequence from first message to production monitoring. Start here before choosing a specific messaging channel.

02 资源文件 1

03 SKILL.md 正文

Overview

Twilio's Messaging platform sends and receives messages across multiple channels through a single API. All channels use client.messages.create() — only the address format changes.

Channel Address format Rich media Template required? Reach Skill
SMS/MMS +15551234567 (E.164) MMS: images/video, US/CA/AU only No Global (180+ countries) twilio-sms-send-message
WhatsApp whatsapp:+15551234567 Yes (images, docs, video, location) Outside 24hr window: yes 190+ countries twilio-whatsapp-send-message
RCS Same number (via Messaging Service) Yes (rich cards, carousels, video) No US + expanding globally twilio-rcs-messaging
Facebook Messenger messenger:{page-scoped-id} Yes No Global —

Which Channel Should I Use?

If you need to... Use Why
Reach any phone number SMS Universal — works on every phone, no app needed
Send rich media globally WhatsApp Images, docs, video work worldwide (MMS is US/CA/AU only)
Send time-sensitive alerts (OTP, outages) SMS Highest open rates, no app dependency
Reach opted-in audience at lower cost WhatsApp No per-message fee in many markets
Run marketing campaigns across channels Start with twilio-marketing-promotions-advisor Planner skill handles channel mix, compliance, and fallback
Send transactional notifications Start with twilio-notifications-alerts-advisor Planner skill handles urgency-based channel routing

Not sure? Use a Planner skill first — it will qualify your use case and recommend the right channel combination.


Unified API

All channels share messages.create(). The only difference is the address format in from and to.

Python

import os
from twilio.rest import Client

client = Client(os.environ["TWILIO_ACCOUNT_SID"], os.environ["TWILIO_AUTH_TOKEN"])

# SMS
sms = client.messages.create(
    from_="+15017122661",
    to="+15558675310",
    body="Your order shipped."
)

# WhatsApp — same API, prefixed addresses
whatsapp = client.messages.create(
    from_="whatsapp:+15017122661",
    to="whatsapp:+15558675310",
    body="Your order shipped."
)

Node.js

const client = require("twilio")(process.env.TWILIO_ACCOUNT_SID, process.env.TWILIO_AUTH_TOKEN);

// SMS
const sms = await client.messages.create({
    from: "+15017122661",
    to: "+15558675310",
    body: "Your order shipped.",
});

// WhatsApp — same API, prefixed addresses
const whatsapp = await client.messages.create({
    from: "whatsapp:+15017122661",
    to: "whatsapp:+15558675310",
    body: "Your order shipped.",
});

Onboarding Sequence

Set up messaging in this order. Each step builds on the previous.

Step 1: Foundation

Get a Twilio number, send your first SMS.

  • twilio-account-setup → twilio-sms-send-message

Step 2: Sender Strategy

Create a Messaging Service and add your numbers to a sender pool. Use messagingServiceSid instead of from for all production sends — this enables geo-match, sticky sender, and unlocks compliance features.

  • twilio-messaging-services

Step 3: Compliance

Register for A2P 10DLC (required for US SMS traffic). Set up opt-out handling.

  • twilio-compliance-onboarding → twilio-compliance-traffic

Step 4: Protect

Enable SMS pumping protection (prevents artificial traffic inflation) and compliance toolkit (quiet hours, reassigned number detection) on your Messaging Service.

  • twilio-messaging-services (Compliance Toolkit + SMS Pumping Protection sections)

Step 5: Add Channels

Add WhatsApp or other channels. Use Content Templates for cross-channel message formatting.

  • twilio-whatsapp-send-message → twilio-content-template-builder

Step 6: Monitor

Enable intelligent alerts for error pattern detection. Set up status callbacks for delivery tracking.

  • twilio-messaging-services (Intelligent Alerts section) → twilio-messaging-webhooks

CANNOT

  • Cannot send cross-channel in a single API call — Each messages.create() targets one channel. For multi-channel fallback, implement sequencing in your application (e.g., try SMS, on failure send WhatsApp).
  • Cannot use WhatsApp free-form messages outside the 24-hour window — After 24 hours since the user's last inbound message, you must use a pre-approved template. See twilio-whatsapp-send-message.
  • Cannot send MMS outside US, Canada, and Australia — MMS is only supported on US/CA/AU numbers. For international rich media, use WhatsApp.
  • Cannot use SMS pumping protection or compliance toolkit without a Messaging Service — These features are configured per Messaging Service. Raw from number sends don't get these protections.
  • Cannot mix channels in a single Messaging Service sender pool — A Messaging Service manages phone numbers for SMS/MMS. WhatsApp senders are configured separately.
  • Cannot guarantee delivery on any channel — SMS can be carrier-filtered, WhatsApp can queue-timeout (4 hours). Always implement status callbacks to track delivery.

Next Steps

  • Send SMS: twilio-sms-send-message
  • Send RCS: twilio-rcs-messaging
  • Send WhatsApp: twilio-whatsapp-send-message
  • Set up sender pools and production features: twilio-messaging-services
  • Channel selection for marketing: twilio-marketing-promotions-advisor
  • Channel selection for notifications: twilio-notifications-alerts-advisor

04 同仓库更多 Skills

zfifteen
zfifteen/skills-catalog

Zotero

Use Zotero Desktop from Codex to enable/probe the local API, search a local Zotero library, list items/collections/tags, export BibTeX, insert citation keys into LaTeX or Markdown drafts, read indexed full text when requested, and import BibTeX/RIS records into Zotero through the connector server. Use when the user mentions Zotero, citations, references.bib, BibTeX export, local Zotero API, localhost:23119, or adding citations from a Zotero library.

★ 1
zfifteen
zfifteen/skills-catalog

zoom-apps-sdk

Use when using Apps SDK.

★ 1
zfifteen
zfifteen/skills-catalog

youtube

Obtain accurate, timestamped YouTube video transcripts (preferring manual captions over auto-generated) as the primary deliverable, then derive summaries, key claims, or notes from that transcript. Use when the user provides a YouTube URL (or video ID) and wants the transcript, a faithful summary, key claims with attribution, timestamped notes, or "what does this video actually say". The skill is transcript-first: never substitute metadata, title, description, or search snippets for the spoken content. Triggers: "youtube transcript", "get the transcript of this video", "summarize this youtube video", "what did they say in https://youtube.com/...", "key claims from this talk".

★ 1
zfifteen
zfifteen/skills-catalog

yeet

Publish local changes to GitHub by confirming scope, committing intentionally, pushing the branch, and opening a draft PR through the GitHub app from this plugin, with `gh` used only as a fallback where connector coverage is insufficient.

★ 1
zfifteen
zfifteen/skills-catalog

x-post-creator

Create X-ready post threads and co-located story packages from the active conversation or referenced project material. Use when the user says turn this into an X-post, /x-post, make this into an X thread, or wants plain-language social posts with supporting images saved to docs/x-posts/[story-name]/.

★ 1
zfifteen
zfifteen/skills-catalog

x-api

Search, read, and write X posts through the local X API MCP server (the same backend used by the Codex x-api skill). Use for searching X/x.com, reading threads and replies, creating lists, staging/publishing posts for @alltheputs, finding high-visibility reply targets for research outreach, ingesting public context, or any request that mentions /x-api or "search X".

★ 1