Teams Blacklisted Tenants

Certain Microsoft Teams tenants explicitly disallow bots from joining any calls hosted within their tenant.

When attempting to schedule a bot for a meeting hosted within one of these tenants, you will receive a 400 error response with the teams_blacklisted_tenant error code.

What Are Blacklisted Tenants?

Blacklisted tenants are organizations that have explicitly told Microsoft to disallow all bots from joining meetings hosted within their tenant.

Oftentimes these are large enterprises operating in particularly sensitive industries, such as large financial institutions.

Are there workarounds for this?

These tenants have explicitly told Microsoft not to allow bots to join any meetings hosted within their tenant.

This restriction is not based on individual user preferences, but an organizational-wide policy for their entire tenant. Thus, it is not possible to work around this restriction.

How to handle blacklisted Teams tenants

Identifying errors due to blacklisted tenants

While Recall.ai cannot provide a public list of these blacklisted tenants, this restriction can be detected during bot creation by checking for a 400 response with the following error code:

{
  "code": "teams_blacklisted_tenant"
}

Best practices

1. Surface User-Friendly Messages: When you receive this 400 error, display a clear message to your users explaining the situation:

   "The meeting host's organization does not allow bots to join their Microsoft Teams calls."

2. Provide Alternative Solutions: In the message surfaced to the user, you can also suggest alternatives such as:

   • Scheduling the meeting with a different platform, if possible, or having your end user host the meeting within their own tenant.
   • Requesting to record the meeting using Teams' built-in recording mechanism.
   
   

Frequently Asked Questions

Can tenants be added or removed from the blacklist?

No, the blacklist is managed entirely by Microsoft and Recall.ai cannot add or remove tenants from this list unless requested by Microsoft directly.

Are there any configurations on our end to prevent this?

No, this restriction is enforced by Microsoft and stakeholders at these tenants, and thus there are no API-level configurations to bypass this.

Will this affect all meetings from the organization?

Yes, if a tenant is blacklisted, all Microsoft Teams meetings hosted by users within that organization will not allow bots to be created for them.

Is there a way to get advance notice?

No, the only way to detect a blacklisted tenant is when the error occurs during bot creation.