Partilhar via

Melhorar informações principais de vendas 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.]

Enquanto os vendedores leem e compõem e-mails no Outlook, podem utilizar o Copilot para Vendas para verem as principais informações de vendas sobre contactos, contas e oportunidades relacionados com o e-mail. As principais informações de vendas baseiam-se numa das seguintes fontes:

  • A oportunidade ligada ao e-mail
  • A oportunidade mais relevante, com base nos contactos e contas no e-mail

Pode expandir a capacidade de principais informações de vendas que o Copilot para Vendas fornece 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 que serão mostradas no cartão de informações de vendas chave C4S no sidecar do Outlook. 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 registo no CRM (gestão das relações com os clientes). O registo pode especificar a conta, oportunidade, oportunidade potencial ou contacto que esteja relacionado com o e-mail. Esta entrada identifica o tipo de registo na CRM para o qual são pedidas as principais informações de vendas.
recordId Cadeia (de carateres) Sim O ID do registo no CRM. Esta entrada fornece o identificador exclusivo do registo da CRM para o qual são pedidas as principais informações de vendas.
crmType Cadeia (de carateres) Não O tipo de sistema de CRM. Os valores válidos são Salesforce e Dynamics 365. Esta entrada indica o tipo de CRM no qual o registo da CRM existe, para o qual são pedidas as principais informações de vendas.
crmOrgUrl Cadeia (de carateres) Não O URL da organização de CRM. Esta entrada indica o URL do ambiente da CRM no qual o registo da CRM existe, para o qual são pedidas as principais informações de vendas.
principal Número inteiro Não O número de informações a obter. Esta entrada indica o número de realces de vendas a obter.
skip Número inteiro Não O número de informações a ignorar. Esta entrada indica o número de itens a ignorar ao obter realces de vendas.

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 adicionar na ação
cargo Cadeia (de carateres) Sim O título do cartão de citações de informações de vendas. Deve incluir apenas o nome do parceiro e pode ter até 20 caracteres. Esta saída indica o título do cartão de citações para as informações.
description Cadeia (de carateres) Sim A descrição das informações de vendas. É mostrado como uma marca de lista no painel Informações de vendas principais e pode ter até 130 caracteres. Aqui está um exemplo: Validação: Próximos passos: Alinhe com a linha cronológica e os critérios de êxito. Esta saída indica o texto das informações a incluir nas principais informações de vendas.
url Cadeia (de carateres) Não Um URL válido para abrir as informações na aplicação parceira. Esta saída indica o URL para obter mais informações sobre as informações.
dateTime DateTime Não 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.
additionalProperties Um objeto que tem os valores Nome da Propriedade e Valor da Propriedade do tipo Cadeia (de carateres) Não Um conjunto de pares nome-valor que indica as propriedades adicionais das informações relacionadas que a ação devolve. Essas informações são mostradas num cartão pop-up quando os utilizadores selecionam informações no painel Informações de vendas principais. Esta saída indica propriedades adicionais como pares nome-valor de cada informação relacionada devolvida pela ação.

Exemplo

{
    "value": [
        {
            "title": "Contract signed",
            "description": "Kenny Smith sent Renewal Contract on 04/23/2023 related to 50 Cafe A-100 Automatic",
            "dateTime": "2023-09-07T03:42:35.4662309Z",
            "url": https://contosohub.com,
            "additionalProperties": {
                "Contract name": "Renewal contract for Fourth Coffee",
                "Signed by": "Alberto Burgos, Tony Benis",
                "Signed": "9/7/23",
                 "Related Opportunity": "50 CafeA-100 Automatic"
            }
        }
    ],
    "hasMoreResults": false
}

O exemplo na imagem que se segue mostra como a saída da API é mapeada para as informações de vendas principais.

Captura de ecrã a mostrar informações de aplicações parceiras nas principais informações de vendas.

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 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 principais informações de venda no Copilot para Vendas
Melhorar o resumos de e-mail com informações da sua aplicação
Melhorar rascunhos de e-mail com ligações de ficheiro da sua aplicação
Melhorar detalhes do registo CRM com informações da sua aplicação
Melhorar os resumos 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