Melhorar resumos do registo CRM com informações da sua aplicação (pré-visualização)

Importante

  • Esta é uma funcionalidade de pré-visualização pronta para produção.
  • As funcionalidades de pré-visualização prontas para a produção estão sujeitas aos termos de utilização suplementares.

[Este artigo é uma documentação de pré-lançamento e está sujeito a alterações.]

Para entender melhor o contexto de uma reunião para a qual se estão a preparar ou de um e-mail que estão a ler, os vendedores querem informações relevantes de CRM (gestão das relações com os clientes), como consultas, preocupações e notas de clientes. O agente de vendas utiliza IA para gerar um resumo de cada registo CRM. Este resumo destaca detalhes cruciais, como a fase de venda, o orçamento e a data de fecho projetada. Pode ampliar a capacidade de resumo de registos CRM que o agente de vendas fornece com insights da sua própria aplicação.

Descrição da API

Você deve adicionar a seguinte descrição da API à ação. Desta forma, o agente de vendas pode identificar a API correta que deve ser invocada para enriquecer a capacidade.

Esta ação obtém informações de vendas adicionais relacionadas com um registo do CRM que serão mostradas no cartão de resumo do registo C4S. A ação reforça as competências existentes do copiloto para vendas.

Operação API

Esta API usa o tipo de operação: GET

Parâmetros de entrada

O Agente de Vendas foi concebido para fornecer os seguintes parâmetros de entrada às suas APIs.

Nome Tipo/formato de dados Obrigatório Detalhes Descrição a adicionar à ação
Tipo de registo String Yes O tipo de entidade ou objeto no CRM para o qual são pedidas informações relacionadas, tais como atividades. O valor inclui o nome exclusivo independente de idioma da entidade ou do tipo de objeto, não o nome a apresentar que pode ser localizado. Os exemplos incluem conta e oportunidade. Esta entrada indica o tipo de objeto ou entidade na CRM para o qual são pedidas informações.
recordId String Yes O identificador exclusivo do registo do CRM. Esta entrada indica o identificador exclusivo do registo da CRM para o qual são pedidas as informações.
DataHoraDeInício Cadeia (de carateres) no formato "data/hora" No A data e hora de início para procurar informações. O formato segue a especificação OpenAPI. Aqui está um exemplo: 2017-07-21T17:32:28Z. Esta entrada indica a data e hora de início das informações pedidas.
endDateTime Cadeia (de carateres) no formato "data/hora" No A data e hora de fim para procurar informações. O formato segue a especificação OpenAPI. Aqui está um exemplo: 2017-07-21T17:32:28Z. Esta entrada indica a data e hora de fim das informações pedidas.
top Integer No O número de informações a obter. Esta entrada indica o número de informações a obter.
ignorar Integer No O número de insights a serem ignorados. Esta entrada indica o número de informações a ignorar.
tipo de CRM String No Os valores válidos são Dynamics 365 e Salesforce. Esta entrada indica o tipo de CRM no qual o registo da CRM existe, para o qual são pedidas as informações.
crmOrgUrl String No O nome do host da organização do CRM, como contoso.crm.dynamics.com. Esta entrada indica o URL do ambiente da CRM no qual o registo da CRM existe, para o qual são pedidas as informações.

Parâmetros de saída

O agente de vendas espera receber uma lista de insights (objetos) das suas APIs, e espera que cada insight tenha parâmetros específicos. Para garantir que o agente de vendas consegue analisar corretamente o resultado, a estrutura de resposta deve seguir as diretrizes da tabela seguinte.

Parâmetro Tipo de dados Obrigatório Detalhes
value Array Yes Uma lista de insights (objetos) que são definidos conforme descrito na seção Esquema para insights .
temMaisResultados booleano No Um valor que indica se mais resultados estão disponíveis.

Esquema para perspetivas

Nome Tipo de dados/formato Obrigatório Detalhes Descrição a ser adicionada na ação
título String Yes O título das informações no cartão de citações. É o título em linguagem natural das informações no idioma especificado através do cabeçalho do pedido Accept-Language. Segue-se um exemplo: Contrato assinado. Esta saída indica o título da atividade no cartão de citações.
description String Yes A descrição das informações. É mostrado como marcas de lista no resumo do registo e é a descrição em linguagem natural das informações no idioma especificado através do cabeçalho Accept-Language. Aqui está um exemplo: Kenny, Logan e outros dois assinaram o Contrato de Renovação Contoso 2023 em 7/9/2023. Esta saída indica a descrição das informações.
data e hora Cadeia (de carateres) no formato "data/hora" Yes A data e hora da atividade em formato UTC. Se a atividade tiver uma hora de início e uma hora de término, o aplicativo deve determinar qual hora mostrar. O formato segue a especificação OpenAPI. Aqui está um exemplo: 2017-07-21T17:32:28Z. Essa saída indica o tempo associado ao insight.
URL String No Um URL válido para abrir a atividade na aplicação de parceiro. Esta saída indica o URL para abrir informações.
additionalProperties Um objeto que tem os valores Property Name e Property Value do tipo String No

Propriedades adicionais que são mostradas na vista detalhada. Os nomes e valores de propriedade estão em linguagem natural no idioma especificado através do cabeçalho Accept-Language. Vejamos um exemplo.

{
"Razão do estado": "Assinado",
"Proprietário": "Kenny Smith"
}
Esta saída indica propriedades adicionais apresentadas na vista detalhada das informações.

Observação

Embora os requisitos da API para expandir as capacidades de resumo de e-mail e de resumo de registos possam parecer semelhantes, têm de ser adicionados como ações separadas no conector.

Example

{
    "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
}

O exemplo na imagem a seguir mostra um exemplo de como a saída da API é mapeada para o resumo de registos.

Captura de ecrã que mostra a anatomia das atividades mais recentes de uma aplicação de parceiro.

Legenda:

  1. Seção que mostra informações do aplicativo parceiro. O título da seção é derivado do nome do conector do Microsoft Power Platform.
  2. Descrições das perceções das respostas da API.
  3. Números de citação que podem ser selecionados para visualizar detalhes sobre o insight.
  4. Cartão de citações que mostra detalhes sobre as informações.
  5. Ícone e título do insight. O ícone é recuperado dos metadados do conector da Microsoft Power Platform. O texto do título é o título das informações da resposta da API.
  6. Propriedades adicionais da informação da resposta da API.
  7. Nome do aplicativo parceiro. O nome mostrado é o nome do conector da Microsoft Power Platform.
  8. Link que pode ser selecionado para visualizar detalhes de informações no aplicativo de parceiro. Baseia-se no URL do insight na resposta da API.

Ver resumo de registo
Enriqueça resumos por e-mail com informações do seu aplicativo
Enriqueça rascunhos de e-mail com links de arquivos do seu aplicativo
Enriqueça insights de oportunidades com dados de seu aplicativo
Melhorar detalhes do registo CRM com informações da sua aplicação
Expandir o representante de vendas com aplicações parceiras
Construir extensões para o agente de vendas