microsoftgraph / microsoftgraph/microsoft-graph-comms-samples

Tracking a call through transfers using compliance bot

Open
#212 14 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
No language data
Stars
253
Forks
275
Avg merge
1d 5h
Merged PRs (30d)
1

Description

I'm trying to come up with a way to track calls that are occurring in Teams, both peer to peer and calls from PSTN. Sadly there is no easy way to do this. One thing that sort of works is setting the bot & all Teams users up for recording compliance, so it gets dragged into every call and is aware of the participants.

I have the bot set up and it is being notified of calls being created/updated/terminated, but I'm struggling to find the documentation needed to decipher the messages it receives. I'm currently using the API rather than the SDK.

The questions I currently have are:

  • In a PSTN-Teams call, the bot gets two calls- when the callee picks up, one of the calls is deleted, and one persists. In a Teams-Teams call, the bot receives 4 calls- one seems to end when the bot answers the call, another ends when the callee picks up, and the remaining two calls persist until someone leaves or transfers the call. What is the meaning of these extra calls that disappear?

  • When a call gets transferred, the bot essentially sees the current call end and a completely new one begin. Is there a reliable way to relate a call that is the result of a transfer to the call it was transferred from? It seems that for PSTN-Teams calls there is a CallChainId in the message the bot receives, which seems to remain the same through each call that results from a transfer. This is not the case for Teams-Teams calls however, where each transfer seems to result in a new call CallChainId so you can't use it to determine if a new Teams-Teams call is the result of a transfer.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the Microsoft Graph Communications API notifications the bot receives for call creation, updates, and termination, focusing on PSTN-Teams and Teams-Teams transfers. Review the call messages described in the issue and document the meaning of disappearing calls and whether transferred calls can be reliably related; done means both behaviors are clearly explained.

Written by the indexing model from the issue text.

Assessment

Domain
api
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
28/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.