[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-openai-twilio-debugging-observability":3,"mdc-lpzyif-key":36,"related-repo-openai-twilio-debugging-observability":3234,"related-org-openai-twilio-debugging-observability":3357},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":25,"repoUrl":26,"updatedAt":27,"license":28,"forks":29,"topics":30,"repo":31,"sourceUrl":34,"mdContent":35},"twilio-debugging-observability","debug and monitor Twilio integrations","Debug Twilio integrations and set up production observability. Covers the Console Debugger, Monitor Alerts API, Event Streams for error log streaming, status callback tracking, common error codes, and a systematic debugging workflow. Use this skill whenever a Twilio integration produces errors, messages fail to deliver, calls drop unexpectedly, or you need to set up monitoring for a production deployment.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"openai","OpenAI","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fopenai.png",[12,16,19,22],{"name":13,"slug":14,"type":15},"Observability","observability","tag",{"name":17,"slug":18,"type":15},"Monitoring","monitoring",{"name":20,"slug":21,"type":15},"Debugging","debugging",{"name":23,"slug":24,"type":15},"Twilio","twilio",3992,"https:\u002F\u002Fgithub.com\u002Fopenai\u002Fplugins","2026-06-30T19:00:57.102",null,465,[],{"repoUrl":26,"stars":25,"forks":29,"topics":32,"description":33},[],"OpenAI Plugins","https:\u002F\u002Fgithub.com\u002Fopenai\u002Fplugins\u002Ftree\u002FHEAD\u002Fplugins\u002Ftwilio-developer-kit\u002Fskills\u002Ftwilio-debugging-observability","---\nname: twilio-debugging-observability\ndescription: >\n  Debug Twilio integrations and set up production observability. Covers the\n  Console Debugger, Monitor Alerts API, Event Streams for error log streaming,\n  status callback tracking, common error codes, and a systematic debugging\n  workflow. Use this skill whenever a Twilio integration produces errors,\n  messages fail to deliver, calls drop unexpectedly, or you need to set up\n  monitoring for a production deployment.\n---\n\n## Overview\n\nTwilio provides several layers of debugging and observability: the Console Debugger for interactive troubleshooting, the Monitor REST API for programmatic alert queries, Event Streams for real-time error streaming, and status callbacks for per-resource delivery tracking. This skill covers the systematic approach to diagnosing issues and setting up production monitoring.\n\n\n---\n\n## Prerequisites\n\n- Twilio account with `TWILIO_ACCOUNT_SID` and `TWILIO_AUTH_TOKEN` -- see `twilio-iam-auth-setup`\n- SDK: `pip install twilio requests` \u002F `npm install twilio`\n- For Event Streams: a publicly accessible HTTPS endpoint or AWS Kinesis stream\n\n---\n\n## Quickstart\n\nCheck for recent errors on your account using the Monitor Alerts API.\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\nalerts = client.monitor.alerts.list(log_level=\"error\", limit=10)\nfor alert in alerts:\n    print(f\"{alert.date_created}: [{alert.error_code}] {alert.alert_text}\")\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\nconst alerts = await client.monitor.alerts.list({ logLevel: \"error\", limit: 10 });\nalerts.forEach(a => {\n    console.log(`${a.dateCreated}: [${a.errorCode}] ${a.alertText}`);\n});\n```\n\n---\n\n## Key Patterns\n\n### 1. Systematic Debugging Workflow\n\nWhen something fails, work through these layers in order:\n\n```\n1. Check status callbacks FIRST\n   (Did your endpoint receive delivery\u002Fcall status? What error code?)\n   |\n2. Check the resource directly via REST API\n   (GET \u002FMessages\u002F{sid} or \u002FCalls\u002F{sid} — current state + error_code)\n   |\n3. Check number reputation \u002F sender registration\n   (Is the number spam-flagged? Is A2P 10DLC registered? Toll-free verified?)\n   |\n4. Check the Console Debugger for webhook\u002FTwiML errors\n   (Console > Monitor > Errors — shows HTTP request\u002Fresponse details)\n   |\n5. Check your webhook endpoint\n   (Is it reachable? Responding within 15s? Returning valid TwiML\u002F200?)\n   |\n6. Query Monitor Alerts API or Event Streams\n   (For patterns across many messages\u002Fcalls, or historical analysis)\n```\n\n**Why status callbacks first:** Status callbacks tell you the exact error code for the specific message or call that failed. The Console Debugger aggregates errors across your account and may not surface the one you're looking for. Start specific, then broaden.\n\n**Number reputation checklist:**\n- SMS 30007 (carrier filtering) → Check A2P 10DLC registration status, content for spam triggers\n- SMS 30034 → Sender not registered for A2P 10DLC — register brand + campaign\n- Calls going to voicemail \u002F \"Spam Likely\" → Check STIR\u002FSHAKEN attestation, Voice Integrity status (see `twilio-numbers-senders`)\n- Toll-free SMS blocked → Check toll-free verification status\n\n**Rule of thumb:** If status callbacks show `delivered` but the user says they didn't receive it, the issue is on the carrier\u002Fdevice side (not Twilio). If the Console Debugger shows no errors at all, the problem is in your application (webhook, TwiML, business logic).\n\n### 2. Console Debugger\n\nThe [Console Debugger](https:\u002F\u002Fconsole.twilio.com\u002Fus1\u002Fmonitor\u002Flogs\u002Fdebugger) shows errors and warnings for your account in real time.\n\nEach entry includes:\n- The exact error or warning that occurred\n- Potential causes and suggested solutions\n- The full HTTP request and response for the associated webhook\n\n**Configure a Debugger webhook** for real-time alerting:\n\nConsole > Monitor > Logs > Debugger > (gear icon) > set Callback URL\n\nDebugger webhook POST parameters:\n\n| Parameter | Description |\n|---|---|\n| `Sid` | Debugger event identifier |\n| `AccountSid` | Account that generated the event |\n| `Level` | `Error` or `Warning` |\n| `Timestamp` | ISO 8601 time |\n| `Payload` | JSON: `resource_sid`, `error_code`, `more_info`, `webhook` (full request\u002Fresponse) |\n\n**Python (Flask) -- debugger webhook handler**\n```python\nimport json, os\nfrom flask import Flask, request\nfrom twilio.request_validator import RequestValidator\n\napp = Flask(__name__)\nvalidator = RequestValidator(os.environ[\"TWILIO_AUTH_TOKEN\"])\n\n@app.route(\"\u002Fdebugger\", methods=[\"POST\"])\ndef debugger_event():\n    sig = request.headers.get(\"X-Twilio-Signature\", \"\")\n    if not validator.validate(request.url, request.form, sig):\n        return \"Forbidden\", 403\n    level = request.form.get(\"Level\")\n    payload = json.loads(request.form.get(\"Payload\", \"{}\"))\n    error_code = payload.get(\"error_code\")\n    resource_sid = payload.get(\"resource_sid\")\n    msg = payload.get(\"more_info\", {}).get(\"msg\", \"\")\n    print(f\"[{level}] Error {error_code} on {resource_sid}: {msg}\")\n    return \"\", 204\n```\n\n**Node.js (Express) -- debugger webhook handler**\n```node\nconst express = require(\"express\");\nconst twilio = require(\"twilio\");\nconst app = express();\napp.use(express.urlencoded({ extended: false }));\n\napp.post(\"\u002Fdebugger\", (req, res) => {\n    const valid = twilio.validateRequest(\n        process.env.TWILIO_AUTH_TOKEN,\n        req.headers[\"x-twilio-signature\"],\n        `https:\u002F\u002F${req.headers.host}${req.originalUrl}`,\n        req.body\n    );\n    if (!valid) return res.status(403).send(\"Forbidden\");\n    const payload = JSON.parse(req.body.Payload || \"{}\");\n    const { error_code, resource_sid } = payload;\n    const msg = payload.more_info?.msg || \"\";\n    console.log(`[${req.body.Level}] Error ${error_code} on ${resource_sid}: ${msg}`);\n    res.sendStatus(204);\n});\n```\n\n### 3. Monitor Alerts API\n\nThe Monitor REST API (`monitor.twilio.com\u002Fv1\u002FAlerts`) provides programmatic access to error and warning logs. Individual alert instances include the full HTTP request and response data.\n\n**Python -- query alerts with date filtering**\n```python\nfrom datetime import datetime, timedelta\n\n# Alerts from the last 24 hours\nstart = datetime.utcnow() - timedelta(days=1)\nalerts = client.monitor.alerts.list(\n    start_date=start,\n    log_level=\"error\",\n    limit=50\n)\n\nfor alert in alerts:\n    print(f\"{alert.date_created} [{alert.error_code}]\")\n    # Fetch full details including HTTP request\u002Fresponse\n    detail = client.monitor.alerts(alert.sid).fetch()\n    print(f\"  Request URL: {detail.request_url}\")\n    print(f\"  Response body: {detail.response_body}\")\n```\n\n**Node.js -- query alerts with date filtering**\n```node\nconst startDate = new Date(Date.now() - 24 * 60 * 60 * 1000);\nconst alerts = await client.monitor.alerts.list({\n    startDate,\n    logLevel: \"error\",\n    limit: 50,\n});\n\nfor (const alert of alerts) {\n    console.log(`${alert.dateCreated} [${alert.errorCode}]`);\n    const detail = await client.monitor.alerts(alert.sid).fetch();\n    console.log(`  Request URL: ${detail.requestUrl}`);\n    console.log(`  Response body: ${detail.responseBody}`);\n}\n```\n\n**Retention:** Enterprise accounts: 13 months. Free accounts: 30 days.\n\n### 4. Monitor Events API\n\nThe Events resource (`monitor.twilio.com\u002Fv1\u002FEvents`) tracks all changes to Twilio resources -- phone number provisioning, account settings, recording access, API key creation, and more.\n\n**Python -- audit recent account changes**\n```python\nevents = client.monitor.events.list(limit=20)\nfor event in events:\n    print(f\"{event.event_date}: {event.event_type}\")\n    print(f\"  Resource: {event.resource_type} ({event.resource_sid})\")\n    print(f\"  Actor: {event.actor_type} ({event.actor_sid}) from {event.source_ip_address}\")\n```\n\nEach event captures: event type, resource, actor (who triggered it), source (API \u002F Console \u002F Twilio admin), and IP address.\n\n**Use cases:**\n- Audit who changed a phone number's webhook URL\n- Track API key creation and deletion\n- Detect unexpected configuration changes\n- Feed events into a SIEM for security monitoring\n\n### 5. Event Streams for Error Log Streaming\n\nFor production monitoring, stream errors to your infrastructure in real time using Event Streams. The Twilio SDK does not wrap Event Streams -- use `requests` \u002F `fetch` directly.\n\n**Python -- set up error log streaming to a webhook**\n```python\nimport os, requests\n\naccount_sid = os.environ[\"TWILIO_ACCOUNT_SID\"]\nauth_token = os.environ[\"TWILIO_AUTH_TOKEN\"]\n\n# Step 1: Create a webhook sink\nsink = requests.post(\n    \"https:\u002F\u002Fevents.twilio.com\u002Fv1\u002FSinks\",\n    auth=(account_sid, auth_token),\n    data={\n        \"Description\": \"Error monitoring sink\",\n        \"SinkType\": \"webhook\",\n        \"SinkConfiguration\": '{\"destination\": \"https:\u002F\u002Fyourapp.com\u002Ftwilio-errors\", \"method\": \"POST\"}'\n    }\n).json()\n\n# Step 2: Subscribe to error log events\nsubscription = requests.post(\n    \"https:\u002F\u002Fevents.twilio.com\u002Fv1\u002FSubscriptions\",\n    auth=(account_sid, auth_token),\n    data={\n        \"Description\": \"Error log subscription\",\n        \"SinkSid\": sink[\"sid\"],\n        \"Types\": '[{\"type\": \"com.twilio.error-logs.error.logged\"}]'\n    }\n).json()\n\nprint(f\"Sink: {sink['sid']}, Subscription: {subscription['sid']}\")\n```\n\n**Sink types:** `webhook`, `kinesis`, `segment`\n\n**Useful event types for observability:**\n\n| Event type | Description |\n|---|---|\n| `com.twilio.error-logs.error.logged` | All errors and warnings on account |\n| `com.twilio.messaging.message.delivered` | Message delivered successfully |\n| `com.twilio.messaging.message.undelivered` | Message delivery failed |\n| `com.twilio.voice.insights.call-summary` | Post-call quality and status summary |\n\n### 6. Status Callback Monitoring\n\nStatus callbacks are the most granular observability mechanism -- they fire for individual resource state changes.\n\n**Message delivery tracking:**\n```python\n# Attach when sending\nmessage = client.messages.create(\n    to=\"+15558675310\", from_=\"+15017122661\", body=\"Hello!\",\n    status_callback=\"https:\u002F\u002Fyourapp.com\u002Fmsg-status\"\n)\n```\n\n**Call lifecycle tracking:**\n```python\ncall = client.calls.create(\n    to=\"+15558675310\", from_=\"+15017122661\",\n    url=\"https:\u002F\u002Fyourapp.com\u002Fvoice\",\n    status_callback=\"https:\u002F\u002Fyourapp.com\u002Fcall-status\",\n    status_callback_event=[\"initiated\", \"ringing\", \"answered\", \"completed\"]\n)\n```\n\n**Recording completion tracking:**\n```python\n# In TwiML\nresponse = VoiceResponse()\nresponse.record(\n    recording_status_callback=\"https:\u002F\u002Fyourapp.com\u002Frecording-status\",\n    recording_status_callback_event=\"completed absent failed\"\n)\n```\n\nRecording status values: `in-progress`, `completed`, `absent`, `failed`. The `RecordingUrl` is available when status is `completed`.\n\n### 7. Debugging Webhooks\n\nWhen Twilio can't reach your webhook or receives an error, the problem is often in your infrastructure.\n\n**Common causes and fixes:**\n\n| Symptom | Likely cause | Fix |\n|---|---|---|\n| Error 11200 in Debugger | Webhook URL returned non-200 \u002F unreachable | Verify endpoint is live: `curl -I https:\u002F\u002Fyourapp.com\u002Fsms` |\n| Error 11205 | HTTP connection failure (port closed, refused, firewall) | Verify server is running and port is open: `curl -I https:\u002F\u002Fyourapp.com\u002Fsms` |\n| Error 12100 | TwiML document could not be parsed | Check for debug output, BOM characters, or malformed XML |\n| Parameters missing after redirect | HTTP 301\u002F302 strips POST body | Fix URL to avoid redirect (add\u002Fremove `www.`, use HTTPS directly) |\n| Webhook works locally but not deployed | Tunnel expired or firewall | Use `curl` from an external host to test |\n| Intermittent failures | ngrok session expired \u002F recycled | Deploy to a stable host for anything beyond quick tests |\n\n**Test webhooks manually:**\n```bash\n# Simulate an inbound SMS webhook\ncurl -X POST https:\u002F\u002Fyourapp.com\u002Fsms \\\n  -d \"From=+15551234567\" \\\n  -d \"To=+15559876543\" \\\n  -d \"Body=Test message\" \\\n  -d \"MessageSid=SM00000000000000000000000000000000\"\n```\n\n**Browser testing:** Visit your webhook URL in Firefox -- it highlights XML errors in the response.\n\n### 8. Common Error Codes\n\n| Code | Name | Cause | Fix |\n|---|---|---|---|\n| 11200 | HTTP retrieval failure | Twilio cannot reach your webhook URL | Check URL, DNS, firewall, SSL cert |\n| 11205 | HTTP connection failure | Webhook endpoint refused connection | Verify server is running and port is open |\n| 11751 | Media download failure | MMS media URL unreachable | Check media URL accessibility |\n| 12100 | Document parse failure | TwiML is not valid XML | Validate XML; remove debug output |\n| 12200 | Schema compliance failure | TwiML verbs\u002Fattributes are invalid | Check TwiML reference for correct syntax |\n| 20003 | Authentication error | Invalid Account SID or Auth Token | Verify credentials in environment |\n| 21211 | Invalid `To` number | Number not in E.164 format | Use `+` country code + number |\n| 21608 | Unverified number (trial) | Trial accounts can only send to verified numbers | Verify number or upgrade account |\n| 30003 | Unreachable destination | Carrier cannot deliver message | Check number validity; retry later |\n| 30006 | Landline or unreachable | Destination is a landline | Use voice channel instead |\n| 30007 | Carrier filtering | Message filtered by carrier | Review content; register for A2P 10DLC |\n| 30008 | Unknown error | Carrier returned generic error | Retry; contact support if persistent |\n\nFull error reference: https:\u002F\u002Fwww.twilio.com\u002Fdocs\u002Fapi\u002Ferrors\n\n### 9. Querying Resource State Directly\n\nWhen you need the current state of a message or call (not waiting for a callback):\n\n**Python**\n```python\n# Check message delivery status\nmessage = client.messages(\"SMxxxxxxxxxx\").fetch()\nprint(f\"Status: {message.status}, Error: {message.error_code}\")\n\n# Check call status\ncall = client.calls(\"CAxxxxxxxxxx\").fetch()\nprint(f\"Status: {call.status}, Duration: {call.duration}\")\n```\n\n**Node.js**\n```node\nconst message = await client.messages(\"SMxxxxxxxxxx\").fetch();\nconsole.log(`Status: ${message.status}, Error: ${message.errorCode}`);\n\nconst call = await client.calls(\"CAxxxxxxxxxx\").fetch();\nconsole.log(`Status: ${call.status}, Duration: ${call.duration}`);\n```\n\n### 10. CLI Debugging\n\nThe Twilio CLI supports debug logging:\n\n```bash\n# Verbose output for any CLI command\ntwilio api:core:messages:list --limit 5 -l debug\n\n# Log levels: debug, info, warn, error\n```\n\nDebug output goes to stderr, so you can pipe normal output while still seeing diagnostics.\n\n---\n\n## Monitoring Checklist\n\nSet up before going to production:\n\n| What to monitor | How | Alert threshold |\n|---|---|---|\n| Webhook errors | Debugger webhook or Event Streams (`com.twilio.error-logs.error.logged`) | Any error |\n| Message delivery failures | Status callback `failed`\u002F`undelivered` | > 2% failure rate |\n| Call completion rate | Status callback `completed` vs total | \u003C 95% completion |\n| Webhook response time | Your APM (DataDog, New Relic) | p95 > 5 seconds |\n| 429 rate limit hits | Count in your backoff handler | > 5% of requests |\n| Account configuration changes | Monitor Events API | Any unexpected change |\n| Recording failures | Recording status callback `failed`\u002F`absent` | Any failure |\n\n---\n\n## CANNOT\n\n- **Cannot fetch more than 10,000 alerts per request** — Use date range filters for large accounts\n- **Cannot get full HTTP request\u002Fresponse from alert list** — Only available when fetching a single alert by SID\n- **Cannot combine multiple filters on Events API** — One additional field (ResourceSid, ActorSid, SourceIpAddress) plus date range per request\n- **Cannot delete an Event Streams sink before its subscription** — Must delete the subscription first\n- **Cannot guarantee status callback delivery or order** — Best-effort. Use composite keys for idempotency.\n- **Cannot rely on a static error code list** — New error codes are added without notice. Always link to the full reference rather than hardcoding.\n\n---\n\n## Next Steps\n\n- **Webhook architecture:** `twilio-webhook-architecture`\n- **Scale webhook handling:** `twilio-reliability-patterns`\n- **Compliance monitoring:** `twilio-compliance-traffic`\n- **Credential security:** `twilio-iam-auth-setup`\n",{"data":37,"body":38},{"name":4,"description":6},{"type":39,"children":40},"root",[41,50,56,60,66,123,126,132,137,146,231,239,303,306,312,319,324,334,344,352,383,401,407,423,428,446,456,461,466,621,629,797,805,961,967,980,988,1120,1128,1237,1247,1253,1266,1274,1321,1326,1334,1357,1363,1383,1391,1623,1652,1660,1749,1755,1760,1768,1814,1822,1876,1884,1938,1987,1993,1998,2006,2168,2176,2321,2331,2337,2659,2670,2676,2681,2688,2750,2757,2803,2809,2814,2877,2882,2885,2891,2896,3085,3088,3094,3157,3160,3166,3228],{"type":42,"tag":43,"props":44,"children":46},"element","h2",{"id":45},"overview",[47],{"type":48,"value":49},"text","Overview",{"type":42,"tag":51,"props":52,"children":53},"p",{},[54],{"type":48,"value":55},"Twilio provides several layers of debugging and observability: the Console Debugger for interactive troubleshooting, the Monitor REST API for programmatic alert queries, Event Streams for real-time error streaming, and status callbacks for per-resource delivery tracking. This skill covers the systematic approach to diagnosing issues and setting up production monitoring.",{"type":42,"tag":57,"props":58,"children":59},"hr",{},[],{"type":42,"tag":43,"props":61,"children":63},{"id":62},"prerequisites",[64],{"type":48,"value":65},"Prerequisites",{"type":42,"tag":67,"props":68,"children":69},"ul",{},[70,99,118],{"type":42,"tag":71,"props":72,"children":73},"li",{},[74,76,83,85,91,93],{"type":48,"value":75},"Twilio account with ",{"type":42,"tag":77,"props":78,"children":80},"code",{"className":79},[],[81],{"type":48,"value":82},"TWILIO_ACCOUNT_SID",{"type":48,"value":84}," and ",{"type":42,"tag":77,"props":86,"children":88},{"className":87},[],[89],{"type":48,"value":90},"TWILIO_AUTH_TOKEN",{"type":48,"value":92}," -- see ",{"type":42,"tag":77,"props":94,"children":96},{"className":95},[],[97],{"type":48,"value":98},"twilio-iam-auth-setup",{"type":42,"tag":71,"props":100,"children":101},{},[102,104,110,112],{"type":48,"value":103},"SDK: ",{"type":42,"tag":77,"props":105,"children":107},{"className":106},[],[108],{"type":48,"value":109},"pip install twilio requests",{"type":48,"value":111}," \u002F ",{"type":42,"tag":77,"props":113,"children":115},{"className":114},[],[116],{"type":48,"value":117},"npm install twilio",{"type":42,"tag":71,"props":119,"children":120},{},[121],{"type":48,"value":122},"For Event Streams: a publicly accessible HTTPS endpoint or AWS Kinesis stream",{"type":42,"tag":57,"props":124,"children":125},{},[],{"type":42,"tag":43,"props":127,"children":129},{"id":128},"quickstart",[130],{"type":48,"value":131},"Quickstart",{"type":42,"tag":51,"props":133,"children":134},{},[135],{"type":48,"value":136},"Check for recent errors on your account using the Monitor Alerts API.",{"type":42,"tag":51,"props":138,"children":139},{},[140],{"type":42,"tag":141,"props":142,"children":143},"strong",{},[144],{"type":48,"value":145},"Python",{"type":42,"tag":147,"props":148,"children":153},"pre",{"className":149,"code":150,"language":151,"meta":152,"style":152},"language-python shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import os\nfrom twilio.rest import Client\n\nclient = Client(os.environ[\"TWILIO_ACCOUNT_SID\"], os.environ[\"TWILIO_AUTH_TOKEN\"])\n\nalerts = client.monitor.alerts.list(log_level=\"error\", limit=10)\nfor alert in alerts:\n    print(f\"{alert.date_created}: [{alert.error_code}] {alert.alert_text}\")\n","python","",[154],{"type":42,"tag":77,"props":155,"children":156},{"__ignoreMap":152},[157,168,177,187,196,204,213,222],{"type":42,"tag":158,"props":159,"children":162},"span",{"class":160,"line":161},"line",1,[163],{"type":42,"tag":158,"props":164,"children":165},{},[166],{"type":48,"value":167},"import os\n",{"type":42,"tag":158,"props":169,"children":171},{"class":160,"line":170},2,[172],{"type":42,"tag":158,"props":173,"children":174},{},[175],{"type":48,"value":176},"from twilio.rest import Client\n",{"type":42,"tag":158,"props":178,"children":180},{"class":160,"line":179},3,[181],{"type":42,"tag":158,"props":182,"children":184},{"emptyLinePlaceholder":183},true,[185],{"type":48,"value":186},"\n",{"type":42,"tag":158,"props":188,"children":190},{"class":160,"line":189},4,[191],{"type":42,"tag":158,"props":192,"children":193},{},[194],{"type":48,"value":195},"client = Client(os.environ[\"TWILIO_ACCOUNT_SID\"], os.environ[\"TWILIO_AUTH_TOKEN\"])\n",{"type":42,"tag":158,"props":197,"children":199},{"class":160,"line":198},5,[200],{"type":42,"tag":158,"props":201,"children":202},{"emptyLinePlaceholder":183},[203],{"type":48,"value":186},{"type":42,"tag":158,"props":205,"children":207},{"class":160,"line":206},6,[208],{"type":42,"tag":158,"props":209,"children":210},{},[211],{"type":48,"value":212},"alerts = client.monitor.alerts.list(log_level=\"error\", limit=10)\n",{"type":42,"tag":158,"props":214,"children":216},{"class":160,"line":215},7,[217],{"type":42,"tag":158,"props":218,"children":219},{},[220],{"type":48,"value":221},"for alert in alerts:\n",{"type":42,"tag":158,"props":223,"children":225},{"class":160,"line":224},8,[226],{"type":42,"tag":158,"props":227,"children":228},{},[229],{"type":48,"value":230},"    print(f\"{alert.date_created}: [{alert.error_code}] {alert.alert_text}\")\n",{"type":42,"tag":51,"props":232,"children":233},{},[234],{"type":42,"tag":141,"props":235,"children":236},{},[237],{"type":48,"value":238},"Node.js",{"type":42,"tag":147,"props":240,"children":244},{"className":241,"code":242,"language":243,"meta":152,"style":152},"language-node shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","const twilio = require(\"twilio\");\nconst client = twilio(process.env.TWILIO_ACCOUNT_SID, process.env.TWILIO_AUTH_TOKEN);\n\nconst alerts = await client.monitor.alerts.list({ logLevel: \"error\", limit: 10 });\nalerts.forEach(a => {\n    console.log(`${a.dateCreated}: [${a.errorCode}] ${a.alertText}`);\n});\n","node",[245],{"type":42,"tag":77,"props":246,"children":247},{"__ignoreMap":152},[248,256,264,271,279,287,295],{"type":42,"tag":158,"props":249,"children":250},{"class":160,"line":161},[251],{"type":42,"tag":158,"props":252,"children":253},{},[254],{"type":48,"value":255},"const twilio = require(\"twilio\");\n",{"type":42,"tag":158,"props":257,"children":258},{"class":160,"line":170},[259],{"type":42,"tag":158,"props":260,"children":261},{},[262],{"type":48,"value":263},"const client = twilio(process.env.TWILIO_ACCOUNT_SID, process.env.TWILIO_AUTH_TOKEN);\n",{"type":42,"tag":158,"props":265,"children":266},{"class":160,"line":179},[267],{"type":42,"tag":158,"props":268,"children":269},{"emptyLinePlaceholder":183},[270],{"type":48,"value":186},{"type":42,"tag":158,"props":272,"children":273},{"class":160,"line":189},[274],{"type":42,"tag":158,"props":275,"children":276},{},[277],{"type":48,"value":278},"const alerts = await client.monitor.alerts.list({ logLevel: \"error\", limit: 10 });\n",{"type":42,"tag":158,"props":280,"children":281},{"class":160,"line":198},[282],{"type":42,"tag":158,"props":283,"children":284},{},[285],{"type":48,"value":286},"alerts.forEach(a => {\n",{"type":42,"tag":158,"props":288,"children":289},{"class":160,"line":206},[290],{"type":42,"tag":158,"props":291,"children":292},{},[293],{"type":48,"value":294},"    console.log(`${a.dateCreated}: [${a.errorCode}] ${a.alertText}`);\n",{"type":42,"tag":158,"props":296,"children":297},{"class":160,"line":215},[298],{"type":42,"tag":158,"props":299,"children":300},{},[301],{"type":48,"value":302},"});\n",{"type":42,"tag":57,"props":304,"children":305},{},[],{"type":42,"tag":43,"props":307,"children":309},{"id":308},"key-patterns",[310],{"type":48,"value":311},"Key Patterns",{"type":42,"tag":313,"props":314,"children":316},"h3",{"id":315},"_1-systematic-debugging-workflow",[317],{"type":48,"value":318},"1. Systematic Debugging Workflow",{"type":42,"tag":51,"props":320,"children":321},{},[322],{"type":48,"value":323},"When something fails, work through these layers in order:",{"type":42,"tag":147,"props":325,"children":329},{"className":326,"code":328,"language":48},[327],"language-text","1. Check status callbacks FIRST\n   (Did your endpoint receive delivery\u002Fcall status? What error code?)\n   |\n2. Check the resource directly via REST API\n   (GET \u002FMessages\u002F{sid} or \u002FCalls\u002F{sid} — current state + error_code)\n   |\n3. Check number reputation \u002F sender registration\n   (Is the number spam-flagged? Is A2P 10DLC registered? Toll-free verified?)\n   |\n4. Check the Console Debugger for webhook\u002FTwiML errors\n   (Console > Monitor > Errors — shows HTTP request\u002Fresponse details)\n   |\n5. Check your webhook endpoint\n   (Is it reachable? Responding within 15s? Returning valid TwiML\u002F200?)\n   |\n6. Query Monitor Alerts API or Event Streams\n   (For patterns across many messages\u002Fcalls, or historical analysis)\n",[330],{"type":42,"tag":77,"props":331,"children":332},{"__ignoreMap":152},[333],{"type":48,"value":328},{"type":42,"tag":51,"props":335,"children":336},{},[337,342],{"type":42,"tag":141,"props":338,"children":339},{},[340],{"type":48,"value":341},"Why status callbacks first:",{"type":48,"value":343}," Status callbacks tell you the exact error code for the specific message or call that failed. The Console Debugger aggregates errors across your account and may not surface the one you're looking for. Start specific, then broaden.",{"type":42,"tag":51,"props":345,"children":346},{},[347],{"type":42,"tag":141,"props":348,"children":349},{},[350],{"type":48,"value":351},"Number reputation checklist:",{"type":42,"tag":67,"props":353,"children":354},{},[355,360,365,378],{"type":42,"tag":71,"props":356,"children":357},{},[358],{"type":48,"value":359},"SMS 30007 (carrier filtering) → Check A2P 10DLC registration status, content for spam triggers",{"type":42,"tag":71,"props":361,"children":362},{},[363],{"type":48,"value":364},"SMS 30034 → Sender not registered for A2P 10DLC — register brand + campaign",{"type":42,"tag":71,"props":366,"children":367},{},[368,370,376],{"type":48,"value":369},"Calls going to voicemail \u002F \"Spam Likely\" → Check STIR\u002FSHAKEN attestation, Voice Integrity status (see ",{"type":42,"tag":77,"props":371,"children":373},{"className":372},[],[374],{"type":48,"value":375},"twilio-numbers-senders",{"type":48,"value":377},")",{"type":42,"tag":71,"props":379,"children":380},{},[381],{"type":48,"value":382},"Toll-free SMS blocked → Check toll-free verification status",{"type":42,"tag":51,"props":384,"children":385},{},[386,391,393,399],{"type":42,"tag":141,"props":387,"children":388},{},[389],{"type":48,"value":390},"Rule of thumb:",{"type":48,"value":392}," If status callbacks show ",{"type":42,"tag":77,"props":394,"children":396},{"className":395},[],[397],{"type":48,"value":398},"delivered",{"type":48,"value":400}," but the user says they didn't receive it, the issue is on the carrier\u002Fdevice side (not Twilio). If the Console Debugger shows no errors at all, the problem is in your application (webhook, TwiML, business logic).",{"type":42,"tag":313,"props":402,"children":404},{"id":403},"_2-console-debugger",[405],{"type":48,"value":406},"2. Console Debugger",{"type":42,"tag":51,"props":408,"children":409},{},[410,412,421],{"type":48,"value":411},"The ",{"type":42,"tag":413,"props":414,"children":418},"a",{"href":415,"rel":416},"https:\u002F\u002Fconsole.twilio.com\u002Fus1\u002Fmonitor\u002Flogs\u002Fdebugger",[417],"nofollow",[419],{"type":48,"value":420},"Console Debugger",{"type":48,"value":422}," shows errors and warnings for your account in real time.",{"type":42,"tag":51,"props":424,"children":425},{},[426],{"type":48,"value":427},"Each entry includes:",{"type":42,"tag":67,"props":429,"children":430},{},[431,436,441],{"type":42,"tag":71,"props":432,"children":433},{},[434],{"type":48,"value":435},"The exact error or warning that occurred",{"type":42,"tag":71,"props":437,"children":438},{},[439],{"type":48,"value":440},"Potential causes and suggested solutions",{"type":42,"tag":71,"props":442,"children":443},{},[444],{"type":48,"value":445},"The full HTTP request and response for the associated webhook",{"type":42,"tag":51,"props":447,"children":448},{},[449,454],{"type":42,"tag":141,"props":450,"children":451},{},[452],{"type":48,"value":453},"Configure a Debugger webhook",{"type":48,"value":455}," for real-time alerting:",{"type":42,"tag":51,"props":457,"children":458},{},[459],{"type":48,"value":460},"Console > Monitor > Logs > Debugger > (gear icon) > set Callback URL",{"type":42,"tag":51,"props":462,"children":463},{},[464],{"type":48,"value":465},"Debugger webhook POST parameters:",{"type":42,"tag":467,"props":468,"children":469},"table",{},[470,489],{"type":42,"tag":471,"props":472,"children":473},"thead",{},[474],{"type":42,"tag":475,"props":476,"children":477},"tr",{},[478,484],{"type":42,"tag":479,"props":480,"children":481},"th",{},[482],{"type":48,"value":483},"Parameter",{"type":42,"tag":479,"props":485,"children":486},{},[487],{"type":48,"value":488},"Description",{"type":42,"tag":490,"props":491,"children":492},"tbody",{},[493,511,528,557,574],{"type":42,"tag":475,"props":494,"children":495},{},[496,506],{"type":42,"tag":497,"props":498,"children":499},"td",{},[500],{"type":42,"tag":77,"props":501,"children":503},{"className":502},[],[504],{"type":48,"value":505},"Sid",{"type":42,"tag":497,"props":507,"children":508},{},[509],{"type":48,"value":510},"Debugger event identifier",{"type":42,"tag":475,"props":512,"children":513},{},[514,523],{"type":42,"tag":497,"props":515,"children":516},{},[517],{"type":42,"tag":77,"props":518,"children":520},{"className":519},[],[521],{"type":48,"value":522},"AccountSid",{"type":42,"tag":497,"props":524,"children":525},{},[526],{"type":48,"value":527},"Account that generated the event",{"type":42,"tag":475,"props":529,"children":530},{},[531,540],{"type":42,"tag":497,"props":532,"children":533},{},[534],{"type":42,"tag":77,"props":535,"children":537},{"className":536},[],[538],{"type":48,"value":539},"Level",{"type":42,"tag":497,"props":541,"children":542},{},[543,549,551],{"type":42,"tag":77,"props":544,"children":546},{"className":545},[],[547],{"type":48,"value":548},"Error",{"type":48,"value":550}," or ",{"type":42,"tag":77,"props":552,"children":554},{"className":553},[],[555],{"type":48,"value":556},"Warning",{"type":42,"tag":475,"props":558,"children":559},{},[560,569],{"type":42,"tag":497,"props":561,"children":562},{},[563],{"type":42,"tag":77,"props":564,"children":566},{"className":565},[],[567],{"type":48,"value":568},"Timestamp",{"type":42,"tag":497,"props":570,"children":571},{},[572],{"type":48,"value":573},"ISO 8601 time",{"type":42,"tag":475,"props":575,"children":576},{},[577,586],{"type":42,"tag":497,"props":578,"children":579},{},[580],{"type":42,"tag":77,"props":581,"children":583},{"className":582},[],[584],{"type":48,"value":585},"Payload",{"type":42,"tag":497,"props":587,"children":588},{},[589,591,597,599,605,606,612,613,619],{"type":48,"value":590},"JSON: ",{"type":42,"tag":77,"props":592,"children":594},{"className":593},[],[595],{"type":48,"value":596},"resource_sid",{"type":48,"value":598},", ",{"type":42,"tag":77,"props":600,"children":602},{"className":601},[],[603],{"type":48,"value":604},"error_code",{"type":48,"value":598},{"type":42,"tag":77,"props":607,"children":609},{"className":608},[],[610],{"type":48,"value":611},"more_info",{"type":48,"value":598},{"type":42,"tag":77,"props":614,"children":616},{"className":615},[],[617],{"type":48,"value":618},"webhook",{"type":48,"value":620}," (full request\u002Fresponse)",{"type":42,"tag":51,"props":622,"children":623},{},[624],{"type":42,"tag":141,"props":625,"children":626},{},[627],{"type":48,"value":628},"Python (Flask) -- debugger webhook handler",{"type":42,"tag":147,"props":630,"children":632},{"className":149,"code":631,"language":151,"meta":152,"style":152},"import json, os\nfrom flask import Flask, request\nfrom twilio.request_validator import RequestValidator\n\napp = Flask(__name__)\nvalidator = RequestValidator(os.environ[\"TWILIO_AUTH_TOKEN\"])\n\n@app.route(\"\u002Fdebugger\", methods=[\"POST\"])\ndef debugger_event():\n    sig = request.headers.get(\"X-Twilio-Signature\", \"\")\n    if not validator.validate(request.url, request.form, sig):\n        return \"Forbidden\", 403\n    level = request.form.get(\"Level\")\n    payload = json.loads(request.form.get(\"Payload\", \"{}\"))\n    error_code = payload.get(\"error_code\")\n    resource_sid = payload.get(\"resource_sid\")\n    msg = payload.get(\"more_info\", {}).get(\"msg\", \"\")\n    print(f\"[{level}] Error {error_code} on {resource_sid}: {msg}\")\n    return \"\", 204\n",[633],{"type":42,"tag":77,"props":634,"children":635},{"__ignoreMap":152},[636,644,652,660,667,675,683,690,698,707,716,725,734,743,752,761,770,779,788],{"type":42,"tag":158,"props":637,"children":638},{"class":160,"line":161},[639],{"type":42,"tag":158,"props":640,"children":641},{},[642],{"type":48,"value":643},"import json, os\n",{"type":42,"tag":158,"props":645,"children":646},{"class":160,"line":170},[647],{"type":42,"tag":158,"props":648,"children":649},{},[650],{"type":48,"value":651},"from flask import Flask, request\n",{"type":42,"tag":158,"props":653,"children":654},{"class":160,"line":179},[655],{"type":42,"tag":158,"props":656,"children":657},{},[658],{"type":48,"value":659},"from twilio.request_validator import RequestValidator\n",{"type":42,"tag":158,"props":661,"children":662},{"class":160,"line":189},[663],{"type":42,"tag":158,"props":664,"children":665},{"emptyLinePlaceholder":183},[666],{"type":48,"value":186},{"type":42,"tag":158,"props":668,"children":669},{"class":160,"line":198},[670],{"type":42,"tag":158,"props":671,"children":672},{},[673],{"type":48,"value":674},"app = Flask(__name__)\n",{"type":42,"tag":158,"props":676,"children":677},{"class":160,"line":206},[678],{"type":42,"tag":158,"props":679,"children":680},{},[681],{"type":48,"value":682},"validator = RequestValidator(os.environ[\"TWILIO_AUTH_TOKEN\"])\n",{"type":42,"tag":158,"props":684,"children":685},{"class":160,"line":215},[686],{"type":42,"tag":158,"props":687,"children":688},{"emptyLinePlaceholder":183},[689],{"type":48,"value":186},{"type":42,"tag":158,"props":691,"children":692},{"class":160,"line":224},[693],{"type":42,"tag":158,"props":694,"children":695},{},[696],{"type":48,"value":697},"@app.route(\"\u002Fdebugger\", methods=[\"POST\"])\n",{"type":42,"tag":158,"props":699,"children":701},{"class":160,"line":700},9,[702],{"type":42,"tag":158,"props":703,"children":704},{},[705],{"type":48,"value":706},"def debugger_event():\n",{"type":42,"tag":158,"props":708,"children":710},{"class":160,"line":709},10,[711],{"type":42,"tag":158,"props":712,"children":713},{},[714],{"type":48,"value":715},"    sig = request.headers.get(\"X-Twilio-Signature\", \"\")\n",{"type":42,"tag":158,"props":717,"children":719},{"class":160,"line":718},11,[720],{"type":42,"tag":158,"props":721,"children":722},{},[723],{"type":48,"value":724},"    if not validator.validate(request.url, request.form, sig):\n",{"type":42,"tag":158,"props":726,"children":728},{"class":160,"line":727},12,[729],{"type":42,"tag":158,"props":730,"children":731},{},[732],{"type":48,"value":733},"        return \"Forbidden\", 403\n",{"type":42,"tag":158,"props":735,"children":737},{"class":160,"line":736},13,[738],{"type":42,"tag":158,"props":739,"children":740},{},[741],{"type":48,"value":742},"    level = request.form.get(\"Level\")\n",{"type":42,"tag":158,"props":744,"children":746},{"class":160,"line":745},14,[747],{"type":42,"tag":158,"props":748,"children":749},{},[750],{"type":48,"value":751},"    payload = json.loads(request.form.get(\"Payload\", \"{}\"))\n",{"type":42,"tag":158,"props":753,"children":755},{"class":160,"line":754},15,[756],{"type":42,"tag":158,"props":757,"children":758},{},[759],{"type":48,"value":760},"    error_code = payload.get(\"error_code\")\n",{"type":42,"tag":158,"props":762,"children":764},{"class":160,"line":763},16,[765],{"type":42,"tag":158,"props":766,"children":767},{},[768],{"type":48,"value":769},"    resource_sid = payload.get(\"resource_sid\")\n",{"type":42,"tag":158,"props":771,"children":773},{"class":160,"line":772},17,[774],{"type":42,"tag":158,"props":775,"children":776},{},[777],{"type":48,"value":778},"    msg = payload.get(\"more_info\", {}).get(\"msg\", \"\")\n",{"type":42,"tag":158,"props":780,"children":782},{"class":160,"line":781},18,[783],{"type":42,"tag":158,"props":784,"children":785},{},[786],{"type":48,"value":787},"    print(f\"[{level}] Error {error_code} on {resource_sid}: {msg}\")\n",{"type":42,"tag":158,"props":789,"children":791},{"class":160,"line":790},19,[792],{"type":42,"tag":158,"props":793,"children":794},{},[795],{"type":48,"value":796},"    return \"\", 204\n",{"type":42,"tag":51,"props":798,"children":799},{},[800],{"type":42,"tag":141,"props":801,"children":802},{},[803],{"type":48,"value":804},"Node.js (Express) -- debugger webhook handler",{"type":42,"tag":147,"props":806,"children":808},{"className":241,"code":807,"language":243,"meta":152,"style":152},"const express = require(\"express\");\nconst twilio = require(\"twilio\");\nconst app = express();\napp.use(express.urlencoded({ extended: false }));\n\napp.post(\"\u002Fdebugger\", (req, res) => {\n    const valid = twilio.validateRequest(\n        process.env.TWILIO_AUTH_TOKEN,\n        req.headers[\"x-twilio-signature\"],\n        `https:\u002F\u002F${req.headers.host}${req.originalUrl}`,\n        req.body\n    );\n    if (!valid) return res.status(403).send(\"Forbidden\");\n    const payload = JSON.parse(req.body.Payload || \"{}\");\n    const { error_code, resource_sid } = payload;\n    const msg = payload.more_info?.msg || \"\";\n    console.log(`[${req.body.Level}] Error ${error_code} on ${resource_sid}: ${msg}`);\n    res.sendStatus(204);\n});\n",[809],{"type":42,"tag":77,"props":810,"children":811},{"__ignoreMap":152},[812,820,827,835,843,850,858,866,874,882,890,898,906,914,922,930,938,946,954],{"type":42,"tag":158,"props":813,"children":814},{"class":160,"line":161},[815],{"type":42,"tag":158,"props":816,"children":817},{},[818],{"type":48,"value":819},"const express = require(\"express\");\n",{"type":42,"tag":158,"props":821,"children":822},{"class":160,"line":170},[823],{"type":42,"tag":158,"props":824,"children":825},{},[826],{"type":48,"value":255},{"type":42,"tag":158,"props":828,"children":829},{"class":160,"line":179},[830],{"type":42,"tag":158,"props":831,"children":832},{},[833],{"type":48,"value":834},"const app = express();\n",{"type":42,"tag":158,"props":836,"children":837},{"class":160,"line":189},[838],{"type":42,"tag":158,"props":839,"children":840},{},[841],{"type":48,"value":842},"app.use(express.urlencoded({ extended: false }));\n",{"type":42,"tag":158,"props":844,"children":845},{"class":160,"line":198},[846],{"type":42,"tag":158,"props":847,"children":848},{"emptyLinePlaceholder":183},[849],{"type":48,"value":186},{"type":42,"tag":158,"props":851,"children":852},{"class":160,"line":206},[853],{"type":42,"tag":158,"props":854,"children":855},{},[856],{"type":48,"value":857},"app.post(\"\u002Fdebugger\", (req, res) => {\n",{"type":42,"tag":158,"props":859,"children":860},{"class":160,"line":215},[861],{"type":42,"tag":158,"props":862,"children":863},{},[864],{"type":48,"value":865},"    const valid = twilio.validateRequest(\n",{"type":42,"tag":158,"props":867,"children":868},{"class":160,"line":224},[869],{"type":42,"tag":158,"props":870,"children":871},{},[872],{"type":48,"value":873},"        process.env.TWILIO_AUTH_TOKEN,\n",{"type":42,"tag":158,"props":875,"children":876},{"class":160,"line":700},[877],{"type":42,"tag":158,"props":878,"children":879},{},[880],{"type":48,"value":881},"        req.headers[\"x-twilio-signature\"],\n",{"type":42,"tag":158,"props":883,"children":884},{"class":160,"line":709},[885],{"type":42,"tag":158,"props":886,"children":887},{},[888],{"type":48,"value":889},"        `https:\u002F\u002F${req.headers.host}${req.originalUrl}`,\n",{"type":42,"tag":158,"props":891,"children":892},{"class":160,"line":718},[893],{"type":42,"tag":158,"props":894,"children":895},{},[896],{"type":48,"value":897},"        req.body\n",{"type":42,"tag":158,"props":899,"children":900},{"class":160,"line":727},[901],{"type":42,"tag":158,"props":902,"children":903},{},[904],{"type":48,"value":905},"    );\n",{"type":42,"tag":158,"props":907,"children":908},{"class":160,"line":736},[909],{"type":42,"tag":158,"props":910,"children":911},{},[912],{"type":48,"value":913},"    if (!valid) return res.status(403).send(\"Forbidden\");\n",{"type":42,"tag":158,"props":915,"children":916},{"class":160,"line":745},[917],{"type":42,"tag":158,"props":918,"children":919},{},[920],{"type":48,"value":921},"    const payload = JSON.parse(req.body.Payload || \"{}\");\n",{"type":42,"tag":158,"props":923,"children":924},{"class":160,"line":754},[925],{"type":42,"tag":158,"props":926,"children":927},{},[928],{"type":48,"value":929},"    const { error_code, resource_sid } = payload;\n",{"type":42,"tag":158,"props":931,"children":932},{"class":160,"line":763},[933],{"type":42,"tag":158,"props":934,"children":935},{},[936],{"type":48,"value":937},"    const msg = payload.more_info?.msg || \"\";\n",{"type":42,"tag":158,"props":939,"children":940},{"class":160,"line":772},[941],{"type":42,"tag":158,"props":942,"children":943},{},[944],{"type":48,"value":945},"    console.log(`[${req.body.Level}] Error ${error_code} on ${resource_sid}: ${msg}`);\n",{"type":42,"tag":158,"props":947,"children":948},{"class":160,"line":781},[949],{"type":42,"tag":158,"props":950,"children":951},{},[952],{"type":48,"value":953},"    res.sendStatus(204);\n",{"type":42,"tag":158,"props":955,"children":956},{"class":160,"line":790},[957],{"type":42,"tag":158,"props":958,"children":959},{},[960],{"type":48,"value":302},{"type":42,"tag":313,"props":962,"children":964},{"id":963},"_3-monitor-alerts-api",[965],{"type":48,"value":966},"3. Monitor Alerts API",{"type":42,"tag":51,"props":968,"children":969},{},[970,972,978],{"type":48,"value":971},"The Monitor REST API (",{"type":42,"tag":77,"props":973,"children":975},{"className":974},[],[976],{"type":48,"value":977},"monitor.twilio.com\u002Fv1\u002FAlerts",{"type":48,"value":979},") provides programmatic access to error and warning logs. Individual alert instances include the full HTTP request and response data.",{"type":42,"tag":51,"props":981,"children":982},{},[983],{"type":42,"tag":141,"props":984,"children":985},{},[986],{"type":48,"value":987},"Python -- query alerts with date filtering",{"type":42,"tag":147,"props":989,"children":991},{"className":149,"code":990,"language":151,"meta":152,"style":152},"from datetime import datetime, timedelta\n\n# Alerts from the last 24 hours\nstart = datetime.utcnow() - timedelta(days=1)\nalerts = client.monitor.alerts.list(\n    start_date=start,\n    log_level=\"error\",\n    limit=50\n)\n\nfor alert in alerts:\n    print(f\"{alert.date_created} [{alert.error_code}]\")\n    # Fetch full details including HTTP request\u002Fresponse\n    detail = client.monitor.alerts(alert.sid).fetch()\n    print(f\"  Request URL: {detail.request_url}\")\n    print(f\"  Response body: {detail.response_body}\")\n",[992],{"type":42,"tag":77,"props":993,"children":994},{"__ignoreMap":152},[995,1003,1010,1018,1026,1034,1042,1050,1058,1066,1073,1080,1088,1096,1104,1112],{"type":42,"tag":158,"props":996,"children":997},{"class":160,"line":161},[998],{"type":42,"tag":158,"props":999,"children":1000},{},[1001],{"type":48,"value":1002},"from datetime import datetime, timedelta\n",{"type":42,"tag":158,"props":1004,"children":1005},{"class":160,"line":170},[1006],{"type":42,"tag":158,"props":1007,"children":1008},{"emptyLinePlaceholder":183},[1009],{"type":48,"value":186},{"type":42,"tag":158,"props":1011,"children":1012},{"class":160,"line":179},[1013],{"type":42,"tag":158,"props":1014,"children":1015},{},[1016],{"type":48,"value":1017},"# Alerts from the last 24 hours\n",{"type":42,"tag":158,"props":1019,"children":1020},{"class":160,"line":189},[1021],{"type":42,"tag":158,"props":1022,"children":1023},{},[1024],{"type":48,"value":1025},"start = datetime.utcnow() - timedelta(days=1)\n",{"type":42,"tag":158,"props":1027,"children":1028},{"class":160,"line":198},[1029],{"type":42,"tag":158,"props":1030,"children":1031},{},[1032],{"type":48,"value":1033},"alerts = client.monitor.alerts.list(\n",{"type":42,"tag":158,"props":1035,"children":1036},{"class":160,"line":206},[1037],{"type":42,"tag":158,"props":1038,"children":1039},{},[1040],{"type":48,"value":1041},"    start_date=start,\n",{"type":42,"tag":158,"props":1043,"children":1044},{"class":160,"line":215},[1045],{"type":42,"tag":158,"props":1046,"children":1047},{},[1048],{"type":48,"value":1049},"    log_level=\"error\",\n",{"type":42,"tag":158,"props":1051,"children":1052},{"class":160,"line":224},[1053],{"type":42,"tag":158,"props":1054,"children":1055},{},[1056],{"type":48,"value":1057},"    limit=50\n",{"type":42,"tag":158,"props":1059,"children":1060},{"class":160,"line":700},[1061],{"type":42,"tag":158,"props":1062,"children":1063},{},[1064],{"type":48,"value":1065},")\n",{"type":42,"tag":158,"props":1067,"children":1068},{"class":160,"line":709},[1069],{"type":42,"tag":158,"props":1070,"children":1071},{"emptyLinePlaceholder":183},[1072],{"type":48,"value":186},{"type":42,"tag":158,"props":1074,"children":1075},{"class":160,"line":718},[1076],{"type":42,"tag":158,"props":1077,"children":1078},{},[1079],{"type":48,"value":221},{"type":42,"tag":158,"props":1081,"children":1082},{"class":160,"line":727},[1083],{"type":42,"tag":158,"props":1084,"children":1085},{},[1086],{"type":48,"value":1087},"    print(f\"{alert.date_created} [{alert.error_code}]\")\n",{"type":42,"tag":158,"props":1089,"children":1090},{"class":160,"line":736},[1091],{"type":42,"tag":158,"props":1092,"children":1093},{},[1094],{"type":48,"value":1095},"    # Fetch full details including HTTP request\u002Fresponse\n",{"type":42,"tag":158,"props":1097,"children":1098},{"class":160,"line":745},[1099],{"type":42,"tag":158,"props":1100,"children":1101},{},[1102],{"type":48,"value":1103},"    detail = client.monitor.alerts(alert.sid).fetch()\n",{"type":42,"tag":158,"props":1105,"children":1106},{"class":160,"line":754},[1107],{"type":42,"tag":158,"props":1108,"children":1109},{},[1110],{"type":48,"value":1111},"    print(f\"  Request URL: {detail.request_url}\")\n",{"type":42,"tag":158,"props":1113,"children":1114},{"class":160,"line":763},[1115],{"type":42,"tag":158,"props":1116,"children":1117},{},[1118],{"type":48,"value":1119},"    print(f\"  Response body: {detail.response_body}\")\n",{"type":42,"tag":51,"props":1121,"children":1122},{},[1123],{"type":42,"tag":141,"props":1124,"children":1125},{},[1126],{"type":48,"value":1127},"Node.js -- query alerts with date filtering",{"type":42,"tag":147,"props":1129,"children":1131},{"className":241,"code":1130,"language":243,"meta":152,"style":152},"const startDate = new Date(Date.now() - 24 * 60 * 60 * 1000);\nconst alerts = await client.monitor.alerts.list({\n    startDate,\n    logLevel: \"error\",\n    limit: 50,\n});\n\nfor (const alert of alerts) {\n    console.log(`${alert.dateCreated} [${alert.errorCode}]`);\n    const detail = await client.monitor.alerts(alert.sid).fetch();\n    console.log(`  Request URL: ${detail.requestUrl}`);\n    console.log(`  Response body: ${detail.responseBody}`);\n}\n",[1132],{"type":42,"tag":77,"props":1133,"children":1134},{"__ignoreMap":152},[1135,1143,1151,1159,1167,1175,1182,1189,1197,1205,1213,1221,1229],{"type":42,"tag":158,"props":1136,"children":1137},{"class":160,"line":161},[1138],{"type":42,"tag":158,"props":1139,"children":1140},{},[1141],{"type":48,"value":1142},"const startDate = new Date(Date.now() - 24 * 60 * 60 * 1000);\n",{"type":42,"tag":158,"props":1144,"children":1145},{"class":160,"line":170},[1146],{"type":42,"tag":158,"props":1147,"children":1148},{},[1149],{"type":48,"value":1150},"const alerts = await client.monitor.alerts.list({\n",{"type":42,"tag":158,"props":1152,"children":1153},{"class":160,"line":179},[1154],{"type":42,"tag":158,"props":1155,"children":1156},{},[1157],{"type":48,"value":1158},"    startDate,\n",{"type":42,"tag":158,"props":1160,"children":1161},{"class":160,"line":189},[1162],{"type":42,"tag":158,"props":1163,"children":1164},{},[1165],{"type":48,"value":1166},"    logLevel: \"error\",\n",{"type":42,"tag":158,"props":1168,"children":1169},{"class":160,"line":198},[1170],{"type":42,"tag":158,"props":1171,"children":1172},{},[1173],{"type":48,"value":1174},"    limit: 50,\n",{"type":42,"tag":158,"props":1176,"children":1177},{"class":160,"line":206},[1178],{"type":42,"tag":158,"props":1179,"children":1180},{},[1181],{"type":48,"value":302},{"type":42,"tag":158,"props":1183,"children":1184},{"class":160,"line":215},[1185],{"type":42,"tag":158,"props":1186,"children":1187},{"emptyLinePlaceholder":183},[1188],{"type":48,"value":186},{"type":42,"tag":158,"props":1190,"children":1191},{"class":160,"line":224},[1192],{"type":42,"tag":158,"props":1193,"children":1194},{},[1195],{"type":48,"value":1196},"for (const alert of alerts) {\n",{"type":42,"tag":158,"props":1198,"children":1199},{"class":160,"line":700},[1200],{"type":42,"tag":158,"props":1201,"children":1202},{},[1203],{"type":48,"value":1204},"    console.log(`${alert.dateCreated} [${alert.errorCode}]`);\n",{"type":42,"tag":158,"props":1206,"children":1207},{"class":160,"line":709},[1208],{"type":42,"tag":158,"props":1209,"children":1210},{},[1211],{"type":48,"value":1212},"    const detail = await client.monitor.alerts(alert.sid).fetch();\n",{"type":42,"tag":158,"props":1214,"children":1215},{"class":160,"line":718},[1216],{"type":42,"tag":158,"props":1217,"children":1218},{},[1219],{"type":48,"value":1220},"    console.log(`  Request URL: ${detail.requestUrl}`);\n",{"type":42,"tag":158,"props":1222,"children":1223},{"class":160,"line":727},[1224],{"type":42,"tag":158,"props":1225,"children":1226},{},[1227],{"type":48,"value":1228},"    console.log(`  Response body: ${detail.responseBody}`);\n",{"type":42,"tag":158,"props":1230,"children":1231},{"class":160,"line":736},[1232],{"type":42,"tag":158,"props":1233,"children":1234},{},[1235],{"type":48,"value":1236},"}\n",{"type":42,"tag":51,"props":1238,"children":1239},{},[1240,1245],{"type":42,"tag":141,"props":1241,"children":1242},{},[1243],{"type":48,"value":1244},"Retention:",{"type":48,"value":1246}," Enterprise accounts: 13 months. Free accounts: 30 days.",{"type":42,"tag":313,"props":1248,"children":1250},{"id":1249},"_4-monitor-events-api",[1251],{"type":48,"value":1252},"4. Monitor Events API",{"type":42,"tag":51,"props":1254,"children":1255},{},[1256,1258,1264],{"type":48,"value":1257},"The Events resource (",{"type":42,"tag":77,"props":1259,"children":1261},{"className":1260},[],[1262],{"type":48,"value":1263},"monitor.twilio.com\u002Fv1\u002FEvents",{"type":48,"value":1265},") tracks all changes to Twilio resources -- phone number provisioning, account settings, recording access, API key creation, and more.",{"type":42,"tag":51,"props":1267,"children":1268},{},[1269],{"type":42,"tag":141,"props":1270,"children":1271},{},[1272],{"type":48,"value":1273},"Python -- audit recent account changes",{"type":42,"tag":147,"props":1275,"children":1277},{"className":149,"code":1276,"language":151,"meta":152,"style":152},"events = client.monitor.events.list(limit=20)\nfor event in events:\n    print(f\"{event.event_date}: {event.event_type}\")\n    print(f\"  Resource: {event.resource_type} ({event.resource_sid})\")\n    print(f\"  Actor: {event.actor_type} ({event.actor_sid}) from {event.source_ip_address}\")\n",[1278],{"type":42,"tag":77,"props":1279,"children":1280},{"__ignoreMap":152},[1281,1289,1297,1305,1313],{"type":42,"tag":158,"props":1282,"children":1283},{"class":160,"line":161},[1284],{"type":42,"tag":158,"props":1285,"children":1286},{},[1287],{"type":48,"value":1288},"events = client.monitor.events.list(limit=20)\n",{"type":42,"tag":158,"props":1290,"children":1291},{"class":160,"line":170},[1292],{"type":42,"tag":158,"props":1293,"children":1294},{},[1295],{"type":48,"value":1296},"for event in events:\n",{"type":42,"tag":158,"props":1298,"children":1299},{"class":160,"line":179},[1300],{"type":42,"tag":158,"props":1301,"children":1302},{},[1303],{"type":48,"value":1304},"    print(f\"{event.event_date}: {event.event_type}\")\n",{"type":42,"tag":158,"props":1306,"children":1307},{"class":160,"line":189},[1308],{"type":42,"tag":158,"props":1309,"children":1310},{},[1311],{"type":48,"value":1312},"    print(f\"  Resource: {event.resource_type} ({event.resource_sid})\")\n",{"type":42,"tag":158,"props":1314,"children":1315},{"class":160,"line":198},[1316],{"type":42,"tag":158,"props":1317,"children":1318},{},[1319],{"type":48,"value":1320},"    print(f\"  Actor: {event.actor_type} ({event.actor_sid}) from {event.source_ip_address}\")\n",{"type":42,"tag":51,"props":1322,"children":1323},{},[1324],{"type":48,"value":1325},"Each event captures: event type, resource, actor (who triggered it), source (API \u002F Console \u002F Twilio admin), and IP address.",{"type":42,"tag":51,"props":1327,"children":1328},{},[1329],{"type":42,"tag":141,"props":1330,"children":1331},{},[1332],{"type":48,"value":1333},"Use cases:",{"type":42,"tag":67,"props":1335,"children":1336},{},[1337,1342,1347,1352],{"type":42,"tag":71,"props":1338,"children":1339},{},[1340],{"type":48,"value":1341},"Audit who changed a phone number's webhook URL",{"type":42,"tag":71,"props":1343,"children":1344},{},[1345],{"type":48,"value":1346},"Track API key creation and deletion",{"type":42,"tag":71,"props":1348,"children":1349},{},[1350],{"type":48,"value":1351},"Detect unexpected configuration changes",{"type":42,"tag":71,"props":1353,"children":1354},{},[1355],{"type":48,"value":1356},"Feed events into a SIEM for security monitoring",{"type":42,"tag":313,"props":1358,"children":1360},{"id":1359},"_5-event-streams-for-error-log-streaming",[1361],{"type":48,"value":1362},"5. Event Streams for Error Log Streaming",{"type":42,"tag":51,"props":1364,"children":1365},{},[1366,1368,1374,1375,1381],{"type":48,"value":1367},"For production monitoring, stream errors to your infrastructure in real time using Event Streams. The Twilio SDK does not wrap Event Streams -- use ",{"type":42,"tag":77,"props":1369,"children":1371},{"className":1370},[],[1372],{"type":48,"value":1373},"requests",{"type":48,"value":111},{"type":42,"tag":77,"props":1376,"children":1378},{"className":1377},[],[1379],{"type":48,"value":1380},"fetch",{"type":48,"value":1382}," directly.",{"type":42,"tag":51,"props":1384,"children":1385},{},[1386],{"type":42,"tag":141,"props":1387,"children":1388},{},[1389],{"type":48,"value":1390},"Python -- set up error log streaming to a webhook",{"type":42,"tag":147,"props":1392,"children":1394},{"className":149,"code":1393,"language":151,"meta":152,"style":152},"import os, requests\n\naccount_sid = os.environ[\"TWILIO_ACCOUNT_SID\"]\nauth_token = os.environ[\"TWILIO_AUTH_TOKEN\"]\n\n# Step 1: Create a webhook sink\nsink = requests.post(\n    \"https:\u002F\u002Fevents.twilio.com\u002Fv1\u002FSinks\",\n    auth=(account_sid, auth_token),\n    data={\n        \"Description\": \"Error monitoring sink\",\n        \"SinkType\": \"webhook\",\n        \"SinkConfiguration\": '{\"destination\": \"https:\u002F\u002Fyourapp.com\u002Ftwilio-errors\", \"method\": \"POST\"}'\n    }\n).json()\n\n# Step 2: Subscribe to error log events\nsubscription = requests.post(\n    \"https:\u002F\u002Fevents.twilio.com\u002Fv1\u002FSubscriptions\",\n    auth=(account_sid, auth_token),\n    data={\n        \"Description\": \"Error log subscription\",\n        \"SinkSid\": sink[\"sid\"],\n        \"Types\": '[{\"type\": \"com.twilio.error-logs.error.logged\"}]'\n    }\n).json()\n\nprint(f\"Sink: {sink['sid']}, Subscription: {subscription['sid']}\")\n",[1395],{"type":42,"tag":77,"props":1396,"children":1397},{"__ignoreMap":152},[1398,1406,1413,1421,1429,1436,1444,1452,1460,1468,1476,1484,1492,1500,1508,1516,1523,1531,1539,1547,1555,1563,1572,1581,1590,1598,1606,1614],{"type":42,"tag":158,"props":1399,"children":1400},{"class":160,"line":161},[1401],{"type":42,"tag":158,"props":1402,"children":1403},{},[1404],{"type":48,"value":1405},"import os, requests\n",{"type":42,"tag":158,"props":1407,"children":1408},{"class":160,"line":170},[1409],{"type":42,"tag":158,"props":1410,"children":1411},{"emptyLinePlaceholder":183},[1412],{"type":48,"value":186},{"type":42,"tag":158,"props":1414,"children":1415},{"class":160,"line":179},[1416],{"type":42,"tag":158,"props":1417,"children":1418},{},[1419],{"type":48,"value":1420},"account_sid = os.environ[\"TWILIO_ACCOUNT_SID\"]\n",{"type":42,"tag":158,"props":1422,"children":1423},{"class":160,"line":189},[1424],{"type":42,"tag":158,"props":1425,"children":1426},{},[1427],{"type":48,"value":1428},"auth_token = os.environ[\"TWILIO_AUTH_TOKEN\"]\n",{"type":42,"tag":158,"props":1430,"children":1431},{"class":160,"line":198},[1432],{"type":42,"tag":158,"props":1433,"children":1434},{"emptyLinePlaceholder":183},[1435],{"type":48,"value":186},{"type":42,"tag":158,"props":1437,"children":1438},{"class":160,"line":206},[1439],{"type":42,"tag":158,"props":1440,"children":1441},{},[1442],{"type":48,"value":1443},"# Step 1: Create a webhook sink\n",{"type":42,"tag":158,"props":1445,"children":1446},{"class":160,"line":215},[1447],{"type":42,"tag":158,"props":1448,"children":1449},{},[1450],{"type":48,"value":1451},"sink = requests.post(\n",{"type":42,"tag":158,"props":1453,"children":1454},{"class":160,"line":224},[1455],{"type":42,"tag":158,"props":1456,"children":1457},{},[1458],{"type":48,"value":1459},"    \"https:\u002F\u002Fevents.twilio.com\u002Fv1\u002FSinks\",\n",{"type":42,"tag":158,"props":1461,"children":1462},{"class":160,"line":700},[1463],{"type":42,"tag":158,"props":1464,"children":1465},{},[1466],{"type":48,"value":1467},"    auth=(account_sid, auth_token),\n",{"type":42,"tag":158,"props":1469,"children":1470},{"class":160,"line":709},[1471],{"type":42,"tag":158,"props":1472,"children":1473},{},[1474],{"type":48,"value":1475},"    data={\n",{"type":42,"tag":158,"props":1477,"children":1478},{"class":160,"line":718},[1479],{"type":42,"tag":158,"props":1480,"children":1481},{},[1482],{"type":48,"value":1483},"        \"Description\": \"Error monitoring sink\",\n",{"type":42,"tag":158,"props":1485,"children":1486},{"class":160,"line":727},[1487],{"type":42,"tag":158,"props":1488,"children":1489},{},[1490],{"type":48,"value":1491},"        \"SinkType\": \"webhook\",\n",{"type":42,"tag":158,"props":1493,"children":1494},{"class":160,"line":736},[1495],{"type":42,"tag":158,"props":1496,"children":1497},{},[1498],{"type":48,"value":1499},"        \"SinkConfiguration\": '{\"destination\": \"https:\u002F\u002Fyourapp.com\u002Ftwilio-errors\", \"method\": \"POST\"}'\n",{"type":42,"tag":158,"props":1501,"children":1502},{"class":160,"line":745},[1503],{"type":42,"tag":158,"props":1504,"children":1505},{},[1506],{"type":48,"value":1507},"    }\n",{"type":42,"tag":158,"props":1509,"children":1510},{"class":160,"line":754},[1511],{"type":42,"tag":158,"props":1512,"children":1513},{},[1514],{"type":48,"value":1515},").json()\n",{"type":42,"tag":158,"props":1517,"children":1518},{"class":160,"line":763},[1519],{"type":42,"tag":158,"props":1520,"children":1521},{"emptyLinePlaceholder":183},[1522],{"type":48,"value":186},{"type":42,"tag":158,"props":1524,"children":1525},{"class":160,"line":772},[1526],{"type":42,"tag":158,"props":1527,"children":1528},{},[1529],{"type":48,"value":1530},"# Step 2: Subscribe to error log events\n",{"type":42,"tag":158,"props":1532,"children":1533},{"class":160,"line":781},[1534],{"type":42,"tag":158,"props":1535,"children":1536},{},[1537],{"type":48,"value":1538},"subscription = requests.post(\n",{"type":42,"tag":158,"props":1540,"children":1541},{"class":160,"line":790},[1542],{"type":42,"tag":158,"props":1543,"children":1544},{},[1545],{"type":48,"value":1546},"    \"https:\u002F\u002Fevents.twilio.com\u002Fv1\u002FSubscriptions\",\n",{"type":42,"tag":158,"props":1548,"children":1550},{"class":160,"line":1549},20,[1551],{"type":42,"tag":158,"props":1552,"children":1553},{},[1554],{"type":48,"value":1467},{"type":42,"tag":158,"props":1556,"children":1558},{"class":160,"line":1557},21,[1559],{"type":42,"tag":158,"props":1560,"children":1561},{},[1562],{"type":48,"value":1475},{"type":42,"tag":158,"props":1564,"children":1566},{"class":160,"line":1565},22,[1567],{"type":42,"tag":158,"props":1568,"children":1569},{},[1570],{"type":48,"value":1571},"        \"Description\": \"Error log subscription\",\n",{"type":42,"tag":158,"props":1573,"children":1575},{"class":160,"line":1574},23,[1576],{"type":42,"tag":158,"props":1577,"children":1578},{},[1579],{"type":48,"value":1580},"        \"SinkSid\": sink[\"sid\"],\n",{"type":42,"tag":158,"props":1582,"children":1584},{"class":160,"line":1583},24,[1585],{"type":42,"tag":158,"props":1586,"children":1587},{},[1588],{"type":48,"value":1589},"        \"Types\": '[{\"type\": \"com.twilio.error-logs.error.logged\"}]'\n",{"type":42,"tag":158,"props":1591,"children":1593},{"class":160,"line":1592},25,[1594],{"type":42,"tag":158,"props":1595,"children":1596},{},[1597],{"type":48,"value":1507},{"type":42,"tag":158,"props":1599,"children":1601},{"class":160,"line":1600},26,[1602],{"type":42,"tag":158,"props":1603,"children":1604},{},[1605],{"type":48,"value":1515},{"type":42,"tag":158,"props":1607,"children":1609},{"class":160,"line":1608},27,[1610],{"type":42,"tag":158,"props":1611,"children":1612},{"emptyLinePlaceholder":183},[1613],{"type":48,"value":186},{"type":42,"tag":158,"props":1615,"children":1617},{"class":160,"line":1616},28,[1618],{"type":42,"tag":158,"props":1619,"children":1620},{},[1621],{"type":48,"value":1622},"print(f\"Sink: {sink['sid']}, Subscription: {subscription['sid']}\")\n",{"type":42,"tag":51,"props":1624,"children":1625},{},[1626,1631,1633,1638,1639,1645,1646],{"type":42,"tag":141,"props":1627,"children":1628},{},[1629],{"type":48,"value":1630},"Sink types:",{"type":48,"value":1632}," ",{"type":42,"tag":77,"props":1634,"children":1636},{"className":1635},[],[1637],{"type":48,"value":618},{"type":48,"value":598},{"type":42,"tag":77,"props":1640,"children":1642},{"className":1641},[],[1643],{"type":48,"value":1644},"kinesis",{"type":48,"value":598},{"type":42,"tag":77,"props":1647,"children":1649},{"className":1648},[],[1650],{"type":48,"value":1651},"segment",{"type":42,"tag":51,"props":1653,"children":1654},{},[1655],{"type":42,"tag":141,"props":1656,"children":1657},{},[1658],{"type":48,"value":1659},"Useful event types for observability:",{"type":42,"tag":467,"props":1661,"children":1662},{},[1663,1678],{"type":42,"tag":471,"props":1664,"children":1665},{},[1666],{"type":42,"tag":475,"props":1667,"children":1668},{},[1669,1674],{"type":42,"tag":479,"props":1670,"children":1671},{},[1672],{"type":48,"value":1673},"Event type",{"type":42,"tag":479,"props":1675,"children":1676},{},[1677],{"type":48,"value":488},{"type":42,"tag":490,"props":1679,"children":1680},{},[1681,1698,1715,1732],{"type":42,"tag":475,"props":1682,"children":1683},{},[1684,1693],{"type":42,"tag":497,"props":1685,"children":1686},{},[1687],{"type":42,"tag":77,"props":1688,"children":1690},{"className":1689},[],[1691],{"type":48,"value":1692},"com.twilio.error-logs.error.logged",{"type":42,"tag":497,"props":1694,"children":1695},{},[1696],{"type":48,"value":1697},"All errors and warnings on account",{"type":42,"tag":475,"props":1699,"children":1700},{},[1701,1710],{"type":42,"tag":497,"props":1702,"children":1703},{},[1704],{"type":42,"tag":77,"props":1705,"children":1707},{"className":1706},[],[1708],{"type":48,"value":1709},"com.twilio.messaging.message.delivered",{"type":42,"tag":497,"props":1711,"children":1712},{},[1713],{"type":48,"value":1714},"Message delivered successfully",{"type":42,"tag":475,"props":1716,"children":1717},{},[1718,1727],{"type":42,"tag":497,"props":1719,"children":1720},{},[1721],{"type":42,"tag":77,"props":1722,"children":1724},{"className":1723},[],[1725],{"type":48,"value":1726},"com.twilio.messaging.message.undelivered",{"type":42,"tag":497,"props":1728,"children":1729},{},[1730],{"type":48,"value":1731},"Message delivery failed",{"type":42,"tag":475,"props":1733,"children":1734},{},[1735,1744],{"type":42,"tag":497,"props":1736,"children":1737},{},[1738],{"type":42,"tag":77,"props":1739,"children":1741},{"className":1740},[],[1742],{"type":48,"value":1743},"com.twilio.voice.insights.call-summary",{"type":42,"tag":497,"props":1745,"children":1746},{},[1747],{"type":48,"value":1748},"Post-call quality and status summary",{"type":42,"tag":313,"props":1750,"children":1752},{"id":1751},"_6-status-callback-monitoring",[1753],{"type":48,"value":1754},"6. Status Callback Monitoring",{"type":42,"tag":51,"props":1756,"children":1757},{},[1758],{"type":48,"value":1759},"Status callbacks are the most granular observability mechanism -- they fire for individual resource state changes.",{"type":42,"tag":51,"props":1761,"children":1762},{},[1763],{"type":42,"tag":141,"props":1764,"children":1765},{},[1766],{"type":48,"value":1767},"Message delivery tracking:",{"type":42,"tag":147,"props":1769,"children":1771},{"className":149,"code":1770,"language":151,"meta":152,"style":152},"# Attach when sending\nmessage = client.messages.create(\n    to=\"+15558675310\", from_=\"+15017122661\", body=\"Hello!\",\n    status_callback=\"https:\u002F\u002Fyourapp.com\u002Fmsg-status\"\n)\n",[1772],{"type":42,"tag":77,"props":1773,"children":1774},{"__ignoreMap":152},[1775,1783,1791,1799,1807],{"type":42,"tag":158,"props":1776,"children":1777},{"class":160,"line":161},[1778],{"type":42,"tag":158,"props":1779,"children":1780},{},[1781],{"type":48,"value":1782},"# Attach when sending\n",{"type":42,"tag":158,"props":1784,"children":1785},{"class":160,"line":170},[1786],{"type":42,"tag":158,"props":1787,"children":1788},{},[1789],{"type":48,"value":1790},"message = client.messages.create(\n",{"type":42,"tag":158,"props":1792,"children":1793},{"class":160,"line":179},[1794],{"type":42,"tag":158,"props":1795,"children":1796},{},[1797],{"type":48,"value":1798},"    to=\"+15558675310\", from_=\"+15017122661\", body=\"Hello!\",\n",{"type":42,"tag":158,"props":1800,"children":1801},{"class":160,"line":189},[1802],{"type":42,"tag":158,"props":1803,"children":1804},{},[1805],{"type":48,"value":1806},"    status_callback=\"https:\u002F\u002Fyourapp.com\u002Fmsg-status\"\n",{"type":42,"tag":158,"props":1808,"children":1809},{"class":160,"line":198},[1810],{"type":42,"tag":158,"props":1811,"children":1812},{},[1813],{"type":48,"value":1065},{"type":42,"tag":51,"props":1815,"children":1816},{},[1817],{"type":42,"tag":141,"props":1818,"children":1819},{},[1820],{"type":48,"value":1821},"Call lifecycle tracking:",{"type":42,"tag":147,"props":1823,"children":1825},{"className":149,"code":1824,"language":151,"meta":152,"style":152},"call = client.calls.create(\n    to=\"+15558675310\", from_=\"+15017122661\",\n    url=\"https:\u002F\u002Fyourapp.com\u002Fvoice\",\n    status_callback=\"https:\u002F\u002Fyourapp.com\u002Fcall-status\",\n    status_callback_event=[\"initiated\", \"ringing\", \"answered\", \"completed\"]\n)\n",[1826],{"type":42,"tag":77,"props":1827,"children":1828},{"__ignoreMap":152},[1829,1837,1845,1853,1861,1869],{"type":42,"tag":158,"props":1830,"children":1831},{"class":160,"line":161},[1832],{"type":42,"tag":158,"props":1833,"children":1834},{},[1835],{"type":48,"value":1836},"call = client.calls.create(\n",{"type":42,"tag":158,"props":1838,"children":1839},{"class":160,"line":170},[1840],{"type":42,"tag":158,"props":1841,"children":1842},{},[1843],{"type":48,"value":1844},"    to=\"+15558675310\", from_=\"+15017122661\",\n",{"type":42,"tag":158,"props":1846,"children":1847},{"class":160,"line":179},[1848],{"type":42,"tag":158,"props":1849,"children":1850},{},[1851],{"type":48,"value":1852},"    url=\"https:\u002F\u002Fyourapp.com\u002Fvoice\",\n",{"type":42,"tag":158,"props":1854,"children":1855},{"class":160,"line":189},[1856],{"type":42,"tag":158,"props":1857,"children":1858},{},[1859],{"type":48,"value":1860},"    status_callback=\"https:\u002F\u002Fyourapp.com\u002Fcall-status\",\n",{"type":42,"tag":158,"props":1862,"children":1863},{"class":160,"line":198},[1864],{"type":42,"tag":158,"props":1865,"children":1866},{},[1867],{"type":48,"value":1868},"    status_callback_event=[\"initiated\", \"ringing\", \"answered\", \"completed\"]\n",{"type":42,"tag":158,"props":1870,"children":1871},{"class":160,"line":206},[1872],{"type":42,"tag":158,"props":1873,"children":1874},{},[1875],{"type":48,"value":1065},{"type":42,"tag":51,"props":1877,"children":1878},{},[1879],{"type":42,"tag":141,"props":1880,"children":1881},{},[1882],{"type":48,"value":1883},"Recording completion tracking:",{"type":42,"tag":147,"props":1885,"children":1887},{"className":149,"code":1886,"language":151,"meta":152,"style":152},"# In TwiML\nresponse = VoiceResponse()\nresponse.record(\n    recording_status_callback=\"https:\u002F\u002Fyourapp.com\u002Frecording-status\",\n    recording_status_callback_event=\"completed absent failed\"\n)\n",[1888],{"type":42,"tag":77,"props":1889,"children":1890},{"__ignoreMap":152},[1891,1899,1907,1915,1923,1931],{"type":42,"tag":158,"props":1892,"children":1893},{"class":160,"line":161},[1894],{"type":42,"tag":158,"props":1895,"children":1896},{},[1897],{"type":48,"value":1898},"# In TwiML\n",{"type":42,"tag":158,"props":1900,"children":1901},{"class":160,"line":170},[1902],{"type":42,"tag":158,"props":1903,"children":1904},{},[1905],{"type":48,"value":1906},"response = VoiceResponse()\n",{"type":42,"tag":158,"props":1908,"children":1909},{"class":160,"line":179},[1910],{"type":42,"tag":158,"props":1911,"children":1912},{},[1913],{"type":48,"value":1914},"response.record(\n",{"type":42,"tag":158,"props":1916,"children":1917},{"class":160,"line":189},[1918],{"type":42,"tag":158,"props":1919,"children":1920},{},[1921],{"type":48,"value":1922},"    recording_status_callback=\"https:\u002F\u002Fyourapp.com\u002Frecording-status\",\n",{"type":42,"tag":158,"props":1924,"children":1925},{"class":160,"line":198},[1926],{"type":42,"tag":158,"props":1927,"children":1928},{},[1929],{"type":48,"value":1930},"    recording_status_callback_event=\"completed absent failed\"\n",{"type":42,"tag":158,"props":1932,"children":1933},{"class":160,"line":206},[1934],{"type":42,"tag":158,"props":1935,"children":1936},{},[1937],{"type":48,"value":1065},{"type":42,"tag":51,"props":1939,"children":1940},{},[1941,1943,1949,1950,1956,1957,1963,1964,1970,1972,1978,1980,1985],{"type":48,"value":1942},"Recording status values: ",{"type":42,"tag":77,"props":1944,"children":1946},{"className":1945},[],[1947],{"type":48,"value":1948},"in-progress",{"type":48,"value":598},{"type":42,"tag":77,"props":1951,"children":1953},{"className":1952},[],[1954],{"type":48,"value":1955},"completed",{"type":48,"value":598},{"type":42,"tag":77,"props":1958,"children":1960},{"className":1959},[],[1961],{"type":48,"value":1962},"absent",{"type":48,"value":598},{"type":42,"tag":77,"props":1965,"children":1967},{"className":1966},[],[1968],{"type":48,"value":1969},"failed",{"type":48,"value":1971},". The ",{"type":42,"tag":77,"props":1973,"children":1975},{"className":1974},[],[1976],{"type":48,"value":1977},"RecordingUrl",{"type":48,"value":1979}," is available when status is ",{"type":42,"tag":77,"props":1981,"children":1983},{"className":1982},[],[1984],{"type":48,"value":1955},{"type":48,"value":1986},".",{"type":42,"tag":313,"props":1988,"children":1990},{"id":1989},"_7-debugging-webhooks",[1991],{"type":48,"value":1992},"7. Debugging Webhooks",{"type":42,"tag":51,"props":1994,"children":1995},{},[1996],{"type":48,"value":1997},"When Twilio can't reach your webhook or receives an error, the problem is often in your infrastructure.",{"type":42,"tag":51,"props":1999,"children":2000},{},[2001],{"type":42,"tag":141,"props":2002,"children":2003},{},[2004],{"type":48,"value":2005},"Common causes and fixes:",{"type":42,"tag":467,"props":2007,"children":2008},{},[2009,2030],{"type":42,"tag":471,"props":2010,"children":2011},{},[2012],{"type":42,"tag":475,"props":2013,"children":2014},{},[2015,2020,2025],{"type":42,"tag":479,"props":2016,"children":2017},{},[2018],{"type":48,"value":2019},"Symptom",{"type":42,"tag":479,"props":2021,"children":2022},{},[2023],{"type":48,"value":2024},"Likely cause",{"type":42,"tag":479,"props":2026,"children":2027},{},[2028],{"type":48,"value":2029},"Fix",{"type":42,"tag":490,"props":2031,"children":2032},{},[2033,2057,2080,2098,2124,2150],{"type":42,"tag":475,"props":2034,"children":2035},{},[2036,2041,2046],{"type":42,"tag":497,"props":2037,"children":2038},{},[2039],{"type":48,"value":2040},"Error 11200 in Debugger",{"type":42,"tag":497,"props":2042,"children":2043},{},[2044],{"type":48,"value":2045},"Webhook URL returned non-200 \u002F unreachable",{"type":42,"tag":497,"props":2047,"children":2048},{},[2049,2051],{"type":48,"value":2050},"Verify endpoint is live: ",{"type":42,"tag":77,"props":2052,"children":2054},{"className":2053},[],[2055],{"type":48,"value":2056},"curl -I https:\u002F\u002Fyourapp.com\u002Fsms",{"type":42,"tag":475,"props":2058,"children":2059},{},[2060,2065,2070],{"type":42,"tag":497,"props":2061,"children":2062},{},[2063],{"type":48,"value":2064},"Error 11205",{"type":42,"tag":497,"props":2066,"children":2067},{},[2068],{"type":48,"value":2069},"HTTP connection failure (port closed, refused, firewall)",{"type":42,"tag":497,"props":2071,"children":2072},{},[2073,2075],{"type":48,"value":2074},"Verify server is running and port is open: ",{"type":42,"tag":77,"props":2076,"children":2078},{"className":2077},[],[2079],{"type":48,"value":2056},{"type":42,"tag":475,"props":2081,"children":2082},{},[2083,2088,2093],{"type":42,"tag":497,"props":2084,"children":2085},{},[2086],{"type":48,"value":2087},"Error 12100",{"type":42,"tag":497,"props":2089,"children":2090},{},[2091],{"type":48,"value":2092},"TwiML document could not be parsed",{"type":42,"tag":497,"props":2094,"children":2095},{},[2096],{"type":48,"value":2097},"Check for debug output, BOM characters, or malformed XML",{"type":42,"tag":475,"props":2099,"children":2100},{},[2101,2106,2111],{"type":42,"tag":497,"props":2102,"children":2103},{},[2104],{"type":48,"value":2105},"Parameters missing after redirect",{"type":42,"tag":497,"props":2107,"children":2108},{},[2109],{"type":48,"value":2110},"HTTP 301\u002F302 strips POST body",{"type":42,"tag":497,"props":2112,"children":2113},{},[2114,2116,2122],{"type":48,"value":2115},"Fix URL to avoid redirect (add\u002Fremove ",{"type":42,"tag":77,"props":2117,"children":2119},{"className":2118},[],[2120],{"type":48,"value":2121},"www.",{"type":48,"value":2123},", use HTTPS directly)",{"type":42,"tag":475,"props":2125,"children":2126},{},[2127,2132,2137],{"type":42,"tag":497,"props":2128,"children":2129},{},[2130],{"type":48,"value":2131},"Webhook works locally but not deployed",{"type":42,"tag":497,"props":2133,"children":2134},{},[2135],{"type":48,"value":2136},"Tunnel expired or firewall",{"type":42,"tag":497,"props":2138,"children":2139},{},[2140,2142,2148],{"type":48,"value":2141},"Use ",{"type":42,"tag":77,"props":2143,"children":2145},{"className":2144},[],[2146],{"type":48,"value":2147},"curl",{"type":48,"value":2149}," from an external host to test",{"type":42,"tag":475,"props":2151,"children":2152},{},[2153,2158,2163],{"type":42,"tag":497,"props":2154,"children":2155},{},[2156],{"type":48,"value":2157},"Intermittent failures",{"type":42,"tag":497,"props":2159,"children":2160},{},[2161],{"type":48,"value":2162},"ngrok session expired \u002F recycled",{"type":42,"tag":497,"props":2164,"children":2165},{},[2166],{"type":48,"value":2167},"Deploy to a stable host for anything beyond quick tests",{"type":42,"tag":51,"props":2169,"children":2170},{},[2171],{"type":42,"tag":141,"props":2172,"children":2173},{},[2174],{"type":48,"value":2175},"Test webhooks manually:",{"type":42,"tag":147,"props":2177,"children":2181},{"className":2178,"code":2179,"language":2180,"meta":152,"style":152},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","# Simulate an inbound SMS webhook\ncurl -X POST https:\u002F\u002Fyourapp.com\u002Fsms \\\n  -d \"From=+15551234567\" \\\n  -d \"To=+15559876543\" \\\n  -d \"Body=Test message\" \\\n  -d \"MessageSid=SM00000000000000000000000000000000\"\n","bash",[2182],{"type":42,"tag":77,"props":2183,"children":2184},{"__ignoreMap":152},[2185,2194,2224,2252,2276,2300],{"type":42,"tag":158,"props":2186,"children":2187},{"class":160,"line":161},[2188],{"type":42,"tag":158,"props":2189,"children":2191},{"style":2190},"--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic",[2192],{"type":48,"value":2193},"# Simulate an inbound SMS webhook\n",{"type":42,"tag":158,"props":2195,"children":2196},{"class":160,"line":170},[2197,2202,2208,2213,2218],{"type":42,"tag":158,"props":2198,"children":2200},{"style":2199},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[2201],{"type":48,"value":2147},{"type":42,"tag":158,"props":2203,"children":2205},{"style":2204},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[2206],{"type":48,"value":2207}," -X",{"type":42,"tag":158,"props":2209,"children":2210},{"style":2204},[2211],{"type":48,"value":2212}," POST",{"type":42,"tag":158,"props":2214,"children":2215},{"style":2204},[2216],{"type":48,"value":2217}," https:\u002F\u002Fyourapp.com\u002Fsms",{"type":42,"tag":158,"props":2219,"children":2221},{"style":2220},"--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8",[2222],{"type":48,"value":2223}," \\\n",{"type":42,"tag":158,"props":2225,"children":2226},{"class":160,"line":179},[2227,2232,2238,2243,2248],{"type":42,"tag":158,"props":2228,"children":2229},{"style":2204},[2230],{"type":48,"value":2231},"  -d",{"type":42,"tag":158,"props":2233,"children":2235},{"style":2234},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[2236],{"type":48,"value":2237}," \"",{"type":42,"tag":158,"props":2239,"children":2240},{"style":2204},[2241],{"type":48,"value":2242},"From=+15551234567",{"type":42,"tag":158,"props":2244,"children":2245},{"style":2234},[2246],{"type":48,"value":2247},"\"",{"type":42,"tag":158,"props":2249,"children":2250},{"style":2220},[2251],{"type":48,"value":2223},{"type":42,"tag":158,"props":2253,"children":2254},{"class":160,"line":189},[2255,2259,2263,2268,2272],{"type":42,"tag":158,"props":2256,"children":2257},{"style":2204},[2258],{"type":48,"value":2231},{"type":42,"tag":158,"props":2260,"children":2261},{"style":2234},[2262],{"type":48,"value":2237},{"type":42,"tag":158,"props":2264,"children":2265},{"style":2204},[2266],{"type":48,"value":2267},"To=+15559876543",{"type":42,"tag":158,"props":2269,"children":2270},{"style":2234},[2271],{"type":48,"value":2247},{"type":42,"tag":158,"props":2273,"children":2274},{"style":2220},[2275],{"type":48,"value":2223},{"type":42,"tag":158,"props":2277,"children":2278},{"class":160,"line":198},[2279,2283,2287,2292,2296],{"type":42,"tag":158,"props":2280,"children":2281},{"style":2204},[2282],{"type":48,"value":2231},{"type":42,"tag":158,"props":2284,"children":2285},{"style":2234},[2286],{"type":48,"value":2237},{"type":42,"tag":158,"props":2288,"children":2289},{"style":2204},[2290],{"type":48,"value":2291},"Body=Test message",{"type":42,"tag":158,"props":2293,"children":2294},{"style":2234},[2295],{"type":48,"value":2247},{"type":42,"tag":158,"props":2297,"children":2298},{"style":2220},[2299],{"type":48,"value":2223},{"type":42,"tag":158,"props":2301,"children":2302},{"class":160,"line":206},[2303,2307,2311,2316],{"type":42,"tag":158,"props":2304,"children":2305},{"style":2204},[2306],{"type":48,"value":2231},{"type":42,"tag":158,"props":2308,"children":2309},{"style":2234},[2310],{"type":48,"value":2237},{"type":42,"tag":158,"props":2312,"children":2313},{"style":2204},[2314],{"type":48,"value":2315},"MessageSid=SM00000000000000000000000000000000",{"type":42,"tag":158,"props":2317,"children":2318},{"style":2234},[2319],{"type":48,"value":2320},"\"\n",{"type":42,"tag":51,"props":2322,"children":2323},{},[2324,2329],{"type":42,"tag":141,"props":2325,"children":2326},{},[2327],{"type":48,"value":2328},"Browser testing:",{"type":48,"value":2330}," Visit your webhook URL in Firefox -- it highlights XML errors in the response.",{"type":42,"tag":313,"props":2332,"children":2334},{"id":2333},"_8-common-error-codes",[2335],{"type":48,"value":2336},"8. Common Error Codes",{"type":42,"tag":467,"props":2338,"children":2339},{},[2340,2365],{"type":42,"tag":471,"props":2341,"children":2342},{},[2343],{"type":42,"tag":475,"props":2344,"children":2345},{},[2346,2351,2356,2361],{"type":42,"tag":479,"props":2347,"children":2348},{},[2349],{"type":48,"value":2350},"Code",{"type":42,"tag":479,"props":2352,"children":2353},{},[2354],{"type":48,"value":2355},"Name",{"type":42,"tag":479,"props":2357,"children":2358},{},[2359],{"type":48,"value":2360},"Cause",{"type":42,"tag":479,"props":2362,"children":2363},{},[2364],{"type":48,"value":2029},{"type":42,"tag":490,"props":2366,"children":2367},{},[2368,2391,2414,2437,2460,2483,2506,2544,2567,2590,2613,2636],{"type":42,"tag":475,"props":2369,"children":2370},{},[2371,2376,2381,2386],{"type":42,"tag":497,"props":2372,"children":2373},{},[2374],{"type":48,"value":2375},"11200",{"type":42,"tag":497,"props":2377,"children":2378},{},[2379],{"type":48,"value":2380},"HTTP retrieval failure",{"type":42,"tag":497,"props":2382,"children":2383},{},[2384],{"type":48,"value":2385},"Twilio cannot reach your webhook URL",{"type":42,"tag":497,"props":2387,"children":2388},{},[2389],{"type":48,"value":2390},"Check URL, DNS, firewall, SSL cert",{"type":42,"tag":475,"props":2392,"children":2393},{},[2394,2399,2404,2409],{"type":42,"tag":497,"props":2395,"children":2396},{},[2397],{"type":48,"value":2398},"11205",{"type":42,"tag":497,"props":2400,"children":2401},{},[2402],{"type":48,"value":2403},"HTTP connection failure",{"type":42,"tag":497,"props":2405,"children":2406},{},[2407],{"type":48,"value":2408},"Webhook endpoint refused connection",{"type":42,"tag":497,"props":2410,"children":2411},{},[2412],{"type":48,"value":2413},"Verify server is running and port is open",{"type":42,"tag":475,"props":2415,"children":2416},{},[2417,2422,2427,2432],{"type":42,"tag":497,"props":2418,"children":2419},{},[2420],{"type":48,"value":2421},"11751",{"type":42,"tag":497,"props":2423,"children":2424},{},[2425],{"type":48,"value":2426},"Media download failure",{"type":42,"tag":497,"props":2428,"children":2429},{},[2430],{"type":48,"value":2431},"MMS media URL unreachable",{"type":42,"tag":497,"props":2433,"children":2434},{},[2435],{"type":48,"value":2436},"Check media URL accessibility",{"type":42,"tag":475,"props":2438,"children":2439},{},[2440,2445,2450,2455],{"type":42,"tag":497,"props":2441,"children":2442},{},[2443],{"type":48,"value":2444},"12100",{"type":42,"tag":497,"props":2446,"children":2447},{},[2448],{"type":48,"value":2449},"Document parse failure",{"type":42,"tag":497,"props":2451,"children":2452},{},[2453],{"type":48,"value":2454},"TwiML is not valid XML",{"type":42,"tag":497,"props":2456,"children":2457},{},[2458],{"type":48,"value":2459},"Validate XML; remove debug output",{"type":42,"tag":475,"props":2461,"children":2462},{},[2463,2468,2473,2478],{"type":42,"tag":497,"props":2464,"children":2465},{},[2466],{"type":48,"value":2467},"12200",{"type":42,"tag":497,"props":2469,"children":2470},{},[2471],{"type":48,"value":2472},"Schema compliance failure",{"type":42,"tag":497,"props":2474,"children":2475},{},[2476],{"type":48,"value":2477},"TwiML verbs\u002Fattributes are invalid",{"type":42,"tag":497,"props":2479,"children":2480},{},[2481],{"type":48,"value":2482},"Check TwiML reference for correct syntax",{"type":42,"tag":475,"props":2484,"children":2485},{},[2486,2491,2496,2501],{"type":42,"tag":497,"props":2487,"children":2488},{},[2489],{"type":48,"value":2490},"20003",{"type":42,"tag":497,"props":2492,"children":2493},{},[2494],{"type":48,"value":2495},"Authentication error",{"type":42,"tag":497,"props":2497,"children":2498},{},[2499],{"type":48,"value":2500},"Invalid Account SID or Auth Token",{"type":42,"tag":497,"props":2502,"children":2503},{},[2504],{"type":48,"value":2505},"Verify credentials in environment",{"type":42,"tag":475,"props":2507,"children":2508},{},[2509,2514,2527,2532],{"type":42,"tag":497,"props":2510,"children":2511},{},[2512],{"type":48,"value":2513},"21211",{"type":42,"tag":497,"props":2515,"children":2516},{},[2517,2519,2525],{"type":48,"value":2518},"Invalid ",{"type":42,"tag":77,"props":2520,"children":2522},{"className":2521},[],[2523],{"type":48,"value":2524},"To",{"type":48,"value":2526}," number",{"type":42,"tag":497,"props":2528,"children":2529},{},[2530],{"type":48,"value":2531},"Number not in E.164 format",{"type":42,"tag":497,"props":2533,"children":2534},{},[2535,2536,2542],{"type":48,"value":2141},{"type":42,"tag":77,"props":2537,"children":2539},{"className":2538},[],[2540],{"type":48,"value":2541},"+",{"type":48,"value":2543}," country code + number",{"type":42,"tag":475,"props":2545,"children":2546},{},[2547,2552,2557,2562],{"type":42,"tag":497,"props":2548,"children":2549},{},[2550],{"type":48,"value":2551},"21608",{"type":42,"tag":497,"props":2553,"children":2554},{},[2555],{"type":48,"value":2556},"Unverified number (trial)",{"type":42,"tag":497,"props":2558,"children":2559},{},[2560],{"type":48,"value":2561},"Trial accounts can only send to verified numbers",{"type":42,"tag":497,"props":2563,"children":2564},{},[2565],{"type":48,"value":2566},"Verify number or upgrade account",{"type":42,"tag":475,"props":2568,"children":2569},{},[2570,2575,2580,2585],{"type":42,"tag":497,"props":2571,"children":2572},{},[2573],{"type":48,"value":2574},"30003",{"type":42,"tag":497,"props":2576,"children":2577},{},[2578],{"type":48,"value":2579},"Unreachable destination",{"type":42,"tag":497,"props":2581,"children":2582},{},[2583],{"type":48,"value":2584},"Carrier cannot deliver message",{"type":42,"tag":497,"props":2586,"children":2587},{},[2588],{"type":48,"value":2589},"Check number validity; retry later",{"type":42,"tag":475,"props":2591,"children":2592},{},[2593,2598,2603,2608],{"type":42,"tag":497,"props":2594,"children":2595},{},[2596],{"type":48,"value":2597},"30006",{"type":42,"tag":497,"props":2599,"children":2600},{},[2601],{"type":48,"value":2602},"Landline or unreachable",{"type":42,"tag":497,"props":2604,"children":2605},{},[2606],{"type":48,"value":2607},"Destination is a landline",{"type":42,"tag":497,"props":2609,"children":2610},{},[2611],{"type":48,"value":2612},"Use voice channel instead",{"type":42,"tag":475,"props":2614,"children":2615},{},[2616,2621,2626,2631],{"type":42,"tag":497,"props":2617,"children":2618},{},[2619],{"type":48,"value":2620},"30007",{"type":42,"tag":497,"props":2622,"children":2623},{},[2624],{"type":48,"value":2625},"Carrier filtering",{"type":42,"tag":497,"props":2627,"children":2628},{},[2629],{"type":48,"value":2630},"Message filtered by carrier",{"type":42,"tag":497,"props":2632,"children":2633},{},[2634],{"type":48,"value":2635},"Review content; register for A2P 10DLC",{"type":42,"tag":475,"props":2637,"children":2638},{},[2639,2644,2649,2654],{"type":42,"tag":497,"props":2640,"children":2641},{},[2642],{"type":48,"value":2643},"30008",{"type":42,"tag":497,"props":2645,"children":2646},{},[2647],{"type":48,"value":2648},"Unknown error",{"type":42,"tag":497,"props":2650,"children":2651},{},[2652],{"type":48,"value":2653},"Carrier returned generic error",{"type":42,"tag":497,"props":2655,"children":2656},{},[2657],{"type":48,"value":2658},"Retry; contact support if persistent",{"type":42,"tag":51,"props":2660,"children":2661},{},[2662,2664],{"type":48,"value":2663},"Full error reference: ",{"type":42,"tag":413,"props":2665,"children":2668},{"href":2666,"rel":2667},"https:\u002F\u002Fwww.twilio.com\u002Fdocs\u002Fapi\u002Ferrors",[417],[2669],{"type":48,"value":2666},{"type":42,"tag":313,"props":2671,"children":2673},{"id":2672},"_9-querying-resource-state-directly",[2674],{"type":48,"value":2675},"9. Querying Resource State Directly",{"type":42,"tag":51,"props":2677,"children":2678},{},[2679],{"type":48,"value":2680},"When you need the current state of a message or call (not waiting for a callback):",{"type":42,"tag":51,"props":2682,"children":2683},{},[2684],{"type":42,"tag":141,"props":2685,"children":2686},{},[2687],{"type":48,"value":145},{"type":42,"tag":147,"props":2689,"children":2691},{"className":149,"code":2690,"language":151,"meta":152,"style":152},"# Check message delivery status\nmessage = client.messages(\"SMxxxxxxxxxx\").fetch()\nprint(f\"Status: {message.status}, Error: {message.error_code}\")\n\n# Check call status\ncall = client.calls(\"CAxxxxxxxxxx\").fetch()\nprint(f\"Status: {call.status}, Duration: {call.duration}\")\n",[2692],{"type":42,"tag":77,"props":2693,"children":2694},{"__ignoreMap":152},[2695,2703,2711,2719,2726,2734,2742],{"type":42,"tag":158,"props":2696,"children":2697},{"class":160,"line":161},[2698],{"type":42,"tag":158,"props":2699,"children":2700},{},[2701],{"type":48,"value":2702},"# Check message delivery status\n",{"type":42,"tag":158,"props":2704,"children":2705},{"class":160,"line":170},[2706],{"type":42,"tag":158,"props":2707,"children":2708},{},[2709],{"type":48,"value":2710},"message = client.messages(\"SMxxxxxxxxxx\").fetch()\n",{"type":42,"tag":158,"props":2712,"children":2713},{"class":160,"line":179},[2714],{"type":42,"tag":158,"props":2715,"children":2716},{},[2717],{"type":48,"value":2718},"print(f\"Status: {message.status}, Error: {message.error_code}\")\n",{"type":42,"tag":158,"props":2720,"children":2721},{"class":160,"line":189},[2722],{"type":42,"tag":158,"props":2723,"children":2724},{"emptyLinePlaceholder":183},[2725],{"type":48,"value":186},{"type":42,"tag":158,"props":2727,"children":2728},{"class":160,"line":198},[2729],{"type":42,"tag":158,"props":2730,"children":2731},{},[2732],{"type":48,"value":2733},"# Check call status\n",{"type":42,"tag":158,"props":2735,"children":2736},{"class":160,"line":206},[2737],{"type":42,"tag":158,"props":2738,"children":2739},{},[2740],{"type":48,"value":2741},"call = client.calls(\"CAxxxxxxxxxx\").fetch()\n",{"type":42,"tag":158,"props":2743,"children":2744},{"class":160,"line":215},[2745],{"type":42,"tag":158,"props":2746,"children":2747},{},[2748],{"type":48,"value":2749},"print(f\"Status: {call.status}, Duration: {call.duration}\")\n",{"type":42,"tag":51,"props":2751,"children":2752},{},[2753],{"type":42,"tag":141,"props":2754,"children":2755},{},[2756],{"type":48,"value":238},{"type":42,"tag":147,"props":2758,"children":2760},{"className":241,"code":2759,"language":243,"meta":152,"style":152},"const message = await client.messages(\"SMxxxxxxxxxx\").fetch();\nconsole.log(`Status: ${message.status}, Error: ${message.errorCode}`);\n\nconst call = await client.calls(\"CAxxxxxxxxxx\").fetch();\nconsole.log(`Status: ${call.status}, Duration: ${call.duration}`);\n",[2761],{"type":42,"tag":77,"props":2762,"children":2763},{"__ignoreMap":152},[2764,2772,2780,2787,2795],{"type":42,"tag":158,"props":2765,"children":2766},{"class":160,"line":161},[2767],{"type":42,"tag":158,"props":2768,"children":2769},{},[2770],{"type":48,"value":2771},"const message = await client.messages(\"SMxxxxxxxxxx\").fetch();\n",{"type":42,"tag":158,"props":2773,"children":2774},{"class":160,"line":170},[2775],{"type":42,"tag":158,"props":2776,"children":2777},{},[2778],{"type":48,"value":2779},"console.log(`Status: ${message.status}, Error: ${message.errorCode}`);\n",{"type":42,"tag":158,"props":2781,"children":2782},{"class":160,"line":179},[2783],{"type":42,"tag":158,"props":2784,"children":2785},{"emptyLinePlaceholder":183},[2786],{"type":48,"value":186},{"type":42,"tag":158,"props":2788,"children":2789},{"class":160,"line":189},[2790],{"type":42,"tag":158,"props":2791,"children":2792},{},[2793],{"type":48,"value":2794},"const call = await client.calls(\"CAxxxxxxxxxx\").fetch();\n",{"type":42,"tag":158,"props":2796,"children":2797},{"class":160,"line":198},[2798],{"type":42,"tag":158,"props":2799,"children":2800},{},[2801],{"type":48,"value":2802},"console.log(`Status: ${call.status}, Duration: ${call.duration}`);\n",{"type":42,"tag":313,"props":2804,"children":2806},{"id":2805},"_10-cli-debugging",[2807],{"type":48,"value":2808},"10. CLI Debugging",{"type":42,"tag":51,"props":2810,"children":2811},{},[2812],{"type":48,"value":2813},"The Twilio CLI supports debug logging:",{"type":42,"tag":147,"props":2815,"children":2817},{"className":2178,"code":2816,"language":2180,"meta":152,"style":152},"# Verbose output for any CLI command\ntwilio api:core:messages:list --limit 5 -l debug\n\n# Log levels: debug, info, warn, error\n",[2818],{"type":42,"tag":77,"props":2819,"children":2820},{"__ignoreMap":152},[2821,2829,2862,2869],{"type":42,"tag":158,"props":2822,"children":2823},{"class":160,"line":161},[2824],{"type":42,"tag":158,"props":2825,"children":2826},{"style":2190},[2827],{"type":48,"value":2828},"# Verbose output for any CLI command\n",{"type":42,"tag":158,"props":2830,"children":2831},{"class":160,"line":170},[2832,2836,2841,2846,2852,2857],{"type":42,"tag":158,"props":2833,"children":2834},{"style":2199},[2835],{"type":48,"value":24},{"type":42,"tag":158,"props":2837,"children":2838},{"style":2204},[2839],{"type":48,"value":2840}," api:core:messages:list",{"type":42,"tag":158,"props":2842,"children":2843},{"style":2204},[2844],{"type":48,"value":2845}," --limit",{"type":42,"tag":158,"props":2847,"children":2849},{"style":2848},"--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C",[2850],{"type":48,"value":2851}," 5",{"type":42,"tag":158,"props":2853,"children":2854},{"style":2204},[2855],{"type":48,"value":2856}," -l",{"type":42,"tag":158,"props":2858,"children":2859},{"style":2204},[2860],{"type":48,"value":2861}," debug\n",{"type":42,"tag":158,"props":2863,"children":2864},{"class":160,"line":179},[2865],{"type":42,"tag":158,"props":2866,"children":2867},{"emptyLinePlaceholder":183},[2868],{"type":48,"value":186},{"type":42,"tag":158,"props":2870,"children":2871},{"class":160,"line":189},[2872],{"type":42,"tag":158,"props":2873,"children":2874},{"style":2190},[2875],{"type":48,"value":2876},"# Log levels: debug, info, warn, error\n",{"type":42,"tag":51,"props":2878,"children":2879},{},[2880],{"type":48,"value":2881},"Debug output goes to stderr, so you can pipe normal output while still seeing diagnostics.",{"type":42,"tag":57,"props":2883,"children":2884},{},[],{"type":42,"tag":43,"props":2886,"children":2888},{"id":2887},"monitoring-checklist",[2889],{"type":48,"value":2890},"Monitoring Checklist",{"type":42,"tag":51,"props":2892,"children":2893},{},[2894],{"type":48,"value":2895},"Set up before going to production:",{"type":42,"tag":467,"props":2897,"children":2898},{},[2899,2920],{"type":42,"tag":471,"props":2900,"children":2901},{},[2902],{"type":42,"tag":475,"props":2903,"children":2904},{},[2905,2910,2915],{"type":42,"tag":479,"props":2906,"children":2907},{},[2908],{"type":48,"value":2909},"What to monitor",{"type":42,"tag":479,"props":2911,"children":2912},{},[2913],{"type":48,"value":2914},"How",{"type":42,"tag":479,"props":2916,"children":2917},{},[2918],{"type":48,"value":2919},"Alert threshold",{"type":42,"tag":490,"props":2921,"children":2922},{},[2923,2947,2978,3002,3020,3038,3056],{"type":42,"tag":475,"props":2924,"children":2925},{},[2926,2931,2942],{"type":42,"tag":497,"props":2927,"children":2928},{},[2929],{"type":48,"value":2930},"Webhook errors",{"type":42,"tag":497,"props":2932,"children":2933},{},[2934,2936,2941],{"type":48,"value":2935},"Debugger webhook or Event Streams (",{"type":42,"tag":77,"props":2937,"children":2939},{"className":2938},[],[2940],{"type":48,"value":1692},{"type":48,"value":377},{"type":42,"tag":497,"props":2943,"children":2944},{},[2945],{"type":48,"value":2946},"Any error",{"type":42,"tag":475,"props":2948,"children":2949},{},[2950,2955,2973],{"type":42,"tag":497,"props":2951,"children":2952},{},[2953],{"type":48,"value":2954},"Message delivery failures",{"type":42,"tag":497,"props":2956,"children":2957},{},[2958,2960,2965,2967],{"type":48,"value":2959},"Status callback ",{"type":42,"tag":77,"props":2961,"children":2963},{"className":2962},[],[2964],{"type":48,"value":1969},{"type":48,"value":2966},"\u002F",{"type":42,"tag":77,"props":2968,"children":2970},{"className":2969},[],[2971],{"type":48,"value":2972},"undelivered",{"type":42,"tag":497,"props":2974,"children":2975},{},[2976],{"type":48,"value":2977},"> 2% failure rate",{"type":42,"tag":475,"props":2979,"children":2980},{},[2981,2986,2997],{"type":42,"tag":497,"props":2982,"children":2983},{},[2984],{"type":48,"value":2985},"Call completion rate",{"type":42,"tag":497,"props":2987,"children":2988},{},[2989,2990,2995],{"type":48,"value":2959},{"type":42,"tag":77,"props":2991,"children":2993},{"className":2992},[],[2994],{"type":48,"value":1955},{"type":48,"value":2996}," vs total",{"type":42,"tag":497,"props":2998,"children":2999},{},[3000],{"type":48,"value":3001},"\u003C 95% completion",{"type":42,"tag":475,"props":3003,"children":3004},{},[3005,3010,3015],{"type":42,"tag":497,"props":3006,"children":3007},{},[3008],{"type":48,"value":3009},"Webhook response time",{"type":42,"tag":497,"props":3011,"children":3012},{},[3013],{"type":48,"value":3014},"Your APM (DataDog, New Relic)",{"type":42,"tag":497,"props":3016,"children":3017},{},[3018],{"type":48,"value":3019},"p95 > 5 seconds",{"type":42,"tag":475,"props":3021,"children":3022},{},[3023,3028,3033],{"type":42,"tag":497,"props":3024,"children":3025},{},[3026],{"type":48,"value":3027},"429 rate limit hits",{"type":42,"tag":497,"props":3029,"children":3030},{},[3031],{"type":48,"value":3032},"Count in your backoff handler",{"type":42,"tag":497,"props":3034,"children":3035},{},[3036],{"type":48,"value":3037},"> 5% of requests",{"type":42,"tag":475,"props":3039,"children":3040},{},[3041,3046,3051],{"type":42,"tag":497,"props":3042,"children":3043},{},[3044],{"type":48,"value":3045},"Account configuration changes",{"type":42,"tag":497,"props":3047,"children":3048},{},[3049],{"type":48,"value":3050},"Monitor Events API",{"type":42,"tag":497,"props":3052,"children":3053},{},[3054],{"type":48,"value":3055},"Any unexpected change",{"type":42,"tag":475,"props":3057,"children":3058},{},[3059,3064,3080],{"type":42,"tag":497,"props":3060,"children":3061},{},[3062],{"type":48,"value":3063},"Recording failures",{"type":42,"tag":497,"props":3065,"children":3066},{},[3067,3069,3074,3075],{"type":48,"value":3068},"Recording status callback ",{"type":42,"tag":77,"props":3070,"children":3072},{"className":3071},[],[3073],{"type":48,"value":1969},{"type":48,"value":2966},{"type":42,"tag":77,"props":3076,"children":3078},{"className":3077},[],[3079],{"type":48,"value":1962},{"type":42,"tag":497,"props":3081,"children":3082},{},[3083],{"type":48,"value":3084},"Any failure",{"type":42,"tag":57,"props":3086,"children":3087},{},[],{"type":42,"tag":43,"props":3089,"children":3091},{"id":3090},"cannot",[3092],{"type":48,"value":3093},"CANNOT",{"type":42,"tag":67,"props":3095,"children":3096},{},[3097,3107,3117,3127,3137,3147],{"type":42,"tag":71,"props":3098,"children":3099},{},[3100,3105],{"type":42,"tag":141,"props":3101,"children":3102},{},[3103],{"type":48,"value":3104},"Cannot fetch more than 10,000 alerts per request",{"type":48,"value":3106}," — Use date range filters for large accounts",{"type":42,"tag":71,"props":3108,"children":3109},{},[3110,3115],{"type":42,"tag":141,"props":3111,"children":3112},{},[3113],{"type":48,"value":3114},"Cannot get full HTTP request\u002Fresponse from alert list",{"type":48,"value":3116}," — Only available when fetching a single alert by SID",{"type":42,"tag":71,"props":3118,"children":3119},{},[3120,3125],{"type":42,"tag":141,"props":3121,"children":3122},{},[3123],{"type":48,"value":3124},"Cannot combine multiple filters on Events API",{"type":48,"value":3126}," — One additional field (ResourceSid, ActorSid, SourceIpAddress) plus date range per request",{"type":42,"tag":71,"props":3128,"children":3129},{},[3130,3135],{"type":42,"tag":141,"props":3131,"children":3132},{},[3133],{"type":48,"value":3134},"Cannot delete an Event Streams sink before its subscription",{"type":48,"value":3136}," — Must delete the subscription first",{"type":42,"tag":71,"props":3138,"children":3139},{},[3140,3145],{"type":42,"tag":141,"props":3141,"children":3142},{},[3143],{"type":48,"value":3144},"Cannot guarantee status callback delivery or order",{"type":48,"value":3146}," — Best-effort. Use composite keys for idempotency.",{"type":42,"tag":71,"props":3148,"children":3149},{},[3150,3155],{"type":42,"tag":141,"props":3151,"children":3152},{},[3153],{"type":48,"value":3154},"Cannot rely on a static error code list",{"type":48,"value":3156}," — New error codes are added without notice. Always link to the full reference rather than hardcoding.",{"type":42,"tag":57,"props":3158,"children":3159},{},[],{"type":42,"tag":43,"props":3161,"children":3163},{"id":3162},"next-steps",[3164],{"type":48,"value":3165},"Next Steps",{"type":42,"tag":67,"props":3167,"children":3168},{},[3169,3184,3199,3214],{"type":42,"tag":71,"props":3170,"children":3171},{},[3172,3177,3178],{"type":42,"tag":141,"props":3173,"children":3174},{},[3175],{"type":48,"value":3176},"Webhook architecture:",{"type":48,"value":1632},{"type":42,"tag":77,"props":3179,"children":3181},{"className":3180},[],[3182],{"type":48,"value":3183},"twilio-webhook-architecture",{"type":42,"tag":71,"props":3185,"children":3186},{},[3187,3192,3193],{"type":42,"tag":141,"props":3188,"children":3189},{},[3190],{"type":48,"value":3191},"Scale webhook handling:",{"type":48,"value":1632},{"type":42,"tag":77,"props":3194,"children":3196},{"className":3195},[],[3197],{"type":48,"value":3198},"twilio-reliability-patterns",{"type":42,"tag":71,"props":3200,"children":3201},{},[3202,3207,3208],{"type":42,"tag":141,"props":3203,"children":3204},{},[3205],{"type":48,"value":3206},"Compliance monitoring:",{"type":48,"value":1632},{"type":42,"tag":77,"props":3209,"children":3211},{"className":3210},[],[3212],{"type":48,"value":3213},"twilio-compliance-traffic",{"type":42,"tag":71,"props":3215,"children":3216},{},[3217,3222,3223],{"type":42,"tag":141,"props":3218,"children":3219},{},[3220],{"type":48,"value":3221},"Credential security:",{"type":48,"value":1632},{"type":42,"tag":77,"props":3224,"children":3226},{"className":3225},[],[3227],{"type":48,"value":98},{"type":42,"tag":3229,"props":3230,"children":3231},"style",{},[3232],{"type":48,"value":3233},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":3235,"total":3356},[3236,3254,3270,3282,3302,3324,3344],{"slug":3237,"name":3237,"fn":3238,"description":3239,"org":3240,"tags":3241,"stars":25,"repoUrl":26,"updatedAt":27},"accessibility-and-inclusive-visualization","make data visualizations accessible","Make data visualizations accessible and inclusive. Use when the user needs chart or diagram accessibility guidance, text alternatives for complex visuals, color and contrast review, keyboard support, reduced-motion behavior for animation or parallax, or an accessibility QA workflow for exported figures, UML-like diagrams, and dashboards.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3242,3245,3248,3251],{"name":3243,"slug":3244,"type":15},"Accessibility","accessibility",{"name":3246,"slug":3247,"type":15},"Charts","charts",{"name":3249,"slug":3250,"type":15},"Data Visualization","data-visualization",{"name":3252,"slug":3253,"type":15},"Design","design",{"slug":3255,"name":3255,"fn":3256,"description":3257,"org":3258,"tags":3259,"stars":25,"repoUrl":26,"updatedAt":3269},"agent-browser","automate browser interactions for agents","Browser automation CLI for AI agents. Use when the user needs to interact with websites, verify dev server output, test web apps, navigate pages, fill forms, click buttons, take screenshots, extract data, or automate any browser task. Also triggers when a dev server starts so you can verify it visually.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3260,3263,3266],{"name":3261,"slug":3262,"type":15},"Agents","agents",{"name":3264,"slug":3265,"type":15},"Browser Automation","browser-automation",{"name":3267,"slug":3268,"type":15},"Testing","testing","2026-04-06T18:41:03.44016",{"slug":3271,"name":3271,"fn":3272,"description":3273,"org":3274,"tags":3275,"stars":25,"repoUrl":26,"updatedAt":3281},"agent-browser-verify","verify dev server output with automated browser","Automated browser verification for dev servers. Triggers when a dev server starts to run a visual gut-check with agent-browser — verifies the page loads, checks for console errors, validates key UI elements, and reports pass\u002Ffail before continuing.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3276,3277,3280],{"name":3264,"slug":3265,"type":15},{"name":3278,"slug":3279,"type":15},"Local Development","local-development",{"name":3267,"slug":3268,"type":15},"2026-04-06T18:41:17.526867",{"slug":3283,"name":3283,"fn":3284,"description":3285,"org":3286,"tags":3287,"stars":25,"repoUrl":26,"updatedAt":3301},"agents-sdk","build AI agents on Cloudflare Workers","Build AI agents on Cloudflare Workers using the Agents SDK. Load when creating stateful agents, durable workflows, real-time WebSocket apps, scheduled tasks, MCP servers, or chat applications. Covers Agent class, state management, callable RPC, Workflows integration, and React hooks. Biases towards retrieval from Cloudflare docs over pre-trained knowledge.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3288,3289,3292,3295,3298],{"name":3261,"slug":3262,"type":15},{"name":3290,"slug":3291,"type":15},"Cloudflare Workers","cloudflare-workers",{"name":3293,"slug":3294,"type":15},"SDK","sdk",{"name":3296,"slug":3297,"type":15},"Serverless","serverless",{"name":3299,"slug":3300,"type":15},"WebSockets","websockets","2026-04-06T18:39:51.717063",{"slug":3303,"name":3303,"fn":3304,"description":3305,"org":3306,"tags":3307,"stars":25,"repoUrl":26,"updatedAt":3323},"ai-elements","build chat UIs with AI Elements","AI Elements component library guidance — pre-built React components for AI interfaces built on shadcn\u002Fui. Use when building chat UIs, message displays, tool call rendering, streaming responses, reasoning panels, or any AI-native interface with the AI SDK.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3308,3311,3314,3317,3320],{"name":3309,"slug":3310,"type":15},"Frontend","frontend",{"name":3312,"slug":3313,"type":15},"React","react",{"name":3315,"slug":3316,"type":15},"shadcn\u002Fui","shadcn-ui",{"name":3318,"slug":3319,"type":15},"UI Components","ui-components",{"name":3321,"slug":3322,"type":15},"Vercel","vercel","2026-04-06T18:40:59.619419",{"slug":3325,"name":3325,"fn":3326,"description":3327,"org":3328,"tags":3329,"stars":25,"repoUrl":26,"updatedAt":3343},"ai-gateway","configure Vercel AI Gateway","Vercel AI Gateway expert guidance. Use when configuring model routing, provider failover, cost tracking, or managing multiple AI providers through a unified API.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3330,3333,3336,3339,3342],{"name":3331,"slug":3332,"type":15},"AI Infrastructure","ai-infrastructure",{"name":3334,"slug":3335,"type":15},"Cost Optimization","cost-optimization",{"name":3337,"slug":3338,"type":15},"LLM","llm",{"name":3340,"slug":3341,"type":15},"Performance","performance",{"name":3321,"slug":3322,"type":15},"2026-04-06T18:40:44.377464",{"slug":3345,"name":3345,"fn":3346,"description":3347,"org":3348,"tags":3349,"stars":25,"repoUrl":26,"updatedAt":3355},"ai-generation-persistence","implement persistence patterns for AI generations","AI generation persistence patterns — unique IDs, addressable URLs, database storage, and cost tracking for every LLM generation",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3350,3351,3354],{"name":3334,"slug":3335,"type":15},{"name":3352,"slug":3353,"type":15},"Database","database",{"name":3337,"slug":3338,"type":15},"2026-04-06T18:41:08.513425",600,{"items":3358,"total":3555},[3359,3380,3403,3420,3436,3453,3472,3484,3498,3512,3524,3539],{"slug":3360,"name":3360,"fn":3361,"description":3362,"org":3363,"tags":3364,"stars":3377,"repoUrl":3378,"updatedAt":3379},"prior-auth-packet-builder","build healthcare prior authorization packets","Build a concise prior authorization packet from local case files and payer policy docs.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3365,3368,3371,3374],{"name":3366,"slug":3367,"type":15},"Documents","documents",{"name":3369,"slug":3370,"type":15},"Healthcare","healthcare",{"name":3372,"slug":3373,"type":15},"Insurance","insurance",{"name":3375,"slug":3376,"type":15},"Regulatory Compliance","regulatory-compliance",28169,"https:\u002F\u002Fgithub.com\u002Fopenai\u002Fopenai-agents-python","2026-04-16T05:11:39.180399",{"slug":3381,"name":3381,"fn":3382,"description":3383,"org":3384,"tags":3385,"stars":3400,"repoUrl":3401,"updatedAt":3402},"aspnet-core","build ASP.NET Core web applications","Build, review, refactor, or architect ASP.NET Core web applications using current official guidance for .NET web development. Use when working on Blazor Web Apps, Razor Pages, MVC, Minimal APIs, controller-based Web APIs, SignalR, gRPC, middleware, dependency injection, configuration, authentication, authorization, testing, performance, deployment, or ASP.NET Core upgrades.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3386,3389,3391,3394,3397],{"name":3387,"slug":3388,"type":15},".NET","dotnet",{"name":3390,"slug":3381,"type":15},"ASP.NET Core",{"name":3392,"slug":3393,"type":15},"Blazor","blazor",{"name":3395,"slug":3396,"type":15},"C#","csharp",{"name":3398,"slug":3399,"type":15},"Web Development","web-development",23787,"https:\u002F\u002Fgithub.com\u002Fopenai\u002Fskills","2026-04-12T05:07:02.819491",{"slug":3404,"name":3404,"fn":3405,"description":3406,"org":3407,"tags":3408,"stars":3400,"repoUrl":3401,"updatedAt":3419},"chatgpt-apps","build ChatGPT Apps SDK applications","Build, scaffold, refactor, and troubleshoot ChatGPT Apps SDK applications that combine an MCP server and widget UI. Use when Codex needs to design tools, register UI resources, wire the MCP Apps bridge or ChatGPT compatibility APIs, apply Apps SDK metadata or CSP or domain settings, or produce a docs-aligned project scaffold. Prefer a docs-first workflow by invoking the openai-docs skill or OpenAI developer docs MCP tools before generating code.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3409,3412,3415,3418],{"name":3410,"slug":3411,"type":15},"Apps SDK","apps-sdk",{"name":3413,"slug":3414,"type":15},"ChatGPT","chatgpt",{"name":3416,"slug":3417,"type":15},"MCP","mcp",{"name":9,"slug":8,"type":15},"2026-04-12T05:07:05.468097",{"slug":3421,"name":3421,"fn":3422,"description":3423,"org":3424,"tags":3425,"stars":3400,"repoUrl":3401,"updatedAt":3435},"cli-creator","build CLIs from API docs","Build a composable CLI for Codex from API docs, an OpenAPI spec, existing curl examples, an SDK, a web app, an admin tool, or a local script. Use when the user wants Codex to create a command-line tool that can run from any repo, expose composable read\u002Fwrite commands, return stable JSON, manage auth, and pair with a companion skill.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3426,3429,3432],{"name":3427,"slug":3428,"type":15},"API Development","api-development",{"name":3430,"slug":3431,"type":15},"CLI","cli",{"name":3433,"slug":3434,"type":15},"Codex","codex","2026-04-12T05:07:04.132762",{"slug":3437,"name":3437,"fn":3438,"description":3439,"org":3440,"tags":3441,"stars":3400,"repoUrl":3401,"updatedAt":3452},"cloudflare-deploy","deploy projects to Cloudflare","Deploy applications and infrastructure to Cloudflare using Workers, Pages, and related platform services. Use when the user asks to deploy, host, publish, or set up a project on Cloudflare.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3442,3445,3448,3449],{"name":3443,"slug":3444,"type":15},"Cloudflare","cloudflare",{"name":3446,"slug":3447,"type":15},"Cloudflare Pages","cloudflare-pages",{"name":3290,"slug":3291,"type":15},{"name":3450,"slug":3451,"type":15},"Deployment","deployment","2026-04-12T05:07:14.275118",{"slug":3454,"name":3454,"fn":3455,"description":3456,"org":3457,"tags":3458,"stars":3400,"repoUrl":3401,"updatedAt":3471},"define-goal","define and set measurable project goals","Help the user define a concrete, measurable goal before starting work, especially when they ask to use the goal tool, create a goal, set an objective, clarify success criteria, or turn a fuzzy intention into a quantitative outcome. Use this skill for goal creation and goal refinement only; it does not manage durable snapshots, decision logs, or long-running execution artifacts.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3459,3462,3465,3468],{"name":3460,"slug":3461,"type":15},"Productivity","productivity",{"name":3463,"slug":3464,"type":15},"Project Management","project-management",{"name":3466,"slug":3467,"type":15},"Strategy","strategy",{"name":3469,"slug":3470,"type":15},"Task Management","task-management","2026-05-23T06:17:16.870838",{"slug":3473,"name":3473,"fn":3474,"description":3475,"org":3476,"tags":3477,"stars":3400,"repoUrl":3401,"updatedAt":3483},"figma","translate Figma designs into code","Use the Figma MCP server to fetch design context, screenshots, variables, and assets from Figma, and to translate Figma nodes into production code. Trigger when a task involves Figma URLs, node IDs, design-to-code implementation, or Figma MCP setup and troubleshooting.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3478,3479,3481,3482],{"name":3252,"slug":3253,"type":15},{"name":3480,"slug":3473,"type":15},"Figma",{"name":3309,"slug":3310,"type":15},{"name":3416,"slug":3417,"type":15},"2026-04-12T05:06:47.939943",{"slug":3485,"name":3485,"fn":3486,"description":3487,"org":3488,"tags":3489,"stars":3400,"repoUrl":3401,"updatedAt":3497},"figma-code-connect-components","connect Figma designs to code components","Connects Figma design components to code components using Code Connect mapping tools. Use when user says \"code connect\", \"connect this component to code\", \"map this component\", \"link component to code\", \"create code connect mapping\", or wants to establish mappings between Figma designs and code implementations. For canvas writes via `use_figma`, use `figma-use`.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3490,3491,3494,3495,3496],{"name":3252,"slug":3253,"type":15},{"name":3492,"slug":3493,"type":15},"Design System","design-system",{"name":3480,"slug":3473,"type":15},{"name":3309,"slug":3310,"type":15},{"name":3318,"slug":3319,"type":15},"2026-05-10T05:59:52.971881",{"slug":3499,"name":3499,"fn":3500,"description":3501,"org":3502,"tags":3503,"stars":3400,"repoUrl":3401,"updatedAt":3511},"figma-create-design-system-rules","generate design system rules from Figma","Generates custom design system rules for the user's codebase. Use when user says \"create design system rules\", \"generate rules for my project\", \"set up design rules\", \"customize design system guidelines\", or wants to establish project-specific conventions for Figma-to-code workflows. Requires Figma MCP server connection.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3504,3505,3506,3509,3510],{"name":3252,"slug":3253,"type":15},{"name":3492,"slug":3493,"type":15},{"name":3507,"slug":3508,"type":15},"Documentation","documentation",{"name":3480,"slug":3473,"type":15},{"name":3309,"slug":3310,"type":15},"2026-05-16T06:07:47.821474",{"slug":3513,"name":3513,"fn":3514,"description":3515,"org":3516,"tags":3517,"stars":3400,"repoUrl":3401,"updatedAt":3523},"figma-implement-design","translate Figma designs into application code","Translates Figma designs into production-ready application code with 1:1 visual fidelity. Use when implementing UI code from Figma files, when user mentions \"implement design\", \"generate code\", \"implement component\", provides Figma URLs, or asks to build components matching Figma specs. For Figma canvas writes via `use_figma`, use `figma-use`.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3518,3519,3520,3521,3522],{"name":3252,"slug":3253,"type":15},{"name":3480,"slug":3473,"type":15},{"name":3309,"slug":3310,"type":15},{"name":3318,"slug":3319,"type":15},{"name":3398,"slug":3399,"type":15},"2026-05-16T06:07:40.583615",{"slug":3525,"name":3525,"fn":3526,"description":3527,"org":3528,"tags":3529,"stars":3400,"repoUrl":3401,"updatedAt":3538},"hatch-pet","create animated pets for Codex","Create, repair, validate, visually QA, and package Codex-compatible animated pets and pet spritesheets from character art, generated images, company or prospect brand cues, or visual references. Use when a user wants a lightweight-worker Codex pet workflow, a non-pixel custom pet style, a prospect or company mascot pet, or a full 8x9 animated pet atlas with transparent unused cells, QA contact sheets, and pet.json packaging. This skill composes the installed $imagegen system skill for visual generation and uses bundled scripts for deterministic spritesheet assembly.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3530,3533,3534,3537],{"name":3531,"slug":3532,"type":15},"Animation","animation",{"name":3433,"slug":3434,"type":15},{"name":3535,"slug":3536,"type":15},"Creative","creative",{"name":3252,"slug":3253,"type":15},"2026-05-02T05:31:48.48485",{"slug":3540,"name":3540,"fn":3541,"description":3542,"org":3543,"tags":3544,"stars":3400,"repoUrl":3401,"updatedAt":3554},"imagegen","generate and edit raster images","Generate or edit raster images when the task benefits from AI-created bitmap visuals such as photos, illustrations, textures, sprites, mockups, or transparent-background cutouts. Use when Codex should create a brand-new image, transform an existing image, or derive visual variants from references, and the output should be a bitmap asset rather than repo-native code or vector. Do not use when the task is better handled by editing existing SVG\u002Fvector\u002Fcode-native assets, extending an established icon or logo system, or building the visual directly in HTML\u002FCSS\u002Fcanvas.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3545,3546,3547,3550,3553],{"name":3535,"slug":3536,"type":15},{"name":3252,"slug":3253,"type":15},{"name":3548,"slug":3549,"type":15},"Image Generation","image-generation",{"name":3551,"slug":3552,"type":15},"Images","images",{"name":9,"slug":8,"type":15},"2026-05-15T06:23:24.312127",675]