Skip to content

Setting Up CoffeePals in Microsoft Teams

How to Install the CoffeePals App

To find the CoffeePals app in the Microsoft Teams store, you can search for CoffeePals in the app tabs. Alternatively, you can click this link which will open the app right in Teams.

If you can't find the CoffeePals app in the Teams store, contact your IT administrator to get permission to view the app within Teams. We have a helpful article on how to do that here.

Create a CoffeePals Team

We recommend creating a new CoffeePals team in MS Teams and inviting people to join this team. This way, people are only matched with other people who want to be matched. This makes it more likely that the meetings actually happen. You can however add it to an existing team.

  1. Click Join or create a team at the bottom of the team list in Microsoft Teams.
  2. Click Create Team.
  3. Click From scratch and select Public (recommended) or Private.
  4. Add a name and description to the team. We've seen it be called "Introductions", "Coffee Buddies", "Random Chats", "Coffee Chats" or, our favourite, CoffeePals.
  5. Click Create
  6. (Optional) You can add members who you know will enjoy being a part of coffee chats, or a test group to pilot the app.
Microsoft Teams team list with the Join or create a team button at the bottom highlighted
Microsoft Teams Join or create a team page with the Create team button highlighted
Microsoft Teams From scratch option, reading "We'll help you create a basic team."
Microsoft Teams Public team option, reading "Anyone in your org can join"
Microsoft Teams public team details with the team name CoffeePals and the description "Get to know people with weekly coffee chats!"
Microsoft Teams Add members to CoffeePals dialog with two people added and the Add button highlighted

Adding the CoffeePals App to the Team

  1. Find the CoffeePals App in the Teams Store or by clicking this link.
  2. Once you find the app, click the dropdown next to Open/Add then click Add to a team.
  3. Add the app to the team you just created.
  4. Ensure that team members can't remove the application by mistake.
CoffeePals in the Microsoft Teams store with the Open dropdown expanded to show Add to a team
Add CoffeePals to a team dialog in Microsoft Teams with the CoffeePals > General channel chosen and the Set up a bot button highlighted
Microsoft Teams team Settings tab, opened from Manage team, with Allow members to add and remove apps unchecked and circled

Once the app is installed on a team, all users on the team will be automatically opted-in. Any new users that join the team will automatically be opted-in.

When the app is installed, CoffeePals sends you a welcome message in your personal chat with it. Click I'm setting this up, then Open the dashboard to sign in.

The CoffeePals welcome message in Microsoft Teams with the buttons I'm setting this up and Someone else set this up

Creating a CoffeePals program for Your Team

To create a program, you'll need to access the dashboard.

  1. Send the CoffeePals app in a personal message with the command "Dashboard". This will return a secure login link to authenticate you into the dashboard.
  2. Once you are in the dashboard, click Programs in the left side menu to view your list of teams.
  3. Click the Create a new program button in the top right corner.
  4. Select a program template from the list.
  5. Proceed to configure and launch your program.

In the dashboard in your browser, the Setup guide in the bottom-right corner keeps track of the rest of your setup. Click Choose who gets matched to add an audience, and Launch your first program to pick a template. It shows to workspace owners and admins until your first program is launched, and it doesn't appear in the CoffeePals tab inside Teams. Click Hide for now to fold it back into the Setup guide button.

The Setup guide panel showing Get started, 1 of 3 complete, with three steps: You're set up and ready to go, Choose who gets matched and Launch your first program, and Hide for now

Announcing CoffeePals to your Organization

Now that you've set up the app, you need to spread the news! Check out our guide on how to announce CoffeePals to your organization.

Match Settings

On the free plan, matching takes place every Tuesday at 10AM in pairs. In the match settings, you can:

  • Enable and Disable matching for the team.
  • Choose which channel matching notifications get sent to.
  • Select the timezone for when matches are sent out.

On the Pro plan, you can:

  • All things on the free plan.
  • Choose either Standard Matching, Cross-Group Matching or lottery matching.
  • Choose the frequency of matching (1-4 weeks).
  • Choose the match day and time.
  • Choose the match group size (1 - 5 members).
  • Make changes to the match message
  • View the match history and see who reported meeting
CoffeeMaker Program Settings

On the free plan, CoffeeMaker will send prompts to your team at 10 AM on Wednesdays and Fridays. In the CoffeeMaker settings, you can:

  • Enable and Disable CoffeeMaker for the Team.
  • Select the channel CoffeeMaker questions will be sent to.
  • Select the timezone

On the Pro plan, you can:

  • All things on the free plan.
  • Choose which days CoffeeMaker sends questions.
  • Choose the time of day CoffeeMaker sends questions.
  • View and manage the order of the questions
  • Add your own questions!

If you have any questions that we did not cover or feedback, hit the purple chat button at the bottom right of the screen! You can also contact us at support@coffeepals.com.

Updated on: 01/08/2024

Was this helpful?

Still need help?

Chat with our team — we usually reply in a few minutes.

Related articles