Enriquecer borradores de correo electrónico con vínculos de archivo de la aplicación (versión preliminar)

Artículo
12/27/2024

Importante

Esta es una característica en vista previa lista para producción.
Las versiones preliminares listas para producción están sujetas a condiciones de uso complementarias.

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

Cuando utiliza Copilot para ventas para redactar un correo electrónico, tiene en cuenta la intención del correo electrónico y utiliza información de CRM de Salesforce o Dynamics 365 para crear el borrador. Puede ampliar la capacidad de redacción de correos electrónicos que Copilot para ventas proporciona con los archivos recomendados de su propia aplicación.

Nota

Esta característica solo se admite para borradores de correo electrónico creados con el panel lateral Copilot para ventas en Outlook.

Descripción de API

Debe agregar la siguiente descripción de API a la acción. De esta manera, Copilot para ventas puede identificar la API correcta que se debe invocar para enriquecer la capacidad.

Esta acción obtiene archivos relevantes para la conversación de correo electrónico, que se mostrarán en los borradores de correo electrónico de C4S en Outlook. La acción mejora las capacidades existentes de copiloto para ventas.

Carga útil de entrada

Nombre.	Tipo de datos	Obligatorio	Details	Descripción que debe agregarse a la acción
resourceData	Objecto	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 correo electrónico de extensibilidad.	Esta entrada identifica el contenido del correo electrónico, que es una colección de conversaciones de correo electrónico, asunto y otros detalles.
resourceType	String	Sí	El tipo de recurso para el que se capturan sugerencias de contenido. Por ejemplo, 'hilo de correo electrónico' o 'chat de equipos'.	Esta entrada identifica el tipo de recurso compartido para obtener vínculos de archivo sugeridos, que en este caso es 'hilo de correo electrónico'.
recordType	String	No	El tipo de registro de CRM, como cuenta u oportunidad.	Esta entrada identifica el tipo de registro en CRM, que está relacionado con el hilo de correo electrónico.
recordId	String	No	El identificador único del registro de CRM que se usará para los contenidos sugeridos.	Esta entrada proporciona el identificador único del registro de CRM relacionado con el hilo de correo electrónico.
crmType	String	No	El tipo de sistema CRM, si está conectado. Los valores válidos con 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	La URL de la organización 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.
inputPrompt	String	No	La solicitud sugerida que se usa actualmente y que da el usuario para generar un borrador de correo electrónico. Por ejemplo, "Responder a una inquietud" o "Hacer una propuesta".	Esta entrada indica el mensaje proporcionado por el usuario al redactar un correo electrónico.
top	Número entero	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	Número entero	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 de datos de correo electrónico de extensibilidad

Property	Type	Details	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.
de	String	Dirección de correo electrónico del remitente.	Esta entrada proporciona la dirección de correo electrónico del remitente.
a	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 de los destinatarios 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 de los destinatarios 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.
messageId	String	El identificador del mensaje Graph del correo electrónico.	Esta entrada proporciona el identificador de mensaje del correo electrónico.
conversationId	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.

Parámetros de salida

Property	Tipo de datos	Obligatorio	Details
Valor	Matriz	Sí	Una lista de vínculos de archivos (objetos) que se definen como se describe en el esquema de respuesta para sugerencias de contenido de archivos o enlaces.
hasMoreResults	Booleana	No	Un valor que indica si hay más resultados.

Esquema de respuesta para sugerencias de contenido de archivos o enlaces

Nombre.	Formato de tipo de datos	Obligatorio	Details	Descripción que debe agregarse a la acción
contentType	string	Sí	El tipo de contenido que se mostrará. Para obtener más información, vaya a Valores predefinidos para contentType	Este resultado indica el tipo de contenido incluido con el borrador de correo electrónico.
contenido	string	Sí	Contenido real incluido. Puede ser una página web o una URL del archivo.	Este resultado indica el contenido real que se incluye con el borrador de correo electrónico. Puede ser una página web o una URL.
contentTitle	string	Sí	Título del contenido sugerido que se muestra al usuario.	Esta salida indica el título del contenido.
contentDescription	string	Sí	Descripción del contenido sugerido que se muestra al usuario.	Este resultado indica el texto que se debe incluir al describir los archivos.
contentIconUrl	string	No	Icono del contenido sugerido que se muestra al usuario. Si no se proporciona, se utiliza un icono genérico.	Este resultado indica el icono que se incluirá para el contenido.
additionalProperties	Objecto	No	Conjunto de pares nombre-valor que indican propiedades adicionales del vínculo de archivo relacionado que devuelve la acción.	Este resultado indica propiedades adicionales como pares nombre-valor de cada vínculo relacionado devuelto por la acción.

Valores predefinidos para contentType

Valor de cadena	Tipo de contenido
content-file	Archivo externo (genérico)
content-web	Página web externa
content-doc	Documento Microsoft Word
content-pdf	Documento PDF de Microsoft
contenido-pptx	Presentación de Microsoft PowerPoint
contenido-xlsx	Hoja de cálculo de Microsoft Excel

Ejemplo

{
  "value": [
    {
      "contentType": 0,
      "content": "https://www.bing.com",
      "contentTitle": "Purchase Contract",
      "contentDescription": "Purchase Contract Description",
      "contentIconUrl": null,
      "additionalProperties": {
        "Recipients": "Logan Edwards",
        "Sender Name": "Kenny Smith"
      }
    },
    {
      "contentType": 3,
      "content": "https://www.microsoft.com",
      "contentTitle": "Strategy Planning",
      "contentDescription": "Strategy Planning Description",
      "contentIconUrl": null,
      "additionalProperties": {
        "Recipients": "Gabriela Edwards",
        "Sender Name": "Maria Smith"
      }
    },
    {
      "contentType": 1,
      "content": "https://www.bing.com",
      "contentTitle": "Contoso Website",
      "contentDescription": "Contoso Website Description",
      "contentIconUrl": null,
      "additionalProperties": {
        "Total Views": "100",
        "Domain": "Contoso.com"
      }
    }
  ],
  "hasMoreResults": false
}

El ejemplo de la siguiente imagen muestra cómo se asigna la salida de la API al borrador de correo electrónico.

Captura de pantalla que muestra los vínculos de archivos de aplicaciones de socios en el borrador de correo electrónico

Leyenda:

Vínculos de archivos de aplicaciones de socios.

Consulte también

Resumir un hilo de correo electrónico utilizando información de ventas con Copilot en Outlook
Enriquecer resúmenes del correo electrónico con información valiosa de su aplicación
Enriquezca la información clave de ventas con información de su aplicación
Enriquecer los detalles de los registros de CRM con información de su aplicación
Enriquecer los resúmenes del registro de CRM con información de su aplicación
Ampliar Microsoft 365 Copilot para ventas con aplicaciones de partners
Crear extensiones Copilot para ventas

Compartir a través de