Add Space Member

Definition

The Add Space Member action in Zenphi’s Google Chat integration allows users to programmatically add members to a Google Chat space. This is particularly useful for automating the process of managing space memberships, ensuring that the right individuals or groups are included in relevant discussions and collaborations.

Use Cases

The Add Space Member action can be employed in various scenarios, including:

1. Onboarding New Employees: Automatically add new hires to relevant team or project spaces.
2. Project Management: Ensure all project stakeholders are added to the dedicated project space.
3. Incident Management: Quickly add team members to a space for coordinated incident response.
4. Event Planning: Add event-specific participants to a space for streamlined communication.
5. Customer Support: Add client representatives or support team members to a private space for customer interactions.

Inputs

The Add Space Member action requires the following inputs:

1. Connection:

The connection authorizes Zenphi to interact with Google Chat on your behalf. It’s necessary to configure this connection to enable communication with Google Chat spaces and users.

2. Space:

The unique ID of the Google Chat space where you want to add members. This ID can be retrieved from the output of the Create Space action or directly from Google Chat.

3. Member Type:

Specifies the type of member to add to the space:

Group: Represents a Google Group that corresponds to the membership.

User: Represents a specific Google Chat user or app.

4. Member:

The email address of the user or group you want to add to the space. For multiple members, repeat the action with different email addresses.

5. Role:

Defines the role of the member within the Chat space, determining their permissions:

Member: The user has basic permissions, such as sending messages.

Manager (For Internal Use Only): Grants administrative permissions, allowing the user to manage the space, such as adding or removing members.

Step-by-Step Guide

Step 1: Add the "Add Space Member" Action

In your Zenphi flow, drag and drop the Add Space Member action from the Google Chat category into your workflow. If you're new to adding actions in Zenphi, you can find a complete guide here.

Step 2: Configure the Action Settings

Connection: Select the appropriate Google Chat connection.

Space: Enter the ID of the target space where the member will be added.

Member Type: Choose whether you’re adding a Group or a User.

Member: Enter the email address of the user or group.

Role: Assign the appropriate role (Member or Manager).

Step 3: Test the Configuration

Run the flow in test mode to verify that the member is successfully added to the specified space.

Check the Google Chat space to confirm the addition of the member.

Step 4: Publish and Automate

Once tested, publish the flow to automate the membership management process.

Integrate with triggers such as form submissions, HR system updates, or project creation events to dynamically manage space memberships.

Outputs

The Add Space Member action provides the following outputs:

1. Member ID:

The unique resource name of the membership.

Format: spaces/{space}/members/{member}

2. Space ID:

The unique identifier of the space where the member was added.

3. Space URI:

A direct link to the space in Google Chat.

4. Create Time:

The timestamp when the membership was created.

Member Detail (For Member Type Only):

Detailed information about the added member.

5. Role:

The assigned role of the user within the space:

ROLE_MEMBER: Basic permissions to participate in the space.

ROLE_MANAGER: Administrative permissions to manage the space.

6. State:

Specifies the relationship of the member with the space:

JOINED: The user is an active participant in the space.

INVITED: The user has been invited but hasn’t joined the space. You can send the Space URI to the user.

NOT_A_MEMBER: The user is not part of the space and has no pending invitation.

7. Group ID (For Group Type Only):

The unique resource name of the Google Group added as a member.

Format: groups/{group}

Example

Scenario: Adding New Project Members to a Space

Flow Trigger:

A project management tool sends a webhook to Zenphi when new team members are added to a project.

Add Space Member Action Configuration:

Space: The ID of the project’s Google Chat space.

Member: Dynamically populated with the email addresses of new team members.

Role: Set to Member.

Output Utilization:

Use the Space URI output to notify added members via email or Slack about their inclusion in the space.

By leveraging Zenphi’s Add Space Member action, you can streamline the process of managing Google Chat space memberships, ensuring seamless collaboration and communication.