Registre o conector no painel de conectores para desenvolvedores do Office

  • Artigo

Importante

Office 365 Conectores no Teams serão descontinuados em breve. A aplicação Fluxos de Trabalho fornece funcionalidades semelhantes com mais escalabilidade e segurança. Para obter mais informações, consulte Descontinuação de conectores Office 365 no Microsoft Teams. O registo de novos conectores no portal do programador do Conector está desativado.

Criar um conector do Office para a sua aplicação é fácil. Tudo o que precisa de fazer é registar o conector no nosso portal do programador, adicionar uma experiência de configuração integrada à sua aplicação e implementar o conector. Você pode ajudar os usuários a descobrir o conector mais facilmente publicando em nosso catálogo.

Criar seu próprio Conector

Registro do seu Conector

Visite o Portal do Programador do Conector e inicie sessão com as suas credenciais do Microsoft 365. Se não tiver um inquilino do Microsoft 365, poderá qualificar-se para um através do Programa para Programadores do Microsoft 365; para obter detalhes, veja as FAQ. Em alternativa, pode inscrever-se numa avaliação gratuita de um mês ou comprar um plano do Microsoft 365.

Escolha Novo conector e preencha o formulário. Ao escolher Salvar, novas opções aparecem na página.

  • O botão Sideload para Outlook adicionará temporariamente seu conector na experiência do Outlook do usuário conectado. Esse usuário poderá configurar o conector na caixa de entrada ou em qualquer grupo do qual ele é membro.
  • O botão Publicar no Store iniciará o processo de publicação, incluindo a análise da Microsoft para a listagem na loja.

Adicionando uma experiência integrada de configuração

Uma experiência de configuração integrada permite que o usuário configure o conector sem sair do Outlook. Seu aplicativo expõe a configuração como uma página da Web que usa a biblioteca JavaScript do Microsoft Teams para comunicar o status de configuração para o Outlook.

Para obter mais detalhes, consulte Integrando a experiência de configuração.

Observação

O documento Integrando a experiência de configuração é específico do Microsoft Teams, mas os métodos documentados funcionam da mesma maneira no Outlook.

Requisitos de configuração específicos do Outlook

Se a sua experiência de configuração requer autenticação, há requisitos adicionais para habilitar o fluxo de autenticação no Outlook no Windows.

O Outlook no Windows passa um parâmetro de consulta adicional para a página inicial de autenticação dos conectores.

callbackUrl=<connectors url>

Seu aplicativo deve manter esse valor e passá-lo como um parâmetro adicional para os métodos microsoftTeams.authentication.notifySuccess ou microsoftTeams.authentication.notifyFailure após a conclusão da autenticação.

microsoftTeams.authentication.notifySuccess(result, callbackUrl);

Publicar seu Conector no Store

Depois de testar cuidadosamente o conector e este estar pronto para ser listado no catálogo de conectores do Office, pode utilizar o botão Publicar na Loja para o submeter para revisão. Após analisado e aprovado, seu conector seria adicionado ao catálogo de conectores.

Lista de verificação de envio do conector

  • Certifique-se de que o conector está totalmente funcional e testado exaustivamente antes de enviá-lo para o repositório.
  • Teste seus cartões de conector em vários clientes nos quais seus usuários os usariam: aplicativos móveis do Outlook na Web, Outlook 2016 ou posterior e Outlook Groups.
  • Certifique-se de que você usa estritamente o Markdown de decoração de texto e não envia HTML em sua carga de cartão do conector.
  • Mantenha um equilíbrio entre adicionar valor e gerar muito ruído. Certifique-se de que o usuário não está sobrecarregado com muitas notificações.
  • Identifique os eventos certos para enviar cartões de conector. Certifique-se de que as informações enviadas ao grupo sejam valiosas para os membros do grupo.
  • Ao enviar relatórios ou resumos, use um formato de resumo e permita que o usuário escolha a hora e a frequência dos relatórios.
  • Ao enviar cartões de conector, aproveite o Markdown da melhor forma possível para destacar partes importantes do cartão.
  • Torne seus cartões de conector acionáveis fornecendo ações relevantes sempre que possível.
  • Ações invocadas devem ser realmente baixas na taxa de falha e devem ter uma resposta rápida em relação ao seu ponto de extremidade.
  • Certifique-se de que você tem provisões para o usuário pausar ou remover a configuração.
  • Tenha uma documentação clara voltada para o usuário sobre os recursos oferecidos pelo seu conector.
  • Ao registrar seu conector:
    • Certifique-se de que o nome e o logotipo de seu conector não violam uma marca comercial ou os direitos autorais de qualquer outro produto ou serviço.
    • Forneça um logotipo de alta qualidade de tipo jpg, jpeg, png ou gif em 60 KB de tamanho.
    • Forneça uma breve descrição de seu aplicativo (por exemplo: "Suporte técnico da Contoso reúne empresas e clientes").
    • Forneça uma descrição detalhada do seu conector (por exemplo: “O conector do Suporte técnico da Contoso notifica seu grupo do Office 365 sobre atividades de tíquetes do cliente”).
  • Ao publicar seu conector ao Store:
    • Certifique-se de preencher as instruções passo a passo e compartilhar as informações da conta de teste para que possamos testar seu conector.

Próximas etapas