Teams Extension Token - Exchange

Servicio:

Communication

Versión de la API:

2025-06-30

Intercambia un token de teléfono de Teams por un token de acceso de usuario de ACS.

POST {endpoint}/access/teamsExtension/:exchangeAccessToken?api-version=2025-06-30

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
endpoint	path	True	string (url)	Recurso de comunicación, por ejemplo, https://my-resource.communication.azure.com
api-version	query	True	string	Versión de la API que se va a invocar.

Respuestas

Nombre	Tipo	Description
200 OK	CommunicationIdentityAccessTokenResult	Éxito
Other Status Codes	CommunicationErrorResponse	Error

Ejemplos

Exchange a Teams Phone token

Solicitud de ejemplo

HTTP

POST https://my-resource.communication.azure.com/access/teamsExtension/:exchangeAccessToken?api-version=2025-06-30

{}

Respuesta de muestra

status code:

200

{
  "identity": {
    "id": "8:acs:2dee53b4-368b-45b4-ab52-8493fb117652_c70d068c-2f32-484d-9455-73070cd5aadd_b27b64b9-39d2-44a3-869d-67700b74e805"
  },
  "accessToken": {
    "token": "token",
    "expiresOn": "2025-07-10T21:39:39.3244584+00:00"
  }
}

Definiciones

Nombre	Description
CommunicationError	Error de Communication Services.
CommunicationErrorResponse	Error de Communication Services.
CommunicationIdentity	Una identidad de comunicación.
CommunicationIdentityAccessToken	Un token de acceso.
CommunicationIdentityAccessTokenResult	Una identidad de comunicación con token de acceso.
TeamsExtensionExchangeTokenRequest

CommunicationError

Object

Error de Communication Services.

Nombre	Tipo	Description
code	string	Código de error.
details	CommunicationError[]	Más detalles sobre los errores específicos que llevaron a este error.
innererror	CommunicationError	Error interno si existe.
message	string	El mensaje de error.
target	string	Destino del error.

CommunicationErrorResponse

Object

Error de Communication Services.

Nombre	Tipo	Description
error	CommunicationError	Error de Communication Services.

CommunicationIdentity

Object

Una identidad de comunicación.

Nombre	Tipo	Description
id	string	Identificador de la identidad.

CommunicationIdentityAccessToken

Object

Un token de acceso.

Nombre	Tipo	Description
expiresOn	string (date-time)	Hora de expiración del token.
token	string	Token de acceso emitido para la identidad.

CommunicationIdentityAccessTokenResult

Object

Una identidad de comunicación con token de acceso.

Nombre	Tipo	Description
accessToken	CommunicationIdentityAccessToken	Un token de acceso.
identity	CommunicationIdentity	Una identidad de comunicación.

TeamsExtensionExchangeTokenRequest

Object