Compartir a través de

Registrar un conector con el panel para desarrolladores Conectores de Office

  • Artículo

Importante

Office 365 Conectores dentro de Teams se retirarán pronto. La aplicación Flujos de trabajo proporciona una funcionalidad similar con más escalabilidad y seguridad. Para obtener más información, consulte Retirada de conectores de Office 365 en Microsoft Teams. El registro de nuevos conectores en el portal para desarrolladores del conector está deshabilitado.

La creación de un conector de Office para la aplicación es fácil. Todo lo que necesita hacer es registrar el conector en nuestro portal para desarrolladores, agregar una experiencia de configuración integrada a la aplicación e implementar el conector. Los usuarios descubrirán el conector fácilmente si lo publica en nuestro catálogo.

Crear su propio conector

Registrar el conector

Visite el Portal para desarrolladores del conector e inicie sesión con sus credenciales de Microsoft 365. Si no tiene un inquilino de Microsoft 365, puede calificar para uno a través del Programa para desarrolladores de Microsoft 365; Para obtener más información, consulte las preguntas más frecuentes. Como alternativa, puede registrarse para obtener una evaluación gratuita de 1 mes o comprar un plan de Microsoft 365.

Seleccione Nuevo conector y rellene el formulario. Una vez que seleccione Guardar, aparecerán en la página nuevas opciones.

  • El botón Transferir localmente a Outlook agregará temporalmente el conector a la experiencia de Outlook del usuario que inicie sesión. El usuario podrá configurar el conector en su bandeja de entrada o en cualquier grupo del que sea miembro el usuario.
  • El botón Publicar en la Tienda iniciará el proceso de publicación, incluida la revisión de la descripción de la Tienda por parte de Microsoft.

Agregar una experiencia de configuración integrada

Una experiencia de configuración integrada permite al usuario configurar el conector sin salir de Outlook. La aplicación expone la configuración como una página web que usa la biblioteca de JavaScript de Microsoft Teams para comunicar el estado de la configuración a Outlook.

Para obtener más información, vea Integrar la experiencia de configuración.

Nota:

El documento Integrar la experiencia de configuración es específico de Microsoft Teams, pero los métodos que se documentan en él funcionan del mismo modo en Outlook.

Requisitos de configuración específicos de Outlook

Si la experiencia de configuración requiere autenticación, hay varios requisitos adicionales para habilitar el flujo de autenticación en Outlook en Windows.

Outlook en Windows pasa un parámetro de consulta adicional a la página de inicio de autenticación de los conectores.

callbackUrl=<connectors url>

La aplicación debe conservar este valor y pasarla como un parámetro adicional a los métodos microsoftTeams.authentication.notifySuccess o microsoftTeams.authentication.notifyFailure una vez que se haya completado la autenticación.

microsoftTeams.authentication.notifySuccess(result, callbackUrl);

Publicar el conector en la Tienda

Una vez que haya probado exhaustivamente el conector y esté listo para aparecer en el catálogo de conectores de Office, puede usar el botón Publicar en la tienda para enviarlo para su revisión. Cuando esté revisado y aprobado, el conector podrá agregarse al catálogo de conectores.

Lista de comprobación para el envío de conectores

  • Asegúrese de que el conector funciona completamente y de que lo ha probado exhaustivamente antes de enviarlo a la Tienda.
  • Pruebe las tarjetas de conector en los clientes donde exista la posibilidad de que los usuarios las usen: en las aplicaciones móviles de Outlook en la Web, Outlook 2016 o versiones posteriores y Outlook Groups.
  • Procure usar estrictamente Markdown para la decoración del texto y no enviar HTML en la carga de la tarjeta del conector.
  • Mantenga un equilibrio entre agregar valor al conector e incluir demasiados elementos prescindibles. Evite abrumar al usuario con demasiadas notificaciones.
  • Identifique los eventos adecuados para los que se vayan a enviar tarjetas de conector. Asegúrese de que la información que se envía al grupo es valiosa para los miembros de ese grupo.
  • Al enviar informes o resúmenes, use un formato lo más conciso posible y deje que el usuario elija el tiempo y la frecuencia con la que recibe los informes.
  • Al enviar tarjetas de conector, use Markdown de la mejor forma posible para resaltar las partes importantes de la tarjeta.
  • Haga que las tarjetas de conector sean accionables; para ello, proporcione las acciones pertinentes siempre que sea posible.
  • Las acciones que se invoquen deben tener una tasa de error realmente baja y una respuesta rápida en el punto de conexión.
  • Asegúrese de que ha aprovisionado todo lo necesario para que el usuario pueda pausar o quitar la configuración.
  • Disponga de una documentación clara orientada al usuario sobre las capacidades que el conector ofrece.
  • Al registrar el conector:
    • Asegúrese de que el nombre y el logotipo del conector no infringen una marca comercial o un copyright de ningún otro producto o servicio.
    • Proporcione un logotipo de gran calidad de tipo jpg, jpeg, png o gif y con un tamaño inferior a 60 KB.
    • Incluya una descripción breve de la aplicación (por ejemplo, "Departamento de soporte técnico de Contoso une a empresas y clientes").
    • Incluya una descripción pormenorizada del conector (por ejemplo, "El conector Departamento de soporte técnico de Contoso informa a su grupo de Office 365 de la actividad de los vales del cliente").
  • Al publicar el conector en la Tienda:
    • Procure dejarnos instrucciones detalladas y compartir información de la cuenta de prueba para que podamos probar el conector.

Siguientes pasos