This guide is for Microsoft 365 / Teams administrators. It explains how to allow the RandomCoffee app, make it available to your users, and (optionally) pre-install it automatically.

You'll need the Teams Administrator or Global Administrator role, and access to the Teams Admin Center.

Microsoft has replaced the old App permission policies with unified app management. App access is now controlled directly from the Manage apps page (the Availability setting), not from permission policies. If your tenant still shows permission policies, both approaches work, but the steps below use the current model.

1. Go to the Teams Admin Center → Teams apps → Manage apps.

2. In the search box, type RandomCoffee.

3. Open the app and check the App status column/field:

- It must be Allowed (not Blocked).

- If it shows Blocked, select the app and choose Allow.

> If the app is Blocked, users can still see previously posted messages but interacting with the buttons (e.g. Yes, I'm in) will fail.

Availability controls who is allowed to install and use the app.

1. In Manage apps, search for RandomCoffee and open it.

2. Go to the Users and groups tab.

3. In the dropdown, select Availability.

4. Choose Available to everyone.

1. In Manage apps, open RandomCoffee → Users and groups tab → Availability.

2. Select Specific users or groups can install.

3. Click Edit availability and add the users or security groups that should have access.

> Important: Only the users/groups included here will be able to use the app. If you restrict availability, make sure everyone who should use RandomCoffee is included.

By default, users add the app themselves. To push it automatically so it's already there for them, use an App setup policy.

1. Go to Teams apps → Setup policies.

2. Select Add to create a new policy (or edit the global/org-wide default).

3. Under Installed apps, click Add apps, search for RandomCoffee, and add it.

4. Save the policy.

5. Assign the policy to the relevant users or groups (via Group policy assignment or per user).

Changes in the Teams Admin Center are not instant. Allow up to 24 hours for allow/availability/setup-policy changes to fully apply across all clients. To speed things up on a specific device, fully quit and restart Teams, or sign out and back in.

If RandomCoffee still doesn't appear or work after completing these steps and waiting for propagation, contact [email protected] with your tenant name and the affected user(s).