Conectar un bot al canal de Outlook para mensajes accionables (vista previa)

SE APLICA A: SDK v4

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

Nota

El canal de Outlook mensajes accionables se encuentra en la vista previa pública. Es posible que las características incluidas en la versión preliminar no estén completas y que se realicen cambios antes de estar disponibles en la versión pública. Se proporcionan solo con fines de evaluación y exploración.

Advertencia

Es una infracción del Código de conducta de bots para crear "spambots", incluidos los bots que envían correo electrónico masivo no deseado o no solicitado.

Requisitos previos

Nota

  • No use sus propias cuentas de correo electrónico personales para bots, ya que todos los mensajes enviados a esa cuenta de correo electrónico se reenviarán al bot. Esto puede provocar que el bot envíe inapropiadamente una respuesta a un remitente. Por este motivo, los bots solo deben usar cuentas de correo electrónico dedicadas de O365.
  • Si usa Microsoft Exchange Server, habilite 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 mensajes accionables para diseñar y probar tarjetas de mensaje accionables.

Importante

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

Implementar e implementar el bot

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

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

    "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 objeto completo.

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

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

Solicitar acceso

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

Pasos siguientes