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