Enriquecer resumos de registro de CRM com insights do aplicativo (versão preliminar)

Importante

  • Esta é uma versão prévia do recurso pronta para produção.
  • As versões prévias do recurso prontas para produção estão sujeitas aos termos de uso complementares.

[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 estão se preparando ou de um email que estão lendo, os vendedores querem informações relevantes de CRM (gerenciamento de relacionamento com o cliente), como dúvidas, preocupações e anotações do cliente. O agente de vendas usa IA para gerar um resumo de cada registro crm. Este resumo destaca detalhes cruciais, como o estágio da venda, o orçamento e a data de fechamento projetada. Você pode estender a capacidade de resumo de registros do CRM que o agente de vendas fornece, integrando insights do seu próprio aplicativo.

Descrição da API

Você deve adicionar a descrição da API a seguir à ação. Dessa forma, o agente de Vendas pode identificar a API correta que deve ser invocada para enriquecer a funcionalidade.

Essa ação obtém insights de vendas adicionais relacionados a um registro de CRM que serão mostrados no cartão de resumo do registro C4S. A ação aprimora as habilidades existentes do copilot para vendas.

Operação da API

Essa API usa o Tipo de Operação: GET

Parâmetros de entrada

O agente de Vendas foi projetado para fornecer os seguintes parâmetros de entrada para suas APIs.

Nome Tipo/formato de dados Obrigatório Detalhes Descrição a ser adicionada na ação
recordType String Yes O tipo de entidade ou objeto no CRM para o qual insights relacionados, como atividades, são solicitados. O valor inclui o nome exclusivo independente do idioma da entidade ou do tipo de objeto, não o nome para exibição que pode ser localizado. Exemplos incluem conta e oportunidade. Esta entrada indica o tipo de entidade ou objeto no CRM para o qual insights relacionados são solicitados.
recordId String Yes O identificador exclusivo do registro de CRM. Esta entrada indica o identificador exclusivo do registro de CRM para o qual insights relacionados são solicitados.
startDateTime Cadeia de caracteres no formato "data e hora" No A data de início e hora para pesquisar insights. O formato segue a especificação OpenAPI. Veja um exemplo: 2017-07-21T17:32:28Z. Esta entrada indica a data de início e a hora de insights solicitados.
endDateTime Cadeia de caracteres no formato "data e hora" No A data de término e hora para pesquisar insights. O formato segue a especificação OpenAPI. Veja um exemplo: 2017-07-21T17:32:28Z. Esta entrada indica a data de término e a hora de insights solicitados.
top Integer No O número de insights a serem buscados. Esta entrada indica o número de insights a serem buscados.
ignorar Integer No O número de insights a serem ignorados. Esta entrada indica o número de insights a serem ignorados.
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 registro de CRM existe, para o qual os insights são solicitados.
crmOrgUrl String No O nome do host da organização do CRM, como contoso.crm.dynamics.com. Esta entrada indica a URL do ambiente de CRM no qual o registro de CRM existe, para o qual os insights são solicitados.

Parâmetros de saída

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

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

Esquema para insights

Nome Tipo de dados/Formato Obrigatório Detalhes Descrição a ser adicionada na ação
title String Yes O título do insight no cartão de citação. Trata-se do título em linguagem natural do insight no idioma especificado no cabeçalho de solicitação Accept-Language. Aqui está um exemplo: Contrato assinado. Esta saída indica o título da atividade no cartão de citação.
descrição String Yes A descrição do insight. Ele é mostrado como marcadores no resumo do registro e é a descrição em linguagem natural do insight no idioma especificado por meio do cabeçalho Accept-Language. Veja 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 do insight.
dateTime Cadeia de caracteres no formato "data e hora" Yes A data e a hora da atividade no formato UTC. Se a atividade tiver uma hora de início e uma hora de término, o aplicativo deverá determinar qual hora mostrar. O formato segue a especificação OpenAPI. Veja um exemplo: 2017-07-21T17:32:28Z. Esta saída indica o tempo associado ao insight.
url String No Uma URL válida para abrir a atividade no aplicativo do parceiro. Esta saída indica a URL para abrir o insight.
additionalProperties Um objeto que tem valores de nome de propriedade e valor de propriedade do tipo String No

Propriedades adicionais que são mostradas na exibição detalhada. Os nomes e valores de propriedade estão em linguagem natural no idioma especificado por meio do cabeçalho Accept-Language. Veja aqui um exemplo.

{
"Razão do status": "Assinado",
"Proprietário": "Kenny Smith"
}
Esta saída indica propriedades adicionais mostradas na exibição detalhada do insight.

Note

Embora os requisitos da API para estender as capacidades de resumo de email e resumo de registro possam parecer semelhantes, eles devem ser adicionados como ações à parte 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 como a saída da API está mapeada para o resumo de registro.

Captura de tela mostrando a anatomia das atividades mais recentes de um aplicativo parceiro.

Legenda:

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

Exibir resumo do registro
Enriqueça resumos de e-mail com percepções do seu aplicativo
Enriquecer rascunhos de email com links de arquivo de seu aplicativo
Enriqueça insights de oportunidade com dados do seu aplicativo
** Enriquecer os detalhes do registro de CRM com insights da sua aplicação
Estender o agente de vendas com aplicativos parceiros
Criar extensões para o agente de Vendas