Enriquecer el resumen del correo electrónico con información valiosa de su 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. Más información: Condiciones de uso complementarias para Dynamics 365

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

Con Copilot en Outlook y Copilot para ventas juntos, se muestran resúmenes de correo electrónico en Outlook con información de ventas procedente de su sistema CRM, como Dynamics 365 o Salesforce CRM. Puede ampliar la capacidad de resumen de correo electrónico proporcionada por Copilot para ventas con información de su propia aplicación.

Descripción de API

Debe agregar la descripción de la API a la acción para permitir que Copilot para ventas identifique la API correcta que se debe invocar para enriquecer esta capacidad. La descripción debe ser la siguiente:

This action gets additional sales insights that will be shown in C4S email summary experience inside outlook summary. The action enhances the existing skills of copilot for sales.

Parámetros de entrada

Copilot para ventas está diseñado para proporcionar los siguientes parámetros de entrada a sus API.

Name	Tipo de datos / Formato	Obligatorio	Details	Descripción que debe agregarse a la acción
recordType	String	No	Tipo de registro en CRM. El valor puede ser cuenta, oportunidad, cliente potencial o contacto relacionado con el correo electrónico.	Esta entrada identifica el tipo de registro en CRM, que está relacionado con el correo electrónico resumido.
recordId	String	No	ID de registro en CRM para el cual se solicitan registros relacionados.	Esta entrada proporciona el identificador único del registro CRM que está relacionado con el correo electrónico resumido.
crmType	String	No	Tipo del trabajo del sistema CRM. 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 correo electrónico resumido.
crmOrgUrl	String	No	URL de organización de CRM	Esta entrada indica el tipo de URL del entorno de CRM en el que existe el registro relacionado con el correo electrónico resumido.
emailContacts	String	Sí	Direcciones de correo electrónico separadas por comas. Por ejemplo: kenny@contoso.com,logan@contoso.com	Esta entrada indica una lista de todos los correos electrónicos de participantes relevantes en el hilo de correo electrónico actual.
Arriba	Número entero	No	Número de informaciones para capturar	Esta entrada indica la cantidad de información que se debe recuperar.
Omitir	Número entero	No	Número de informaciones que se omitirán	Esta entrada indica el número de elementos que hay que omitir cuando se obtienen informaciones.

Parámetros de salida

Copilot para ventas prevé recibir de sus API una lista de informaciones (objetos), cada uno con parámetros específicos. Para garantizar que Copilot para ventas pueda analizar el resultado correctamente, es fundamental seguir la estructura de respuesta que se describe a continuación.

Parámetro	Tipo de datos	Obligatorio	Details
Valor	Matriz	Sí	Lista de informaciones (objetos) definidos como se menciona en Esquema de informaciones Nota: aunque el parámetro de valor incluye una lista de informaciones, solo se utiliza la primera información en el resumen de enriquecimiento del correo electrónico.
hasMoreResults	Booleana	No	Indica si hay más resultados disponibles.

Esquema para obtener información

Name	Tipo de datos / Formato	Obligatorio	Details	Descripción que debe agregarse a la acción
Nombre	Cadena, hasta 20 caracteres	Sí	Título de la información de ventas	Esta salida indica el título de la sección del partner y debe incluir solo el nombre del partner.
Description	String	Sí	Información entregada a los usuarios. Por ejemplo: 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.

Nota

Si bien los requisitos de API para ampliar las capacidades de resumen de correo electrónico y resumen de registros pueden parecer similares, deben agregarse como acciones independientes en el conector.

Ejemplo

{
  "value": [
    {
      "title": "From Contoso Customer Insights",
      "description": "Your colleagues Mona Kane, Ray Tanaka and Daniela Smith have worked with them before."
    }
  ],
  "hasMoreResults": false
}

La siguiente imagen muestra un ejemplo de cómo se asigna la salida de la API al resumen de correo electrónico.

Leyenda:

1. Título de la información. Las informaciones con el mismo título se agrupan.
2. Descripción de la información. Una descripción por información.

Consulte también

Obtenga más información sobre los resúmenes por correo electrónico en Copilot para ventas
Agregar una nueva capacidad de preguntas y respuestas al chat de Sales
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 detalles del resumen de CRM con información de su aplicación
Ampliar Microsoft Copilot para ventas con aplicaciones de partners
Crear API de aplicaciones para ampliar Copilot para ventas