Compartilhar via


Contoso Hub

Este é um conector de exemplo para estender o Copilot for Sales

Esse conector está disponível nos seguintes produtos e regiões:

Service Class Regions
Copilot Studio Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicativos Lógicos Standard Todas as regiões dos Aplicativos Lógicos , exceto as seguintes:
     – Regiões do Azure Governamental
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Power Apps Premium Todas as regiões do Power Apps , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Power Automate Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Metadados do conector
Publicador Microsoft

Limitações

Nome Chamadas Período de renovação
Chamadas à API por conexão 100 60 segundos

Ações

Chat sobre os principais stakeholders (versão prévia)

Essa API retorna os principais tomadores de decisão ou os principais stackholders de uma conta, dado um nome de conta CRM como entrada

Enriquecer as principais informações de vendas (versão prévia)

Essa ação obtém insights adicionais sobre vendas que serão mostrados no cartão de informações das principais vendas C4S no complemento do Outlook. A ação aprimora as habilidades existentes do Copilot para vendas

Enriquecer detalhes do registro do CRM (versão prévia)

Essa ação obtém registros relacionados a um registro CRM. A ação aprimora as habilidades existentes do Copilot for Sales

Enriquecer resumo de email (versão prévia)

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

Resumo do registro do Enrich CRM (versão prévia)

Essa ação obtém insights de vendas adicionais relacionados a um registro de CRM que serão mostrados no cartão de resumo do registro C4S. A ação aprimora as habilidades existentes do copilot para vendas

Chat sobre os principais stakeholders (versão prévia)

Essa API retorna os principais tomadores de decisão ou os principais stackholders de uma conta, dado um nome de conta CRM como entrada

Parâmetros

Nome Chave Obrigatório Tipo Description
accountName
accountName True string

O nome da conta crm de entrada

tipo de CRM
crmType string

Essa entrada indica o tipo de CRM no qual a contagem de CRM existe, para a qual os principais tomadores de decisão ou os principais stackholders são solicitados

Retornos

Enriquecer as principais informações de vendas (versão prévia)

Essa ação obtém insights adicionais sobre vendas que serão mostrados no cartão de informações das principais vendas C4S no complemento do Outlook. A ação aprimora as habilidades existentes do Copilot para vendas

Parâmetros

Nome Chave Obrigatório Tipo Description
recordType
recordType True string

Essa entrada identifica o tipo de registro no CRM para o qual as informações de vendas de chave são solicitadas

recordId
recordId True string

Essa entrada fornece o identificador exclusivo do registro CRM para o qual as informações de vendas de chave são solicitadas

tipo de CRM
crmType string

Essa entrada indica o tipo de CRM no qual o registro CRM existe, para o qual as informações de vendas de chave são solicitadas

crmOrgUrl
crmOrgUrl string

Essa entrada indica a URL do ambiente crm no qual o registro CRM existe, para o qual as informações de vendas de chave são solicitadas

top
top integer

Essa entrada indica o número de realces de vendas a serem buscados

ignorar
skip integer

Essa entrada indica o número de itens a serem ignoradas ao buscar realces de vendas

Retornos

Enriquecer detalhes do registro do CRM (versão prévia)

Essa ação obtém registros relacionados a um registro CRM. A ação aprimora as habilidades existentes do Copilot for Sales

Parâmetros

Nome Chave Obrigatório Tipo Description
recordType
recordType True string

Essa entrada identifica o tipo de registro no CRM para o qual os registros relacionados são solicitados

recordId
recordId True string

Essa entrada fornece o identificador exclusivo do registro CRM para o qual os registros relacionados são solicitados

top
top integer

Essa entrada indica o número de registros relacionados a serem buscados

ignorar
skip integer

Essa entrada indica o número de registros a serem ignoradas ao buscar registros relacionados

tipo de CRM
crmType string

Essa entrada indica o tipo de CRM do qual os registros relacionados são buscados

crmOrgUrl
crmOrgUrl string

Essa entrada indica a URL do ambiente crm do qual os registros relacionados são buscados

Retornos

Enriquecer resumo de email (versão prévia)

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

Parâmetros

Nome Chave Obrigatório Tipo Description
emailContacts
emailContacts True string

Essa entrada indica uma lista de todos os emails de participante relevantes no thread de email atual

recordType
recordType string

Essa entrada identifica o tipo de registro no CRM que está relacionado ao email resumido

recordId
recordId string

Essa entrada fornece o identificador exclusivo do registro CRM que está relacionado ao email resumido

tipo de CRM
crmType string

Essa entrada indica o tipo de CRM no qual o registro relacionado ao email resumido existe

crmOrgUrl
crmOrgUrl string

Essa entrada indica a URL do ambiente crm no qual o registro relacionado ao email resumido existe

top
top integer

Essa entrada indica o número de insights a serem buscados

ignorar
skip integer

Essa entrada indica o número de itens a serem ignoradas ao buscar insights

Retornos

Resumo do registro do Enrich CRM (versão prévia)

Essa ação obtém insights de vendas adicionais relacionados a um registro de CRM que serão mostrados no cartão de resumo do registro C4S. A ação aprimora as habilidades existentes do copilot para vendas

Parâmetros

Nome Chave Obrigatório Tipo Description
recordType
recordType True string

Essa entrada indica a entidade ou o tipo de objeto no CRM para o qual os insights são solicitados

recordId
recordId True string

Essa entrada indica o identificador exclusivo do registro CRM para o qual os insights são solicitados

startDateTime
startDateTime date-time

Essa entrada indica a data e a hora de início dos insights solicitados

endDateTime
endDateTime date-time

Essa entrada indica a data e a hora de término dos insights solicitados

top
top integer

Essa entrada indica o número de insights a serem buscados

ignorar
skip integer

Essa entrada indica o número de insights a serem ignoradas

tipo de CRM
crmType string

Essa entrada indica o tipo de CRM no qual o registro CRM existe, para o qual os insights são solicitados

crmOrgUrl
crmOrgUrl string

Esta entrada indica a URL do ambiente de CRM no qual o registro de CRM existe, para o qual os insights são solicitados.

Retornos

Definições

Activity

Nome Caminho Tipo Description
title
title string

Essa saída indica o título da atividade no cartão de citação

descrição
description string

Essa saída indica a descrição do insight

data e hora
dateTime date-time

Essa saída indica o tempo associado ao insight

url
url string

Essa saída indica a URL para abrir insights

additionalProperties
additionalProperties object

Essa saída indica propriedades adicionais exibidas na exibição detalhada do insight

ActivityListResponseEnvelope

Nome Caminho Tipo Description
value
value array of Activity
tem mais resultados
hasMoreResults boolean

Isso indica se há mais resultados a serem buscados em chamadas subsequentes

AdaptiveCardWrapper

Nome Caminho Tipo Description
adaptiveCard
adaptiveCard string
previewCardData
previewCardData PreviewCardData

EmailInsight

Nome Caminho Tipo Description
title
title string

Essa saída indica o título da seção de parceiro e deve incluir apenas o nome do parceiro

descrição
description string

Essa saída indica o texto que você gostaria de incluir no resumo do email

EmailInsightListResponseEnvelope

Nome Caminho Tipo Description
value
value array of EmailInsight
tem mais resultados
hasMoreResults boolean

Isso indica se há mais resultados a serem buscados em chamadas subsequentes

ExternalRelatedRecord

Nome Caminho Tipo Description
recordId
recordId string

Essa saída identifica exclusivamente cada registro relacionado retornado pela ação

recordTypeDisplayName
recordTypeDisplayName string

Essa saída indica o nome de exibição do tipo de registro de cada registro relacionado retornado pela ação

recordTitle
recordTitle string

Essa saída indica o título de cada registro relacionado retornado pela ação

recordTypePluralDisplayName
recordTypePluralDisplayName string

Essa saída indica o nome de exibição plural do tipo de registro de cada registro relacionado retornado pela ação

recordType
recordType string

Essa saída indica o tipo de cada registro relacionado retornado pela ação

url
url string

Essa saída indica a URL de cada registro relacionado retornado pela ação

additionalProperties
additionalProperties object

Essa saída indica propriedades adicionais como pares nome-valor de cada registro relacionado retornado pela ação

ExternalRelatedRecordListResponseEnvelope

Nome Caminho Tipo Description
value
value array of ExternalRelatedRecord
tem mais resultados
hasMoreResults boolean

Isso indica se há mais resultados a serem buscados em chamadas subsequentes

PartnerConnectorResponse

Nome Caminho Tipo Description
adaptiveCards
adaptiveCards array of AdaptiveCardWrapper

PreviewCardData

Nome Caminho Tipo Description
title
title string
subtítulo
subtitle string
url
url string

SalesHighlight

Nome Caminho Tipo Description
title
title string

Esse resultado indica o título do cartão de citação para o insight.

descrição
description string

Esse resultado indica o texto do insight a ser incluído nas informações de vendas principais.

data e hora
dateTime date-time

Esta saída indica o tempo associado ao insight.

url
url string

Essa saída fornece a URL para obter mais informações sobre o insight.

additionalProperties
additionalProperties object

Essa saída indica propriedades adicionais como pares nome-valor de cada insight relacionado retornado pela ação.

SalesHighlightListResponseEnvelope

Nome Caminho Tipo Description
value
value array of SalesHighlight
tem mais resultados
hasMoreResults boolean

Isso indica se há mais resultados a serem buscados em chamadas subsequentes