Enriquecer resumo de e-mails com sugestões de conteúdo 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.]

Quando o Copilot no Outlook e o agente de vendas são usados em conjunto, os resumos de email mostrados no Outlook incluem informações de vendas provenientes do seu sistema de gestão de relacionamento com o cliente (CRM), como o Dynamics 365 ou o Salesforce CRM. Pode ampliar a capacidade de resumo por email que o agente de vendas fornece com insights da sua própria aplicação.

Observação

Esta API substitui a API de Competência de Resumo de E-mail (ID da operação: scp-get-email-insights) existente por uma nova versão.

Descrição da API

Você deve adicionar a seguinte descrição da API à ação. Isto ajuda o agente de vendas a identificar a API correta a invocar para enriquecer a capacidade.

Esta ação obtém informações de vendas adicionais que serão mostradas na experiência de resumo de e-mails do C4S dentro do resumo do Outlook. A ação reforça as competências existentes do copiloto para vendas.

Detalhes da API

  • Nome da API: Competência de Resumo de E-mail Versão 2
  • ID da operação Swagger: scp-get-email-insights-v2
  • Método de operação Swagger: publicação
  • Caminho: <PowerAppsConnectorHostName>/api/enhanceskills/email-insights-v2

Payload de entrada

Este payload vai como o corpo do pedido da API.

Nome Tipo de Dados Obrigatório Detalhes Descrição a adicionar à ação
resourceData Objeto Yes Os dados do recurso a usar para obter o conteúdo sugerido. Para a estrutura de dados, aceda ao Modelo de dados de e-mail de extensibilidade. Esta entrada identifica o conteúdo do e-mail, que é uma coleção de tópico de e-mail, assunto e outros detalhes.
Entidades Relacionadas Array No A matriz de entidades relacionadas. Para a estrutura de dados, vá para Modelo de dados de entidade relacionado. Essa entrada identifica a matriz de registos do CRM, que está relacionada com o tópico de email.
tipo de CRM String No O tipo de sistema de CRM, se ligado. Os valores válidos são Salesforce e Dynamics 365. Esta entrada indica o tipo de CRM em que existe o registo relacionado com o tópico de e-mail.
crmOrgUrl String No A URL da organização do CRM. Esta entrada indica o URL do ambiente de CRM em que existe o registo relacionado com o tópico de e-mail.
top Integer No O número de itens a obter. Esta entrada indica o número de ligações de ficheiro a obter.
ignorar Integer No O número de itens a ignorar. Esta entrada indica o número de itens a ignorar ao obter ligações de ficheiros sugeridos.

Modelo de dados de e-mail de extensibilidade

Propriedade Tipo Detalhes Descrição a adicionar à ação
plaintextBody String O corpo completo do e-mail inclui todas as mensagens anteriores do tópico de e-mail nele contido. Esta entrada fornece todo o conteúdo do tópico de e-mail em formato de texto.
fullHtmlBody String A versão HTML completa do corpo do e-mail que inclui todas as mensagens anteriores do tópico de e-mail nele contido. Esta entrada fornece todo o conteúdo do tópico de e-mail em formato HTML.
Assunto String Assunto do e-mail. Esta entrada fornece o assunto do e-mail.
de String Endereço de e-mail do remetente. Esta entrada fornece o endereço de e-mail do remetente.
a Cadeia[] Endereços de e-mail do destinatário. Esta entrada fornece o endereço de e-mail do destinatário.
cc Cadeia[] Endereços de e-mail do destinatário adicionados no campo Cc do e-mail. Esta entrada fornece todos os endereços de e-mail do destinatário que estão incluídos no campo Cc do e-mail.
bcc Cadeia[] Endereços de e-mail do destinatário adicionados no campo Bcc do e-mail. Esta entrada fornece todos os endereços de e-mail do destinatário que são adicionado ao campo Bcc do e-mail.
sentDateTime DateTimeOffset A data e a hora do e-mail no formato UTC, juntamente com a propriedade Offset. Para obter mais informações, aceda a Estrutura de DateTimeOffset (Sistema) Esta entrada fornece o carimbo de data/hora do e-mail.
ID da mensagem String O ID de mensagem do Graph do e-mail. Esta entrada fornece o ID da mensagem do e-mail.
conversationId String O ID de conversação do Graph do tópico do e-mail. Esta entrada fornece o ID da conversação do tópico do e-mail.
Propriedade Tipo Obrigatório Detalhes Descrição a adicionar à ação
identificadorDaEntidade String Yes O tipo de registo do CRM, como conta ou oportunidade. Esta entrada fornece o identificador exclusivo do registo de CRM que está relacionado com o tópico de e-mail.
entityType String Yes O identificador exclusivo do registo de CRM a usar para conteúdos sugeridos. Esta entrada identifica o tipo de registo no CRM, que está relacionada com o tópico de e-mail.
entitySource String No Esta entrada indica a origem da entidade, atualmente contém valores "conectados" ou vazios. Esta entrada indica o tipo de origem da entidade.

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 .

Nota: Embora este parâmetro inclua uma lista de informações, apenas a primeira informação é utilizada no resumo do melhoramento de e-mail para a experiência de tela do Outlook.
temMaisResultados booleano No Um valor que indica se mais resultados estão disponíveis.

Esquema para perspetivas

Nome Tipo/formato de dados Obrigatório Detalhes Descrição a adicionar à ação
informações String Yes As informações que são entregues aos utilizadores, como Os seus colegas Mona Kane, Ray Tanaka e Daniela Smith, já trabalharam com eles anteriormente. Esta saída indica o texto que pretende incluir no resumo do e-mail.

Example

{
    "value": [
        {
            "insight": "Your colleagues Mona Kane, Ray Tanaka and Daniela Smith have worked with them before."
        },
        {
            "insight": "The email was opened three times in the last month."
        }
    ],
    "hasMoreResults": false
}

O exemplo na imagem a seguir mostra como a saída da API é mapeada para o resumo de e-mail no painel lateral.

Captura de ecrã a mostrar informações de aplicações de parceiros no resumo de e-mails.

Legenda:

  1. Título das informações. As informações que têm o mesmo título são agrupadas.
  2. Descrições de informações. Cada informação tem uma descrição.

O exemplo na imagem a seguir mostra como a saída da API é mapeada para o resumo de e-mail no corpo de e-mail.

Captura de ecrã que mostra informações de aplicações parceiras no corpo do e-mail.

Legenda:

  1. Título das informações. As informações que têm o mesmo título são agrupadas.
  2. Descrição das informações. Cada informação tem uma descrição.

Resumir uma conversa de e-mail usando informações de vendas com o Copilot no Outlook
Enriqueça insights de oportunidades com dados de seu aplicativo
Melhorar detalhes do registo CRM com informações da sua aplicação
Enriqueça resumos de registros do CRM com informações do seu aplicativo
Expandir o representante de vendas com aplicações parceiras
Enriqueça rascunhos de e-mail com links de arquivos do seu aplicativo
Construir extensões para o agente de vendas

  • Last updated on