twilio-conversations-classic-api

Build multi-channel messaging conversations using the Twilio Conversations classic API.

5.3k|765|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/openai/plugins --skill twilio-conversations-classic-api
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: twilio-conversations-classic-api
Source: https://github.com/openai/plugins/tree/main/plugins/twilio-developer-kit/skills/twilio-conversations-classic-api
Command: npx skills add https://github.com/openai/plugins --skill twilio-conversations-classic-api

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires twilio.

What problem does it solve?

Single-message SMS or WhatsApp APIs cannot maintain persistent, multi-party threads with shared history. This Skill guides you through the Twilio Conversations (classic) API so you can create conversations where SMS, WhatsApp, and web chat participants message together with full history and multi-agent access.

Core Features & Use Cases

  • Conversation and Participant Management: Create conversation services and conversations, then add SMS, WhatsApp, or chat participants and remove them when done.
  • Messaging and Media: Send text and media messages (up to 10 URLs), fetch message history, and list or filter conversations by state.
  • Webhooks and Metadata: Handle incoming messages and delivery receipts via signature-validated webhooks, and store custom JSON attributes on conversations and participants.
  • Use Case: Build a customer support thread where a customer on SMS, a supervisor on WhatsApp, and an agent on web chat all collaborate in one persistent conversation tied to an order ID.

Quick Start

Use the twilio-conversations-classic-api skill to create a conversation, add an SMS participant, and send a first message with the Twilio Python SDK.

Frequently Asked Questions about twilio-conversations-classic-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Twilio conversation with SMS participants?

Create a conversation with client.conversations.v1.conversations.create, then add SMS participants by passing messaging_binding_address (the user's number) and messaging_binding_proxy_address (your Twilio number) to the participants resource. The Twilio number must be assigned to a Conversations Service first.

How do I add WhatsApp participants to a Twilio conversation?

Add WhatsApp participants by prefixing both addresses with 'whatsapp:' in the messaging_binding_address and messaging_binding_proxy_address parameters. WhatsApp messages remain subject to the 24-hour service window rules.

Can I send media files through Twilio Conversations?

Yes, pass publicly accessible media URLs via the media_url parameter when creating a message, with up to 10 URLs per message. Supported formats include JPG, PNG, GIF, PDF, and vCard, delivered across SMS as MMS, WhatsApp, and chat.

How do I validate Twilio webhook requests for conversations?

Validate the X-Twilio-Signature header using Twilio's RequestValidator in Python or twilio.validateRequest in Node.js with your auth token, request URL, and form parameters. Reject requests that fail validation with a 403 response.

What are the limitations of the Twilio Conversations classic API?

Conversations support up to 1,000 participants each, and chat participants require Access Tokens for client-side SDK authentication. The classic v1 API is in maintenance mode, so Twilio recommends the Conversations v2 API for new projects.