Suplementos para o Outlook em dispositivos móveis

Os suplementos funcionam agora no Outlook em dispositivos móveis, com as mesmas APIs disponíveis para outros pontos finais do Outlook. Se já criou um suplemento para o Outlook, é fácil pô-lo a funcionar no Outlook mobile.

Os suplementos móveis do Outlook são suportados em todas as contas empresariais do Microsoft 365 e contas Outlook.com. No entanto, o suporte não está atualmente disponível em contas do Gmail.

Um painel de tarefas de exemplo no Outlook no iOS

Um painel de tarefas de exemplo no Outlook no Android

Qual é a diferença no celular?

• O tamanho pequeno e rápidas interações tornam o projeto para celular um desafio. Para garantir experiências de qualidade para os clientes, qualquer suplemento que declare suporte móvel tem de cumprir determinados critérios de validação a aprovar no AppSource.

  • O suplemento DEVE cumprir as diretrizes de interface do usuário.
  • O cenário do suplemento TEM de fazer sentido em dispositivos móveis.
  • Terá de concordar com a nossa adenda para programadores para suplementos no iOS e tem de submeter o seu ID de Programador da Apple para verificação.

• Em geral, apenas o modo de Leitura de Mensagens é suportado. Isto tem implicações na forma como configura o manifesto.

  • Manifesto unificado para o Microsoft 365: "mailRead" é o único item que deve declarar na matriz "extensions.ribbons.contexts".
  • Manifesto apenas de suplemento: MobileMessageReadCommandSurface é o único ExtensionPoint que deve declarar na secção móvel do seu manifesto.

  No entanto, existem algumas exceções.

  1. O modo Organizador de Compromissos é suportado para suplementos integrados do fornecedor de reuniões online.

     • Manifesto unificado para o Microsoft 365: "onlineMeetingDetailsOrganizer" é permitido na matriz "extensions.ribbons.contexts".
     • Manifesto apenas de suplemento: o ponto de extensão MobileOnlineMeetingCommandSurface é permitido.

     Para obter mais informações sobre este cenário, consulte Criar um suplemento do Outlook para dispositivos móveis para um fornecedor de reuniões online.

  2. O modo Participante do Compromisso é suportado para suplementos integrados criados por fornecedores de aplicações de gestão de relações com clientes (CRM) e de escrita de notas.

     • Manifesto unificado para o Microsoft 365: "logEventMeetingDetailsAttendee" é permitido na matriz "extensions.ribbons.contexts".
     • Manifesto apenas de suplemento: o ponto de extensão MobileLogEventAppointmentAttendee é permitido.

     Para obter mais informações sobre este cenário, veja Registar notas de compromisso para uma aplicação externa nos suplementos móveis do Outlook.

  3. Os suplementos baseados em eventos que são ativados no OnNewMessageCompose evento requerem uma exceção.

     • Manifesto unificado para o Microsoft 365: os suplementos baseados em eventos não são tratados como um contexto no manifesto unificado, pelo que não existe nenhuma exceção para configurar a matriz "extensions.ribbons.contexts". No entanto, tenha em atenção que os suplementos baseados em eventos necessitam de uma propriedade "extensions.autoRunEvents" no manifesto.
     • Manifesto apenas de suplemento: o ponto de extensão LaunchEventtem de ser declarado.

     Para obter mais informações, veja Implementar a ativação baseada em eventos em suplementos móveis do Outlook.

• A API makeEwsRequestAsync não é suportada em dispositivos móveis, uma vez que a aplicação móvel utiliza APIs REST para comunicar com o servidor. Se seu back-end do aplicativo precisa se conectar ao servidor do Exchange, é possível usar o token de retorno de chamada para fazer chamadas de API REST. Para obter detalhes, consulte Usar APIs REST do Outlook de um suplemento do Outlook.

• O seu manifesto tem de declarar suporte móvel, incluindo controlos móveis especiais e tamanhos de ícones.

  • Manifesto unificado para o Microsoft 365: inclua a cadeia "mobile" na matriz "extensions.ribbons.requirements.formFactors" e inclua uma matriz "customMobileRibbonGroups" no objeto de separador da matriz "extensions.ribbons.tabs". O objeto nesta matriz tem de incluir uma matriz "controls.type" de "mobileButton" e "controls.icons".
  • Manifesto apenas de suplemento: inclua um <MobileFormFactor> e inclua os tipos corretos de controlos e tamanhos de ícones.

  Para saber mais, consulte Adicionar suporte para comandos de suplementos no Outlook em dispositivos móveis.

O que torna um bom cenário para suplementos móveis do Outlook?

Lembre-se de que o tamanho médio da sessão Outlook em um telefone é bem menor do que em um PC. Isso significa que seu suplemento deve ser rápido e o cenário deve permitir que o usuário entre, saia e prossiga com seu fluxo de email.

Eis exemplos de cenários que fazem sentido no Outlook Mobile.

• O suplemento traz informações valiosas para o Outlook, para ajudar os usuários na triagem dos emails e a responder adequadamente. Por exemplo, um suplemento de gestão de relações com os clientes (CRM) que permite ao utilizador ver as informações do cliente e partilhar as informações adequadas.

• O suplemento agrega valor ao conteúdo do email do usuário, salvando as informações em um controle, uma colaboração ou um sistema semelhante. Por exemplo, um suplemento que permite aos utilizadores transformar e-mails em itens de tarefas para controlo de projetos ou pedidos de ajuda para uma equipa de suporte.

Uma interação de usuário de exemplo para criar um cartão do Trello com base em uma mensagem de email no iOS

Uma interação de usuário de exemplo para criar um cartão do Trello com base em uma mensagem de email no Android

Teste seus suplementos no celular

Para testar um suplemento no Outlook mobile, primeiro carregue um suplemento com uma conta do Microsoft 365 ou Outlook.com no Outlook na Web, no Windows (novo ou clássico) ou no Mac. Certifique-se de que o seu manifesto está corretamente formatado para conter MobileFormFactor ou que não será carregado no Outlook Mobile.

Depois de o suplemento estar a funcionar, certifique-se de que o testa em diferentes tamanhos de ecrã, incluindo telemóveis e tablets. Você deve verificar se ele atende às diretrizes de acessibilidade de contraste, tamanho da fonte e cor, bem como de usabilidade com um leitor de tela, como o VoiceOver no iOS ou TalkBack no Android.

A resolução de problemas em dispositivos móveis pode ser difícil, uma vez que pode não ter as ferramentas a que está habituado. No entanto, uma opção para a resolução de problemas no iOS é utilizar o Fiddler (marcar este tutorial sobre como utilizá-lo com um dispositivo iOS).

Observação

Os Outlook na Web modernos em smartphones iPhone e Android já não são necessários ou estão disponíveis para testar suplementos do Outlook. Além disso, os suplementos não são suportados no Outlook para Android, no iOS e na Web móvel moderna com contas do Exchange no local. Determinados dispositivos iOS ainda suportam suplementos ao utilizar contas do Exchange no local com Outlook na Web clássicos. Para obter informações sobre os dispositivos suportados, confira Requisitos para executar Suplementos do Office.

Próximas etapas

Saiba como:

• Adicione suporte para comandos de suplementos no Outlook em dispositivos móveis.
• Implementar APIs JavaScript do Outlook suportadas.
• Projetar uma ótima experiência móvel para seu suplemento.
• Obter um token de acesso e chamar APIs REST do Outlook do suplemento.