Online Meetings

Online Meetings is a component that lets you work with Microsoft Teams online meetings directly from the Nappai dashboard.
You can list meetings, get details for a specific meeting, download transcripts, or retrieve the chat that happened during a meeting.
All of this is done through the Microsoft Teams API, so you only need to set up a Teams credential once and then use the component in your workflows.

How it Works

When you add the Online Meetings component to a workflow, Nappai sends requests to the Microsoft Teams API.
The component uses the credential you selected to authenticate with Teams, then performs the operation you choose (List Meetings, Get Meeting Details, Download Transcript, or Get Meeting Chat).
The results are returned as a data table that can be passed to other components or used to trigger actions in your automation.

Operations

This component offers several operations that you can select based on what you need to do. You can only use one operation at a time:

List Meetings: Retrieve a list of online meetings within a specified time range, optionally filtered by attendees or other criteria.
Get Meeting Details: Fetch detailed information about a specific meeting using its Meeting ID.
Download Transcript: Download the transcript file for a meeting using the Transcript ID.
Get Meeting Chat: Retrieve the chat messages from a meeting.

To use the component, first select the operation you need in the “Operation” field.

Inputs

Mapping Mode

This component has a special mode called “Mapping Mode”. When you enable this mode using the toggle switch, an additional input called “Mapping Data” is activated, and each input field offers you three different ways to provide data:

Fixed: You type the value directly into the field.
Mapped: You connect the output of another component to use its result as the value.
Javascript: You write Javascript code to dynamically calculate the value.

This flexibility allows you to create more dynamic and connected workflows.

Input Fields

The following fields are available to configure this component. Each field may be visible in different operations:

Credential: Select the Microsoft Teams credential you have configured in Nappai credentials.
Visible in: List Meetings, Get Meeting Details, Download Transcript, Get Meeting Chat
Operation: Choose the operation you want to perform.
Visible in: List Meetings, Get Meeting Details, Download Transcript, Get Meeting Chat
Mapping Mode: Enable mapping mode to process multiple data records in batch.
Visible in: List Meetings, Get Meeting Details, Download Transcript, Get Meeting Chat
End Time: End time of the meeting.
Visible in: List Meetings
Start Time: Start time of the meeting.
Visible in: List Meetings
Attendees: Email addresses of attendees (comma‑separated).
Auto Admit: Who gets automatically admitted to the meeting.
Lobby Bypass: Who can bypass the meeting lobby.
Max Results: Maximum number of results to return.
Visible in: List Meetings, Get Meeting Chat
Meeting ID: ID of the online meeting.
Visible in: Get Meeting Details, Download Transcript, Get Meeting Chat
Meeting Subject: Subject/title of the meeting.
Transcript ID: ID of the transcript to download.
Visible in: Download Transcript
Tool Name: The name of the tool that will be used when this component is connected as a tool. This name will be displayed to the agent when it selects tools to use.
Visible in: List Meetings, Get Meeting Details, Download Transcript, Get Meeting Chat
Tool Description: A detailed description of what this tool does. This description will help the agent understand when and how to use this tool effectively.
Visible in: List Meetings, Get Meeting Details, Download Transcript, Get Meeting Chat
Tools arguments metadata: Defines the arguments metadata for the tools.
Visible in: List Meetings, Get Meeting Details, Download Transcript, Get Meeting Chat

Outputs

Data: A data table containing the results of the selected operation (e.g., list of meetings, meeting details, transcript content, or chat messages).
Tool: A tool object that can be used by the Nappai agent when the component is connected as a tool.

Usage Example

Example 1 – List Meetings

Drag the Online Meetings component into your workflow.
Set Operation to List Meetings.
Enter a Start Time (e.g., 2024‑10‑01T08:00:00Z) and an End Time (e.g., 2024‑10‑01T18:00:00Z).
Optionally set Max Results to limit the number of meetings returned.
Connect the Data output to a “Filter” component to keep only meetings with a specific attendee, then pass the filtered data to a “Send Email” component.

Example 2 – Get Meeting Details

Use the Online Meetings component with Operation set to Get Meeting Details.
Provide the Meeting ID of the meeting you want details for.
The Data output will contain fields such as subject, start time, end time, and participants, which you can then use in downstream components.

Microsoft Teams Calendar Component – Manage Teams calendar events and schedule new meetings.
Microsoft Teams Chat Component – Send and retrieve chat messages in Teams channels.
Microsoft Teams File Component – Upload, download, and manage files stored in Teams.

Tips and Best Practices

Use Mapping Mode when you need to process many meetings at once (e.g., batch‑list meetings for a month).
Set Max Results to avoid overwhelming your workflow with too many records.
Store the Meeting ID from a previous step (e.g., after creating a meeting) and reuse it in the Get Meeting Details or Download Transcript operations.
Keep your credential secure – only share the credential with trusted users and never expose it in logs.

Security Considerations

The component uses a Microsoft Teams credential that contains sensitive information (Client ID, Client Secret, Tenant ID).
Ensure the credential is stored in Nappai’s secure credential store and that only authorized users can view or edit it.
When using the component in a public or shared workflow, avoid exposing the credential name or any derived data in logs or output messages.