Споделяне чрез

Обогатете подробностите за CRM записа с прозрения от вашето приложение (предварителен преглед)

  • Статия

Важно

[Тази статия е предварително издание на документацията и подлежи на промяна.]

Продавачите могат да преглеждат подробности за записан контакт, заедно със свързани записи, като например акаунти и възможности. Можете да разширите възможността за подробности за записа за управление на взаимоотношенията с клиенти (CRM), която Copilot for Sales предоставя с прозрения от вашето собствено приложение.

Описание на API

Трябва да добавите следното описание на API към действието. По този начин Copilot for Sales може да идентифицира правилния API, който трябва да бъде извикан, за да обогати възможностите.

Това действие получава записи, свързани с CRM запис. Действието подобрява съществуващите умения на Copilot for Sales.

Работа с API

Този API използва тип операция: GET

Входни параметри

Copilot for Sales е предназначен да предостави следните входни параметри на вашите API.

Име Тип/формат на данните Необходимо Подробни данни Описание, което да добавите в действието
Тип запис String Да Типът на обекта или обекта в CRM, за който се изискват свързани записи. Стойността включва независимото от езика уникално име на обекта или типа обект, а не показваното име, което може да бъде локализирано. Примерите включват акаунт и възможност. Този вход идентифицира типа на записа в CRM, за който се изискват свързани записи.
recordId String Да Уникалният идентификатор на CRM записа. Този вход предоставя уникалния идентификатор на CRM записа, за който се изискват свързани записи.
горе Integer No Броят на дейностите за извличане. Този вход показва броя на свързаните записи за извличане.
skip Integer No Броят на дейностите, които трябва да се пропуснат. Този вход показва броя на записите, които трябва да се пропуснат при извличане на свързани записи.
crmType String No Видът на CRM системата. Валидните стойности са Dynamics 365 и Salesforce. Този вход показва типа CRM, от който се извличат съответните записи.
crmOrgUrl String No Името на хоста на CRM организацията, като # contoso.crm.dynamics.com. Този вход показва URL адреса на CRM средата, от която се извличат съответните записи.

Бележка

Тази точка на разширение поддържа рендиране на прозрения от до пет разширения на конектора в страничната кола на Outlook.

Изходни параметри

Copilot for Sales очаква да получи списък с прозрения (обекти) от вашите API и очаква всяка информация да има специфични параметри. За да се гарантира, че Copilot for Sales може правилно да анализира резултата, структурата на отговора трябва да се придържа към указанията в таблицата по-долу.

параметър Тип на данни Необходимо Подробни данни
Стойност Масив Да Списък с прозрения (обекти), които са дефинирани, както е описано в раздела Схема за прозрения .
hasMoreРезултати Boolean No Стойност, която показва дали са налични повече резултати.

Схема за прозрения

Име Тип/формат на данните Необходимо Подробни данни Описание, което да добавите в действието
recordId String Да Уникалният идентификатор на записа. Този изход уникално идентифицира всеки свързан запис, върнат от действието.
recordTypeDisplayName String Да Показваното име на типа запис, като например Договор. Тя трябва да бъде локализирана на езика, който е посочен чрез заглавката Accept-Language . Този изход показва показваното име на типа на записа на всеки свързан запис, върнат от действието.
recordTypePluralDisplayName String Да Показваното име в множествено число на типа запис, като например Договори. Тя трябва да бъде локализирана на езика, който е посочен чрез заглавката Accept-Language . Този изход показва показваното име в множествено число на типа на записа на всеки свързан запис, върнат от действието.
Тип запис String Да Името на системата на типа запис, като например договор. Този изход показва типа на всеки свързан запис, върнат от действието.
записЗаглавие String Да Името на записа, като например договор за подновяване на Contoso 2023. Този изход показва заглавието на всеки свързан запис, върнат от действието.
URL адрес String No Валиден URL адрес за отваряне на записа в партньорското приложение. Този изход показва URL адреса на всеки свързан запис, върнат от действието.
допълнителниСвойства Обект, който има стойности "Име на свойство" и "Стойност на свойство" от типа "Низ " No

Допълнителни свойства, които са показани в подробния изглед. Имената и стойностите на свойствата са на естествен език на езика, който е зададен чрез заглавката Accept-Language . Ето един пример.

{
 "Причина за състоянието": "Подписан",
 "Собственик": "Кени Смит"
}
 Този изход показва допълнителни свойства като двойки име-стойност на всеки свързан запис, върнат от действието.

Пример

{
    "value": [
        {
            "recordId": "ID1",
            "recordTypeDisplayName": "Contract",
            "recordTitle": "50 Cafe A-100 Automatic Renewal Contract",
            "recordTypePluralDisplayName": "Documents",
            "recordType": "contract",
            "url": "https://contosohub.com/contract/id1",
            "additionalProperties": {
                "Status": "Signed",
                "Date": "9/7/23",
                "Signed by": "Alberto Burgos, Tony [last name]"
            }
        },
        {
            "recordId": "ID2",
            "recordTypeDisplayName": "Contract",
            "recordTitle": "ABC Company 2023 Renewal Contract",
            "recordTypePluralDisplayName": "Documents",
            "recordType": "contract",
            "url": "https://contosohub.com/contract/id2",
            "additionalProperties": {
                "Status": "Delivered",
                "Date": "9/3/23",
                 "Signed by": "Alberto Burgos"
            }
        }
    ],
    "hasMoreResults": false
}

Примерът в следващото изображение показва как изходът на API се съпоставя със свързаните записи.

Екранна снимка, показваща анатомията на свързаните записи от партньорско приложение.

Легенда:

  1. Карта, която показва свързани записи от партньорското приложение.
  2. Икона и заглавие на картата. Иконата се извлича от метаданните на Microsoft Power Platform конектора. Заглавието е името на конектора Microsoft Power Platform .
  3. Свързани заглавия на записи от отговора на API. Две допълнителни свойства от отговора на API се изобразяват като ключови полета на всеки свързан запис.
  4. Бутон "Още действия", който може да се използва или за копиране на връзка към записа, или за преглед на подробности за записа в партньорското приложение. Връзката се основава на URL адреса на свързания запис в отговора на API.
  5. Допълнителни свойства на свързания запис от отговора на API.

Вижте подробности за записа
Обогатете резюметата на имейли с прозрения от вашето приложение
Обогатете чернови на имейли с връзки към файлове от вашата кандидатура
Обогатете ключова информация за продажбите с прозрения от вашето приложение
Обогатете резюметата на CRM записите с прозрения от вашето приложение
Разширете Microsoft 365 Copilot за продажби с партньорски приложения
Изграждане на разширения за Copilot за продажби