Update to Twilio Developer Kit

{
  "name": "twilio-whatsapp-manage-senders",
  "description": "Create, configure, and manage WhatsApp Business senders via Twilio's Channels Senders API. Covers programmatic sender registration, profile setup, webhook configuration, sender lifecycle statuses, and ISV flows. Use this skill to register and manage production WhatsApp senders at scale.",
  "included_files": [
    {
      "relative_path": "agents/openai.yaml",
      "size_in_bytes": 241
    }
  ],
  "skill_md_contents": "---\nname: twilio-whatsapp-manage-senders\ndescription: >\n  Create, configure, and manage WhatsApp Business senders via Twilio's\n  Channels Senders API. Covers programmatic sender registration, profile setup,\n  webhook configuration, sender lifecycle statuses, and ISV flows. Use this\n  skill to register and manage production WhatsApp senders at scale.\n---\n\n## Overview\n\nA WhatsApp sender is a phone number registered with WhatsApp Business through Twilio. Registration goes through a lifecycle of statuses before becoming `ONLINE`. Sandbox testing does not require a registered sender — see `twilio-whatsapp-send-message`.\n\n---\n\n## Prerequisites\n\n- Upgraded Twilio account (trial accounts cannot register production senders)\n  — See `twilio-account-setup` for signup and upgrade steps\n- A phone number capable of receiving SMS or voice verification\n- Number must not already be registered with WhatsApp\n- Environment variables:\n  - `TWILIO_ACCOUNT_SID`\n  - `TWILIO_AUTH_TOKEN`\n  — See `twilio-iam-auth-setup` for credential setup and best practices\n- SDK: `pip install twilio` / `npm install twilio`\n\n---\n\n## Quickstart\n\n**Python**\n```python\nimport os\nfrom twilio.rest import Client\n\nclient = Client(os.environ[\"TWILIO_ACCOUNT_SID\"], os.environ[\"TWILIO_AUTH_TOKEN\"])\n\n# Step 1: Initiate registration\nsender = client.messaging.v2.channels.senders.create(\n    sender_id=\"whatsapp:+15017122661\",\n    verification_method=\"sms\"\n)\nprint(sender.sid)     # XExxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\nprint(sender.status)  # CREATING\n\n# Step 2: Submit the OTP Twilio sends to the number\nsender = client.messaging.v2.channels.senders(sender.sid).update(\n    verification_code=\"123456\"\n)\nprint(sender.status)  # ONLINE (may pass through TWILIO_REVIEW first)\n```\n\n**Node.js**\n```node\nconst twilio = require(\"twilio\");\nconst client = twilio(process.env.TWILIO_ACCOUNT_SID, process.env.TWILIO_AUTH_TOKEN);\n\n// Step 1: Initiate registration\nconst sender = await client.messaging.v2.channels.senders.create({\n    senderId: \"whatsapp:+15017122661\",\n    verificationMethod: \"sms\",\n});\nconsole.log(sender.sid, sender.status);\n\n// Step 2: Submit the OTP\nconst verified = await client.messaging.v2.channels.senders(sender.sid).update({\n    verificationCode: \"123456\",\n});\nconsole.log(verified.status);\n```\n\n---\n\n## Sender Lifecycle Statuses\n\n| Status | Meaning |\n|--------|---------|\n| `CREATING` | Registration initiated |\n| `PENDING_VERIFICATION` | Awaiting OTP submission |\n| `VERIFYING` | OTP being validated |\n| `TWILIO_REVIEW` | Under Twilio/Meta review |\n| `ONLINE` | Active and ready to send |\n| `OFFLINE` | Inactive — check `offlineReasons` |\n| `DRAFT` | Incomplete registration |\n\n---\n\n## Key Patterns\n\n### Set Business Profile\n\n**Python**\n```python\nsender = client.messaging.v2.channels.senders(SENDER_SID).update(\n    profile_name=\"Acme Support\",\n    profile_about=\"Official support channel for Acme Corp\",\n    profile_address=\"123 Main St, San Francisco, CA\",\n    profile_vertical=\"PROFESSIONAL_SERVICES\",\n    profile_logo_url=\"https://acme.com/logo.png\",\n    profile_websites=[\"https://acme.com\"]\n)\n```\n\n**Node.js**\n```node\nconst sender = await client.messaging.v2.channels.senders(SENDER_SID).update({\n    profileName: \"Acme Support\",\n    profileAbout: \"Official support channel for Acme Corp\",\n    profileAddress: \"123 Main St, San Francisco, CA\",\n    profileVertical: \"PROFESSIONAL_SERVICES\",\n    profileLogoUrl: \"https://acme.com/logo.png\",\n    profileWebsites: [\"https://acme.com\"],\n});\n```\n\n### Configure Webhooks\n\n**Python**\n```python\nsender = client.messaging.v2.channels.senders(SENDER_SID).update(\n    callback_url=\"https://yourapp.com/whatsapp/inbound\",\n    callback_method=\"POST\",\n    status_callback_url=\"https://yourapp.com/whatsapp/status\"\n)\n```\n\n**Node.js**\n```node\nawait client.messaging.v2.channels.senders(SENDER_SID).update({\n    callbackUrl: \"https://yourapp.com/whatsapp/inbound\",\n    callbackMethod: \"POST\",\n    statusCallbackUrl: \"https://yourapp.com/whatsapp/status\",\n});\n```\n\n### Retrieve and List Senders\n\n**Python**\n```python\nsender = client.messaging.v2.channels.senders(SENDER_SID).fetch()\nprint(sender.status)\n\nfor s in client.messaging.v2.channels.senders.list():\n    print(s.sid, s.status)\n```\n\n**Node.js**\n```node\nconst sender = await client.messaging.v2.channels.senders(SENDER_SID).fetch();\nconst senders = await client.messaging.v2.channels.senders.list();\nsenders.forEach(s => console.log(s.sid, s.status));\n```\n\nIf a sender is `OFFLINE`, check the `offlineReasons` array in the response (e.g. code `63020` means business hasn't accepted Twilio's Meta invitation).\n\n### Migrate an Existing WhatsApp Number\n\nIf a number is already registered on WhatsApp (personal or business):\n1. Check: `https://wa.me/<PHONE_NUMBER>?text=hi`\n2. Delete the existing WhatsApp account on the device, or disable 2FA on the competing platform\n3. Proceed with registration above\n\n### ISV / Tech Provider Flow\n\nRegister senders under a client's WhatsApp Business Account (WABA):\n\n**Python**\n```python\nsender = client.messaging.v2.channels.senders.create(\n    sender_id=\"whatsapp:+15017122661\",\n    waba_id=\"client-waba-id\"\n)\n```\n\n**Node.js**\n```node\nconst sender = await client.messaging.v2.channels.senders.create({\n    senderId: \"whatsapp:+15017122661\",\n    wabaId: \"client-waba-id\",\n});\n```\n\nThe client must accept Twilio's invitation in their Meta Business Manager.\n\n---\n\n## CANNOT\n\n- **Cannot register a phone number to multiple WABAs** — Each number belongs to one WABA at a time\n- **Cannot exceed 2 senders without Meta Business Verification** — Unverified accounts are limited to 2\n- **Cannot exceed 20 senders without exception** — Verified Meta Business Manager: max 20 (50 with exception request)\n- **Cannot verify phone number only via SMS** — Voice verification is available if SMS cannot be received\n\n---\n\n## Next Steps\n\n- **Send WhatsApp messages with this sender:** `twilio-whatsapp-send-message`\n- **Create message templates:** `twilio-content-template-builder`\n- **Send WhatsApp OTPs:** `twilio-verify-send-otp`\n"
}