From 17b6da97caa6a69309f8879224fad2649f14679e Mon Sep 17 00:00:00 2001 From: Teddy Arida-Moody Date: Wed, 7 Oct 2026 09:46:17 -0700 Subject: [PATCH] docs(socket): note Socket Mode availability on Canary and Pilot1 Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- examples/socket/README.md | 9 +++++---- examples/socket/src/main.py | 2 ++ 2 files changed, 7 insertions(+), 4 deletions(-) diff --git a/examples/socket/README.md b/examples/socket/README.md index 6f5f369a..5860385b 100644 --- a/examples/socket/README.md +++ b/examples/socket/README.md @@ -60,9 +60,10 @@ You should see per-geo `ready` logs as each connection comes up, then `you said - **No HTTP surface** — tabs, remote functions, OAuth callbacks, and other browser routes are unavailable in Socket Mode. -- **Canary endpoint** — the sample currently overrides `negotiate_base_url` - because Socket Mode negotiate is available on the canary ring while the - production default returns 503. Remove the override when production is - enabled. +- **Canary and Pilot1 endpoints** — Socket Mode is currently available only on + the Canary (`https://canary.botapi.skype.com`) and Pilot1 + (`https://pilot1.botapi.skype.com`) rings; the production default returns + 503. The sample sets `negotiate_base_url` to the canary ring, but Pilot1 works + too. Remove the override when production is enabled. - **Classic bot identity only** — Socket Mode connects with the bot's MSA App Id. Agentic identities are not supported today. diff --git a/examples/socket/src/main.py b/examples/socket/src/main.py index 81e346c6..36263f12 100644 --- a/examples/socket/src/main.py +++ b/examples/socket/src/main.py @@ -27,6 +27,8 @@ app = App( socket_mode=SocketModeOptions( + # Socket Mode is only available on the Canary and Pilot1 rings for now. + # Pilot1 (https://pilot1.botapi.skype.com) is supported as well. negotiate_base_url="https://canary.botapi.skype.com", ) )