Document the 3P IDP auth flow for bots

[aosolis]

We document the mechanics of the flow for tabs, but there is no similar explanation or diagram for bots.

The details page for bots doesn't describe the underlying protocol of invokes. Where do we describe the signin/verifyState invoke, and the special values for state that we send? For example CancelledByUser when the login popup is closed. If this isn't handled correctly the user will see an error banner on the card.

---

Document Details

⚠ Do not edit this section. It is required for learn.microsoft.com ➟ GitHub issue linking.

• ID: 6d5b8b0f-3da3-8642-6edf-dc6608a830cf
• Version Independent ID: f93cdabd-f6ab-29d0-f3c9-78deb21ca521
• Content: Enable authentication using third-party OAuth provider - Teams
• Content Source: msteams-platform/tabs/how-to/authentication/auth-flow-tab.md
• Service: msteams
• GitHub Login: @surbhigupta
• Microsoft Alias: lajanuar

[ghost]

Hi aosolis! Thank you for bringing this issue to our attention. We will investigate and if we require further information we will reach out in one business day. Please use this link to escalate if you don't get replies.

Best regards, Teams Platform

[sayali-MSFT]

@aosolis - Thanks for reporting your issue. We will check it and update the document accordingly.

[ChetanSharma-msft]

Hello @aosolis - Sorry for delay in response. 3P IDP flow is documented here: Add third party IdP authentication to bot app

Please check and let us know if any other details to be added.

[aosolis]

The documentation is still missing the information that I asked for over a year ago.