Skip to main content

Overview

Statisfy reads and posts in Microsoft Teams channels much as it does in Slack. You can connect Microsoft Teams, Slack, or both. With the integration, you can:
  • Capture customer conversations from Teams channels as account activity
  • Map each channel to an account so conversations attach to the right customer
  • Post meeting insights to Teams channels through notification rules and a common channel
  • Ask Stella by @mentioning it in a Teams channel
  • Reply to customers from the Workbench, from Stella drafts, or through a Digital Worker
  • Post from agents and automations to a Teams channel

Prerequisites

  • Admin access to Statisfy
  • A Microsoft Global Administrator or Privileged Role Administrator to approve Statisfy once for your organization, and a Teams Administrator or Global Administrator to add the Statisfy app to your Teams app catalog. A Global Administrator can do both.
  • Custom apps allowed in your Microsoft Teams org. In the Teams admin center, go to Teams apps > Manage apps > Org-wide app settings.
  • A Microsoft 365 organization in Microsoft’s global cloud. US Government high-security clouds (GCC High, DoD) and Microsoft’s China cloud aren’t supported.
Each Statisfy workspace connects one Microsoft organization, and each Microsoft organization can connect to only one Statisfy workspace. If your organization is already connected to another Statisfy workspace, Connect fails with This Microsoft organisation is already connected to another Statisfy account.

Connect Microsoft Teams

  1. On the Integrations page, find the Microsoft Teams tile and click Connect.
  2. Have a Microsoft Global Administrator or Privileged Role Administrator complete the Microsoft sign-in. Microsoft asks them to approve Statisfy for your organization.
  3. Microsoft then asks for a second sign-in, by a Teams Administrator or Global Administrator. In this step, Statisfy adds its app to your organization’s Teams app catalog. If the admin who approved Statisfy in step 2 is a Privileged Role Administrator without the Teams Administrator role, a Teams Administrator or Global Administrator must do this sign-in.
  4. When both steps finish, Statisfy shows Microsoft Teams connected!
Microsoft Teams tile on the Integrations page, with the Connected status and the Settings link If the second step fails with Couldn’t add Statisfy to Microsoft Teams, check that the admin is a Teams or Global Administrator and that custom apps are allowed. Then try again.

Use Slack and Microsoft Teams together

You can connect Slack and Microsoft Teams at the same time. Each one works on its own:
  • Each provider has its own settings, channels, and Stella switch.
  • Notification rules can post to Slack channels and Teams channels in the same rule.
  • Digital Workers reply on each provider you turn on for the worker.
  • The Workbench shows unanswered threads from both.
  • The Activity page shows a Slack tab and a Teams tab when both are connected.

Add Statisfy to your teams

Statisfy reads only the teams you add it to. To open the Teams settings, click Settings on the Microsoft Teams tile on the Integrations page.
  1. In the Teams section, find the team. Its status is Not installed, Waiting for Microsoft Teams, or Ready to send.
  2. Click Install next to the team.
Teams section of the Microsoft Teams settings page. One team shows Not installed with an Install button. Two teams show Ready to send with Refresh and Remove buttons After you install the app, Microsoft confirms the install. This usually takes a few seconds. Until then, the team shows Waiting for Microsoft Teams and Statisfy can’t post in it. If it doesn’t change, click Check again. Posting any message in one of the team’s channels also completes the install. The team’s channels appear in the Channels section within a few seconds. Click Refresh in the Channels section to reload the list. If a channel is still missing, click Refresh next to its team.

What Statisfy reads

When you add Statisfy to a team, it reads the standard channels in that team, including channels created later. A channel rule can limit which channels it reads. It captures:
  • Posts and replies
  • Edits and deletes. When someone edits or deletes a message, Statisfy updates or removes its stored copy.
  • Attached files and pasted images
When you install the app into a team, Statisfy reads the last 30 days of messages. After that, a daily catch-up recovers any messages Statisfy missed, going back up to 30 days. Replies sent through Statisfy by your team or a Digital Worker also appear in the account’s Teams activity. Teams conversations count everywhere Slack conversations do, including search, account timelines, engagement, account summaries, and Stella.

Refresh a team

  1. Click Refresh next to an installed team.
  2. In the Refresh dialog, enter the number of Days to backfill, from 1 to 90. The default is 30.
  3. Click Refresh.
Statisfy reads the team’s channels and members again, and backfills the messages from those days. Use Refresh when a channel or member is missing, or after channels start to be ingested.

Remove Statisfy from a team

  1. In the Teams section, click Remove next to an installed team.
  2. In the Remove Statisfy from this team? dialog, click Remove to confirm.
After you remove the app, the team’s channels stop receiving new messages.

Add Statisfy to a group chat

Statisfy can also read a Teams group chat: a chat with 3 or more people that is not in a team. You add Statisfy to each chat in Microsoft Teams, not on the settings page.
A person in your organization must create the chat and add Statisfy to it. Microsoft doesn’t let a person from outside your organization add an app to a chat, and Statisfy can’t read a chat that a person from another organization created.
  1. In Microsoft Teams, click Apps in the left bar.
  2. Click Built for your organisation (in some languages, Built for your org), then click Statisfy.
  3. Click Add. If you already added Statisfy, Teams skips this step.
  4. Under Or choose a place to use the app, click Chats.
  5. Select the group chat, then click Go.
The chat shows [Your name] added Statisfy here. No permission prompt appears: a chat member’s add grants Statisfy access to read that chat’s messages, members and name.
The + in the chat’s header and Actions and apps in the message box don’t list Statisfy. They show tabs and message actions only.
The chat appears in the Channels section within a few seconds, with Group chat in the Team column. Statisfy reads the last 30 days of the chat’s messages. After that, it captures each new message. A daily catch-up recovers any messages it missed. Edits, deletes and pasted images are captured as in channels. A file posted in a chat is kept as a link only. A chat has no reply threads, so Statisfy groups its messages into conversations by topic and time, as it does for a channel with the Threads layout. Each chat maps to one account, as a channel does. Statisfy picks the account from the chat’s members from outside your organization, then from the chat’s name. Statisfy reads chats only: Stella doesn’t answer in a chat, and the Workbench, Digital Workers and notifications don’t post in one. If you connected Microsoft Teams before Statisfy supported group chats, update the Statisfy app in your Teams app catalog first. Until you do, Statisfy can’t be added to a chat.
  1. On the Integrations page, open the Microsoft Teams tile.
  2. Click Update app. This button shows only when a newer Statisfy app is available.
  3. Complete the same two Microsoft sign-ins as in Connect Microsoft Teams, steps 2 and 3.
Your teams and channels stay connected. To stop reading a chat, turn off its Ingest messages switch, or remove Statisfy from the chat in Microsoft Teams.

Manage channels

The Channels section lists the standard channels of the teams Statisfy has been installed in, and the group chats Statisfy was added to. Use Search channels… to find a channel by its channel, team, or account name. Use the filters next to the search to narrow the list:
  • Team: one team, or All teams
  • Ingest: Ingest on or Ingest off
  • Account: Mapped or Not mapped
The search and the filters combine. Click Clear filters to show all channels again. The list shows 100 channels per page. Each row has these columns: Channels section with the search box and the Team, Ingest, and Account filters. The Team filter is set to one team and the Account filter to Not mapped, so the list shows 5 of 9 channels with Clear filters below it

Map a channel to an account

Statisfy maps channels to accounts automatically, using the team’s members and the team and channel name (“Team / Channel”). It picks the account when the channel’s first message is captured, so the Account column can be empty until then. To change the mapping, select an account in the Account column. You can also map a channel from the account page:
  1. Open the account and click the settings gear next to the account name.
  2. Under Add Channel, click Microsoft Teams. This button shows only when Slack is also connected.
  3. In Select a channel, select the channel.
  4. Click Save.
Statisfy maps a channel using the members of its whole team. If one team holds channels for several customers, a channel can map to the wrong account. Use one team per customer, or map each channel by hand.

Stop capturing a channel

A save of the channel rule resets this switch on every channel.
Turn off the Ingest messages switch for a channel. Statisfy stops capturing that channel’s messages. Turn the switch back on to resume.

Choose channels with a rule

Use a channel rule when only some channels in your teams are customer channels. For example, ingest only the channels whose names begin with cust-.
When you save the rule, Statisfy sets Ingest messages on every Teams channel to match the rule, including the General channel of each team. This resets the changes you made to single channels. Statisfy doesn’t backfill the channels that turn on. To backfill them, use Refresh on their team.
  1. On the Microsoft Teams settings page, find Channels to ingest.
  2. Enter a value in Channel name begins with, Channel name ends with, or both.
  3. Click Save.
  4. In the Apply the channel rule? dialog, click Save.
Statisfy ingests a channel when its name begins with the first value or ends with the second value. The match isn’t case-sensitive. If both values are empty, Statisfy ingests every channel. After the save, the rule also sets Ingest messages for each new channel. A change you make to a single channel stays until the next save of the rule. Only admins can change the rule. The same setting is on the Microsoft Teams tab of each Digital Worker. It applies to the whole workspace.

Customer channels

A customer channel is a standard channel in a team that has guest members (the Guests badge). The guest setting applies to the whole team, so every channel in that team counts as a customer channel. The Workbench and Digital Workers reply in customer channels that are mapped to an account.

Meeting insight notifications

Statisfy can post meeting insights to Teams channels in two ways:
  • Notification rules: in Settings > Notification Rules, create or edit a rule. Under Select Recipients, choose Teams, then pick channels. You can add Slack channels and Teams channels to the same rule. See Notification Rules.
  • Common channel: in Settings > Config, under the Notification settings, set Common Microsoft Teams channel for pushing Statisfy meeting insights. It sits next to Slack’s common channel.
Edit Notification Rule dialog. A Teams channel is added under Select Recipients, and the recipient type list shows Email, Slack, and Teams Account types for common channel notifications applies to both the Slack and the Teams common channel. Notification settings with the common Slack channel and the common Microsoft Teams channel set to a team and channel Only channels Statisfy can post in appear in these pickers. If none appear, the picker shows Configuration incomplete. with a Finish Microsoft Teams setup link. Install Statisfy in a team and wait for it to show Ready to send.

Stella in Microsoft Teams

To ask Stella a question, @mention Stella in a Teams channel. Stella replies in the thread with Stella is looking into this…, then replaces that message with its answer. If Stella fails, it retries, so an answer can take a few minutes. Stella answers in a channel only when:
  1. Stella is turned on for Teams. On the Teams settings page, set Enable Stella to Enable for all Statisfy users or Enable for all users. The default is Disable.
  2. Enable Stella is checked for the channel in the Channels section.
Enable Stella list on the Teams settings page, with the options Disable, Enable for all Statisfy users, and Enable for all users With Enable for all Statisfy users, Stella answers only people who are Statisfy users. Anyone else gets a reply saying Stella is disabled. Stella never answers in channels of teams with guest members, so you can’t check Enable Stella for those channels. The Teams Stella switch is separate from the Slack one. Turning Stella on or off in Slack doesn’t change Teams. Stella doesn’t answer direct messages in Teams. All @mentions in the same thread are one conversation, so you can ask follow-up questions. Stella uses the earlier messages in that thread. If Stella needs your approval before it does an action, such as creating a Jira ticket, it posts an approval card in the thread. Click Approve or Reject, and Stella continues in the thread. Only the person who asked Stella can decide. See Approving Stella’s actions.

Workbench

The Workbench finds customer Teams threads that are waiting on a reply from you. It drafts a reply for each one, with one card per thread.
  1. Open the item in your Workbench queue. Use the Teams type filter to see only Teams items.
  2. Review the customer’s thread and edit the draft.
  3. Click Approve & send.
Workbench queue filtered to Teams, with one item labeled Unanswered Teams Statisfy posts the reply in the customer’s thread. The post comes from the Statisfy app, led by your name in bold (or the worker’s name, for a held Digital Worker reply). Teams doesn’t let apps post as a person.

Stella drafts

You can ask Stella to message a customer on Microsoft Teams. Stella drafts a new conversation in the customer’s Teams channel. Review the draft, then click Edit & Send to edit and post it. When the Workbench is enabled, you can also click Add to Workbench to save it to your queue. Stella draft card for a Teams message, with the team and channel, a preview of the message, and the Edit & Send and Add to Workbench buttons

Digital Workers

A Digital Worker can reply to customers in their Teams channels. To turn it on, open the worker and go to the Microsoft Teams tab. This tab only appears while Microsoft Teams is connected. Microsoft Teams tab of a Digital Worker, with the Microsoft Teams switch, the Auto-reply on hold switch, and the acknowledgement message
  • Approval by default: Teams replies wait for approval unless you add a Microsoft Teams override set to smart under Autonomy. Held replies appear in the Workbench and in the Digital Workers pool, where a teammate can edit and send them.
  • What it replies to: the worker replies only to new customer messages up to 6 hours old. It always replies in that message’s thread.
  • How replies appear: replies come from the Statisfy app, with the worker’s name in bold at the start.
  • After a teammate answers: if a teammate answered the customer after the worker’s last reply, the worker holds its next reply for approval.
  • Which channels: the tab also shows the channel rule. It is the same rule as on the Microsoft Teams settings page.

Agents and automations

  • Agents: an agent with the Microsoft Teams toolkit can post to a Teams channel and reply in a thread. Before it sends, an approval card shows the destination as “Team / Channel”.
  • Automations: the Send Microsoft Teams Message component posts a new conversation in a Teams channel. Select the channel in the Channel list. See Actions.

Disconnect Microsoft Teams

  1. On the Integrations page, open the Microsoft Teams tile and click Disconnect.
  2. A Microsoft Teams Administrator or Global Administrator signs in.
Statisfy removes its app from every team and from your Teams app catalog. When the app leaves the catalog, it also stops working in your group chats. If you connect Microsoft Teams again later, add Statisfy to each group chat again. Messages already captured are kept. If removing the app from a team fails, Disconnect stops with an error and Microsoft Teams stays connected; click Disconnect again. If Microsoft no longer lets Statisfy remove the app (for example, after approval was withdrawn), Statisfy disconnects and tells you how many teams still have the app. Remove it from those teams in Microsoft Teams.

If Microsoft approval is withdrawn

A Microsoft admin in your organization can withdraw Statisfy’s approval, or disable or delete the Statisfy app. When that happens, the Microsoft Teams connection goes into an error state, and the history catch-up and team refresh jobs fail with Microsoft Teams approval was withdrawn. The connection returns to connected automatically once Microsoft lets Statisfy in again.

Not supported

  • Direct messages: meeting-insight DMs, the Workbench digest, Stella DMs, Agent Studio approval nudges, and welcome messages aren’t available in Teams.
  • Private channels: Statisfy doesn’t read or post in private channels.
  • Shared channels: channels hosted by another organization, and shared channels hosted by your customer.
  • 1:1 chats: Statisfy doesn’t read or post in 1:1 chats, and Stella doesn’t answer in them. (In Slack, Stella can answer direct messages.)
  • Posts in group chats: Statisfy reads group chats, but it doesn’t post in them, and Stella doesn’t answer in them.
  • Posts by other apps and bots: same as Slack.
  • File attachments on posts Statisfy sends: replies, Digital Worker messages, and Stella drafts are text only.
  • Agent Studio: the Slack Channel Manager (create channels and invite people) and Integration Call have no Teams version.
  • US Government (GCC High, DoD) and China clouds.

Differences from Slack

View Teams conversations

Captured conversations appear in the Teams tab on the Activity page and on each account’s timeline. Open a conversation in the activity drawer to read the whole thread. The Source column shows the channel name, and the Team column shows the channel’s team. For a group chat, the Source column shows the chat’s name and the Team column shows Group chat. To see only the conversations of one team, add the Teams Activity › Team filter and select the team. Teams tab on the Activity page, with each conversation's title, source channel, team, message count, participants, last update, and sentiment