Repository navigation
docs(cli): document current socket mode commands - #3084
Merged
teddy arida-moody (teddyam) merged 3 commits intoNov 19, 2026
Merged
Conversation
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Contributor
There was a problem hiding this comment.
🟢 Approval recommended
No active review issues remain for the documentation-only clarification of socket and HTTP delivery workflows.
No open issues 🎉
What changed in this PR
Updates CLI documentation to explain current socket-mode behavior alongside HTTP delivery. Documentation only; no CLI behavior changes.
Changes:
- Add socket/HTTP workflows for creation, updates, inspection, and diagnostics.
- Document socket enablement failures, recovery steps, JSON follow-up fields, and restart requirements.
- Clarify when public HTTPS endpoints and tunnels are needed across bot locations.
| File | Description |
|---|---|
teams.md/docs/main/developer-tools/local-tunnels.md |
Distinguishes HTTP tunnels from socket delivery. |
teams.md/docs/cli/index.md |
Adds messaging modes to the CLI feature overview. |
teams.md/docs/cli/getting-started/quickstart.md |
Adds socket and HTTP creation examples. |
teams.md/docs/cli/concepts/local-tunnels.md |
Explains switching from sockets to tunnel-based HTTP. |
teams.md/docs/cli/concepts/bot-locations.md |
Clarifies that messaging mode is independent of bot location. |
teams.md/docs/cli/commands/index.md |
Adds a messaging-mode command reference table. |
teams.md/docs/cli/commands/app/update.md |
Documents mode switching, endpoint requirements, and JSON follow-ups. |
teams.md/docs/cli/commands/app/get.md |
Explains configured-mode inspection and its limits. |
teams.md/docs/cli/commands/app/doctor.md |
Describes socket diagnostics and endpoint probing. |
teams.md/docs/cli/commands/app/create.md |
Adds Azure examples, ownership requirements, and failure recovery. |
Review effort: Balanced
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Nick Walker (nickwalkmsft)
approved these changes
Nov 19, 2026
teddy arida-moody (teddyam)
deleted the
teddyam-socket-mode-command-docs
branch
November 19, 2026 19:18
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Update the CLI documentation to describe the socket-mode behavior currently merged into
main, so users can choose and troubleshoot message delivery without relying on testing-era instructions.app create,app update,app get, andapp doctorreferences with socket/HTTP workflows, Azure examples, JSON follow-up fields, and restart guidance.Documentation only; no CLI behavior changes.
Validation
npx turbo build --filter=@microsoft/teams.cligit diff --check