Enriquezca los resúmenes de registros de CRM con información de su 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 modificaciones].
Para comprender mejor el contexto de una reunión que están preparando o un correo electrónico que están leyendo, los vendedores quieren información relevante sobre la gestión de relaciones con el cliente (CRM), como consultas, inquietudes y notas de los clientes. Copilot para ventas utiliza IA para generar un resumen de cada registro de CRM. Este resumen destaca detalles cruciales, como la etapa de ventas, el presupuesto y la fecha de cierre proyectada. Puede ampliar la capacidad de resumen de registros de CRM que proporciona Copilot para ventas con información de su propia aplicación.
Descripción de API
Debes 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 información de ventas adicional relacionada con un registro de CRM que se mostrará en el resumen del registro de C4S tarjeta. La acción mejora el capacidades existente de copiloto para ventas.
Parámetros de entrada
Copilot para ventas está diseñado para proporcionar los siguientes parámetros de entrada a sus API.
| Name | Tipo/formato de datos | Obligatorio | Details | Descripción para agregar en la acción |
|---|---|---|---|---|
| recordType | String | Sí | El tipo de entidad u objeto en CRM para el que se solicita información relacionada, como actividades. El valor incluye el nombre único, independiente del idioma, de la entidad o del tipo de objeto, no el nombre que se puede localizar. Los ejemplos incluyen cuenta y oportunidad. | Esta entrada indica la entidad o el tipo de objeto en CRM para el cual se solicita información. |
| recordId | String | Sí | El identificador único del registro de CRM. | Esta entrada indica el identificador único del registro CRM para el que se solicita información. |
| startDateTime | Cadena en formato 'fecha-hora' | No | La fecha y hora de inicio para buscar información. El formato sigue la especificación OpenAPI . He aquí un ejemplo: 2017-07-21T17:32:28Z. | Esta entrada indica la fecha y hora de inicio de la información solicitada. |
| endDateTime | Cadena en formato 'fecha-hora' | No | La fecha y hora final para buscar información. El formato sigue la especificación OpenAPI . He aquí un ejemplo: 2017-07-21T17:32:28Z. | Esta entrada indica la fecha y hora de finalización de la información solicitada. |
| top | Número entero | No | La cantidad de información a obtener. | Esta entrada indica la cantidad de información que se debe recuperar. |
| skip | Número entero | No | La cantidad de información que se debe omitir. | Esta entrada indica la cantidad de información que se debe omitir. |
| crmType | String | No | Los valores válidos son Dynamics 365 y Salesforce. | Esta entrada indica el tipo de CRM en el que existe el registro de CRM, para el cual se solicita información. |
| crmOrgUrl | String | No | El nombre de host de la organización CRM, como contoso.crm.dynamics.com. | Esta entrada indica la URL del entorno CRM en el que existe el registro CRM para el que se solicita información. |
Parámetros de salida
Copilot para ventas espera recibir una lista de información (objetos) de sus API y espera que cada información tenga parámetros específicos. Para garantizar que Copilot para ventas pueda analizar correctamente la salida, la estructura respuesta debe cumplir con las pautas de la siguiente tabla.
| Parámetro | Tipo de datos | Obligatorio | Details |
|---|---|---|---|
| Valor | Matriz | Sí | Una lista de información (objetos) que se definen como se describe en la sección Esquema para información . |
| hasMoreResults | Booleana | No | Un valor que indica si hay más resultados disponibles. |
Esquema para insights
| Name | Tipo de datos/formato | Obligatorio | Details | Descripción que debe agregarse a la acción |
|---|---|---|---|---|
| nombre | String | Sí | El título de la información sobre la cita tarjeta. Es el título en lenguaje natural de la información en el idioma que se especifica a través del encabezado de solicitud. Accept-Language He aquí un ejemplo: Contrato firmado. |
Esta salida indica el título de la actividad en la tarjeta de citas. |
| Descripción | String | Sí | La descripción de la visión. Se muestra como viñetas en el resumen del registro y es la descripción en lenguaje natural de la información en el idioma que se especifica a través del encabezado Accept-Language . A continuación se muestra un ejemplo: Kenny, Logan y otras dos personas firmaron el contrato de renovación de Contoso 2023 el 7 de septiembre de 2023. |
Esta salida indica la descripción de la información. |
| dateTime | Cadena en formato 'fecha-hora' | Sí | La fecha y hora de la actividad en formato UTC. Si la actividad tiene una hora de inicio y una hora de finalización, la aplicación debe determinar qué hora mostrar. El formato sigue la especificación OpenAPI . He aquí un ejemplo: 2017-07-21T17:32:28Z. | Esta salida indica el tiempo asociado con la información. |
| Dirección URL | String | No | Una URL válida para abrir la actividad en la aplicación asociada. | Este resultado indica la URL para abrir la información. |
| additionalProperties | Un objeto que tiene valores de Nombre de propiedad y Valor de propiedad del tipo Cadena | No | Propiedades adicionales que se muestran en la vista detallada. Los nombres y valores de las propiedades están en lenguaje natural en el idioma que se especifica a través del encabezado {
|
Este resultado indica propiedades adicionales que se muestran en la vista detallada de la información. |
Nota
Si bien los requisitos de API para ampliar las capacidades de resumen de correo electrónico y de resumen de registros pueden parecer similares, deben agregarse como acciones separadas en el conector.
Ejemplo
{
"value": [
{
"title": "Contract signed",
"description": "You have 5 connections in Fourth Coffee Inc",
"dateTime": "2024-05-07T03:28:38.0667701Z",
"url": null,
"additionalProperties": {
"Contract name": "50 Cafe-A-100 Automatic Renewal Contract",
"Signed by": "Alberto Burgos, Tony",
"Signed": "9/7/23"
}
},
{
"title": "Contract signed",
"description": "Multiple stakeholders from Fourth Coffee have visited the Contoso website four times in the last four months",
"dateTime": "2024-05-07T03:28:38.0669445Z",
"url": null,
"additionalProperties": {
"Contract name": "50 Cafe-A-100 Automatic Renewal Contract",
"Signed by": "Alberto Burgos, Tony",
"Signed": "9/7/23"
}
}
],
"hasMoreResults": false
}
El ejemplo en la siguiente imagen muestra cómo se asigna la salida de la API al resumen del registro.
Leyenda:
- Sección que muestra información de la aplicación del socio. El título de la sección se deriva del nombre del conector Microsoft Power Platform .
- Descripciones de la información de la API respuesta.
- Números de citas que se pueden seleccionar para ver detalles sobre la información.
- Cita tarjeta que muestra detalles sobre el insight.
- Icono y título de la información. El icono se recupera de los metadatos del conector. Microsoft Power Platform El texto del título es el título de la información de la API respuesta.
- Propiedades adicionales del insight de la API respuesta.
- Nombre de la aplicación de asociado. El nombre que se muestra es el nombre del conector Microsoft Power Platform .
- Vincular que se puede seleccionar para ver detalles de información en la aplicación del socio. Se basa en la URL de la información en la API respuesta.
Consulte también
Ver resumen del registro
Agregue nuevas capacidades de preguntas y respuestas (Q&A) al chat de ventas
Enriquezca los resúmenes de correo electrónico con información de su aplicación
Enriquezca la información de ventas clave con información de su aplicación
Enriquecer los detalles de los registros de CRM con información de su aplicación
Extender para ventas con aplicaciones de socios Microsoft 365 Copilot
Construir extensiones Copilot para ventas