Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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 usa o agente de vendas para redigir um email, ele considera a intenção do email e utiliza informações de CRM do Salesforce ou Dynamics 365 para criar o rascunho. Pode ampliar a capacidade de redação por email que o agente de vendas fornece com ficheiros recomendados da sua própria aplicação.
Observação
Esta funcionalidade é suportada apenas para rascunhos de email criados através do agente de vendas no Outlook.
Descrição da API
Você deve adicionar a seguinte descrição da API à ação. Desta forma, o agente de vendas pode identificar a API correta que deve ser invocada para enriquecer a capacidade.
Esta ação obtém ficheiros relevantes para a conversação de e-mail, que serão mostrados em rascunhos de e-mail C4S no Outlook. A ação reforça as competências existentes do copiloto para vendas.
Operação API
Esta API usa o tipo de operação: POST
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. |
| resourceType | String | Yes | O tipo de recurso para o qual se obtêm sugestões de conteúdo. Por exemplo, 'email-thread' ou 'teams-chat'. | Esta entrada identifica o tipo de recurso partilhado para obter ligações de ficheiros sugeridos que, neste caso, é 'email-thread'. |
| Tipo de registo | String | No | O tipo de registo do CRM, como conta ou oportunidade. | Esta entrada identifica o tipo de registo no CRM, que está relacionada com o tópico de e-mail. |
| recordId | String | No | O identificador exclusivo do registo de CRM a usar para conteúdos sugeridos. | Esta entrada fornece o identificador exclusivo do registo de CRM que está relacionado com o tópico de e-mail. |
| 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. |
| inputPrompt | String | No | O pedido sugerido usado atualmente dado pelo utilizador para gerar o rascunho de e-mail. Por exemplo, "Responder a uma preocupação" ou "Fazer uma proposta". | Esta entrada indica o pedido fornecido pelo utilizador durante a elaboração de um rascunho 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[] | Os endereços de e-mail dos destinatários adicionados ao 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[] | Os endereços de e-mail dos destinatários adicionados ao 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. |
Parâmetros de saída
| Propriedade | Tipo de Dados | Obrigatório | Detalhes |
|---|---|---|---|
| value | Array | Yes | Uma lista de ligações de ficheiro (objetos) definidos conforme descrito na resposta Esquema para sugestões de conteúdo de ficheiro ou ligação. |
| temMaisResultados | booleano | No | Um valor que indica se mais resultados estão disponíveis. |
Esquema para resposta de sugestões de conteúdo de ficheiro ou ligação
| Nome | Formato do tipo de dados | Obrigatório | Detalhes | Descrição a adicionar à ação |
|---|---|---|---|---|
| TipoDeConteúdo | cadeia (de caracteres) | Yes | O tipo de conteúdo a apresentar. Para mais informações, aceda a Valores predefinidos para contentType | Esta saída indica o tipo de conteúdo incluído no rascunho do e-mail. |
| conteúdo | cadeia (de caracteres) | Yes | Conteúdo real incluído. Pode ser uma página Web ou um URL do ficheiro. | Esta saída indica o conteúdo real que está incluído no rascunho do e-mail. Pode ser uma página Web ou um URL. |
| contentTitle | cadeia (de caracteres) | Yes | Título do conteúdo sugerido mostrado ao utilizador. | Esta saída indica o título do conteúdo. |
| conteúdoDescrição | cadeia (de caracteres) | Yes | Descrição do conteúdo sugerido mostrado ao utilizador. | Esta saída indica o texto a incluir ao descrever os ficheiros. |
| contentIconUrl | cadeia (de caracteres) | No | Ícone do conteúdo sugerido mostrado ao utilizador. Se não for fornecido, é utilizado um ícone genérico. | Esta saída indica o ícone a incluir para o conteúdo. |
| additionalProperties | Objeto | No | Um conjunto de pares nome-valor que indica as propriedades adicionais da ligação de ficheiro relacionada que a ação devolve. | Esta saída indica propriedades adicionais como pares nome-valor de cada ligação relacionada devolvida pela ação. |
Valores predefinidos para contentType
| Valor da cadeia de caracteres | Tipo de conteúdo |
|---|---|
| arquivo de conteúdo | Ficheiro Externo (Genérico) |
| content-web | Página web externa |
| content-doc | Documento do Microsoft Word |
| content-pdf | Documento PDF da Microsoft |
| conteúdo-pptx | Apresentação do Microsoft PowerPoint |
| content-xlsx | Folha de cálculo do Microsoft Excel |
Example
{
"value": [
{
"contentType": 0,
"content": "https://www.bing.com",
"contentTitle": "Purchase Contract",
"contentDescription": "Purchase Contract Description",
"contentIconUrl": null,
"additionalProperties": {
"Recipients": "Logan Edwards",
"Sender Name": "Kenny Smith"
}
},
{
"contentType": 3,
"content": "https://www.microsoft.com",
"contentTitle": "Strategy Planning",
"contentDescription": "Strategy Planning Description",
"contentIconUrl": null,
"additionalProperties": {
"Recipients": "Gabriela Edwards",
"Sender Name": "Maria Smith"
}
},
{
"contentType": 1,
"content": "https://www.bing.com",
"contentTitle": "Contoso Website",
"contentDescription": "Contoso Website Description",
"contentIconUrl": null,
"additionalProperties": {
"Total Views": "100",
"Domain": "Contoso.com"
}
}
],
"hasMoreResults": false
}
O exemplo na imagem seguinte mostra um exemplo de como a saída da API é mapeada para o rascunho de e-mail.
Legenda:
- Ligações de ficheiro de aplicações parceiras.
Ver também
Resumir uma conversa de e-mail usando informações de vendas com o Copilot no Outlook
Enriqueça resumos por e-mail com informações do seu aplicativo
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
Construir extensões para o agente de vendas