Partilhar via

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

  • Artigo

Importante

[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 Copilot para Vendas usa IA para gerar um resumo de cada registo do CRM. Este resumo destaca detalhes cruciais, como a fase de venda, o orçamento e a data de fecho projetada. Pode expandir a capacidade de resumo de registos de CRM que o Copilot para Vendas oferece com informações da sua própria aplicação.

Descrição da API

Tem de adicionar a seguinte descrição da API à ação. Dessa forma, o Copilot para Vendas pode identificar a API correta que deve ser invocada para melhorar o recurso.

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 aprimora as capacidades existentes do Copilot para vendas.

Parâmetros de entrada

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

Nome Tipo de dados/formato Obrigatório Details Descrição a adicionar na ação
recordType Cadeia (de carateres) Sim 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 Cadeia (de carateres) Sim 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.
startDateTime Cadeia (de carateres) no formato "data/hora" Não A data e hora de início para procurar informações. O formato segue a especificação de OpenAPI. Segue-se 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" Não A data e hora de fim para procurar informações. O formato segue a especificação de OpenAPI. Segue-se um exemplo: 2017-07-21T17:32:28Z. Esta entrada indica a data e hora de fim das informações pedidas.
principal Número inteiro Não O número de informações a obter. Esta entrada indica o número de informações a obter.
skip Número inteiro Não O número de informações a ignorar. Esta entrada indica o número de informações a ignorar.
crmType Cadeia (de carateres) Não 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 Cadeia (de carateres) Não 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 Copilot para Vendas espera receber uma lista de informações (objetos) das suas APIs e espera que cada informação tenha parâmetros específicos. Para garantir que o Copilot para Vendas pode analisar corretamente a saída, a estrutura de resposta deve seguir as diretrizes na tabela seguinte.

Parâmetro Tipo de dados Obrigatório Details
valor Matriz Sim Uma lista de informações (objetos) que são definidas conforme descrito na secção Esquema para informações.
hasMoreResults Boolean Não Um valor que indica se estão disponíveis mais resultados.

Esquema para informações

Nome Tipo de dados/formato Obrigatório Details Descrição a ser adicionada na ação
cargo Cadeia (de carateres) Sim 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 Cadeia (de carateres) Sim 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.
dateTime Cadeia (de carateres) no formato "data/hora" Sim A data e hora da atividade no formato UTC. Se a atividade tiver uma hora de início e uma hora de fim, a aplicação deve determinar a hora a mostrar. O formato segue a especificação de OpenAPI. Segue-se um exemplo: 2017-07-21T17:32:28Z. Esta saída indica o tempo associado às informações.
url Cadeia (de carateres) Não 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 Nome da Propriedade e Valor da Propriedade do tipo Cadeia (de carateres) Não

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. Segue-se um exemplo.

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

Nota

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.

Exemplo

{
    "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. Secção que mostra informações da aplicação de parceiro. O título da secção é derivado do nome do conector do Microsoft Power Platform.
  2. Descrições das informações da resposta da API.
  3. Números de citação que podem ser selecionados para ver detalhes sobre as informações.
  4. Cartão de citações que mostra detalhes sobre as informações.
  5. Ícone e título das informações. O ícone é obtido dos metadados do conector do Microsoft Power Platform. O texto do título é o título das informações da resposta da API.
  6. Propriedades adicionais das informações da resposta da API.
  7. Nome da aplicação parceira. O nome que é mostrado é o nome do conector do Microsoft Power Platform.
  8. Ligação que pode ser selecionada para ver os detalhes das informações na aplicação do parceiro. Baseia-se no URL das informações na resposta da API.

Ver resumo de registo
Adicionar novas capacidades de pergunta e resposta (Perguntas e Respostas) ao chat de Vendas
Melhorar o resumos de e-mail com informações da sua aplicação
Melhorar informações principais de vendas com informações da sua aplicação
Melhorar detalhes do registo CRM com informações da sua aplicação
Expandir o Microsoft 365 Copilot para Vendas com aplicações de parceiros
Compilar extensões do Copilot para Vendas