Enriquecer 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 cambios.]

Para comprender mejor el contexto de una reunión para la que se están preparando o un correo electrónico que están leyendo, los vendedores quieren información relevante sobre la gestión de las relaciones con los clientes (CRM), como consultas, inquietudes y notas de los clientes. El agente de ventas usa 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 el agente de ventas proporciona, integrando perspectivas de su propia aplicación.

Descripción de API

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

Esta acción obtiene información de ventas adicional relacionada con un registro de CRM que se mostrará en la tarjeta de resumen de registros de C4S. La acción mejora las habilidades existentes del copiloto de ventas.

Operación API

Esta API usa el tipo de operación: GET

Parámetros de entrada

El agente de ventas está diseñado para proporcionar los siguientes parámetros de entrada a las API.

Nombre Tipo de datos o formato Obligatorio Detalles Descripción que debe agregarse a la acción
Tipo de registro String Sí Tipo de entidad u objeto en CRM para el cual se solicita información relacionada, como actividades. El valor incluye el nombre único independiente del lenguaje de la entidad o el tipo de objeto, no el nombre para mostrar que se puede localizar. Algunos ejemplos son la cuenta y la 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 CRM. Esta entrada indica el identificador único del registro CRM para el que se solicita información.
startDateTime Cadena con formato de fecha y hora No Fecha y hora de inicio para buscar información. El formato sigue la especificación openAPI. Este es un ejemplo: 2017-07-21T17:32:28Z. Esta entrada indica la fecha y hora de inicio de la información solicitada.
endDateTime Cadena con formato de fecha y hora No Fecha y hora de finalización para buscar información. El formato sigue la especificación openAPI. Este es un ejemplo: 2017-07-21T17:32:28Z. Esta entrada indica la fecha y hora de finalización de la información solicitada.
top Integer No Número de datos que se van a obtener. Esta entrada indica la cantidad de información que se debe recuperar.
skip Integer No Número de conclusiones que se van a omitir. Esta entrada indica la cantidad de información que se debe omitir.
tipo de CRM String No Los valores válidos con Salesforce y Dynamics 365. 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 de 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

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.
tieneMásResultados Booleano No Valor que indica si hay más resultados disponibles.

Esquema para obtener información

Nombre Tipo de datos/formato Obligatorio Detalles Descripción que debe agregarse a la acción
título String Sí Título de la información en la tarjeta de cita. Es el título en lenguaje natural de la idea en el lenguaje especificado en el encabezado de solicitud de Accept-Language. A continuación se muestra un ejemplo de 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 conclusió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 de Accept-Language. Ejemplo: Kenny, Logan y otros dos firmaron el contrato de renovación Contoso 2023 el 9/7/2023. Esta salida indica la descripción de la información.
fecha y hora Cadena con formato de fecha y hora Sí 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 se va a mostrar. El formato sigue la especificación openAPI. Este es un ejemplo: 2017-07-21T17:32:28Z. Este resultado indica el tiempo asociado al análisis.
URL String No Una URL válida para abrir la actividad en la aplicación del partner. Este resultado indica la URL para abrir la información.
additionalProperties Objeto que tiene valores Nombre de propiedad y Valor de propiedad del tipo String No

Propiedades adicionales que se muestran en la vista detallada. Los nombres y valores de propiedad están en lenguaje natural en el idioma que se especifica a través del encabezado Accept-Language. He aquí un ejemplo.

{
 "Razón del estado": "Desconectado",
 "Propietario": "Kenny Smith"
}
 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 resumen de registros pueden parecer similares, deben agregarse como acciones independientes 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 de la imagen siguiente muestra cómo se asigna la salida de la API al resumen del registro.

Captura de pantalla que muestra la anatomía de las actividades más recientes de una aplicación asociada.

Leyenda:

  1. Sección que muestra información de la aplicación de asociado. El título de la sección se deriva del nombre del conector de Microsoft Power Platform.
  2. Descripciones de información de la respuesta de la API.
  3. Números de cita que se pueden seleccionar para ver detalles sobre la información.
  4. Tarjeta de referencia que muestra detalles sobre el análisis.
  5. Icono y título del análisis. El icono se extrae de los metadatos del conector de Microsoft Power Platform. El texto del título es el título de la información de la respuesta de la API.
  6. Propiedades adicionales del análisis de la respuesta de la API.
  7. Nombre de la aplicación asociada. El nombre que se muestra es el nombre del conector de Microsoft Power Platform.
  8. Enlace que se puede seleccionar para ver los detalles del análisis en la aplicación del socio. Se basa en la dirección URL de la información en la respuesta de la API.

Ver el resumen del registro
Enriquecer resúmenes de correo electrónico con información de la aplicación
Enriquezca los borradores de correo electrónico con vínculos de archivos 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
Extensión del agente de ventas con aplicaciones de asociados
Crear extensiones para el agente de ventas

  • Last updated on