naftiko/skills/answer-call

Answer Call

Answer an incoming call in Microsoft Teams communications.

API Details

• API Name: Microsoft Teams API
• OpenAPI Ref: ../../openapi/microsoft-teams-openapi.yaml
• Endpoint: POST /communications/calls/{call-id}/answer
• Operation ID: answerCall
• Tag: Calls

Sandbox

• Base URL: http://localhost:8080/rest/microsoft-teams-api/1.0.0

Required Headers

• Authorization: Bearer {access_token}
• Content-Type: application/json

OAuth Scopes

• Calls.Initiate.All

Parameters

Path Parameters

| Name | Type | Required | Description | |------|------|----------|-------------| | call-id | string | Yes | The unique identifier of the call |

Request Body

| Name | Type | Required | Description | |------|------|----------|-------------| | callbackUri | string | Yes | The callback URL for call state notifications | | acceptedModalities | array | Yes | The accepted modalities (audio, video, videoBasedScreenSharing) | | mediaConfig | object | No | The media configuration for the call |

Example Request

curl -X POST "http://localhost:8080/rest/microsoft-teams-api/1.0.0/communications/calls/{call-id}/answer" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "callbackUri": "https://bot.example.com/api/calls",
    "acceptedModalities": ["audio"],
    "mediaConfig": {
      "@odata.type": "#microsoft.graph.appHostedMediaConfig",
      "blob": "<Media Session Configuration>"
    }
  }'

Example Response

No content body is returned.

Status Code: 202 Accepted

Instructions

1. Obtain a valid access token with the Calls.Initiate.All scope.
2. Identify the call ID for the incoming call you want to answer.
3. Construct the request body with the callbackUri and acceptedModalities.
4. Optionally include mediaConfig to configure the media session.
5. The acceptedModalities array can include audio, video, or videoBasedScreenSharing.
6. Send a POST request to the /communications/calls/{call-id}/answer endpoint.
7. A successful request returns a 202 status code indicating the answer operation has been accepted.