[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-openai-twilio-conference-calls":3,"mdc--7qtfff-key":30,"related-repo-openai-twilio-conference-calls":2095,"related-org-openai-twilio-conference-calls":2218},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":19,"repoUrl":20,"updatedAt":21,"license":22,"forks":23,"topics":24,"repo":25,"sourceUrl":28,"mdContent":29},"twilio-conference-calls","build multi-party calls with Twilio","Build multi-party calls using Twilio Conference. Covers warm transfer, cold transfer, coaching (whisper), hold vs mute, participant modes, and supervisor barge. Use this skill for any contact center, support line, or scenario requiring transfers, holds, or multi-party calls.\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],{"name":13,"slug":14,"type":15},"Communications","communications","tag",{"name":17,"slug":18,"type":15},"Twilio","twilio",3992,"https:\u002F\u002Fgithub.com\u002Fopenai\u002Fplugins","2026-06-30T19:00:57.102",null,465,[],{"repoUrl":20,"stars":19,"forks":23,"topics":26,"description":27},[],"OpenAI Plugins","https:\u002F\u002Fgithub.com\u002Fopenai\u002Fplugins\u002Ftree\u002FHEAD\u002Fplugins\u002Ftwilio-developer-kit\u002Fskills\u002Ftwilio-conference-calls","---\nname: twilio-conference-calls\ndescription: >\n  Build multi-party calls using Twilio Conference. Covers warm transfer,\n  cold transfer, coaching (whisper), hold vs mute, participant modes, and\n  supervisor barge. Use this skill for any contact center, support line,\n  or scenario requiring transfers, holds, or multi-party calls.\n---\n\n## Overview\n\nConference is the foundation of contact center call handling. The key insight: **every call that might need a transfer should start as a Conference**, not a direct `\u003CDial>`. A Conference supports hold, transfer, coaching, and recording — a direct Dial does not.\n\n```\nCaller ──→ Conference Room ←── Agent\n                  ↑\n              Supervisor (coach mode: speaks to agent only)\n```\n\n**Contact center best practice:** Every multi-agent call should use Conference, not direct Dial.\n\n---\n\n## Prerequisites\n\n- Twilio account with a voice-capable phone number — see `twilio-account-setup`\n- `TWILIO_ACCOUNT_SID` and `TWILIO_AUTH_TOKEN` — see `twilio-iam-auth-setup`\n- SDK: `pip install twilio` \u002F `npm install twilio`\n- For agent routing: TaskRouter — see `twilio-taskrouter-routing`\n\n---\n\n## Quickstart\n\n**Step 1 — Put the inbound caller into a Conference**\n\nWhen a call comes in, place the caller into a named Conference room.\n\n**Python (Flask)**\n```python\nfrom flask import Flask, request\nfrom twilio.twiml.voice_response import VoiceResponse\n\napp = Flask(__name__)\n\n@app.route(\"\u002Fvoice\", methods=[\"POST\"])\ndef incoming_call():\n    call_sid = request.form[\"CallSid\"]\n    response = VoiceResponse()\n    dial = response.dial()\n    dial.conference(\n        f\"room-{call_sid}\",\n        start_conference_on_enter=True,\n        end_conference_on_exit=False,  # Keep conference alive when caller disconnects (for wrap-up)\n        wait_url=\"http:\u002F\u002Ftwimlets.com\u002Fholdmusic?Bucket=com.twilio.music.classical\",\n        status_callback=\"https:\u002F\u002Fyourapp.com\u002Fconference-events\",\n        status_callback_event=\"join leave\",\n        record=\"record-from-start\"\n    )\n    return str(response)\n```\n\n**Node.js (Express)**\n```node\napp.post(\"\u002Fvoice\", (req, res) => {\n    const callSid = req.body.CallSid;\n    const response = new VoiceResponse();\n    const dial = response.dial();\n    dial.conference(\n        `room-${callSid}`,\n        {\n            startConferenceOnEnter: true,\n            endConferenceOnExit: false,\n            waitUrl: \"http:\u002F\u002Ftwimlets.com\u002Fholdmusic?Bucket=com.twilio.music.classical\",\n            statusCallback: \"https:\u002F\u002Fyourapp.com\u002Fconference-events\",\n            statusCallbackEvent: \"join leave\",\n            record: \"record-from-start\",\n        }\n    );\n    res.type(\"text\u002Fxml\").send(response.toString());\n});\n```\n\n**Step 2 — Connect an agent to the same Conference**\n\nAfter TaskRouter assigns a worker, dial the agent into the conference:\n\n> **Security:** Never interpolate untrusted user input into inline `twiml=` strings. Use the SDK's `VoiceResponse` builder for any dynamic content.\n\n**Python**\n```python\n# Called from your assignment callback or agent connect logic\ndef connect_agent(conference_name, agent_phone):\n    client.calls.create(\n        to=agent_phone,\n        from_=\"+15551234567\",  # your Twilio number\n        twiml=f'''\u003CResponse>\n            \u003CDial>\n                \u003CConference>{conference_name}\u003C\u002FConference>\n            \u003C\u002FDial>\n        \u003C\u002FResponse>''',\n        status_callback=\"https:\u002F\u002Fyourapp.com\u002Fagent-call-status\"\n    )\n```\n\n**Node.js**\n```node\nasync function connectAgent(conferenceName, agentPhone) {\n    await client.calls.create({\n        to: agentPhone,\n        from: \"+15551234567\",\n        twiml: `\u003CResponse>\u003CDial>\u003CConference>${conferenceName}\u003C\u002FConference>\u003C\u002FDial>\u003C\u002FResponse>`,\n        statusCallback: \"https:\u002F\u002Fyourapp.com\u002Fagent-call-status\",\n    });\n}\n```\n\n---\n\n## Key Patterns\n\n### Warm Transfer\n\nPut caller on hold → dial new agent into Conference → original agent briefs new agent → original agent drops.\n\n**Python**\n```python\ndef warm_transfer(conference_sid, original_agent_call_sid, new_agent_phone, conference_name):\n    # Step 1: Put caller on hold (hold = hears music, can't hear agents)\n    caller_participant = client.conferences(conference_sid) \\\n        .participants(caller_call_sid) \\\n        .update(hold=True)\n\n    # Step 2: Dial new agent into the same conference\n    client.calls.create(\n        to=new_agent_phone,\n        from_=\"+15551234567\",\n        twiml=f'\u003CResponse>\u003CDial>\u003CConference>{conference_name}\u003C\u002FConference>\u003C\u002FDial>\u003C\u002FResponse>',\n        status_callback=\"https:\u002F\u002Fyourapp.com\u002Ftransfer-agent-status\"\n    )\n\n    # Step 3: Original agent briefs new agent (caller is on hold, can't hear)\n    # ... agents talk ...\n\n    # Step 4: Take caller off hold\n    client.conferences(conference_sid) \\\n        .participants(caller_call_sid) \\\n        .update(hold=False)\n\n    # Step 5: Original agent leaves\n    client.conferences(conference_sid) \\\n        .participants(original_agent_call_sid) \\\n        .update(status=\"completed\")  # Removes from conference\n```\n\n### Cold Transfer\n\nSimpler — just redirect the caller to a new agent without briefing.\n\n**Python**\n```python\ndef cold_transfer(conference_sid, original_agent_call_sid, new_agent_phone, conference_name):\n    # Remove original agent\n    client.conferences(conference_sid) \\\n        .participants(original_agent_call_sid) \\\n        .update(status=\"completed\")\n\n    # Dial new agent into conference\n    client.calls.create(\n        to=new_agent_phone,\n        from_=\"+15551234567\",\n        twiml=f'\u003CResponse>\u003CDial>\u003CConference>{conference_name}\u003C\u002FConference>\u003C\u002FDial>\u003C\u002FResponse>'\n    )\n```\n\n### Hold vs Mute\n\n| Feature | Hold | Mute |\n|---------|------|------|\n| Participant hears | Hold music | Everything (but can't speak) |\n| Other participants hear | Nothing from held party | Nothing from muted party |\n| Use when | Transfer briefing, agent lookup | Quick aside (agent mutes self to cough) |\n| API | `hold=True` | `muted=True` |\n\n```python\n# Hold — plays music to the held participant\nclient.conferences(conf_sid).participants(participant_sid).update(hold=True)\nclient.conferences(conf_sid).participants(participant_sid).update(hold=False)\n\n# Mute — silences the participant but they still hear\nclient.conferences(conf_sid).participants(participant_sid).update(muted=True)\nclient.conferences(conf_sid).participants(participant_sid).update(muted=False)\n```\n\n**Critical distinction:** Hold plays music. Mute just silences. Using mute when you mean hold exposes agent-side conversations to the caller.\n\n### Coaching (Supervisor Whisper)\n\nSupervisor joins the Conference and can speak to the agent only — the caller cannot hear the supervisor.\n\n**Python**\n```python\ndef add_coach(conference_sid, supervisor_phone, conference_name):\n    \"\"\"Add supervisor as coach — speaks to agent only, caller can't hear.\"\"\"\n    client.calls.create(\n        to=supervisor_phone,\n        from_=\"+15551234567\",\n        twiml=f'''\u003CResponse>\n            \u003CDial>\n                \u003CConference\n                    coach=\"{agent_call_sid}\"\n                    statusCallback=\"https:\u002F\u002Fyourapp.com\u002Fcoach-events\"\n                >{conference_name}\u003C\u002FConference>\n            \u003C\u002FDial>\n        \u003C\u002FResponse>'''\n    )\n```\n\n**Node.js**\n```node\nasync function addCoach(conferenceSid, supervisorPhone, conferenceName, agentCallSid) {\n    await client.calls.create({\n        to: supervisorPhone,\n        from: \"+15551234567\",\n        twiml: `\u003CResponse>\n            \u003CDial>\n                \u003CConference coach=\"${agentCallSid}\">${conferenceName}\u003C\u002FConference>\n            \u003C\u002FDial>\n        \u003C\u002FResponse>`,\n    });\n}\n```\n\n**Coach behavior:**\n- Supervisor hears both caller and agent\n- Supervisor can speak to agent only (caller cannot hear)\n- Coach audio is NOT captured in conference recording — record separately if needed\n- To switch from coach to barge (speak to everyone), update the participant\n\n### Supervisor Barge\n\nSupervisor joins and speaks to everyone — useful for escalation or takeover.\n\n```python\ndef barge_in(conference_sid, supervisor_phone, conference_name):\n    \"\"\"Supervisor joins as full participant — everyone hears them.\"\"\"\n    client.calls.create(\n        to=supervisor_phone,\n        from_=\"+15551234567\",\n        twiml=f'\u003CResponse>\u003CDial>\u003CConference>{conference_name}\u003C\u002FConference>\u003C\u002FDial>\u003C\u002FResponse>'\n    )\n```\n\n### Participant Management\n\n```python\n# List all participants in a conference\nparticipants = client.conferences(conference_sid).participants.list()\nfor p in participants:\n    print(f\"CallSid: {p.call_sid}, Muted: {p.muted}, Hold: {p.hold}\")\n\n# Remove a participant\nclient.conferences(conference_sid).participants(call_sid).update(status=\"completed\")\n\n# End the entire conference\nclient.conferences(conference_sid).update(status=\"completed\")\n```\n\n---\n\n## Gotchas\n\n### 1. Conference Requires 2+ Participants to \"Exist\"\n\nA Conference with only one participant is in a waiting state. The single participant hears hold music. API calls to the Conference may behave unexpectedly until a second participant joins.\n\n### 2. Coach Audio Not in Recording\n\nConference recordings capture the main audio mix only. Coach\u002Fwhisper audio is NOT recorded. If you need to record coaching sessions for QA, add a separate recording on the supervisor's call leg.\n\n### 3. endConferenceOnExit Behavior\n\nIf `endConferenceOnExit=True` for any participant, the conference ends when they leave — dropping all other participants. Set this carefully:\n- Caller: Usually `False` (so agents can wrap up)\n- Agent: Usually `False` (so caller can be transferred)\n- Supervisor: Always `False`\n\n### 4. Conference Name Is Account-Scoped\n\nConference names must be unique within your account at any given time. Use a unique identifier (like CallSid) in the name to prevent collisions:\n```python\nconference_name = f\"room-{call_sid}\"  # unique per call\n```\n\n---\n\n## CANNOT\n\n- **Cannot use `\u003CGather>` inside a Conference** — DTMF goes into the audio mix, not a handler. Gather before joining the conference.\n- **Cannot rely on speaker events for app logic** — Speaker events fire too frequently to be actionable in real-time routing.\n- **Cannot get post-flight participant data from REST API** — Completed conferences return empty participant lists. Use Voice Insights for historical data.\n- **Coach audio is NOT in the conference recording** — Supervisor whisper audio is excluded from the recorded mix. Record the supervisor's call leg separately if needed.\n- **Cannot filter Insights list endpoint by `processing_state`** — Must fetch by Conference SID directly.\n- **Cannot use PII in `friendlyName`** — Compliance requirement, not just a suggestion.\n- **Cannot create a conference with 0 call legs and get Insights data** — Insights requires at least 1 participant call attempt.\n- **Cannot poll Insights immediately after conference end** — Takes 15-30+ minutes for data to appear, even for `in_progress` state.\n- **Cannot exceed 250 participants per conference** — Hard limit\n- **Cannot pre-add phone numbers to a conference** — Participants must be active calls\n- **Cannot use a private URL for hold music** — Hold music URL must be publicly accessible\n- **Cannot get per-participant recordings from conference recording** — Recording is per-conference (mono mixed). Use dual-channel recording for QA — see `twilio-call-recordings`\n\n---\n\n## Next Steps\n\n- **Route calls to agents:** `twilio-taskrouter-routing`\n- **Record calls:** `twilio-call-recordings`\n- **IVR before conferencing:** `twilio-voice-twiml`\n- **AI agent with escalation:** `twilio-voice-conversation-relay`\n",{"data":31,"body":32},{"name":4,"description":6},{"type":33,"children":34},"root",[35,44,67,79,89,93,99,170,173,179,187,192,200,391,399,543,551,556,586,594,696,704,775,778,784,791,796,803,1016,1022,1027,1034,1130,1136,1249,1311,1321,1327,1332,1339,1452,1459,1548,1556,1579,1585,1590,1648,1654,1739,1742,1748,1754,1759,1765,1770,1776,1789,1827,1833,1838,1852,1855,1861,2018,2021,2027,2089],{"type":36,"tag":37,"props":38,"children":40},"element","h2",{"id":39},"overview",[41],{"type":42,"value":43},"text","Overview",{"type":36,"tag":45,"props":46,"children":47},"p",{},[48,50,56,58,65],{"type":42,"value":49},"Conference is the foundation of contact center call handling. The key insight: ",{"type":36,"tag":51,"props":52,"children":53},"strong",{},[54],{"type":42,"value":55},"every call that might need a transfer should start as a Conference",{"type":42,"value":57},", not a direct ",{"type":36,"tag":59,"props":60,"children":62},"code",{"className":61},[],[63],{"type":42,"value":64},"\u003CDial>",{"type":42,"value":66},". A Conference supports hold, transfer, coaching, and recording — a direct Dial does not.",{"type":36,"tag":68,"props":69,"children":73},"pre",{"className":70,"code":72,"language":42},[71],"language-text","Caller ──→ Conference Room ←── Agent\n                  ↑\n              Supervisor (coach mode: speaks to agent only)\n",[74],{"type":36,"tag":59,"props":75,"children":77},{"__ignoreMap":76},"",[78],{"type":42,"value":72},{"type":36,"tag":45,"props":80,"children":81},{},[82,87],{"type":36,"tag":51,"props":83,"children":84},{},[85],{"type":42,"value":86},"Contact center best practice:",{"type":42,"value":88}," Every multi-agent call should use Conference, not direct Dial.",{"type":36,"tag":90,"props":91,"children":92},"hr",{},[],{"type":36,"tag":37,"props":94,"children":96},{"id":95},"prerequisites",[97],{"type":42,"value":98},"Prerequisites",{"type":36,"tag":100,"props":101,"children":102},"ul",{},[103,115,140,159],{"type":36,"tag":104,"props":105,"children":106},"li",{},[107,109],{"type":42,"value":108},"Twilio account with a voice-capable phone number — see ",{"type":36,"tag":59,"props":110,"children":112},{"className":111},[],[113],{"type":42,"value":114},"twilio-account-setup",{"type":36,"tag":104,"props":116,"children":117},{},[118,124,126,132,134],{"type":36,"tag":59,"props":119,"children":121},{"className":120},[],[122],{"type":42,"value":123},"TWILIO_ACCOUNT_SID",{"type":42,"value":125}," and ",{"type":36,"tag":59,"props":127,"children":129},{"className":128},[],[130],{"type":42,"value":131},"TWILIO_AUTH_TOKEN",{"type":42,"value":133}," — see ",{"type":36,"tag":59,"props":135,"children":137},{"className":136},[],[138],{"type":42,"value":139},"twilio-iam-auth-setup",{"type":36,"tag":104,"props":141,"children":142},{},[143,145,151,153],{"type":42,"value":144},"SDK: ",{"type":36,"tag":59,"props":146,"children":148},{"className":147},[],[149],{"type":42,"value":150},"pip install twilio",{"type":42,"value":152}," \u002F ",{"type":36,"tag":59,"props":154,"children":156},{"className":155},[],[157],{"type":42,"value":158},"npm install twilio",{"type":36,"tag":104,"props":160,"children":161},{},[162,164],{"type":42,"value":163},"For agent routing: TaskRouter — see ",{"type":36,"tag":59,"props":165,"children":167},{"className":166},[],[168],{"type":42,"value":169},"twilio-taskrouter-routing",{"type":36,"tag":90,"props":171,"children":172},{},[],{"type":36,"tag":37,"props":174,"children":176},{"id":175},"quickstart",[177],{"type":42,"value":178},"Quickstart",{"type":36,"tag":45,"props":180,"children":181},{},[182],{"type":36,"tag":51,"props":183,"children":184},{},[185],{"type":42,"value":186},"Step 1 — Put the inbound caller into a Conference",{"type":36,"tag":45,"props":188,"children":189},{},[190],{"type":42,"value":191},"When a call comes in, place the caller into a named Conference room.",{"type":36,"tag":45,"props":193,"children":194},{},[195],{"type":36,"tag":51,"props":196,"children":197},{},[198],{"type":42,"value":199},"Python (Flask)",{"type":36,"tag":68,"props":201,"children":205},{"className":202,"code":203,"language":204,"meta":76,"style":76},"language-python shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","from flask import Flask, request\nfrom twilio.twiml.voice_response import VoiceResponse\n\napp = Flask(__name__)\n\n@app.route(\"\u002Fvoice\", methods=[\"POST\"])\ndef incoming_call():\n    call_sid = request.form[\"CallSid\"]\n    response = VoiceResponse()\n    dial = response.dial()\n    dial.conference(\n        f\"room-{call_sid}\",\n        start_conference_on_enter=True,\n        end_conference_on_exit=False,  # Keep conference alive when caller disconnects (for wrap-up)\n        wait_url=\"http:\u002F\u002Ftwimlets.com\u002Fholdmusic?Bucket=com.twilio.music.classical\",\n        status_callback=\"https:\u002F\u002Fyourapp.com\u002Fconference-events\",\n        status_callback_event=\"join leave\",\n        record=\"record-from-start\"\n    )\n    return str(response)\n","python",[206],{"type":36,"tag":59,"props":207,"children":208},{"__ignoreMap":76},[209,220,229,239,248,256,265,274,283,292,301,310,319,328,337,346,355,364,373,382],{"type":36,"tag":210,"props":211,"children":214},"span",{"class":212,"line":213},"line",1,[215],{"type":36,"tag":210,"props":216,"children":217},{},[218],{"type":42,"value":219},"from flask import Flask, request\n",{"type":36,"tag":210,"props":221,"children":223},{"class":212,"line":222},2,[224],{"type":36,"tag":210,"props":225,"children":226},{},[227],{"type":42,"value":228},"from twilio.twiml.voice_response import VoiceResponse\n",{"type":36,"tag":210,"props":230,"children":232},{"class":212,"line":231},3,[233],{"type":36,"tag":210,"props":234,"children":236},{"emptyLinePlaceholder":235},true,[237],{"type":42,"value":238},"\n",{"type":36,"tag":210,"props":240,"children":242},{"class":212,"line":241},4,[243],{"type":36,"tag":210,"props":244,"children":245},{},[246],{"type":42,"value":247},"app = Flask(__name__)\n",{"type":36,"tag":210,"props":249,"children":251},{"class":212,"line":250},5,[252],{"type":36,"tag":210,"props":253,"children":254},{"emptyLinePlaceholder":235},[255],{"type":42,"value":238},{"type":36,"tag":210,"props":257,"children":259},{"class":212,"line":258},6,[260],{"type":36,"tag":210,"props":261,"children":262},{},[263],{"type":42,"value":264},"@app.route(\"\u002Fvoice\", methods=[\"POST\"])\n",{"type":36,"tag":210,"props":266,"children":268},{"class":212,"line":267},7,[269],{"type":36,"tag":210,"props":270,"children":271},{},[272],{"type":42,"value":273},"def incoming_call():\n",{"type":36,"tag":210,"props":275,"children":277},{"class":212,"line":276},8,[278],{"type":36,"tag":210,"props":279,"children":280},{},[281],{"type":42,"value":282},"    call_sid = request.form[\"CallSid\"]\n",{"type":36,"tag":210,"props":284,"children":286},{"class":212,"line":285},9,[287],{"type":36,"tag":210,"props":288,"children":289},{},[290],{"type":42,"value":291},"    response = VoiceResponse()\n",{"type":36,"tag":210,"props":293,"children":295},{"class":212,"line":294},10,[296],{"type":36,"tag":210,"props":297,"children":298},{},[299],{"type":42,"value":300},"    dial = response.dial()\n",{"type":36,"tag":210,"props":302,"children":304},{"class":212,"line":303},11,[305],{"type":36,"tag":210,"props":306,"children":307},{},[308],{"type":42,"value":309},"    dial.conference(\n",{"type":36,"tag":210,"props":311,"children":313},{"class":212,"line":312},12,[314],{"type":36,"tag":210,"props":315,"children":316},{},[317],{"type":42,"value":318},"        f\"room-{call_sid}\",\n",{"type":36,"tag":210,"props":320,"children":322},{"class":212,"line":321},13,[323],{"type":36,"tag":210,"props":324,"children":325},{},[326],{"type":42,"value":327},"        start_conference_on_enter=True,\n",{"type":36,"tag":210,"props":329,"children":331},{"class":212,"line":330},14,[332],{"type":36,"tag":210,"props":333,"children":334},{},[335],{"type":42,"value":336},"        end_conference_on_exit=False,  # Keep conference alive when caller disconnects (for wrap-up)\n",{"type":36,"tag":210,"props":338,"children":340},{"class":212,"line":339},15,[341],{"type":36,"tag":210,"props":342,"children":343},{},[344],{"type":42,"value":345},"        wait_url=\"http:\u002F\u002Ftwimlets.com\u002Fholdmusic?Bucket=com.twilio.music.classical\",\n",{"type":36,"tag":210,"props":347,"children":349},{"class":212,"line":348},16,[350],{"type":36,"tag":210,"props":351,"children":352},{},[353],{"type":42,"value":354},"        status_callback=\"https:\u002F\u002Fyourapp.com\u002Fconference-events\",\n",{"type":36,"tag":210,"props":356,"children":358},{"class":212,"line":357},17,[359],{"type":36,"tag":210,"props":360,"children":361},{},[362],{"type":42,"value":363},"        status_callback_event=\"join leave\",\n",{"type":36,"tag":210,"props":365,"children":367},{"class":212,"line":366},18,[368],{"type":36,"tag":210,"props":369,"children":370},{},[371],{"type":42,"value":372},"        record=\"record-from-start\"\n",{"type":36,"tag":210,"props":374,"children":376},{"class":212,"line":375},19,[377],{"type":36,"tag":210,"props":378,"children":379},{},[380],{"type":42,"value":381},"    )\n",{"type":36,"tag":210,"props":383,"children":385},{"class":212,"line":384},20,[386],{"type":36,"tag":210,"props":387,"children":388},{},[389],{"type":42,"value":390},"    return str(response)\n",{"type":36,"tag":45,"props":392,"children":393},{},[394],{"type":36,"tag":51,"props":395,"children":396},{},[397],{"type":42,"value":398},"Node.js (Express)",{"type":36,"tag":68,"props":400,"children":404},{"className":401,"code":402,"language":403,"meta":76,"style":76},"language-node shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","app.post(\"\u002Fvoice\", (req, res) => {\n    const callSid = req.body.CallSid;\n    const response = new VoiceResponse();\n    const dial = response.dial();\n    dial.conference(\n        `room-${callSid}`,\n        {\n            startConferenceOnEnter: true,\n            endConferenceOnExit: false,\n            waitUrl: \"http:\u002F\u002Ftwimlets.com\u002Fholdmusic?Bucket=com.twilio.music.classical\",\n            statusCallback: \"https:\u002F\u002Fyourapp.com\u002Fconference-events\",\n            statusCallbackEvent: \"join leave\",\n            record: \"record-from-start\",\n        }\n    );\n    res.type(\"text\u002Fxml\").send(response.toString());\n});\n","node",[405],{"type":36,"tag":59,"props":406,"children":407},{"__ignoreMap":76},[408,416,424,432,440,447,455,463,471,479,487,495,503,511,519,527,535],{"type":36,"tag":210,"props":409,"children":410},{"class":212,"line":213},[411],{"type":36,"tag":210,"props":412,"children":413},{},[414],{"type":42,"value":415},"app.post(\"\u002Fvoice\", (req, res) => {\n",{"type":36,"tag":210,"props":417,"children":418},{"class":212,"line":222},[419],{"type":36,"tag":210,"props":420,"children":421},{},[422],{"type":42,"value":423},"    const callSid = req.body.CallSid;\n",{"type":36,"tag":210,"props":425,"children":426},{"class":212,"line":231},[427],{"type":36,"tag":210,"props":428,"children":429},{},[430],{"type":42,"value":431},"    const response = new VoiceResponse();\n",{"type":36,"tag":210,"props":433,"children":434},{"class":212,"line":241},[435],{"type":36,"tag":210,"props":436,"children":437},{},[438],{"type":42,"value":439},"    const dial = response.dial();\n",{"type":36,"tag":210,"props":441,"children":442},{"class":212,"line":250},[443],{"type":36,"tag":210,"props":444,"children":445},{},[446],{"type":42,"value":309},{"type":36,"tag":210,"props":448,"children":449},{"class":212,"line":258},[450],{"type":36,"tag":210,"props":451,"children":452},{},[453],{"type":42,"value":454},"        `room-${callSid}`,\n",{"type":36,"tag":210,"props":456,"children":457},{"class":212,"line":267},[458],{"type":36,"tag":210,"props":459,"children":460},{},[461],{"type":42,"value":462},"        {\n",{"type":36,"tag":210,"props":464,"children":465},{"class":212,"line":276},[466],{"type":36,"tag":210,"props":467,"children":468},{},[469],{"type":42,"value":470},"            startConferenceOnEnter: true,\n",{"type":36,"tag":210,"props":472,"children":473},{"class":212,"line":285},[474],{"type":36,"tag":210,"props":475,"children":476},{},[477],{"type":42,"value":478},"            endConferenceOnExit: false,\n",{"type":36,"tag":210,"props":480,"children":481},{"class":212,"line":294},[482],{"type":36,"tag":210,"props":483,"children":484},{},[485],{"type":42,"value":486},"            waitUrl: \"http:\u002F\u002Ftwimlets.com\u002Fholdmusic?Bucket=com.twilio.music.classical\",\n",{"type":36,"tag":210,"props":488,"children":489},{"class":212,"line":303},[490],{"type":36,"tag":210,"props":491,"children":492},{},[493],{"type":42,"value":494},"            statusCallback: \"https:\u002F\u002Fyourapp.com\u002Fconference-events\",\n",{"type":36,"tag":210,"props":496,"children":497},{"class":212,"line":312},[498],{"type":36,"tag":210,"props":499,"children":500},{},[501],{"type":42,"value":502},"            statusCallbackEvent: \"join leave\",\n",{"type":36,"tag":210,"props":504,"children":505},{"class":212,"line":321},[506],{"type":36,"tag":210,"props":507,"children":508},{},[509],{"type":42,"value":510},"            record: \"record-from-start\",\n",{"type":36,"tag":210,"props":512,"children":513},{"class":212,"line":330},[514],{"type":36,"tag":210,"props":515,"children":516},{},[517],{"type":42,"value":518},"        }\n",{"type":36,"tag":210,"props":520,"children":521},{"class":212,"line":339},[522],{"type":36,"tag":210,"props":523,"children":524},{},[525],{"type":42,"value":526},"    );\n",{"type":36,"tag":210,"props":528,"children":529},{"class":212,"line":348},[530],{"type":36,"tag":210,"props":531,"children":532},{},[533],{"type":42,"value":534},"    res.type(\"text\u002Fxml\").send(response.toString());\n",{"type":36,"tag":210,"props":536,"children":537},{"class":212,"line":357},[538],{"type":36,"tag":210,"props":539,"children":540},{},[541],{"type":42,"value":542},"});\n",{"type":36,"tag":45,"props":544,"children":545},{},[546],{"type":36,"tag":51,"props":547,"children":548},{},[549],{"type":42,"value":550},"Step 2 — Connect an agent to the same Conference",{"type":36,"tag":45,"props":552,"children":553},{},[554],{"type":42,"value":555},"After TaskRouter assigns a worker, dial the agent into the conference:",{"type":36,"tag":557,"props":558,"children":559},"blockquote",{},[560],{"type":36,"tag":45,"props":561,"children":562},{},[563,568,570,576,578,584],{"type":36,"tag":51,"props":564,"children":565},{},[566],{"type":42,"value":567},"Security:",{"type":42,"value":569}," Never interpolate untrusted user input into inline ",{"type":36,"tag":59,"props":571,"children":573},{"className":572},[],[574],{"type":42,"value":575},"twiml=",{"type":42,"value":577}," strings. Use the SDK's ",{"type":36,"tag":59,"props":579,"children":581},{"className":580},[],[582],{"type":42,"value":583},"VoiceResponse",{"type":42,"value":585}," builder for any dynamic content.",{"type":36,"tag":45,"props":587,"children":588},{},[589],{"type":36,"tag":51,"props":590,"children":591},{},[592],{"type":42,"value":593},"Python",{"type":36,"tag":68,"props":595,"children":597},{"className":202,"code":596,"language":204,"meta":76,"style":76},"# Called from your assignment callback or agent connect logic\ndef connect_agent(conference_name, agent_phone):\n    client.calls.create(\n        to=agent_phone,\n        from_=\"+15551234567\",  # your Twilio number\n        twiml=f'''\u003CResponse>\n            \u003CDial>\n                \u003CConference>{conference_name}\u003C\u002FConference>\n            \u003C\u002FDial>\n        \u003C\u002FResponse>''',\n        status_callback=\"https:\u002F\u002Fyourapp.com\u002Fagent-call-status\"\n    )\n",[598],{"type":36,"tag":59,"props":599,"children":600},{"__ignoreMap":76},[601,609,617,625,633,641,649,657,665,673,681,689],{"type":36,"tag":210,"props":602,"children":603},{"class":212,"line":213},[604],{"type":36,"tag":210,"props":605,"children":606},{},[607],{"type":42,"value":608},"# Called from your assignment callback or agent connect logic\n",{"type":36,"tag":210,"props":610,"children":611},{"class":212,"line":222},[612],{"type":36,"tag":210,"props":613,"children":614},{},[615],{"type":42,"value":616},"def connect_agent(conference_name, agent_phone):\n",{"type":36,"tag":210,"props":618,"children":619},{"class":212,"line":231},[620],{"type":36,"tag":210,"props":621,"children":622},{},[623],{"type":42,"value":624},"    client.calls.create(\n",{"type":36,"tag":210,"props":626,"children":627},{"class":212,"line":241},[628],{"type":36,"tag":210,"props":629,"children":630},{},[631],{"type":42,"value":632},"        to=agent_phone,\n",{"type":36,"tag":210,"props":634,"children":635},{"class":212,"line":250},[636],{"type":36,"tag":210,"props":637,"children":638},{},[639],{"type":42,"value":640},"        from_=\"+15551234567\",  # your Twilio number\n",{"type":36,"tag":210,"props":642,"children":643},{"class":212,"line":258},[644],{"type":36,"tag":210,"props":645,"children":646},{},[647],{"type":42,"value":648},"        twiml=f'''\u003CResponse>\n",{"type":36,"tag":210,"props":650,"children":651},{"class":212,"line":267},[652],{"type":36,"tag":210,"props":653,"children":654},{},[655],{"type":42,"value":656},"            \u003CDial>\n",{"type":36,"tag":210,"props":658,"children":659},{"class":212,"line":276},[660],{"type":36,"tag":210,"props":661,"children":662},{},[663],{"type":42,"value":664},"                \u003CConference>{conference_name}\u003C\u002FConference>\n",{"type":36,"tag":210,"props":666,"children":667},{"class":212,"line":285},[668],{"type":36,"tag":210,"props":669,"children":670},{},[671],{"type":42,"value":672},"            \u003C\u002FDial>\n",{"type":36,"tag":210,"props":674,"children":675},{"class":212,"line":294},[676],{"type":36,"tag":210,"props":677,"children":678},{},[679],{"type":42,"value":680},"        \u003C\u002FResponse>''',\n",{"type":36,"tag":210,"props":682,"children":683},{"class":212,"line":303},[684],{"type":36,"tag":210,"props":685,"children":686},{},[687],{"type":42,"value":688},"        status_callback=\"https:\u002F\u002Fyourapp.com\u002Fagent-call-status\"\n",{"type":36,"tag":210,"props":690,"children":691},{"class":212,"line":312},[692],{"type":36,"tag":210,"props":693,"children":694},{},[695],{"type":42,"value":381},{"type":36,"tag":45,"props":697,"children":698},{},[699],{"type":36,"tag":51,"props":700,"children":701},{},[702],{"type":42,"value":703},"Node.js",{"type":36,"tag":68,"props":705,"children":707},{"className":401,"code":706,"language":403,"meta":76,"style":76},"async function connectAgent(conferenceName, agentPhone) {\n    await client.calls.create({\n        to: agentPhone,\n        from: \"+15551234567\",\n        twiml: `\u003CResponse>\u003CDial>\u003CConference>${conferenceName}\u003C\u002FConference>\u003C\u002FDial>\u003C\u002FResponse>`,\n        statusCallback: \"https:\u002F\u002Fyourapp.com\u002Fagent-call-status\",\n    });\n}\n",[708],{"type":36,"tag":59,"props":709,"children":710},{"__ignoreMap":76},[711,719,727,735,743,751,759,767],{"type":36,"tag":210,"props":712,"children":713},{"class":212,"line":213},[714],{"type":36,"tag":210,"props":715,"children":716},{},[717],{"type":42,"value":718},"async function connectAgent(conferenceName, agentPhone) {\n",{"type":36,"tag":210,"props":720,"children":721},{"class":212,"line":222},[722],{"type":36,"tag":210,"props":723,"children":724},{},[725],{"type":42,"value":726},"    await client.calls.create({\n",{"type":36,"tag":210,"props":728,"children":729},{"class":212,"line":231},[730],{"type":36,"tag":210,"props":731,"children":732},{},[733],{"type":42,"value":734},"        to: agentPhone,\n",{"type":36,"tag":210,"props":736,"children":737},{"class":212,"line":241},[738],{"type":36,"tag":210,"props":739,"children":740},{},[741],{"type":42,"value":742},"        from: \"+15551234567\",\n",{"type":36,"tag":210,"props":744,"children":745},{"class":212,"line":250},[746],{"type":36,"tag":210,"props":747,"children":748},{},[749],{"type":42,"value":750},"        twiml: `\u003CResponse>\u003CDial>\u003CConference>${conferenceName}\u003C\u002FConference>\u003C\u002FDial>\u003C\u002FResponse>`,\n",{"type":36,"tag":210,"props":752,"children":753},{"class":212,"line":258},[754],{"type":36,"tag":210,"props":755,"children":756},{},[757],{"type":42,"value":758},"        statusCallback: \"https:\u002F\u002Fyourapp.com\u002Fagent-call-status\",\n",{"type":36,"tag":210,"props":760,"children":761},{"class":212,"line":267},[762],{"type":36,"tag":210,"props":763,"children":764},{},[765],{"type":42,"value":766},"    });\n",{"type":36,"tag":210,"props":768,"children":769},{"class":212,"line":276},[770],{"type":36,"tag":210,"props":771,"children":772},{},[773],{"type":42,"value":774},"}\n",{"type":36,"tag":90,"props":776,"children":777},{},[],{"type":36,"tag":37,"props":779,"children":781},{"id":780},"key-patterns",[782],{"type":42,"value":783},"Key Patterns",{"type":36,"tag":785,"props":786,"children":788},"h3",{"id":787},"warm-transfer",[789],{"type":42,"value":790},"Warm Transfer",{"type":36,"tag":45,"props":792,"children":793},{},[794],{"type":42,"value":795},"Put caller on hold → dial new agent into Conference → original agent briefs new agent → original agent drops.",{"type":36,"tag":45,"props":797,"children":798},{},[799],{"type":36,"tag":51,"props":800,"children":801},{},[802],{"type":42,"value":593},{"type":36,"tag":68,"props":804,"children":806},{"className":202,"code":805,"language":204,"meta":76,"style":76},"def warm_transfer(conference_sid, original_agent_call_sid, new_agent_phone, conference_name):\n    # Step 1: Put caller on hold (hold = hears music, can't hear agents)\n    caller_participant = client.conferences(conference_sid) \\\n        .participants(caller_call_sid) \\\n        .update(hold=True)\n\n    # Step 2: Dial new agent into the same conference\n    client.calls.create(\n        to=new_agent_phone,\n        from_=\"+15551234567\",\n        twiml=f'\u003CResponse>\u003CDial>\u003CConference>{conference_name}\u003C\u002FConference>\u003C\u002FDial>\u003C\u002FResponse>',\n        status_callback=\"https:\u002F\u002Fyourapp.com\u002Ftransfer-agent-status\"\n    )\n\n    # Step 3: Original agent briefs new agent (caller is on hold, can't hear)\n    # ... agents talk ...\n\n    # Step 4: Take caller off hold\n    client.conferences(conference_sid) \\\n        .participants(caller_call_sid) \\\n        .update(hold=False)\n\n    # Step 5: Original agent leaves\n    client.conferences(conference_sid) \\\n        .participants(original_agent_call_sid) \\\n        .update(status=\"completed\")  # Removes from conference\n",[807],{"type":36,"tag":59,"props":808,"children":809},{"__ignoreMap":76},[810,818,826,834,842,850,857,865,872,880,888,896,904,911,918,926,934,941,949,957,964,973,981,990,998,1007],{"type":36,"tag":210,"props":811,"children":812},{"class":212,"line":213},[813],{"type":36,"tag":210,"props":814,"children":815},{},[816],{"type":42,"value":817},"def warm_transfer(conference_sid, original_agent_call_sid, new_agent_phone, conference_name):\n",{"type":36,"tag":210,"props":819,"children":820},{"class":212,"line":222},[821],{"type":36,"tag":210,"props":822,"children":823},{},[824],{"type":42,"value":825},"    # Step 1: Put caller on hold (hold = hears music, can't hear agents)\n",{"type":36,"tag":210,"props":827,"children":828},{"class":212,"line":231},[829],{"type":36,"tag":210,"props":830,"children":831},{},[832],{"type":42,"value":833},"    caller_participant = client.conferences(conference_sid) \\\n",{"type":36,"tag":210,"props":835,"children":836},{"class":212,"line":241},[837],{"type":36,"tag":210,"props":838,"children":839},{},[840],{"type":42,"value":841},"        .participants(caller_call_sid) \\\n",{"type":36,"tag":210,"props":843,"children":844},{"class":212,"line":250},[845],{"type":36,"tag":210,"props":846,"children":847},{},[848],{"type":42,"value":849},"        .update(hold=True)\n",{"type":36,"tag":210,"props":851,"children":852},{"class":212,"line":258},[853],{"type":36,"tag":210,"props":854,"children":855},{"emptyLinePlaceholder":235},[856],{"type":42,"value":238},{"type":36,"tag":210,"props":858,"children":859},{"class":212,"line":267},[860],{"type":36,"tag":210,"props":861,"children":862},{},[863],{"type":42,"value":864},"    # Step 2: Dial new agent into the same conference\n",{"type":36,"tag":210,"props":866,"children":867},{"class":212,"line":276},[868],{"type":36,"tag":210,"props":869,"children":870},{},[871],{"type":42,"value":624},{"type":36,"tag":210,"props":873,"children":874},{"class":212,"line":285},[875],{"type":36,"tag":210,"props":876,"children":877},{},[878],{"type":42,"value":879},"        to=new_agent_phone,\n",{"type":36,"tag":210,"props":881,"children":882},{"class":212,"line":294},[883],{"type":36,"tag":210,"props":884,"children":885},{},[886],{"type":42,"value":887},"        from_=\"+15551234567\",\n",{"type":36,"tag":210,"props":889,"children":890},{"class":212,"line":303},[891],{"type":36,"tag":210,"props":892,"children":893},{},[894],{"type":42,"value":895},"        twiml=f'\u003CResponse>\u003CDial>\u003CConference>{conference_name}\u003C\u002FConference>\u003C\u002FDial>\u003C\u002FResponse>',\n",{"type":36,"tag":210,"props":897,"children":898},{"class":212,"line":312},[899],{"type":36,"tag":210,"props":900,"children":901},{},[902],{"type":42,"value":903},"        status_callback=\"https:\u002F\u002Fyourapp.com\u002Ftransfer-agent-status\"\n",{"type":36,"tag":210,"props":905,"children":906},{"class":212,"line":321},[907],{"type":36,"tag":210,"props":908,"children":909},{},[910],{"type":42,"value":381},{"type":36,"tag":210,"props":912,"children":913},{"class":212,"line":330},[914],{"type":36,"tag":210,"props":915,"children":916},{"emptyLinePlaceholder":235},[917],{"type":42,"value":238},{"type":36,"tag":210,"props":919,"children":920},{"class":212,"line":339},[921],{"type":36,"tag":210,"props":922,"children":923},{},[924],{"type":42,"value":925},"    # Step 3: Original agent briefs new agent (caller is on hold, can't hear)\n",{"type":36,"tag":210,"props":927,"children":928},{"class":212,"line":348},[929],{"type":36,"tag":210,"props":930,"children":931},{},[932],{"type":42,"value":933},"    # ... agents talk ...\n",{"type":36,"tag":210,"props":935,"children":936},{"class":212,"line":357},[937],{"type":36,"tag":210,"props":938,"children":939},{"emptyLinePlaceholder":235},[940],{"type":42,"value":238},{"type":36,"tag":210,"props":942,"children":943},{"class":212,"line":366},[944],{"type":36,"tag":210,"props":945,"children":946},{},[947],{"type":42,"value":948},"    # Step 4: Take caller off hold\n",{"type":36,"tag":210,"props":950,"children":951},{"class":212,"line":375},[952],{"type":36,"tag":210,"props":953,"children":954},{},[955],{"type":42,"value":956},"    client.conferences(conference_sid) \\\n",{"type":36,"tag":210,"props":958,"children":959},{"class":212,"line":384},[960],{"type":36,"tag":210,"props":961,"children":962},{},[963],{"type":42,"value":841},{"type":36,"tag":210,"props":965,"children":967},{"class":212,"line":966},21,[968],{"type":36,"tag":210,"props":969,"children":970},{},[971],{"type":42,"value":972},"        .update(hold=False)\n",{"type":36,"tag":210,"props":974,"children":976},{"class":212,"line":975},22,[977],{"type":36,"tag":210,"props":978,"children":979},{"emptyLinePlaceholder":235},[980],{"type":42,"value":238},{"type":36,"tag":210,"props":982,"children":984},{"class":212,"line":983},23,[985],{"type":36,"tag":210,"props":986,"children":987},{},[988],{"type":42,"value":989},"    # Step 5: Original agent leaves\n",{"type":36,"tag":210,"props":991,"children":993},{"class":212,"line":992},24,[994],{"type":36,"tag":210,"props":995,"children":996},{},[997],{"type":42,"value":956},{"type":36,"tag":210,"props":999,"children":1001},{"class":212,"line":1000},25,[1002],{"type":36,"tag":210,"props":1003,"children":1004},{},[1005],{"type":42,"value":1006},"        .participants(original_agent_call_sid) \\\n",{"type":36,"tag":210,"props":1008,"children":1010},{"class":212,"line":1009},26,[1011],{"type":36,"tag":210,"props":1012,"children":1013},{},[1014],{"type":42,"value":1015},"        .update(status=\"completed\")  # Removes from conference\n",{"type":36,"tag":785,"props":1017,"children":1019},{"id":1018},"cold-transfer",[1020],{"type":42,"value":1021},"Cold Transfer",{"type":36,"tag":45,"props":1023,"children":1024},{},[1025],{"type":42,"value":1026},"Simpler — just redirect the caller to a new agent without briefing.",{"type":36,"tag":45,"props":1028,"children":1029},{},[1030],{"type":36,"tag":51,"props":1031,"children":1032},{},[1033],{"type":42,"value":593},{"type":36,"tag":68,"props":1035,"children":1037},{"className":202,"code":1036,"language":204,"meta":76,"style":76},"def cold_transfer(conference_sid, original_agent_call_sid, new_agent_phone, conference_name):\n    # Remove original agent\n    client.conferences(conference_sid) \\\n        .participants(original_agent_call_sid) \\\n        .update(status=\"completed\")\n\n    # Dial new agent into conference\n    client.calls.create(\n        to=new_agent_phone,\n        from_=\"+15551234567\",\n        twiml=f'\u003CResponse>\u003CDial>\u003CConference>{conference_name}\u003C\u002FConference>\u003C\u002FDial>\u003C\u002FResponse>'\n    )\n",[1038],{"type":36,"tag":59,"props":1039,"children":1040},{"__ignoreMap":76},[1041,1049,1057,1064,1071,1079,1086,1094,1101,1108,1115,1123],{"type":36,"tag":210,"props":1042,"children":1043},{"class":212,"line":213},[1044],{"type":36,"tag":210,"props":1045,"children":1046},{},[1047],{"type":42,"value":1048},"def cold_transfer(conference_sid, original_agent_call_sid, new_agent_phone, conference_name):\n",{"type":36,"tag":210,"props":1050,"children":1051},{"class":212,"line":222},[1052],{"type":36,"tag":210,"props":1053,"children":1054},{},[1055],{"type":42,"value":1056},"    # Remove original agent\n",{"type":36,"tag":210,"props":1058,"children":1059},{"class":212,"line":231},[1060],{"type":36,"tag":210,"props":1061,"children":1062},{},[1063],{"type":42,"value":956},{"type":36,"tag":210,"props":1065,"children":1066},{"class":212,"line":241},[1067],{"type":36,"tag":210,"props":1068,"children":1069},{},[1070],{"type":42,"value":1006},{"type":36,"tag":210,"props":1072,"children":1073},{"class":212,"line":250},[1074],{"type":36,"tag":210,"props":1075,"children":1076},{},[1077],{"type":42,"value":1078},"        .update(status=\"completed\")\n",{"type":36,"tag":210,"props":1080,"children":1081},{"class":212,"line":258},[1082],{"type":36,"tag":210,"props":1083,"children":1084},{"emptyLinePlaceholder":235},[1085],{"type":42,"value":238},{"type":36,"tag":210,"props":1087,"children":1088},{"class":212,"line":267},[1089],{"type":36,"tag":210,"props":1090,"children":1091},{},[1092],{"type":42,"value":1093},"    # Dial new agent into conference\n",{"type":36,"tag":210,"props":1095,"children":1096},{"class":212,"line":276},[1097],{"type":36,"tag":210,"props":1098,"children":1099},{},[1100],{"type":42,"value":624},{"type":36,"tag":210,"props":1102,"children":1103},{"class":212,"line":285},[1104],{"type":36,"tag":210,"props":1105,"children":1106},{},[1107],{"type":42,"value":879},{"type":36,"tag":210,"props":1109,"children":1110},{"class":212,"line":294},[1111],{"type":36,"tag":210,"props":1112,"children":1113},{},[1114],{"type":42,"value":887},{"type":36,"tag":210,"props":1116,"children":1117},{"class":212,"line":303},[1118],{"type":36,"tag":210,"props":1119,"children":1120},{},[1121],{"type":42,"value":1122},"        twiml=f'\u003CResponse>\u003CDial>\u003CConference>{conference_name}\u003C\u002FConference>\u003C\u002FDial>\u003C\u002FResponse>'\n",{"type":36,"tag":210,"props":1124,"children":1125},{"class":212,"line":312},[1126],{"type":36,"tag":210,"props":1127,"children":1128},{},[1129],{"type":42,"value":381},{"type":36,"tag":785,"props":1131,"children":1133},{"id":1132},"hold-vs-mute",[1134],{"type":42,"value":1135},"Hold vs Mute",{"type":36,"tag":1137,"props":1138,"children":1139},"table",{},[1140,1164],{"type":36,"tag":1141,"props":1142,"children":1143},"thead",{},[1144],{"type":36,"tag":1145,"props":1146,"children":1147},"tr",{},[1148,1154,1159],{"type":36,"tag":1149,"props":1150,"children":1151},"th",{},[1152],{"type":42,"value":1153},"Feature",{"type":36,"tag":1149,"props":1155,"children":1156},{},[1157],{"type":42,"value":1158},"Hold",{"type":36,"tag":1149,"props":1160,"children":1161},{},[1162],{"type":42,"value":1163},"Mute",{"type":36,"tag":1165,"props":1166,"children":1167},"tbody",{},[1168,1187,1205,1223],{"type":36,"tag":1145,"props":1169,"children":1170},{},[1171,1177,1182],{"type":36,"tag":1172,"props":1173,"children":1174},"td",{},[1175],{"type":42,"value":1176},"Participant hears",{"type":36,"tag":1172,"props":1178,"children":1179},{},[1180],{"type":42,"value":1181},"Hold music",{"type":36,"tag":1172,"props":1183,"children":1184},{},[1185],{"type":42,"value":1186},"Everything (but can't speak)",{"type":36,"tag":1145,"props":1188,"children":1189},{},[1190,1195,1200],{"type":36,"tag":1172,"props":1191,"children":1192},{},[1193],{"type":42,"value":1194},"Other participants hear",{"type":36,"tag":1172,"props":1196,"children":1197},{},[1198],{"type":42,"value":1199},"Nothing from held party",{"type":36,"tag":1172,"props":1201,"children":1202},{},[1203],{"type":42,"value":1204},"Nothing from muted party",{"type":36,"tag":1145,"props":1206,"children":1207},{},[1208,1213,1218],{"type":36,"tag":1172,"props":1209,"children":1210},{},[1211],{"type":42,"value":1212},"Use when",{"type":36,"tag":1172,"props":1214,"children":1215},{},[1216],{"type":42,"value":1217},"Transfer briefing, agent lookup",{"type":36,"tag":1172,"props":1219,"children":1220},{},[1221],{"type":42,"value":1222},"Quick aside (agent mutes self to cough)",{"type":36,"tag":1145,"props":1224,"children":1225},{},[1226,1231,1240],{"type":36,"tag":1172,"props":1227,"children":1228},{},[1229],{"type":42,"value":1230},"API",{"type":36,"tag":1172,"props":1232,"children":1233},{},[1234],{"type":36,"tag":59,"props":1235,"children":1237},{"className":1236},[],[1238],{"type":42,"value":1239},"hold=True",{"type":36,"tag":1172,"props":1241,"children":1242},{},[1243],{"type":36,"tag":59,"props":1244,"children":1246},{"className":1245},[],[1247],{"type":42,"value":1248},"muted=True",{"type":36,"tag":68,"props":1250,"children":1252},{"className":202,"code":1251,"language":204,"meta":76,"style":76},"# Hold — plays music to the held participant\nclient.conferences(conf_sid).participants(participant_sid).update(hold=True)\nclient.conferences(conf_sid).participants(participant_sid).update(hold=False)\n\n# Mute — silences the participant but they still hear\nclient.conferences(conf_sid).participants(participant_sid).update(muted=True)\nclient.conferences(conf_sid).participants(participant_sid).update(muted=False)\n",[1253],{"type":36,"tag":59,"props":1254,"children":1255},{"__ignoreMap":76},[1256,1264,1272,1280,1287,1295,1303],{"type":36,"tag":210,"props":1257,"children":1258},{"class":212,"line":213},[1259],{"type":36,"tag":210,"props":1260,"children":1261},{},[1262],{"type":42,"value":1263},"# Hold — plays music to the held participant\n",{"type":36,"tag":210,"props":1265,"children":1266},{"class":212,"line":222},[1267],{"type":36,"tag":210,"props":1268,"children":1269},{},[1270],{"type":42,"value":1271},"client.conferences(conf_sid).participants(participant_sid).update(hold=True)\n",{"type":36,"tag":210,"props":1273,"children":1274},{"class":212,"line":231},[1275],{"type":36,"tag":210,"props":1276,"children":1277},{},[1278],{"type":42,"value":1279},"client.conferences(conf_sid).participants(participant_sid).update(hold=False)\n",{"type":36,"tag":210,"props":1281,"children":1282},{"class":212,"line":241},[1283],{"type":36,"tag":210,"props":1284,"children":1285},{"emptyLinePlaceholder":235},[1286],{"type":42,"value":238},{"type":36,"tag":210,"props":1288,"children":1289},{"class":212,"line":250},[1290],{"type":36,"tag":210,"props":1291,"children":1292},{},[1293],{"type":42,"value":1294},"# Mute — silences the participant but they still hear\n",{"type":36,"tag":210,"props":1296,"children":1297},{"class":212,"line":258},[1298],{"type":36,"tag":210,"props":1299,"children":1300},{},[1301],{"type":42,"value":1302},"client.conferences(conf_sid).participants(participant_sid).update(muted=True)\n",{"type":36,"tag":210,"props":1304,"children":1305},{"class":212,"line":267},[1306],{"type":36,"tag":210,"props":1307,"children":1308},{},[1309],{"type":42,"value":1310},"client.conferences(conf_sid).participants(participant_sid).update(muted=False)\n",{"type":36,"tag":45,"props":1312,"children":1313},{},[1314,1319],{"type":36,"tag":51,"props":1315,"children":1316},{},[1317],{"type":42,"value":1318},"Critical distinction:",{"type":42,"value":1320}," Hold plays music. Mute just silences. Using mute when you mean hold exposes agent-side conversations to the caller.",{"type":36,"tag":785,"props":1322,"children":1324},{"id":1323},"coaching-supervisor-whisper",[1325],{"type":42,"value":1326},"Coaching (Supervisor Whisper)",{"type":36,"tag":45,"props":1328,"children":1329},{},[1330],{"type":42,"value":1331},"Supervisor joins the Conference and can speak to the agent only — the caller cannot hear the supervisor.",{"type":36,"tag":45,"props":1333,"children":1334},{},[1335],{"type":36,"tag":51,"props":1336,"children":1337},{},[1338],{"type":42,"value":593},{"type":36,"tag":68,"props":1340,"children":1342},{"className":202,"code":1341,"language":204,"meta":76,"style":76},"def add_coach(conference_sid, supervisor_phone, conference_name):\n    \"\"\"Add supervisor as coach — speaks to agent only, caller can't hear.\"\"\"\n    client.calls.create(\n        to=supervisor_phone,\n        from_=\"+15551234567\",\n        twiml=f'''\u003CResponse>\n            \u003CDial>\n                \u003CConference\n                    coach=\"{agent_call_sid}\"\n                    statusCallback=\"https:\u002F\u002Fyourapp.com\u002Fcoach-events\"\n                >{conference_name}\u003C\u002FConference>\n            \u003C\u002FDial>\n        \u003C\u002FResponse>'''\n    )\n",[1343],{"type":36,"tag":59,"props":1344,"children":1345},{"__ignoreMap":76},[1346,1354,1362,1369,1377,1384,1391,1398,1406,1414,1422,1430,1437,1445],{"type":36,"tag":210,"props":1347,"children":1348},{"class":212,"line":213},[1349],{"type":36,"tag":210,"props":1350,"children":1351},{},[1352],{"type":42,"value":1353},"def add_coach(conference_sid, supervisor_phone, conference_name):\n",{"type":36,"tag":210,"props":1355,"children":1356},{"class":212,"line":222},[1357],{"type":36,"tag":210,"props":1358,"children":1359},{},[1360],{"type":42,"value":1361},"    \"\"\"Add supervisor as coach — speaks to agent only, caller can't hear.\"\"\"\n",{"type":36,"tag":210,"props":1363,"children":1364},{"class":212,"line":231},[1365],{"type":36,"tag":210,"props":1366,"children":1367},{},[1368],{"type":42,"value":624},{"type":36,"tag":210,"props":1370,"children":1371},{"class":212,"line":241},[1372],{"type":36,"tag":210,"props":1373,"children":1374},{},[1375],{"type":42,"value":1376},"        to=supervisor_phone,\n",{"type":36,"tag":210,"props":1378,"children":1379},{"class":212,"line":250},[1380],{"type":36,"tag":210,"props":1381,"children":1382},{},[1383],{"type":42,"value":887},{"type":36,"tag":210,"props":1385,"children":1386},{"class":212,"line":258},[1387],{"type":36,"tag":210,"props":1388,"children":1389},{},[1390],{"type":42,"value":648},{"type":36,"tag":210,"props":1392,"children":1393},{"class":212,"line":267},[1394],{"type":36,"tag":210,"props":1395,"children":1396},{},[1397],{"type":42,"value":656},{"type":36,"tag":210,"props":1399,"children":1400},{"class":212,"line":276},[1401],{"type":36,"tag":210,"props":1402,"children":1403},{},[1404],{"type":42,"value":1405},"                \u003CConference\n",{"type":36,"tag":210,"props":1407,"children":1408},{"class":212,"line":285},[1409],{"type":36,"tag":210,"props":1410,"children":1411},{},[1412],{"type":42,"value":1413},"                    coach=\"{agent_call_sid}\"\n",{"type":36,"tag":210,"props":1415,"children":1416},{"class":212,"line":294},[1417],{"type":36,"tag":210,"props":1418,"children":1419},{},[1420],{"type":42,"value":1421},"                    statusCallback=\"https:\u002F\u002Fyourapp.com\u002Fcoach-events\"\n",{"type":36,"tag":210,"props":1423,"children":1424},{"class":212,"line":303},[1425],{"type":36,"tag":210,"props":1426,"children":1427},{},[1428],{"type":42,"value":1429},"                >{conference_name}\u003C\u002FConference>\n",{"type":36,"tag":210,"props":1431,"children":1432},{"class":212,"line":312},[1433],{"type":36,"tag":210,"props":1434,"children":1435},{},[1436],{"type":42,"value":672},{"type":36,"tag":210,"props":1438,"children":1439},{"class":212,"line":321},[1440],{"type":36,"tag":210,"props":1441,"children":1442},{},[1443],{"type":42,"value":1444},"        \u003C\u002FResponse>'''\n",{"type":36,"tag":210,"props":1446,"children":1447},{"class":212,"line":330},[1448],{"type":36,"tag":210,"props":1449,"children":1450},{},[1451],{"type":42,"value":381},{"type":36,"tag":45,"props":1453,"children":1454},{},[1455],{"type":36,"tag":51,"props":1456,"children":1457},{},[1458],{"type":42,"value":703},{"type":36,"tag":68,"props":1460,"children":1462},{"className":401,"code":1461,"language":403,"meta":76,"style":76},"async function addCoach(conferenceSid, supervisorPhone, conferenceName, agentCallSid) {\n    await client.calls.create({\n        to: supervisorPhone,\n        from: \"+15551234567\",\n        twiml: `\u003CResponse>\n            \u003CDial>\n                \u003CConference coach=\"${agentCallSid}\">${conferenceName}\u003C\u002FConference>\n            \u003C\u002FDial>\n        \u003C\u002FResponse>`,\n    });\n}\n",[1463],{"type":36,"tag":59,"props":1464,"children":1465},{"__ignoreMap":76},[1466,1474,1481,1489,1496,1504,1511,1519,1526,1534,1541],{"type":36,"tag":210,"props":1467,"children":1468},{"class":212,"line":213},[1469],{"type":36,"tag":210,"props":1470,"children":1471},{},[1472],{"type":42,"value":1473},"async function addCoach(conferenceSid, supervisorPhone, conferenceName, agentCallSid) {\n",{"type":36,"tag":210,"props":1475,"children":1476},{"class":212,"line":222},[1477],{"type":36,"tag":210,"props":1478,"children":1479},{},[1480],{"type":42,"value":726},{"type":36,"tag":210,"props":1482,"children":1483},{"class":212,"line":231},[1484],{"type":36,"tag":210,"props":1485,"children":1486},{},[1487],{"type":42,"value":1488},"        to: supervisorPhone,\n",{"type":36,"tag":210,"props":1490,"children":1491},{"class":212,"line":241},[1492],{"type":36,"tag":210,"props":1493,"children":1494},{},[1495],{"type":42,"value":742},{"type":36,"tag":210,"props":1497,"children":1498},{"class":212,"line":250},[1499],{"type":36,"tag":210,"props":1500,"children":1501},{},[1502],{"type":42,"value":1503},"        twiml: `\u003CResponse>\n",{"type":36,"tag":210,"props":1505,"children":1506},{"class":212,"line":258},[1507],{"type":36,"tag":210,"props":1508,"children":1509},{},[1510],{"type":42,"value":656},{"type":36,"tag":210,"props":1512,"children":1513},{"class":212,"line":267},[1514],{"type":36,"tag":210,"props":1515,"children":1516},{},[1517],{"type":42,"value":1518},"                \u003CConference coach=\"${agentCallSid}\">${conferenceName}\u003C\u002FConference>\n",{"type":36,"tag":210,"props":1520,"children":1521},{"class":212,"line":276},[1522],{"type":36,"tag":210,"props":1523,"children":1524},{},[1525],{"type":42,"value":672},{"type":36,"tag":210,"props":1527,"children":1528},{"class":212,"line":285},[1529],{"type":36,"tag":210,"props":1530,"children":1531},{},[1532],{"type":42,"value":1533},"        \u003C\u002FResponse>`,\n",{"type":36,"tag":210,"props":1535,"children":1536},{"class":212,"line":294},[1537],{"type":36,"tag":210,"props":1538,"children":1539},{},[1540],{"type":42,"value":766},{"type":36,"tag":210,"props":1542,"children":1543},{"class":212,"line":303},[1544],{"type":36,"tag":210,"props":1545,"children":1546},{},[1547],{"type":42,"value":774},{"type":36,"tag":45,"props":1549,"children":1550},{},[1551],{"type":36,"tag":51,"props":1552,"children":1553},{},[1554],{"type":42,"value":1555},"Coach behavior:",{"type":36,"tag":100,"props":1557,"children":1558},{},[1559,1564,1569,1574],{"type":36,"tag":104,"props":1560,"children":1561},{},[1562],{"type":42,"value":1563},"Supervisor hears both caller and agent",{"type":36,"tag":104,"props":1565,"children":1566},{},[1567],{"type":42,"value":1568},"Supervisor can speak to agent only (caller cannot hear)",{"type":36,"tag":104,"props":1570,"children":1571},{},[1572],{"type":42,"value":1573},"Coach audio is NOT captured in conference recording — record separately if needed",{"type":36,"tag":104,"props":1575,"children":1576},{},[1577],{"type":42,"value":1578},"To switch from coach to barge (speak to everyone), update the participant",{"type":36,"tag":785,"props":1580,"children":1582},{"id":1581},"supervisor-barge",[1583],{"type":42,"value":1584},"Supervisor Barge",{"type":36,"tag":45,"props":1586,"children":1587},{},[1588],{"type":42,"value":1589},"Supervisor joins and speaks to everyone — useful for escalation or takeover.",{"type":36,"tag":68,"props":1591,"children":1593},{"className":202,"code":1592,"language":204,"meta":76,"style":76},"def barge_in(conference_sid, supervisor_phone, conference_name):\n    \"\"\"Supervisor joins as full participant — everyone hears them.\"\"\"\n    client.calls.create(\n        to=supervisor_phone,\n        from_=\"+15551234567\",\n        twiml=f'\u003CResponse>\u003CDial>\u003CConference>{conference_name}\u003C\u002FConference>\u003C\u002FDial>\u003C\u002FResponse>'\n    )\n",[1594],{"type":36,"tag":59,"props":1595,"children":1596},{"__ignoreMap":76},[1597,1605,1613,1620,1627,1634,1641],{"type":36,"tag":210,"props":1598,"children":1599},{"class":212,"line":213},[1600],{"type":36,"tag":210,"props":1601,"children":1602},{},[1603],{"type":42,"value":1604},"def barge_in(conference_sid, supervisor_phone, conference_name):\n",{"type":36,"tag":210,"props":1606,"children":1607},{"class":212,"line":222},[1608],{"type":36,"tag":210,"props":1609,"children":1610},{},[1611],{"type":42,"value":1612},"    \"\"\"Supervisor joins as full participant — everyone hears them.\"\"\"\n",{"type":36,"tag":210,"props":1614,"children":1615},{"class":212,"line":231},[1616],{"type":36,"tag":210,"props":1617,"children":1618},{},[1619],{"type":42,"value":624},{"type":36,"tag":210,"props":1621,"children":1622},{"class":212,"line":241},[1623],{"type":36,"tag":210,"props":1624,"children":1625},{},[1626],{"type":42,"value":1376},{"type":36,"tag":210,"props":1628,"children":1629},{"class":212,"line":250},[1630],{"type":36,"tag":210,"props":1631,"children":1632},{},[1633],{"type":42,"value":887},{"type":36,"tag":210,"props":1635,"children":1636},{"class":212,"line":258},[1637],{"type":36,"tag":210,"props":1638,"children":1639},{},[1640],{"type":42,"value":1122},{"type":36,"tag":210,"props":1642,"children":1643},{"class":212,"line":267},[1644],{"type":36,"tag":210,"props":1645,"children":1646},{},[1647],{"type":42,"value":381},{"type":36,"tag":785,"props":1649,"children":1651},{"id":1650},"participant-management",[1652],{"type":42,"value":1653},"Participant Management",{"type":36,"tag":68,"props":1655,"children":1657},{"className":202,"code":1656,"language":204,"meta":76,"style":76},"# List all participants in a conference\nparticipants = client.conferences(conference_sid).participants.list()\nfor p in participants:\n    print(f\"CallSid: {p.call_sid}, Muted: {p.muted}, Hold: {p.hold}\")\n\n# Remove a participant\nclient.conferences(conference_sid).participants(call_sid).update(status=\"completed\")\n\n# End the entire conference\nclient.conferences(conference_sid).update(status=\"completed\")\n",[1658],{"type":36,"tag":59,"props":1659,"children":1660},{"__ignoreMap":76},[1661,1669,1677,1685,1693,1700,1708,1716,1723,1731],{"type":36,"tag":210,"props":1662,"children":1663},{"class":212,"line":213},[1664],{"type":36,"tag":210,"props":1665,"children":1666},{},[1667],{"type":42,"value":1668},"# List all participants in a conference\n",{"type":36,"tag":210,"props":1670,"children":1671},{"class":212,"line":222},[1672],{"type":36,"tag":210,"props":1673,"children":1674},{},[1675],{"type":42,"value":1676},"participants = client.conferences(conference_sid).participants.list()\n",{"type":36,"tag":210,"props":1678,"children":1679},{"class":212,"line":231},[1680],{"type":36,"tag":210,"props":1681,"children":1682},{},[1683],{"type":42,"value":1684},"for p in participants:\n",{"type":36,"tag":210,"props":1686,"children":1687},{"class":212,"line":241},[1688],{"type":36,"tag":210,"props":1689,"children":1690},{},[1691],{"type":42,"value":1692},"    print(f\"CallSid: {p.call_sid}, Muted: {p.muted}, Hold: {p.hold}\")\n",{"type":36,"tag":210,"props":1694,"children":1695},{"class":212,"line":250},[1696],{"type":36,"tag":210,"props":1697,"children":1698},{"emptyLinePlaceholder":235},[1699],{"type":42,"value":238},{"type":36,"tag":210,"props":1701,"children":1702},{"class":212,"line":258},[1703],{"type":36,"tag":210,"props":1704,"children":1705},{},[1706],{"type":42,"value":1707},"# Remove a participant\n",{"type":36,"tag":210,"props":1709,"children":1710},{"class":212,"line":267},[1711],{"type":36,"tag":210,"props":1712,"children":1713},{},[1714],{"type":42,"value":1715},"client.conferences(conference_sid).participants(call_sid).update(status=\"completed\")\n",{"type":36,"tag":210,"props":1717,"children":1718},{"class":212,"line":276},[1719],{"type":36,"tag":210,"props":1720,"children":1721},{"emptyLinePlaceholder":235},[1722],{"type":42,"value":238},{"type":36,"tag":210,"props":1724,"children":1725},{"class":212,"line":285},[1726],{"type":36,"tag":210,"props":1727,"children":1728},{},[1729],{"type":42,"value":1730},"# End the entire conference\n",{"type":36,"tag":210,"props":1732,"children":1733},{"class":212,"line":294},[1734],{"type":36,"tag":210,"props":1735,"children":1736},{},[1737],{"type":42,"value":1738},"client.conferences(conference_sid).update(status=\"completed\")\n",{"type":36,"tag":90,"props":1740,"children":1741},{},[],{"type":36,"tag":37,"props":1743,"children":1745},{"id":1744},"gotchas",[1746],{"type":42,"value":1747},"Gotchas",{"type":36,"tag":785,"props":1749,"children":1751},{"id":1750},"_1-conference-requires-2-participants-to-exist",[1752],{"type":42,"value":1753},"1. Conference Requires 2+ Participants to \"Exist\"",{"type":36,"tag":45,"props":1755,"children":1756},{},[1757],{"type":42,"value":1758},"A Conference with only one participant is in a waiting state. The single participant hears hold music. API calls to the Conference may behave unexpectedly until a second participant joins.",{"type":36,"tag":785,"props":1760,"children":1762},{"id":1761},"_2-coach-audio-not-in-recording",[1763],{"type":42,"value":1764},"2. Coach Audio Not in Recording",{"type":36,"tag":45,"props":1766,"children":1767},{},[1768],{"type":42,"value":1769},"Conference recordings capture the main audio mix only. Coach\u002Fwhisper audio is NOT recorded. If you need to record coaching sessions for QA, add a separate recording on the supervisor's call leg.",{"type":36,"tag":785,"props":1771,"children":1773},{"id":1772},"_3-endconferenceonexit-behavior",[1774],{"type":42,"value":1775},"3. endConferenceOnExit Behavior",{"type":36,"tag":45,"props":1777,"children":1778},{},[1779,1781,1787],{"type":42,"value":1780},"If ",{"type":36,"tag":59,"props":1782,"children":1784},{"className":1783},[],[1785],{"type":42,"value":1786},"endConferenceOnExit=True",{"type":42,"value":1788}," for any participant, the conference ends when they leave — dropping all other participants. Set this carefully:",{"type":36,"tag":100,"props":1790,"children":1791},{},[1792,1805,1817],{"type":36,"tag":104,"props":1793,"children":1794},{},[1795,1797,1803],{"type":42,"value":1796},"Caller: Usually ",{"type":36,"tag":59,"props":1798,"children":1800},{"className":1799},[],[1801],{"type":42,"value":1802},"False",{"type":42,"value":1804}," (so agents can wrap up)",{"type":36,"tag":104,"props":1806,"children":1807},{},[1808,1810,1815],{"type":42,"value":1809},"Agent: Usually ",{"type":36,"tag":59,"props":1811,"children":1813},{"className":1812},[],[1814],{"type":42,"value":1802},{"type":42,"value":1816}," (so caller can be transferred)",{"type":36,"tag":104,"props":1818,"children":1819},{},[1820,1822],{"type":42,"value":1821},"Supervisor: Always ",{"type":36,"tag":59,"props":1823,"children":1825},{"className":1824},[],[1826],{"type":42,"value":1802},{"type":36,"tag":785,"props":1828,"children":1830},{"id":1829},"_4-conference-name-is-account-scoped",[1831],{"type":42,"value":1832},"4. Conference Name Is Account-Scoped",{"type":36,"tag":45,"props":1834,"children":1835},{},[1836],{"type":42,"value":1837},"Conference names must be unique within your account at any given time. Use a unique identifier (like CallSid) in the name to prevent collisions:",{"type":36,"tag":68,"props":1839,"children":1841},{"className":202,"code":1840,"language":204,"meta":76,"style":76},"conference_name = f\"room-{call_sid}\"  # unique per call\n",[1842],{"type":36,"tag":59,"props":1843,"children":1844},{"__ignoreMap":76},[1845],{"type":36,"tag":210,"props":1846,"children":1847},{"class":212,"line":213},[1848],{"type":36,"tag":210,"props":1849,"children":1850},{},[1851],{"type":42,"value":1840},{"type":36,"tag":90,"props":1853,"children":1854},{},[],{"type":36,"tag":37,"props":1856,"children":1858},{"id":1857},"cannot",[1859],{"type":42,"value":1860},"CANNOT",{"type":36,"tag":100,"props":1862,"children":1863},{},[1864,1882,1892,1902,1912,1928,1944,1954,1972,1982,1992,2002],{"type":36,"tag":104,"props":1865,"children":1866},{},[1867,1880],{"type":36,"tag":51,"props":1868,"children":1869},{},[1870,1872,1878],{"type":42,"value":1871},"Cannot use ",{"type":36,"tag":59,"props":1873,"children":1875},{"className":1874},[],[1876],{"type":42,"value":1877},"\u003CGather>",{"type":42,"value":1879}," inside a Conference",{"type":42,"value":1881}," — DTMF goes into the audio mix, not a handler. Gather before joining the conference.",{"type":36,"tag":104,"props":1883,"children":1884},{},[1885,1890],{"type":36,"tag":51,"props":1886,"children":1887},{},[1888],{"type":42,"value":1889},"Cannot rely on speaker events for app logic",{"type":42,"value":1891}," — Speaker events fire too frequently to be actionable in real-time routing.",{"type":36,"tag":104,"props":1893,"children":1894},{},[1895,1900],{"type":36,"tag":51,"props":1896,"children":1897},{},[1898],{"type":42,"value":1899},"Cannot get post-flight participant data from REST API",{"type":42,"value":1901}," — Completed conferences return empty participant lists. Use Voice Insights for historical data.",{"type":36,"tag":104,"props":1903,"children":1904},{},[1905,1910],{"type":36,"tag":51,"props":1906,"children":1907},{},[1908],{"type":42,"value":1909},"Coach audio is NOT in the conference recording",{"type":42,"value":1911}," — Supervisor whisper audio is excluded from the recorded mix. Record the supervisor's call leg separately if needed.",{"type":36,"tag":104,"props":1913,"children":1914},{},[1915,1926],{"type":36,"tag":51,"props":1916,"children":1917},{},[1918,1920],{"type":42,"value":1919},"Cannot filter Insights list endpoint by ",{"type":36,"tag":59,"props":1921,"children":1923},{"className":1922},[],[1924],{"type":42,"value":1925},"processing_state",{"type":42,"value":1927}," — Must fetch by Conference SID directly.",{"type":36,"tag":104,"props":1929,"children":1930},{},[1931,1942],{"type":36,"tag":51,"props":1932,"children":1933},{},[1934,1936],{"type":42,"value":1935},"Cannot use PII in ",{"type":36,"tag":59,"props":1937,"children":1939},{"className":1938},[],[1940],{"type":42,"value":1941},"friendlyName",{"type":42,"value":1943}," — Compliance requirement, not just a suggestion.",{"type":36,"tag":104,"props":1945,"children":1946},{},[1947,1952],{"type":36,"tag":51,"props":1948,"children":1949},{},[1950],{"type":42,"value":1951},"Cannot create a conference with 0 call legs and get Insights data",{"type":42,"value":1953}," — Insights requires at least 1 participant call attempt.",{"type":36,"tag":104,"props":1955,"children":1956},{},[1957,1962,1964,1970],{"type":36,"tag":51,"props":1958,"children":1959},{},[1960],{"type":42,"value":1961},"Cannot poll Insights immediately after conference end",{"type":42,"value":1963}," — Takes 15-30+ minutes for data to appear, even for ",{"type":36,"tag":59,"props":1965,"children":1967},{"className":1966},[],[1968],{"type":42,"value":1969},"in_progress",{"type":42,"value":1971}," state.",{"type":36,"tag":104,"props":1973,"children":1974},{},[1975,1980],{"type":36,"tag":51,"props":1976,"children":1977},{},[1978],{"type":42,"value":1979},"Cannot exceed 250 participants per conference",{"type":42,"value":1981}," — Hard limit",{"type":36,"tag":104,"props":1983,"children":1984},{},[1985,1990],{"type":36,"tag":51,"props":1986,"children":1987},{},[1988],{"type":42,"value":1989},"Cannot pre-add phone numbers to a conference",{"type":42,"value":1991}," — Participants must be active calls",{"type":36,"tag":104,"props":1993,"children":1994},{},[1995,2000],{"type":36,"tag":51,"props":1996,"children":1997},{},[1998],{"type":42,"value":1999},"Cannot use a private URL for hold music",{"type":42,"value":2001}," — Hold music URL must be publicly accessible",{"type":36,"tag":104,"props":2003,"children":2004},{},[2005,2010,2012],{"type":36,"tag":51,"props":2006,"children":2007},{},[2008],{"type":42,"value":2009},"Cannot get per-participant recordings from conference recording",{"type":42,"value":2011}," — Recording is per-conference (mono mixed). Use dual-channel recording for QA — see ",{"type":36,"tag":59,"props":2013,"children":2015},{"className":2014},[],[2016],{"type":42,"value":2017},"twilio-call-recordings",{"type":36,"tag":90,"props":2019,"children":2020},{},[],{"type":36,"tag":37,"props":2022,"children":2024},{"id":2023},"next-steps",[2025],{"type":42,"value":2026},"Next Steps",{"type":36,"tag":100,"props":2028,"children":2029},{},[2030,2045,2059,2074],{"type":36,"tag":104,"props":2031,"children":2032},{},[2033,2038,2040],{"type":36,"tag":51,"props":2034,"children":2035},{},[2036],{"type":42,"value":2037},"Route calls to agents:",{"type":42,"value":2039}," ",{"type":36,"tag":59,"props":2041,"children":2043},{"className":2042},[],[2044],{"type":42,"value":169},{"type":36,"tag":104,"props":2046,"children":2047},{},[2048,2053,2054],{"type":36,"tag":51,"props":2049,"children":2050},{},[2051],{"type":42,"value":2052},"Record calls:",{"type":42,"value":2039},{"type":36,"tag":59,"props":2055,"children":2057},{"className":2056},[],[2058],{"type":42,"value":2017},{"type":36,"tag":104,"props":2060,"children":2061},{},[2062,2067,2068],{"type":36,"tag":51,"props":2063,"children":2064},{},[2065],{"type":42,"value":2066},"IVR before conferencing:",{"type":42,"value":2039},{"type":36,"tag":59,"props":2069,"children":2071},{"className":2070},[],[2072],{"type":42,"value":2073},"twilio-voice-twiml",{"type":36,"tag":104,"props":2075,"children":2076},{},[2077,2082,2083],{"type":36,"tag":51,"props":2078,"children":2079},{},[2080],{"type":42,"value":2081},"AI agent with escalation:",{"type":42,"value":2039},{"type":36,"tag":59,"props":2084,"children":2086},{"className":2085},[],[2087],{"type":42,"value":2088},"twilio-voice-conversation-relay",{"type":36,"tag":2090,"props":2091,"children":2092},"style",{},[2093],{"type":42,"value":2094},"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":2096,"total":2217},[2097,2115,2131,2143,2163,2185,2205],{"slug":2098,"name":2098,"fn":2099,"description":2100,"org":2101,"tags":2102,"stars":19,"repoUrl":20,"updatedAt":21},"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},[2103,2106,2109,2112],{"name":2104,"slug":2105,"type":15},"Accessibility","accessibility",{"name":2107,"slug":2108,"type":15},"Charts","charts",{"name":2110,"slug":2111,"type":15},"Data Visualization","data-visualization",{"name":2113,"slug":2114,"type":15},"Design","design",{"slug":2116,"name":2116,"fn":2117,"description":2118,"org":2119,"tags":2120,"stars":19,"repoUrl":20,"updatedAt":2130},"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},[2121,2124,2127],{"name":2122,"slug":2123,"type":15},"Agents","agents",{"name":2125,"slug":2126,"type":15},"Browser Automation","browser-automation",{"name":2128,"slug":2129,"type":15},"Testing","testing","2026-04-06T18:41:03.44016",{"slug":2132,"name":2132,"fn":2133,"description":2134,"org":2135,"tags":2136,"stars":19,"repoUrl":20,"updatedAt":2142},"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},[2137,2138,2141],{"name":2125,"slug":2126,"type":15},{"name":2139,"slug":2140,"type":15},"Local Development","local-development",{"name":2128,"slug":2129,"type":15},"2026-04-06T18:41:17.526867",{"slug":2144,"name":2144,"fn":2145,"description":2146,"org":2147,"tags":2148,"stars":19,"repoUrl":20,"updatedAt":2162},"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},[2149,2150,2153,2156,2159],{"name":2122,"slug":2123,"type":15},{"name":2151,"slug":2152,"type":15},"Cloudflare Workers","cloudflare-workers",{"name":2154,"slug":2155,"type":15},"SDK","sdk",{"name":2157,"slug":2158,"type":15},"Serverless","serverless",{"name":2160,"slug":2161,"type":15},"WebSockets","websockets","2026-04-06T18:39:51.717063",{"slug":2164,"name":2164,"fn":2165,"description":2166,"org":2167,"tags":2168,"stars":19,"repoUrl":20,"updatedAt":2184},"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},[2169,2172,2175,2178,2181],{"name":2170,"slug":2171,"type":15},"Frontend","frontend",{"name":2173,"slug":2174,"type":15},"React","react",{"name":2176,"slug":2177,"type":15},"shadcn\u002Fui","shadcn-ui",{"name":2179,"slug":2180,"type":15},"UI Components","ui-components",{"name":2182,"slug":2183,"type":15},"Vercel","vercel","2026-04-06T18:40:59.619419",{"slug":2186,"name":2186,"fn":2187,"description":2188,"org":2189,"tags":2190,"stars":19,"repoUrl":20,"updatedAt":2204},"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},[2191,2194,2197,2200,2203],{"name":2192,"slug":2193,"type":15},"AI Infrastructure","ai-infrastructure",{"name":2195,"slug":2196,"type":15},"Cost Optimization","cost-optimization",{"name":2198,"slug":2199,"type":15},"LLM","llm",{"name":2201,"slug":2202,"type":15},"Performance","performance",{"name":2182,"slug":2183,"type":15},"2026-04-06T18:40:44.377464",{"slug":2206,"name":2206,"fn":2207,"description":2208,"org":2209,"tags":2210,"stars":19,"repoUrl":20,"updatedAt":2216},"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},[2211,2212,2215],{"name":2195,"slug":2196,"type":15},{"name":2213,"slug":2214,"type":15},"Database","database",{"name":2198,"slug":2199,"type":15},"2026-04-06T18:41:08.513425",600,{"items":2219,"total":2416},[2220,2241,2264,2281,2297,2314,2333,2345,2359,2373,2385,2400],{"slug":2221,"name":2221,"fn":2222,"description":2223,"org":2224,"tags":2225,"stars":2238,"repoUrl":2239,"updatedAt":2240},"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},[2226,2229,2232,2235],{"name":2227,"slug":2228,"type":15},"Documents","documents",{"name":2230,"slug":2231,"type":15},"Healthcare","healthcare",{"name":2233,"slug":2234,"type":15},"Insurance","insurance",{"name":2236,"slug":2237,"type":15},"Regulatory Compliance","regulatory-compliance",28169,"https:\u002F\u002Fgithub.com\u002Fopenai\u002Fopenai-agents-python","2026-04-16T05:11:39.180399",{"slug":2242,"name":2242,"fn":2243,"description":2244,"org":2245,"tags":2246,"stars":2261,"repoUrl":2262,"updatedAt":2263},"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},[2247,2250,2252,2255,2258],{"name":2248,"slug":2249,"type":15},".NET","dotnet",{"name":2251,"slug":2242,"type":15},"ASP.NET Core",{"name":2253,"slug":2254,"type":15},"Blazor","blazor",{"name":2256,"slug":2257,"type":15},"C#","csharp",{"name":2259,"slug":2260,"type":15},"Web Development","web-development",23787,"https:\u002F\u002Fgithub.com\u002Fopenai\u002Fskills","2026-04-12T05:07:02.819491",{"slug":2265,"name":2265,"fn":2266,"description":2267,"org":2268,"tags":2269,"stars":2261,"repoUrl":2262,"updatedAt":2280},"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},[2270,2273,2276,2279],{"name":2271,"slug":2272,"type":15},"Apps SDK","apps-sdk",{"name":2274,"slug":2275,"type":15},"ChatGPT","chatgpt",{"name":2277,"slug":2278,"type":15},"MCP","mcp",{"name":9,"slug":8,"type":15},"2026-04-12T05:07:05.468097",{"slug":2282,"name":2282,"fn":2283,"description":2284,"org":2285,"tags":2286,"stars":2261,"repoUrl":2262,"updatedAt":2296},"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},[2287,2290,2293],{"name":2288,"slug":2289,"type":15},"API Development","api-development",{"name":2291,"slug":2292,"type":15},"CLI","cli",{"name":2294,"slug":2295,"type":15},"Codex","codex","2026-04-12T05:07:04.132762",{"slug":2298,"name":2298,"fn":2299,"description":2300,"org":2301,"tags":2302,"stars":2261,"repoUrl":2262,"updatedAt":2313},"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},[2303,2306,2309,2310],{"name":2304,"slug":2305,"type":15},"Cloudflare","cloudflare",{"name":2307,"slug":2308,"type":15},"Cloudflare Pages","cloudflare-pages",{"name":2151,"slug":2152,"type":15},{"name":2311,"slug":2312,"type":15},"Deployment","deployment","2026-04-12T05:07:14.275118",{"slug":2315,"name":2315,"fn":2316,"description":2317,"org":2318,"tags":2319,"stars":2261,"repoUrl":2262,"updatedAt":2332},"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},[2320,2323,2326,2329],{"name":2321,"slug":2322,"type":15},"Productivity","productivity",{"name":2324,"slug":2325,"type":15},"Project Management","project-management",{"name":2327,"slug":2328,"type":15},"Strategy","strategy",{"name":2330,"slug":2331,"type":15},"Task Management","task-management","2026-05-23T06:17:16.870838",{"slug":2334,"name":2334,"fn":2335,"description":2336,"org":2337,"tags":2338,"stars":2261,"repoUrl":2262,"updatedAt":2344},"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},[2339,2340,2342,2343],{"name":2113,"slug":2114,"type":15},{"name":2341,"slug":2334,"type":15},"Figma",{"name":2170,"slug":2171,"type":15},{"name":2277,"slug":2278,"type":15},"2026-04-12T05:06:47.939943",{"slug":2346,"name":2346,"fn":2347,"description":2348,"org":2349,"tags":2350,"stars":2261,"repoUrl":2262,"updatedAt":2358},"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},[2351,2352,2355,2356,2357],{"name":2113,"slug":2114,"type":15},{"name":2353,"slug":2354,"type":15},"Design System","design-system",{"name":2341,"slug":2334,"type":15},{"name":2170,"slug":2171,"type":15},{"name":2179,"slug":2180,"type":15},"2026-05-10T05:59:52.971881",{"slug":2360,"name":2360,"fn":2361,"description":2362,"org":2363,"tags":2364,"stars":2261,"repoUrl":2262,"updatedAt":2372},"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},[2365,2366,2367,2370,2371],{"name":2113,"slug":2114,"type":15},{"name":2353,"slug":2354,"type":15},{"name":2368,"slug":2369,"type":15},"Documentation","documentation",{"name":2341,"slug":2334,"type":15},{"name":2170,"slug":2171,"type":15},"2026-05-16T06:07:47.821474",{"slug":2374,"name":2374,"fn":2375,"description":2376,"org":2377,"tags":2378,"stars":2261,"repoUrl":2262,"updatedAt":2384},"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},[2379,2380,2381,2382,2383],{"name":2113,"slug":2114,"type":15},{"name":2341,"slug":2334,"type":15},{"name":2170,"slug":2171,"type":15},{"name":2179,"slug":2180,"type":15},{"name":2259,"slug":2260,"type":15},"2026-05-16T06:07:40.583615",{"slug":2386,"name":2386,"fn":2387,"description":2388,"org":2389,"tags":2390,"stars":2261,"repoUrl":2262,"updatedAt":2399},"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},[2391,2394,2395,2398],{"name":2392,"slug":2393,"type":15},"Animation","animation",{"name":2294,"slug":2295,"type":15},{"name":2396,"slug":2397,"type":15},"Creative","creative",{"name":2113,"slug":2114,"type":15},"2026-05-02T05:31:48.48485",{"slug":2401,"name":2401,"fn":2402,"description":2403,"org":2404,"tags":2405,"stars":2261,"repoUrl":2262,"updatedAt":2415},"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},[2406,2407,2408,2411,2414],{"name":2396,"slug":2397,"type":15},{"name":2113,"slug":2114,"type":15},{"name":2409,"slug":2410,"type":15},"Image Generation","image-generation",{"name":2412,"slug":2413,"type":15},"Images","images",{"name":9,"slug":8,"type":15},"2026-05-15T06:23:24.312127",675]