Aplicativos em reuniões do TeamsApps in Teams meetings

As reuniões permitem colaboração, parceria, comunicação informada e comentários compartilhados em um fórum inclusivo e ativo.Meetings enable collaboration, partnership, informed communication, and shared feedback in an inclusive and active forum. O aplicativo de reunião pode oferecer uma experiência do usuário para cada estágio do ciclo de vida da reunião, incluindo a experiência do aplicativo pré-reunião, na reunião e pós-reunião, dependendo do status do participante.The meeting app can deliver a user experience for each stage of the meeting lifecycle including pre-meeting, in-meeting and post-meeting app experience, depending on the attendee's status.

Os usuários finais do Teams podem acessar aplicativos durante reuniões usando a galeria de guias, por exemplo:Teams end-users can access apps during meetings using the tab gallery, for example:

  • Pré-estágio de um quadro KanbanPre-stage a Kanban board
  • Iniciar uma caixa de diálogo acionável na reuniãoLaunch an in-meeting actionable dialog
  • Criar uma sondagem pós-reuniãoCreate a post-meeting poll

A extensibilidade do aplicativo de reunião do Teams baseia-se nos seguintes conceitos:Teams’ meeting app extensibility is based on the following concepts:

✔ ciclo de vida da reunião tem estágios como antes, durante e após o período de tempo de reunião.✔ Meeting lifecycle has stages such as before, during, and after meeting time frame.
✔ Funções de participante em uma reunião, como organizador da reunião, apresentador ou participante.✔ Participant roles in a meeting such as meeting organizer, presenter, or attendee.
✔ Tipos de usuário em uma reunião, como no locatário, convidado, federado ou usuário anônimo do Teams.✔ User types in a meeting such as in-tenant, guest, federated, or anonymous Teams user.

Este artigo aborda informações sobre o ciclo de vida da reunião e como integrar guias, bots e extensões de mensagens em sua reunião.This article covers information about the meeting lifecycle and how to integrate tabs, bots, and messaging extensions in your meeting. Ele também permite identificar funções de participantes e também usar diferentes tipos de usuário para executar tarefas.It also enables you to identify participant roles and also use different user types to perform tasks.

Observação

Para trabalhar com os recursos de extensibilidade do aplicativo de reunião, você deve ter as permissões apropriadas.To work with the meeting app extensibility features, you must have the appropriate permissions.

Ciclo de vida da reuniãoMeeting lifecycle

O ciclo de vida da reunião consiste na experiência do aplicativo de pré-reunião, na reunião e pós-reunião.Meeting lifecycle consists of pre-meeting, in-meeting, and post-meeting app experience. Você pode integrar guias, bots e extensões de mensagens em cada estágio do ciclo de vida da reunião.You can integrate tabs, bots, and messaging extensions in each stage of the meeting lifecycle.

Integrar guias ao ciclo de vida da reuniãoIntegrate tabs into the meeting lifecycle

As guias permitem que os membros da equipe acessem serviços e conteúdo em um espaço específico em um canal ou chat.Tabs allow team members to access services and content in a specific space within a channel or chat. Isso permite que a equipe trabalhe diretamente com guias e tenha conversas sobre as ferramentas e dados disponíveis nas guias.This lets the team work directly with tabs and have conversations about the tools and data available within tabs. Na reunião do Teams, os usuários podem adicionar uma guia selecionando maisIn Teams meeting, users can add a tab by selecting plus Plus buttone escolher o aplicativo que eles querem instalar como uma guia., and choosing the app that they want to install as a tab.

Importante

Se você tiver integrado uma guia à sua reunião, seu aplicativo deverá seguir o fluxo de autenticação de logom único (SSO) do Teams para guias.If you have integrated a tab with your meeting, then your app must follow the Teams single sign-on (SSO) authentication flow for tabs.

Observação

  • Os clientes móveis suportam guias somente em estágios pré e pós-reunião.Mobile clients support tabs only in pre and post meeting stages. As experiências em reunião que estão na caixa de diálogo e no painel da reunião não estão disponíveis no momento em dispositivos móveis.The in-meeting experiences that is in-meeting dialog and panel are currently not available on mobile.
  • Os aplicativos têm suporte apenas em reuniões agendadas privadas.Apps are supported only in private scheduled meetings.

Experiência do aplicativo de pré-reuniãoPre-meeting app experience

Experiência de pré-reunião:Pre-meeting experience:

experiência de pré-reunião

Guia Pré-reunião:Pre-meeting tab:

exibição de guia de pré-reunião

✔ usuários com permissão são usuários que podem adicionar aplicativos a uma reunião durante diferentes estágios do ciclo de vida da reunião.✔ Permissioned users are users who can add apps to a meeting during different stages of the meeting lifecycle. Esses usuários podem adicionar aplicativos a uma reunião por meio da galeria de guias de duas maneiras:These users can add apps to a meeting through the tab gallery in two ways:

  • Usando a guia Detalhes no formulário de agendamento do Teams.Using the Details tab on the Teams scheduling form.

  • Usando a guia Chat de reunião em uma reunião existente.Using the meeting Chat tab in an existing meeting.

✔ aplicativos tab são acessíveis em reuniões Páginas detalhes e chats usando um botão de ➕ de adoção.✔ Tab apps are accessible in meetings Details and Chats pages using a plus ➕ button.

✔ layout tab deve estar em um estado organizado se houver mais de dez pesquisas ou pesquisas.✔ Tab layout must be in an organized state if there are more than ten polls or surveys.

Experiência do aplicativo na reuniãoIn-meeting app experience

✔ aplicativos de reunião são hospedados na barra superior superior da janela de chat e como experiência de guia na reunião usando a guia na reunião. Quando os usuários adicionam uma guia a uma reunião por meio da galeria de guias, os aplicativos que são durante as experiências de reunião são mostrados.✔ Meeting apps are hosted in the top upper bar of the chat window and as in-meeting tab experience using the in-meeting tab. When users add a tab to a meeting through the tab gallery, apps that are during meeting experiences are shown.

✔ usuários com permissão podem adicionar aplicativos durante a reunião.✔ Permissioned users can add apps while in the meeting.

✔ Quando carregado no contexto de uma reunião, os aplicativos podem aproveitar o SDK do cliente do Teams para acessar o , e renderizar adequadamente meetingId userMri a frameContext experiência.✔ When loaded in the context of a meeting, apps can leverage the Teams client SDK to access the meetingId, userMri, and frameContext to appropriately render the experience.

✔ Exportar um resultado de uma pesquisa ou sondagem notifica os usuários que os resultados foram baixados com êxito.✔ Exporting a result of a survey or poll notifies the users that the results successfully downloaded.

✔ Um aplicativo fica visível em uma reunião do Teams no painel lateral ou na caixa de diálogo na reunião.✔ An app is visible in a Teams meeting in the side panel or the in-meeting dialog box. Use a caixa de diálogo na reunião para mostrar conteúdo a actionable para os participantes da reunião.Use the in-meeting dialog box to showcase actionable content for meeting participants. Para obter mais informações, consulte create apps for Teams meetings.For more information, see create apps for Teams meetings.

Observação

O manifesto do aplicativo especifica que sua guia é otimizadapara o painel lateral , que é onde ele é exibido.Your app manifest specifies that your tab is optimized for side panel, that is where it is displayed. Ele também pode fazer parte de uma experiência de bandeja de compartilhamento, sujeito a diretrizes de design especificadas.It can also be part of a share-tray experience, subject to specified design guidelines.

As imagens a seguir exibem o aplicativo como uma caixa de diálogo na reunião e como um painel lateral separado:The following images display the app as an in-meeting dialog box and as a separate side panel:

Experiência na reunião

Exibição de diálogo na reunião

Caixa de diálogo a actionable na reunião para usuáriosIn-meeting actionable dialog for users

Exibição de caixa de diálogo

Experiência de aplicativo pós-reuniãoPost-meeting app experience

Exibição pós-reunião

✔ O cenário do aplicativo pós-reunião é semelhante à experiência atual pós-reunião com o benefício adicionado de ter guias que existem dentro da superfície.✔ The post-meeting app scenario is similar to the current post-meeting experience with the added benefit of having tabs that exist within the surface.

✔ os usuários com permissão podem adicionar aplicativos da galeria de guias a uma reunião usando a guia Detalhes no formulário de agendamento do Teams e a guia Chat de reunião em uma reunião existente.✔ Permissioned users can add apps from the tab gallery to a meeting using the Details tab on the Teams scheduling form and the meeting Chat tab in an existing meeting.

✔ layout da guia deve ser organizado quando houver mais de dez pesquisas ou pesquisas.✔ Tab layout must be organized when there are more than ten polls or surveys.

Integrar bots ao ciclo de vida da reuniãoIntegrate bots into the meeting lifecycle

Para implementação de bot, comece com a complicação de um bot e continue com a criação de aplicativos para reuniões do Teams.For bot implementation, start with build a bot and then continue with create apps for Teams meetings.

Integrar extensões de mensagens ao ciclo de vida da reuniãoIntegrate messaging extensions into the meeting lifecycle

Para implementação de extensão de mensagens, comece com a criação de uma extensão de mensagens e continue com a criação de aplicativos para reuniões do Teams.For messaging extension implementation, start with build a messaging extension and then continue with create apps for Teams meetings.

Funções de participante e tipos de usuário em uma reuniãoParticipant roles and user types in a meeting

Participantes de uma reunião

Funções de participanteParticipant roles

As configurações de participante padrão são determinadas pelo administrador de IT de uma organização.Default participant settings are determined by an organization's IT administrator. Veja a seguir as funções dos participantes em uma reunião:The following are the participant roles in a meeting:

  • Organizador: o organizador agenda uma reunião, define as opções de reunião, atribui funções de reunião e inicia a reunião.Organizer: The organizer schedules a meeting, sets the meeting options, assigns meeting roles, and starts the meeting. Somente usuários com uma conta M365 com uma licença do Teams podem ser organizadores e controlar as permissões do participante.Only users with a M365 account with a Teams license can be organizers and control attendee permissions. Um organizador da reunião pode alterar as configurações de uma reunião específica.A meeting organizer can change the settings for a specific meeting. Os organizadores podem fazer essas alterações na página da Web opções de reunião.Organizers can make these changes on the Meeting options web page.
  • Apresentador : os apresentadores têm os mesmos recursos que o organizador.Presenter: Presenters have the same capabilities as organizer. No entanto, um apresentador não pode remover um organizador da sessão ou modificar opções de reunião para a sessão.However, a presenter cannot remove an organizer from the session or modify meeting options for the session. Por padrão, os participantes que participam de uma reunião têm a função de apresentador.By default, participants joining a meeting have the presenter role.
  • Participante: um participante é um usuário que foi convidado a participar de uma reunião, mas que não está autorizado a atuar como apresentador.Attendee: An attendee is a user who has been invited to attend a meeting but who is not authorized to act as a presenter. Os participantes podem interagir com outros membros da reunião, mas não podem gerenciar nenhuma das configurações de reunião ou compartilhar conteúdo.Attendees can interact with other meeting members but cannot manage any of the meeting settings or share content.

Somente um organizador ou apresentador pode adicionar, remover ou desinstalar aplicativos.Only an organizer or presenter can add, remove, or uninstall apps. Somente organizador ou apresentador pode criar votações em uma reunião.Only organizer or presenter can create polls in a meeting.

Para obter mais informações, consulte funções em uma reunião do Teams.For more information, see roles in a Teams meeting.

Você pode acessar a página Opções de reunião da seguinte forma:You can access the Meeting options page as follows:

  • No Teams, vá para o logotipo do  calendário, selecione uma reunião e, em seguida, opções de reunião.In Teams, go to Calendar calendar logo, select a meeting, and then Meeting options.

  • Em um convite de reunião, selecione Opções de reunião.In a meeting invitation, select Meeting options.

  • Durante uma reunião, selecione Mostrar que os participantes mostram o ícone dos participantes nos  controles de reunião.During a meeting, select Show participants show participants icon in the meeting controls. Em seguida, acima da lista de participantes, escolha Gerenciar permissões.Then, above the list of participants, choose Manage permissions.

Tipos de usuáriosUser types

Observação

Os usuários com tipos de usuário específicos atribuídos a eles podem participar de reuniões e assumir uma das funções de participante descritas nas funções de participante.Users with specific user types assigned to them can join meetings and assume one of the participant roles described in participant roles. O tipo de usuário não está incluído na API getParticipantRole.The user type is not included in the getParticipantRole API.

Os seguintes tipos de usuário identificam o que cada usuário pode fazer e o que podem acessar:The following user types identify what each user can do and what they can access:

  • In-tenant: Os usuários no locatário pertencem à organização e têm credenciais no Azure Active Directory (AAD) para o locatário.In-tenant: In-tenant users belong to the organization and have credentials in Azure Active Directory (AAD) for the tenant. Eles geralmente são funcionários em tempo integral, no local ou remotos.They are usually full-time, onsite, or remote employees. Um usuário no locatário pode ser um organizador, apresentador ou participante.An in-tenant user can be an organizer, presenter, or attendee.
  • Convidado: um convidado é um participante de outra organização convidado para acessar o Teams ou outros recursos no locatário da organização.Guest: A guest is a participant from another organization invited to access Teams or other resources in the organization's tenant. Os convidados são adicionados ao AAD da sua organização e têm os mesmos recursos do Teams como um membro nativo da equipe com acesso a chats, reuniões e arquivos de equipe.Guests are added to your organization’s AAD and have the same Teams capabilities as a native team member with access to team chats, meetings, and files. Um usuário convidado pode ser organizador, apresentador ou participante.A guest user can be an organizer, presenter, or attendee. Para obter mais informações, consulte acesso de convidados no Teams.For more information, see guest access in Teams.
  • Federado ou externo: um usuário federado é um usuário externo do Teams em outra organização que foi convidado a participar de uma reunião.Federated or external: A federated user is an external Teams user in another organization who has been invited to join a meeting. Esses usuários têm credenciais válidas com parceiros federados e são autorizados pelo Teams.These users have valid credentials with federated partners and are authorized by Teams. Eles não têm acesso às suas equipes ou a outros recursos compartilhados da sua organização.They do not have access to your teams or other shared resources from your organization. O acesso de convidados é uma opção melhor para usuários externos ter acesso a equipes e canais.Guest access is a better option for external users to have access to teams and channels. Para obter mais informações, consulte manage external access in Teams.For more information, see manage external access in Teams.
  • Anônimo: os usuários anônimos não têm uma identidade AAD e não são federados com um locatário.Anonymous: Anonymous users do not have an AAD identity and are not federated with a tenant. O participante anônimo é como um usuário externo, mas sua identidade não é projetada na reunião.The anonymous participant is like an external user, but their identity is not projected in the meeting. Um usuário anônimo não pode ser um organizador, mas pode ser um apresentador ou um participante.An anonymous user cannot be an organizer but can be a presenter or an attendee.

Observação

Os usuários anônimos herdam a política de permissão de aplicativo padrão global no nível do usuário.Anonymous users inherit the global default user-level app permission policy. Para obter mais informações, consulte Manage Apps.For more information, see Manage Apps.

A tabela a seguir fornece os tipos de usuário e quais recursos cada usuário pode acessar:The following table provides the user types and what features each user can access:

Tipo de usuárioUser type GuiasTabs BotsBots Extensões de mensagensMessaging extensions Cartões AdaptáveisAdaptive Cards Módulos de tarefasTask modules Caixa de diálogo na reuniãoIn-meeting dialog
Usuário anônimoAnonymous user Não disponívelNot available Não disponívelNot available Não disponívelNot available Interações no chat de reunião são permitidas.Interactions in the meeting chat are allowed. Interações no chat de reunião de um Cartão Adaptável são permitidas.Interactions in the meeting chat from an Adaptive Card are allowed. Não disponívelNot available
Convidado que faz parte do locatário AADGuest that is part of the tenant AAD A interação é permitida.Interaction is allowed. Não é permitido criar, atualizar e excluir.Creating, updating, and deleting are not allowed. Não disponívelNot available Não disponívelNot available Interações no chat de reunião são permitidas.Interactions in the meeting chat are allowed. Interações no chat de reunião de um Cartão Adaptável são permitidas.Interactions in the meeting chat from an Adaptive Card are allowed. DisponívelAvailable
FederadoFederated Não disponívelNot available Não disponívelNot available Não disponívelNot available Não disponívelNot available Não disponívelNot available Não disponívelNot available

Confira tambémSee also

Próximas etapasNext steps