Activity: Conversation Update Events

As seen from the previous page, the conversationUpdate activity is used to describe a change in a conversation's members, description, existence, or otherwise. There are several default events that originate from the Agents protocol. However, Teams also has custom events that can be used to extend the conversation update activity.

Default conversation update events

The following events are part of the original Agents protocol and are supported by Teams.

// Initiate an action when a team member is added to a conversation app.on('conversationUpdate', async ({ activity }) => { if (activity.membersAdded) { } });
  • historyDisclosed - Deprecated
  • membersAdded
  • membersRemoved
  • topicName

Custom Teams conversation update events

The following events are custom to Teams and are not part of the original Agents protocol. These events are handled by the router and can be referenced directly as below.

app.on('channelCreated', async ({ activity }) => {});

The following events are custom to Teams and are not part of the original Agents protocol.

  • channelCreated
  • channelDeleted
  • channelRenamed
  • channelRestored
  • teamArchived
  • teamDeleted
  • teamHardDeleted
  • teamRenamed
  • teamRestored
  • teamUnarchived

Table of conversation update events

EventAction takenScope
'channelCreated'Channel createdTeam
'channelDeleted'Channel deletedTeam
'channelRenamed'Channel renamedTeam
'channelRestored'Channel restoredTeam
'historyDisclosed'Deprecated. Whether channel history is disclosedTeam
'membersAdded'List of members addedPersonal, Group, Team
'membersRemoved'List of members removedPersonal, Group, Team
'teamRenamed'Team is renamedTeam
'teamDeleted'Team is deletedTeam
'teamHardDeleted'Team is permanently deletedTeam
'teamArchived'Team is archivedTeam
'teamUnarchived'Team is unarchivedTeam
'teamRestored'Team is restored after being deletedTeam
'topicName'Chat's display name for a group chatGroup