Compartilhar via


Enriquecer detalhes 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 prontas para produção estão sujeitas a termos de uso complementares.

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

Os vendedores podem exibir detalhes sobre um contato salvo com os registros associados, como contas e oportunidades. Você pode estender a capacidade dos detalhes de registro de CRM (gerenciamento de relacionamento com o cliente) que o Copilot para vendas fornece insights do próprio aplicativo.

Descrição da API

Você deve 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 enriquecer a capacidade.

Essa ação obtém registros relacionados a um registro do CRM. A ação aprimora as habilidades existentes do Copilot para Vendas.

Parâmetros de entrada

O Copilot para vendas foi projetado para oferecer os seguintes parâmetros de entrada para as APIs.

Name Tipo de dados/formato Obrigatória Details Descrição a ser adicionada na ação
recordType String Sim O tipo de entidade ou objeto no CRM para o qual registos relacionados 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 identifica o tipo de registro no CRM para o qual os registros relacionados são solicitados.
recordId String Sim O identificador exclusivo do registro de CRM. Esta entrada fornece o identificador exclusivo do registro de CRM para o qual os registros relacionados são solicitados.
principais Integer No O número de atividades a serem buscadas. Esta entrada indica o número de registros relacionados a serem buscados.
skip Integer No O número de atividades a serem ignoradas. Esta entrada indica o número de registros a serem ignorados durante a busca de registros relacionados.
crmType String No O tipo do sistema de CRM. Os valores válidos são Dynamics 365 e Salesforce. Esta entrada indica o tipo de CRM do qual os registros relacionados são buscados.
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 do qual os registros relacionados são buscados.

Observação

Este ponto de extensão dá suporte à renderização de insights com até cinco extensões de conector no sidecar do Outlook.

Parâmetros de saída

O Copilot para 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 Copilot para Vendas possa analisar corretamente o resultado, a estrutura da resposta deve seguir as diretrizes na tabela a seguir.

Parâmetro Tipo de dados Obrigatória Details
value Matriz Sim Uma lista de insights (objetos) definidos conforme descrito na seção Esquema para insights.
hasMoreResults Boolean No Um valor que indica se mais resultados estão disponíveis.

Esquema de insights

Name Tipo de dados/formato Obrigatória Details Descrição a ser adicionada na ação
recordId String Sim O identificador exclusivo do registro. Esta saída identifica com exclusividade cada registro relacionado retornado pela ação.
recordTypeDisplayName String Sim O nome de exibição do tipo de registro, como Contrato. Ele deve ser localizado no idioma especificado por meio do cabeçalho Accept-Language. Esta saída indica o nome de exibição do tipo de registro de cada registro relacionado retornado pela ação.
recordTypePluralDisplayName String Sim O nome de exibição plural do tipo de registro, como Contratos. Ele deve ser localizado no idioma especificado por meio do cabeçalho Accept-Language. Esta saída indica o nome de exibição plural do tipo de registro de cada registro relacionado retornado pela ação.
recordType String Sim O nome de sistema do tipo de registro, como contrato. Esta saída indica o tipo de cada registro relacionado retornado pela ação.
recordTitle String Sim O nome do tipo de registro, como Contrato de renovação da Contoso 2023. Esta saída indica o tipo de cada título relacionado retornado pela ação.
url String No Uma URL válida para abrir o registro no aplicativo do parceiro. Esta saída indica a URL de cada registro relacionado retornado pela ação.
additionalProperties Um objeto que tem valores Nome de Propriedade e Valor de Propriedade do tipo Cadeia de caracteres 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 a seguir um exemplo.

{
"Razão do status": "Assinado",
"Proprietário": "Kenny Smith"
}
Esta saída indica propriedades adicionais como pares nome-valor de cada registro relacionado retornado pela ação.

Exemplo

{
    "value": [
        {
            "recordId": "ID1",
            "recordTypeDisplayName": "Contract",
            "recordTitle": "50 Cafe A-100 Automatic Renewal Contract",
            "recordTypePluralDisplayName": "Documents",
            "recordType": "contract",
            "url": "https://contosohub.com/contract/id1",
            "additionalProperties": {
                "Status": "Signed",
                "Date": "9/7/23",
                "Signed by": "Alberto Burgos, Tony [last name]"
            }
        },
        {
            "recordId": "ID2",
            "recordTypeDisplayName": "Contract",
            "recordTitle": "ABC Company 2023 Renewal Contract",
            "recordTypePluralDisplayName": "Documents",
            "recordType": "contract",
            "url": "https://contosohub.com/contract/id2",
            "additionalProperties": {
                "Status": "Delivered",
                "Date": "9/3/23",
                 "Signed by": "Alberto Burgos"
            }
        }
    ],
    "hasMoreResults": false
}

O exemplo na imagem a seguir mostra como a saída da API é mapeada para os registros relacionados.

Captura de tela mostrando a anatomia de registros relacionados de um aplicativo parceiro.

Legenda:

  1. Cartão que mostra registros relacionados do aplicativo parceiro.
  2. Ícone e título do cartão. O ícone é recuperado dos metadados do conector do Microsoft Power Platform. O título é o nome do conector da Microsoft Power Platform.
  3. Títulos de registros relacionados da resposta da API. Duas propriedades adicionais da resposta da API são renderizadas como campos-chave de cada registro relacionado.
  4. Botão "Mais ações" que pode ser usado para copiar um link para o registro ou para exibir detalhes do registro no aplicativo parceiro. O link se baseia na URL do registro relacionado na resposta da API.
  5. Propriedades adicionais do registro relacionado da resposta da API.

Visualizar detalhes do registro
Adicionar novas capacidades de perguntas e respostas (Q&A) ao chat do Sales
Enriquecer os resumos do email com insights do aplicativo
Enriquecer informações-chave de vendas com insights do aplicativo
Enriquecer resumos de registro de CRM com insights do aplicativo
Estender Copilot para Vendas do Microsoft 365 com aplicativos de parceiros
Compilar extensões do Copilot para vendas