Фраза «внешний пользователь» в Teams неоднозначна. Guest имеет B2B-учётную запись в host tenant, external access user остаётся в своей организации, anonymous participant приходит по ссылке без Entra identity. Один и тот же bot manifest не даёт этим трём типам одинаковые возможности.

До изменения кода воспроизведите проблему в конкретном контексте: personal, group chat, meeting chat, standard или shared channel. Microsoft отдельно указывает, что приложения в one-to-one чате с external access users не поддерживаются; такой тест нельзя починить дополнительным Graph permission.

Матрица поддержки задаёт правильное ожидание

УчастникКто добавляет appГде бот может работать
внутреннийсам пользователь/админ/hostпо объявленным scopes и policy
guest B2Bпользователь host organizationуже добавленные chats/channels; personal по правилам
external accessnative host user/meeting hostgroup/meeting chat после добавления; не external 1:1
anonymousсам не добавляетограниченное взаимодействие с уже доступным meeting app
shared channel memberв host channel contextпри поддержке shared channel и cross-tenant access

Клиентская кнопка «добавить» может отсутствовать по дизайну платформы или policy. Проверяйте, установлено ли приложение в нужный conversation scope и разрешено ли оно политиками host organization, а не только публикацию в каталоге.

Доставку activity отделяют от авторизации

log {
  activityId, activityType, conversationType, conversationIdHash,
  activity.conversation.tenantId, from.idHash, from.aadObjectIdHash,
  serviceUrlHost, appVersion, authStage
}
// Не логировать token, displayName, email и текст сообщения целиком

Если endpoint вообще не получил activity, исследуйте installation/scope/policy и Bot service. Если activity пришла, но ответ 401/403 выдаёт ваш backend или Graph, проблема уже в token audience, tenant, consent либо вашей модели доступа. Это разные инциденты.

Shared channel имеет host IDs, отличные от привычных team IDs

Для shared channel Microsoft рекомендует использовать `channel.ownerGroupId` как team ID для Graph channel APIs и `channel.ownerTenantId` как host tenant. `team.groupId` в этом контексте может быть пустым. В activity бота host tenant доступен как `activity.conversation.tenantId`.

  • Не считайте весь parent team списком участников shared channel.
  • Получайте прямых и косвенных участников через channel membership APIs.
  • Сравнивайте tenant участника с ownerTenantId перед доступом к данным.
  • Проверяйте доступ пользователя к каналу, а не только существование account.
  • Не переносите данные private/shared channel в общий отчёт без разрешения.

Home tenant и host tenant отвечают за разные ресурсы

Для внешнего пользователя token может требоваться от его home tenant, тогда как SharePoint/канал принадлежат host tenant. Документация shared channels отдельно просит передавать правильный tenant ID в `getAuthToken` по сценарию. Приложение должно быть multitenant там, где это требуется, а consent проверяется в нужной организации.

Не исправляйте 403 заменой tenant на `common` без проверки issuer, audience и permission. Backend валидирует подпись и claims токена, затем собственное разрешение пользователя на конкретный conversation/resource.

Scope в manifest должен совпадать с местом использования

Bot для meeting/group chat и bot для channel получают разные conversation types. SSO для Teams bot официально поддерживается в one-to-one и group chat, но не в channel scope; для канала планируйте подходящий auth flow. App policy, admin consent и `webApplicationInfo` проверяются отдельно от messaging endpoint.

Пять тестовых персон заменяют один аккаунт разработчика

  1. Внутренний user host tenant проверяет baseline.
  2. Guest B2B вызывает бота в уже добавленном standard channel.
  3. External access user взаимодействует в group/meeting chat, куда app добавил host.
  4. Shared channel member из другой организации проходит in-channel действие и SSO.
  5. Anonymous attendee взаимодействует только в поддерживаемом meeting-сценарии.
  6. Каждый тест повторяется без admin role и в разрешённом policy наборе.
  7. Отдельно фиксируется ожидаемо неподдерживаемый external one-to-one chat.

В диагностический пакет включите тип пользователя, host/home tenant IDs в сокращённом виде, conversation type, app scopes, policy result, activity ID и sanitised 401/403. Access tokens, email и содержимое корпоративного чата удалите. Результат подтверждён, когда поддерживаемые внешние сценарии проходят, а неподдерживаемые показывают понятное ограничение.

Проверенные источники