Conectar un bot en el canal de Outlook para mensajes accionables (versión preliminar)

  • Artículo

SE APLICA A: SDK v4

Los mensajes que requieren acción permiten a los usuarios realizar acciones rápidas desde Outlook. Al conectar un bot al canal Mensajes accionables de Outlook, el bot puede usar tarjetas adaptables para crear mensajes accionables, lo que mejora la interacción del usuario.

Nota:

El canal de Outlook para mensajes que requieren acción está en versión preliminar pública. Es posible que las características incluidas en la versión preliminar no se completen y que se sometan a cambios antes de estar disponibles en la versión pública. Solo se proporcionan con fines de evaluación y exploración.

Advertencia

Es una infracción del Código de conducta de Bot Framework crear "spambots", lo que incluye bots que envían correo masivo no deseado ni solicitado.

Requisitos previos

Nota:

  • No utilice sus propias cuentas de correo electrónico personal con bots, ya que todos los mensajes enviados a esa cuenta de correo electrónico se reenviarán al bot. Como consecuencia, el bot puede enviar una respuesta al remitente de manera inadecuada. Por este motivo, los bots solo deben usar cuentas de correo electrónico de Office 365 dedicadas.
  • Si usa Microsoft Exchange Server, habilite la Detección automática antes de configurar el canal de correo electrónico.

Diseñar los mensajes

El canal de Outlook para mensajes accionables envía y recibe tarjetas adaptables por correo electrónico.

Puede usar el Diseñador de mensaje que requiere acción para diseñar y probar tarjetas de mensajes que requieren acción.

Importante

El modelo de acción de bot universal se presenta en el esquema de Tarjetas adaptables, versión 1.4. Para usar estas nuevas funcionalidades, la propiedad de versión de la tarjeta adaptable debe establecerse en 1.4 o posterior. Vea Action.Execute en el Explorador de esquemas de tarjetas adaptables.

Implementar y desplegar el bot

El flujo general es para que el bot envíe un mensaje accionable a un usuario y, a continuación, controle la acción del usuario.

  1. Cuando el usuario responde a la tarjeta en el correo electrónico, Outlook envía una actividad de invocación al bot. La propiedad de value de la actividad contiene un objeto de acción con las propiedades type, verb y data. Por ejemplo, la actividad incluiría la siguiente información, donde el verbo y los datos corresponden a información sobre la tarjeta que el bot envió inicialmente.

    "type": "invoke",
"name": "adaptiveCard/action",
"value": {
  "action": {
    "type": "Action.Execute",
    "verb": "<DEVELOPER_DEFINED_VERB>",
    "data": {
      // DEVELOPER_DEFINED_PROPERTIES
    }
  },
}

    Vea Action.Execute en el Explorador de esquemas de tarjetas adaptables para obtener el esquema de objetos completo.

  2. El bot controla la actividad de invocación entrante y devuelve un resultado que incluye una nueva tarjeta adaptable que tendrá lugar de la tarjeta adaptable original. La respuesta de invocación podría ser similar a la siguiente:

    {
  "statusCode": 200,
  "type": "application/vnd.microsoft.card.adaptive",
  "value": <UPDATED_ADAPTIVE_CARD>
}

Solicitar acceso

  1. Abra el recurso del bot en Azure Portal.
  2. Abra el panel Canales.
  3. Seleccione el canal de Outlook.
  4. En la página Configurar Outlook, seleccione regístrese aquí.
  5. Rellene el formulario de registro para solicitar acceso. Consulte Registrar el servicio con el panel para desarrolladores de correo electrónico que requiere acción para obtener más información.

Pasos siguientes