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

Quando o Copilot no Outlook e o agente de Vendas são usados juntos, os resumos de email mostrados no Outlook incluem informações de vendas provenientes do sistema crm (gerenciamento de relacionamento com o cliente), como o Dynamics 365 ou o Salesforce CRM. Você pode estender a funcionalidade de resumo de email que o agente de Vendas fornece com insights de seu próprio aplicativo.

Note

Esta API substitui a API Habilidade de Resumo do Email existente (ID da operação: scp-get-email-insights) por uma nova versão.

Descrição da API

Você deve adicionar a descrição da API a seguir à ação. Isso ajuda o agente de vendas a identificar a API correta a ser invocada para enriquecer a funcionalidade.

Essa ação obtém insights de vendas adicionais que serão mostrados na experiência de resumo de email do C4S dentro do resumo do Outlook. A ação aprimora as habilidades existentes do copilot para vendas.

Detalhes da API

  • Nome da API: versão 2 da Habilidade de Resumo do Email
  • ID da operação do Swagger: scp-get-email-insights-v2
  • Método de operação do Swagger: postagem
  • Caminho: <PowerAppsConnectorHostName>/api/enhanceskills/email-insights-v2

Conteúdo de entrada

Esse conteúdo vai como o corpo da solicitação API.

Nome Tipo de dados Obrigatório Detalhes Descrição a ser adicionada na ação
dados de recursos Objeto Yes Os dados de recurso a serem usados para buscar o conteúdo sugerido. Para a estrutura de dados, vá até Modelo de dados do email de extensibilidade. Essa entrada identifica o conteúdo do email, que é uma coleção de thread de email, assunto e outros detalhes.
entidades relacionadas Array No A matriz de entidades relacionadas. Para a estrutura de dados, vá até Modelo de dados da entidade relacionada. Essa entrada identifica a matriz de registros do CRM, que está relacionada ao thread de email.
tipo de CRM String No O tipo de sistema CRM, se conectado. Os valores válidos são Salesforce e Dynamics 365. Esta entrada indica o tipo de CRM no qual o registro relacionado ao thread de email existe.
crmOrgUrl String No A URL da organização do CRM. Esta entrada indica a URL do ambiente de CRM no qual o registro relacionado ao thread de email existe.
top Integer No O número de itens a serem buscados. Esta entrada indica o número de links de arquivo a serem buscados.
ignorar Integer No O número de itens a serem ignorados. Esta entrada indica o número de itens a serem ignorados durante a busca de links de arquivo sugeridos.

Modelo de dados do email de extensibilidade

Propriedade Tipo Detalhes Descrição a ser adicionada na ação
plaintextBody String O corpo completo do email inclui todas as mensagens anteriores do thread de emails. Esta entrada fornece todo o conteúdo do thread de emails em formato de texto.
fullHtmlBody String A versão HTML completa do corpo do email que inclui todas as mensagens anteriores do thread de emails. Esta entrada fornece todo o conteúdo do thread de emails em formato HTML.
assunto String Assunto do e-mail. Esta entrada fornece o assunto do email.
from String Endereço de email do remetente. Esta entrada fornece o endereço de email do remetente.
Para String[] Endereços de email do destinatário. Esta entrada fornece o endereço de email do destinatário.
cc String[] Endereços de email do destinatário adicionados no campo Cc do email. Esta entrada fornece todos os endereços de email do destinatário incluídos no campo Cc do email.
bcc String[] Endereços de email do destinatário adicionados no campo Cco do email. Esta entrada fornece todos os endereços de email do destinatário adicionados no campo Cco do email.
sentDateTime DateTimeOffset A data e a hora do email em formato UTC com a propriedade Offset. Para obter mais informações, vá até DateTimeOffset Struct (sistema) Esta entrada fornece o carimbo de data/hora do email.
ID da Mensagem String O ID da mensagem do Graph do email. Esta entrada fornece o ID da mensagem do email.
conversationId String O ID da conversa do Graph do thread de emails. Esta entrada fornece o ID da conversa do thread de emails.
Propriedade Tipo Obrigatório Detalhes Descrição a ser adicionada na ação
entityId String Yes O tipo de registro do CRM, como conta ou oportunidade. Esta entrada fornece o identificador exclusivo do registro de CRM relacionado ao thread de email.
entityType String Yes O identificador exclusivo do registro de CRM a ser usado para conteúdo sugerido. Esta entrada identifica o tipo de registro no CRM, que está relacionado ao thread de email.
entitySource String No Essa entrada indica a origem da entidade, atualmente contém valores "conectados" ou vazios. Essa entrada indica o tipo de origem da entidade.

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 .

Observação: embora esse parâmetro inclua uma lista de insights, somente o primeiro insight é usado no resumo do enriquecimento de email para a experiência de Tela do Outlook.
tem mais resultados booleano No Um valor que indica se há mais resultados disponíveis.

Esquema para insights

Nome Tipo/formato de dados Obrigatório Detalhes Descrição a ser adicionada na ação
insight String Yes O insight que é entregue aos usuários, como Seus colegas Mona Kane, Ray Tanaka e Daniela Smith já trabalharam com eles antes. Esta saída indica o texto que você gostaria de incluir no resumo de email.

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 do email no painel lateral.

Captura de tela mostrando insights de aplicativos de parceiro no resumo do email.

Legenda:

  1. Título do insight. Os insights que tenham o mesmo título são agrupados.
  2. Descrições do insight. Cada insight tem uma descrição.

O exemplo na imagem a seguir mostra como a saída da API é mapeada para o resumo do email no corpo do email.

Captura de tela mostrando insights de aplicativos parceiros no corpo do email.

Legenda:

  1. Título do insight. Os insights que tenham o mesmo título são agrupados.
  2. Descrição do insight. Cada insight tem uma descrição.

Resumir uma conversa de emails usando as informações de vendas com o Copilot no Outlook
Enriqueça insights de oportunidade com dados do seu aplicativo
** Enriquecer os detalhes do registro de CRM com insights da sua aplicação
Enriquecer os resumos de registros CRM com insights do seu aplicativo
Estender o agente de vendas com aplicativos parceiros
Enriquecer rascunhos de email com links de arquivo de seu aplicativo
Criar extensões para o agente de Vendas

  • Last updated on