Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Importante
- Esta é uma funcionalidade de pré-visualização pronta para produção.
- As pré-visualizações prontas para produção estão sujeitas a termos de utilização suplementares.
[Este artigo é uma documentação de pré-lançamento e está sujeito a alterações.]
Quando usa a aplicação Sales para redigir um email, ela considera a intenção do email e utiliza informações de CRM do Salesforce ou Dynamics 365 para criar o rascunho. Pode expandir a capacidade de redação de emails que a aplicação Sales oferece com ficheiros recomendados da sua própria aplicação.
Nota
Esta funcionalidade é suportada apenas para rascunhos de email criados através da aplicação Sales no Outlook.
Descrição da API
Tem de adicionar a seguinte descrição da API à ação. Desta forma, a aplicação Sales 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 aprimora as capacidades existentes do Copilot 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 na ação |
|---|---|---|---|---|
| resourceData | Objeto | Sim | 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. |
| tipoDeRecurso | Cadeia (de carateres) | Sim | 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'. |
| recordType | Cadeia (de carateres) | Não | 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 | Cadeia (de carateres) | Não | 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. |
| crmType | Cadeia (de carateres) | Não | 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 | Cadeia (de carateres) | Não | O URL da organização de CRM. | Esta entrada indica o URL do ambiente de CRM em que existe o registo relacionado com o tópico de e-mail. |
| inputPrompt | Cadeia (de carateres) | Não | 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. |
| principal | Número inteiro | Não | O número de itens a obter. | Esta entrada indica o número de ligações de ficheiro a obter. |
| ignorar | Número inteiro | Não | 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 na ação |
|---|---|---|---|
| plaintextBody | Cadeia (de carateres) | 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 | Cadeia (de carateres) | 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. |
| requerente | Cadeia (de carateres) | Assunto do e-mail. | Esta entrada fornece o assunto do e-mail. |
| de | Cadeia (de carateres) | Endereço de e-mail do remetente. | Esta entrada fornece o endereço de e-mail do remetente. |
| para | Cadeia (de carateres)[] | Endereços de e-mail do destinatário. | Esta entrada fornece o endereço de e-mail do destinatário. |
| cc | Cadeia (de carateres)[] | 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 (de carateres)[] | 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 | Cadeia (de carateres) | O ID de mensagem do Graph do e-mail. | Esta entrada fornece o ID da mensagem do e-mail. |
| conversationId | Cadeia (de carateres) | 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 |
|---|---|---|---|
| valor | Matriz | Sim | 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. |
| hasMoreResults | booleano | Não | Um valor que indica se estão disponíveis mais resultados. |
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 na ação |
|---|---|---|---|---|
| TipoDeConteúdo | cadeia (de caracteres) | Sim | 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) | Sim | 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) | Sim | 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) | Sim | 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) | Não | Í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 | Não | 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 de cadeia | 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 |
Exemplo
{
"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.
Veja também
Resumir um tópico de e-mail utilizando informações de vendas com o Copilot no Outlook
Enriquecer resumos do e-mail com informações da sua aplicação
Enriqueça insights de oportunidades com dados de seu aplicativo
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
Amplie as Vendas no Microsoft 365 Copilot com aplicações parceiras
Construir extensões para Vendas no Microsoft 365 Copilot