Enriquecer el resumen del correo electrónico con sugerencias de contenido de la aplicación (versión preliminar)

Importante

  • Esta es una característica en vista previa lista para producción.
  • Las vistas previas listas para producción están sujetas a términos de uso complementarios.

[Este artículo es documentación preliminar y está sujeto a cambios.]

Cuando Copilot en Outlook y el agente de ventas se usan juntos, los resúmenes de correo electrónico que se muestran en Outlook incluyen información de ventas que se obtiene del sistema de administración de relaciones con clientes (CRM), como Dynamics 365 o Salesforce CRM. Puede ampliar la funcionalidad de resumen de correo electrónico que proporciona el agente de ventas con información de su propia aplicación.

Nota:

Esta API reemplaza la API de Aptitud de resumen de correo electrónico existente (ID de operación: scp-get-email-insights) con una nueva versión.

Descripción de API

Debe agregar la siguiente descripción de API a la acción. Esto ayuda al agente de ventas a identificar la API correcta que se va a invocar para enriquecer la funcionalidad.

Esta acción obtiene información adicional sobre las ventas que se mostrará en el resumen de correo electrónico de C4S dentro del resumen de Outlook. La acción mejora las habilidades existentes del copiloto de ventas.

Detalles de la API

  • Nombre de la API: Habilidad de Resumen de Correo Electrónico Versión 2
  • ID de operación Swagger: "scp-get-email-insights-v2"
  • Método de operación Swagger: post
  • Ruta: <PowerAppsConnectorHostName>/api/enhanceskills/email-insights-v2

Carga útil de entrada

Esta carga útil va como el cuerpo de la solicitud de la API.

Nombre Tipo de datos Obligatorio Detalles Descripción que debe agregarse a la acción
datosDeRecurso Objeto Sí Los datos de recursos que se usarán para obtener el contenido sugerido. Para la estructura de datos, vaya a Modelo de datos de extensibilidad de correo electrónico. Esta entrada identifica el contenido del correo electrónico, que es una colección de conversaciones de correo electrónico, asunto y otros detalles.
entidadesRelacionadas Array No Matriz de entidades relacionadas. Para la estructura de datos, vaya a Modelo de datos de entidades relacionadas. Esta entrada identifica la matriz de registros de CRM, que está relacionada con el hilo de correo electrónico.
tipo de CRM String No El tipo de sistema CRM, si está conectado. Los valores válidos son Salesforce y Dynamics 365. Esta entrada indica el tipo de CRM en el que existe el registro relacionado con el hilo de correo electrónico.
crmOrgUrl String No Dirección URL de la organización de CRM. Esta entrada indica la dirección URL del entorno de CRM en el que existe el registro relacionado con el hilo de correo electrónico.
top Integer No El número de elementos que se deben recuperar. Esta entrada indica la cantidad de vínculos de archivos que se debe recuperar.
skip Integer No Número de elementos que se deben omitir. Esta entrada indica el número de elementos que se deben omitir al obtener vínculos de archivo sugeridos.

Modelo extensible de datos de correo electrónico

Propiedad Tipo Detalles Descripción que debe agregarse a la acción
plaintextBody String El cuerpo completo del correo electrónico incluye todos los mensajes anteriores del hilo de correo electrónico. Esta entrada proporciona todo el contenido del hilo de correo electrónico en formato de texto.
fullHtmlBody String La versión HTML completa del cuerpo de correo electrónico que incluye todos los mensajes anteriores del hilo de correo electrónico. Esta entrada proporciona todo el contenido del hilo de correo electrónico en formato HTML.
Asunto String Asunto del correo electrónico. Esta entrada proporciona el asunto del correo electrónico.
desde String Dirección de correo electrónico del remitente. Esta entrada proporciona la dirección de correo electrónico del remitente.
to Cadena[] Direcciones de correo electrónico del destinatario. Esta entrada proporciona la dirección de correo electrónico del receptor.
cc Cadena[] Direcciones de correo electrónico del destinatario agregadas en el campo Cc del correo electrónico. Esta entrada proporciona todas las direcciones de correo electrónico del receptor que se incluyen en el campo Cc del correo electrónico.
bcc Cadena[] Direcciones de correo electrónico del destinatario agregadas en el campo CCO del correo electrónico. Esta entrada proporciona todas las direcciones de correo electrónico del destinatario que se agregan en el campo CCO del correo electrónico.
sentDateTime DateTimeOffset La fecha y hora del correo electrónico en formato UTC junto con la propiedad Offset. Para obtener más información, vaya a DateTimeOffset Struct (Sistema) Esta entrada proporciona la marca de tiempo del correo electrónico.
ID de mensaje String El identificador del mensaje Graph del correo electrónico. Esta entrada proporciona el identificador de mensaje del correo electrónico.
Id de conversación String Identificador de la conversación de Graph del hilo de correo electrónico. Esta entrada proporciona el identificador de conversación del hilo de correo electrónico.
Propiedad Tipo Obligatorio Detalles Descripción que debe agregarse a la acción
entityId String Sí El tipo de registro de CRM, como cuenta u oportunidad. Esta entrada proporciona el identificador único del registro de CRM relacionado con el hilo de correo electrónico.
entityType String Sí El identificador único del registro de CRM que se usará para los contenidos sugeridos. Esta entrada identifica el tipo de registro en CRM, que está relacionado con el hilo de correo electrónico.
entitySource String No Esta entrada indica el origen de la entidad, y actualmente contiene valores conectados o vacíos. Esta entrada indica el tipo de origen de la entidad.

Parámetros de salida

El agente de ventas espera recibir una lista de conclusiones (objetos) de las API y espera que cada información tenga parámetros específicos. Para asegurarse de que el agente de ventas puede analizar correctamente la salida, la estructura de respuesta debe cumplir las directrices de la tabla siguiente.

Parámetro Tipo de dato Obligatorio Detalles
value Array Sí

Una lista de información (objetos) que se define como se describe en la sección Esquema de informaciones.

Nota: aunque este parámetro incluye una lista de ideas, solo se utiliza la primera idea en el resumen de enriquecimiento de correo electrónico para la experiencia de lienzo de Outlook.
tieneMásResultados Booleano No Valor que indica si hay más resultados disponibles.

Esquema para obtener información

Nombre Tipo de datos o formato Obligatorio Detalles Descripción que debe agregarse a la acción
perspectiva String Sí La información que se entrega a los usuarios, como Sus colegas Mona Kane, Ray Tanaka y Daniela Smith han trabajado con ellos antes. Este resultado indica el texto que le gustaría que se incluyera en el resumen del correo electrónico.

Ejemplo

{
    "value": [
        {
            "insight": "Your colleagues Mona Kane, Ray Tanaka and Daniela Smith have worked with them before."
        },
        {
            "insight": "The email was opened three times in the last month."
        }
    ],
    "hasMoreResults": false
}

El ejemplo de la siguiente imagen muestra cómo se asigna la salida de la API al resumen de correo electrónico en el panel lateral.

Captura de pantalla que muestra información valiosa de aplicaciones asociadas en un resumen de correo electrónico.

Leyenda:

  1. Título de la perspectiva. Los análisis o perspectivas con el mismo título se agrupan juntos.
  2. Descripciones de la conclusión. Cada perspectiva tiene una descripción.

El ejemplo de la siguiente imagen muestra cómo se asigna la salida de la API al resumen del correo electrónico en el cuerpo del correo electrónico.

Captura de pantalla que muestra información de aplicaciones de socios en el cuerpo del correo electrónico

Leyenda:

  1. Título de la perspectiva. Los análisis o perspectivas con el mismo título se agrupan juntos.
  2. Descripción del análisis. Cada perspectiva tiene una descripción.

Resumir un hilo de correo electrónico utilizando información de ventas con Copilot en Outlook
Enriquece las perspectivas de oportunidades con datos de tu aplicación
Enriquecer los detalles de los registros de CRM con información de su aplicación
Enriquecimiento de resúmenes de registros de CRM con información de la aplicación
Extensión del agente de ventas con aplicaciones de asociados
Enriquezca los borradores de correo electrónico con vínculos de archivos de su aplicación
Crear extensiones para el agente de ventas

  • Last updated on