{
  "schema": "https://ai-atoms.com/schemas/skill-v1.json",
  "type": "skill",
  "id": "skill/twilio-communications",
  "version": "1.0.0",
  "name": "Twilio Communications",
  "description": "Build communication features with Twilio: SMS messaging, voice calls, WhatsApp Business API, and user verification (2FA). Covers the full spectrum from simple notifications to complex IVR systems a...",
  "system_prompt_fragment": "# Twilio Communications\n\n## Patterns\n\n### SMS Sending Pattern\n\nBasic pattern for sending SMS messages with Twilio.\nHandles the fundamentals: phone number formatting, message delivery,\nand delivery status callbacks.\n\nKey considerations:\n- Phone numbers must be in E.164 format (+1234567890)\n- Default rate limit: 80 messages per second (MPS)\n- Messages over 160 characters are split (and cost more)\n- Carrier filtering can block messages (especially to US numbers)\n\n\n**When to use**: ['Sending notifications to users', 'Transactional messages (order confirmations, shipping)', 'Alerts and reminders']\n\n```python\nfrom twilio.rest import Client\nfrom twilio.base.exceptions import TwilioRestException\nimport os\nimport re\n\nclass TwilioSMS:\n    \"\"\"\n    SMS sending with proper error handling and validation.\n    \"\"\"\n\n    def __init__(self):\n        self.client = Client(\n            os.environ[\"TWILIO_ACCOUNT_SID\"],\n            os.environ[\"TWILIO_AUTH_TOKEN\"]\n        )\n        self.from_number = os.environ[\"TWILIO_PHONE_NUMBER\"]\n\n    def validate_e164(self, phone: str) -> bool:\n        \"\"\"Validate phone number is in E.164 format.\"\"\"\n        pattern = r'^\\+[1-9]\\d{1,14}$'\n        return bool(re.match(pattern, phone))\n\n    def send_sms(\n        self,\n        to: str,\n        body: str,\n        status_callback: str = None\n    ) -> dict:\n        \"\"\"\n        Send an SMS message.\n\n        Args:\n            to: Recipient phone number in E.164 format\n            body: Message text (160 chars = 1 segment)\n            status_callback: URL for delivery status webhooks\n\n        Returns:\n            Message SID and status\n        \"\"\"\n        # Validate phone number format\n        if not self.validate_e164(to):\n            return {\n                \"success\": False,\n                \"error\": \"Phone number must be in E.164 format (+1234567890)\"\n            }\n\n        # Check message length (warn about segmentation)\n        segment_count = (len(body) + 159) // 160\n        if segment_count > 1:\n            print(f\"Warning: Message will be sent as {segment_count} segments\")\n\n        try:\n            message = self.client.messages.create(\n                to=to,\n                from_=self.from_number,\n                body=body,\n                status_callback=status_callback\n            )\n\n            return {\n                \"success\": True,\n                \"message_sid\": message.sid,\n                \"status\": message.status,\n                \"segments\": segment_count\n            }\n\n        except TwilioRestException as e:\n            return self._handle_error(e)\n\n    def _handle_error(self, error: Twilio\n```\n\n### Twilio Verify Pattern (2FA/OTP)\n\nUse Twilio Verify for phone number verification and 2FA.\nHandles code generation, delivery, rate limiting, and fraud prevention.\n\nKey benefits over DIY OTP:\n- Twilio manages code generation and expiration\n- Built-in fraud prevention (saved customers $82M+ blocking 747M attempts)\n- Handles rate limiting automatically\n- Multi-channel: SMS, Voice, Email, Push, WhatsApp\n\nGoogle found SMS 2FA blocks \"100% of automated bots, 96% of bulk\nphishing attacks, and 76% of targeted attacks.\"\n\n\n**When to use**: ['User phone number verification at signup', 'Two-factor authentication (2FA)', 'Password reset verification', 'High-value transaction confirmation']\n\n```python\nfrom twilio.rest import Client\nfrom twilio.base.exceptions import TwilioRestException\nimport os\nfrom enum import Enum\nfrom typing import Optional\n\nclass VerifyChannel(Enum):\n    SMS = \"sms\"\n    CALL = \"call\"\n    EMAIL = \"email\"\n    WHATSAPP = \"whatsapp\"\n\nclass TwilioVerify:\n    \"\"\"\n    Phone verification with Twilio Verify.\n    Never store OTP codes - Twilio handles it.\n    \"\"\"\n\n    def __init__(self, verify_service_sid: str = None):\n        self.client = Client(\n            os.environ[\"TWILIO_ACCOUNT_SID\"],\n            os.environ[\"TWILIO_AUTH_TOKEN\"]\n        )\n        # Create a Verify Service in Twilio Console first\n        self.service_sid = verify_service_sid or os.environ[\"TWILIO_VERIFY_SID\"]\n\n    def send_verification(\n        self,\n        to: str,\n        channel: VerifyChannel = VerifyChannel.SMS,\n        locale: str = \"en\"\n    ) -> dict:\n        \"\"\"\n        Send verification code to phone/email.\n\n        Args:\n            to: Phone number (E.164) or email\n            channel: SMS, call, email, or whatsapp\n            locale: Language code for message\n\n        Returns:\n            Verification status\n        \"\"\"\n        try:\n            verification = self.client.verify \\\n                .v2 \\\n                .services(self.service_sid) \\\n                .verifications \\\n                .create(\n                    to=to,\n                    channel=channel.value,\n                    locale=locale\n                )\n\n            return {\n                \"success\": True,\n                \"status\": verification.status,  # \"pending\"\n                \"channel\": channel.value,\n                \"valid\": verification.valid\n            }\n\n        except TwilioRestException as e:\n            return self._handle_verify_error(e)\n\n    def check_verification(self, to: str, code: str) -> dict:\n        \"\"\"\n        Check if verification code is correct.\n\n        Args:\n            to: Phone number or email that received code\n            code: The code entered by user\n\n        R\n```\n\n### TwiML IVR Pattern\n\nBuild Interactive Voice Response (IVR) systems using TwiML.\nTwiML (Twilio Markup Language) is XML that tells Twilio what to do\nwhen receiving calls.\n\nCore TwiML verbs:\n- <Say>: Text-to-speech\n- <Play>: Play audio file\n- <Gather>: Collect keypad/speech input\n- <Dial>: Connect to another number\n- <Record>: Record caller's voice\n- <Redirect>: Move to another TwiML endpoint\n\nKey insight: Twilio makes HTTP request to your webhook, you return\nTwiML, Twilio executes it. Stateless, so use URL params or sessions.\n\n\n**When to use**: ['Phone menu systems (press 1 for sales...)', 'Automated customer support', 'Appointment reminders with confirmation', 'Voicemail systems']\n\n```python\nfrom flask import Flask, request, Response\nfrom twilio.twiml.voice_response import VoiceResponse, Gather\nfrom twilio.request_validator import RequestValidator\nimport os\n\napp = Flask(__name__)\n\ndef validate_twilio_request(f):\n    \"\"\"Decorator to validate requests are from Twilio.\"\"\"\n    def wrapper(*args, **kwargs):\n        validator = RequestValidator(os.environ[\"TWILIO_AUTH_TOKEN\"])\n\n        # Get request details\n        url = request.url\n        params = request.form.to_dict()\n        signature = request.headers.get(\"X-Twilio-Signature\", \"\")\n\n        if not validator.validate(url, params, signature):\n            return \"Invalid request\", 403\n\n        return f(*args, **kwargs)\n    wrapper.__name__ = f.__name__\n    return wrapper\n\n@app.route(\"/voice/incoming\", methods=[\"POST\"])\n@validate_twilio_request\ndef incoming_call():\n    \"\"\"Handle incoming call with IVR menu.\"\"\"\n    response = VoiceResponse()\n\n    # Gather digits with timeout\n    gather = Gather(\n        num_digits=1,\n        action=\"/voice/menu-selection\",\n        method=\"POST\",\n        timeout=5\n    )\n    gather.say(\n        \"Welcome to Acme Corp. \"\n        \"Press 1 for sales. \"\n        \"Press 2 for support. \"\n        \"Press 3 to leave a message.\"\n    )\n    response.append(gather)\n\n    # If no input, repeat\n    response.redirect(\"/voice/incoming\")\n\n    return Response(str(response), mimetype=\"text/xml\")\n\n@app.route(\"/voice/menu-selection\", methods=[\"POST\"])\n@validate_twilio_request\ndef menu_selection():\n    \"\"\"Route based on menu selection.\"\"\"\n    response = VoiceResponse()\n    digit = request.form.get(\"Digits\", \"\")\n\n    if digit == \"1\":\n        # Transfer to sales\n        response.say(\"Connecting you to sales.\")\n        response.dial(os.environ[\"SALES_PHONE\"])\n\n    elif digit == \"2\":\n        # Transfer to support\n        response.say(\"Connecting you to support.\")\n        response.dial(os.environ[\"SUPPORT_PHONE\"])\n\n    elif digit == \"3\":\n        # Voicemail\n        response.say(\"Please leave a message after \n```\n\n## ⚠️ Sharp Edges\n\n| Issue | Severity | Solution |\n|-------|----------|----------|\n| Issue | high | ## Track opt-out status in your database |\n| Issue | medium | ## Implement retry logic for transient failures |\n| Issue | high | ## Register for A2P 10DLC (US requirement) |\n| Issue | critical | ## ALWAYS validate the signature |\n| Issue | high | ## Track session windows per user |\n| Issue | critical | ## Never hardcode credentials |\n| Issue | medium | ## Implement application-level rate limiting too |\n\n## When to Use\nThis skill is applicable to execute the workflow or actions described in the overview.",
  "applicable_domains": [
    "other"
  ],
  "category": "other",
  "invocation": [
    "/twilio-communications"
  ],
  "authored_by": "claudeskills.in community",
  "source_url": "https://claudeskills.in/skill/twilio-communications",
  "provenance": {
    "source": "claudeskills.in",
    "source_url": "https://claudeskills.in/skill/twilio-communications",
    "license": "Apache-2.0",
    "imported_at": "2026-09-03",
    "notes": "Aggregated by claudeskills.in from community GitHub lists. Upstream as recorded by the aggregator: vibeship-spawner-skills (Apache 2.0)."
  },
  "tags": [
    "claudeskills",
    "other"
  ],
  "lifecycle": "draft"
}