DOCSTOOLS: RECORDING A WORK ITEM - MICROSOFT TEAMS

Tools: Recording a Work Item - Microsoft Teams

Microsoft Teams integration is the recommended way to get started with YakShaver, offering seamless integration with your existing workflow. This guide covers installation, setup, and recording methods.

Install YakShaver in Microsoft Teams

  1. In Microsoft Teams, click Apps (on the left sidebar)
  2. Search for "YakShaver" in the search box
  3. Click Add to install the YakShaver bot

Image

Figure: Adding YakShaver bot

πŸ’‘ Tip: Right-click YakShaver and select "Pin" to keep it on your sidebar.

Activate YakShaver

  1. Open YakShaver from your sidebar or Apps list
  2. In the chatbox, type on to activate automatic processing
  3. You'll see a confirmation card when YakShaver is active

Image

Figure: YakShaver activation confirmation

Recording Options with Teams

Option 1: Recording in a Meeting or Group Call

  1. Share the screen you want to record in the meeting
  2. Click More | Record and Transcribe | Start Recording
  3. When recording starts, clearly explain the task for YakShaver to process
  4. When finished, stop the recording to send it for processing

Option 2: Recording by Yourself

  1. Go to your Teams calendar
  2. Click Meet now and then Start Meeting
    Image
    Figure: Starting a meeting with yourself
  3. Share the screen you want to capture
  4. Click More | Record and Transcribe | Start Recording
  5. Explain the task clearly for YakShaver to process
  6. When done, stop recording or leave the call
    Image
    Figure: Starting a recording in Teams
  7. YakShaver will automatically process your recording
    Image
    Figure: YakShaver task confirmation in Teams

What Happens Next

After processing your recording, YakShaver will create a work item and notify you via:

  1. A Teams message confirmation
  2. One of these email types (depending on your project setup):
    • The email task itself
    • GitHub issue notification with a link
    • Azure DevOps work item notification with a link

Image
Figure: Example GitHub notification email

Chat Commands

You can control YakShaver with these commands in the Teams chat:

  • on - Set YakShaver to always process your videos
  • off - Set YakShaver to ask before processing
  • status - Check your current settings
  • leaderboard - View the leaderboard
  • help - Show list of commands
  • hi - Display welcome message

Tips & Troubleshooting

  • Forgot to turn it on? YakShaver will ask if you want to process new recordings.
  • Want to cancel during recording? Say "abort," "cancel the task," or "never mind."
  • Need a work item instead of email? Use the conversion button in the email.
Last Updated: 15 January 2025