Compartir a través de

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

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 usa la aplicación Sales para redactar un correo electrónico, considera la intención del correo electrónico y usa información de CRM de Salesforce o Dynamics 365 para crear el borrador. Puede ampliar la funcionalidad de borrador de correo electrónico que proporciona la aplicación Sales con archivos recomendados de su propia aplicación.

Nota

Esta característica solo se admite para borradores de correo electrónico creados mediante la aplicación Sales en Outlook.

Descripción de API

Debe agregar la siguiente descripción de API a la acción. De este modo, la aplicación Sales puede identificar la API correcta que se debe invocar para enriquecer la funcionalidad.

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.

Operación API

Esta API utiliza el tipo de operación: POST

Carga útil de entrada

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

Nombre. Tipo de datos Obligatorio Detalles 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 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.
tipoDeRecurso Cuerda Sí El tipo de recurso para el que se van a obtener sugerencias de contenido. Por ejemplo, 'email-thread' o 'teams-chat'. 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'.
Tipo de registro Cuerda 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 Cuerda 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.
tipo de CRM Cuerda 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 Cuerda 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 Cuerda 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 la indicación proporcionada 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

Propiedad Tipo Detalles Descripción que debe agregarse a la acción
plaintextBody Cuerda 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 Cuerda 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 Cuerda Asunto del correo electrónico. Esta entrada proporciona el asunto del correo electrónico.
de Cuerda 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 receptores 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.
ID de mensaje Cuerda El identificador del mensaje Graph del correo electrónico. Esta entrada proporciona el identificador de mensaje del correo electrónico.
Id de conversación Cuerda 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

Propiedad Tipo de datos Obligatorio Detalles
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.
tieneMásResultados 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 Detalles Descripción que debe agregarse a la acción
tipo de contenido cuerda / cadena Sí Tipo de contenido de devolución de llamada. 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 cuerda / cadena Sí Contenido actual incluido. Puede ser una página web o una URL del archivo. Este resultado indica el contenido actual que se incluye con el borrador de correo electrónico. Puede ser una página web o una URL.
Título del contenido cuerda / cadena Sí Título del contenido sugerido que se muestra al usuario. Esta salida indica el título del contenido.
descripción del contenido cuerda / cadena 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 cuerda / cadena 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.
propiedades adicionales Objecto No Conjunto de pares nombre-valor que indican propiedades adicionales del enlace de archivo relacionado que devuelve la acción. Esta salida indica propiedades adicionales como pares nombre-valor de cada enlace relacionado devuelto por la acción.

Valores predefinidos para contentType

Valor de cadena Tipo de contenido
content-file Archivo externo (genérico)
contenido-web Página web externa
content-doc Documento Microsoft Word
Contenido-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:

  1. 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
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
Enriquecer los resúmenes del registro de CRM con información de su aplicación
Ampliar ventas en Microsoft 365 Copilot con aplicaciones asociadas
Crear extensiones para ventas en Microsoft 365 Copilot

  • Last updated on