Channel

The Channel component lets you manage Microsoft Teams channels directly from your Nappai dashboard. You can list teams, view channels, see who’s in a channel, or create a new channel—all in one place.

How it Works

When you use this component, Nappai talks to the Microsoft Teams API. It sends the request you configure (like “Get Teams” or “Create Channel”) and returns the data it receives back. If you enable Mapping Mode, the component can handle many records at once, letting you feed a list of teams or channels and get a list of results in return.

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:

• Get Teams: Retrieves a list of Microsoft Teams that the logged‑in user can access.
• Get Teams Channels: Retrieves all channels inside a specific Microsoft Team.
• Get Channel Members: Retrieves the members of a particular channel.
• Create Channel: Creates a new channel inside a Microsoft Team.

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:

• Operation: Choose the action you want to perform.

  • Visible in: Get Teams, Get Teams Channels, Get Channel Members, Create Channel

• Credential: Select the Microsoft Teams credential you have configured in Nappai.

  • Visible in: Get Teams, Get Teams Channels, Get Channel Members, Create Channel

• Mapping Mode: Enable mapping mode to process multiple data records in batch.

  • Visible in: Get Teams, Get Teams Channels, Get Channel Members, Create Channel

• Top Teams Count: Number of top teams to retrieve (default: 20).

  • Visible in: Get Teams

• Teams ID: ID of the Microsoft Teams.

  • Visible in: Get Teams Channels, Get Channel Members, Create Channel

• Channel ID: ID of the channel.

  • Visible in: Get Channel Members

• Channel Name: Name for the channel.

  • Visible in: Create Channel

• Channel Description: Description for the new channel.

  • Visible in: Create Channel

• Channel Type: Type of channel to create.

  • Visible in: Create Channel

• Member Role: Role for the new channel member.

  • Visible in: Create Channel

• User ID: ID of the user to add to the channel.

  • Visible in: Create Channel

• 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: Get Teams, Get Teams Channels, Get Channel Members, Create Channel

• 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: Get Teams, Get Teams Channels, Get Channel Members, Create Channel

• Tools arguments metadata: Defines the arguments metadata for the tools.

  • Visible in: Get Teams, Get Teams Channels, Get Channel Members, Create Channel

Outputs

• Data: The raw data returned from the Microsoft Teams API (e.g., list of teams, channels, members). This can be used as input for other components or for further processing.
• Tool: A tool representation that can be passed to an AI agent. It includes the operation name, arguments, and a description, allowing the agent to decide when to call this component.

Usage Example

Example 1 – Get Teams

1. Drag the Channel component onto the canvas.
2. In the Operation field, select Get Teams.
3. (Optional) Set Top Teams Count to 10 if you only want the first ten teams.
4. Connect the Credential field to the Microsoft Teams credential you created earlier.
5. Run the workflow. The Data output will contain a list of teams you can use in subsequent steps.

Example 2 – Create Channel

1. Drag the Channel component onto the canvas.
2. In the Operation field, select Create Channel.
3. Fill in Teams ID with the ID of the team where you want the channel.
4. Provide a Channel Name, Channel Description, and choose a Channel Type.
5. (Optional) Add a User ID and Member Role to invite a user immediately.
6. Connect the Credential field to your Microsoft Teams credential.
7. Run the workflow. The Data output will show the newly created channel’s details, and the Tool output can be used by an AI agent to confirm the creation.

Related Components

• Microsoft Teams Connection – Set up and manage your Microsoft Teams credentials.
• Microsoft Teams Channel Component – A higher‑level component that can perform multiple channel operations in a single step.

Tips and Best Practices

• Enable Mapping Mode when you need to process many teams or channels at once; it saves time and reduces API calls.
• Use the Tool output to let AI agents decide when to call the component automatically.
• Limit the Top Teams Count if you only need a subset; this reduces data transfer and speeds up the workflow.
• Always verify the Credential is correctly configured before running the component to avoid authentication errors.
• Keep the Channel Description concise; it helps team members understand the channel’s purpose quickly.

Security Considerations

• The component uses OAuth tokens stored in the Microsoft Teams credential. These tokens are never exposed in the UI or logs.
• Ensure that only trusted users have access to the credential configuration page.
• When enabling Mapping Mode, be mindful of the volume of data you process to avoid hitting Microsoft Teams API rate limits.

---