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

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

  • Статия

Важно

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

За да разберат по-добре контекста на среща, за която се подготвят, или имейл, който четат, продавачите искат подходяща информация за управление на взаимоотношенията с клиенти (CRM), като например клиентски запитвания, притеснения и бележки. Copilot for Sales използва AI, за да генерира обобщение на всеки CRM запис. Това резюме подчертава важни подробности, като етапа на продажбите, бюджета и прогнозната дата на затваряне. Можете да разширите възможността за обобщение на CRM записи, която Copilot for Sales предоставя с прозрения от вашето собствено приложение.

Описание на API

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

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

Работа с API

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

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

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

Име Тип/формат на данните Необходимо Подробни данни Описание, което да добавите в действието
Тип запис String Да Типът на обекта или обекта в CRM, за който се изискват свързани прозрения, като например дейности. Стойността включва независимото от езика уникално име на обекта или типа обект, а не показваното име, което може да бъде локализирано. Примерите включват акаунт и възможност. Този вход показва обекта или типа на обекта в CRM, за който се изискват прозрения.
recordId String Да Уникалният идентификатор на CRM записа. Този вход показва уникалния идентификатор на CRM записа, за който се изискват прозрения.
startDateTime Низ във формат "дата-час" No Началната дата и часът за търсене на прозрения. Форматът следва OpenAPI спецификацията. Ето един пример: 2017-07-21T17:32:28Z. Този вход показва началната дата и часа на исканите прозрения.
endDateTime Низ във формат "дата-час" No Крайната дата и час за търсене на прозрения. Форматът следва OpenAPI спецификацията. Ето един пример: 2017-07-21T17:32:28Z. Този вход показва крайната дата и час на исканите прозрения.
горе Integer No Броят на прозренията за извличане. Този вход показва броя на прозренията за извличане.
skip Integer No Броят на прозренията, които трябва да се пропуснат. Този вход показва броя на прозренията, които трябва да се пропуснат.
crmType String No Валидните стойности са Dynamics 365 и Salesforce. Този вход показва типа CRM, в който съществува CRM записът, за който се изискват прозрения.
crmOrgUrl String No Името на хоста на CRM организацията, като # contoso.crm.dynamics.com. Този вход показва URL адреса на CRM средата, в която съществува CRM записът, за която се изискват прозрения.

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

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

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

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

Име Тип/формат на данни Необходимо Подробни данни Описание, което ще бъде добавено в действие
заглавие String Да Заглавието на прозрението на картата за цитиране. Това е заглавието на естествения език на прозренията на езика, който е посочен чрез заглавката на Accept-Language заявката. Ето един пример: Подписан договор. Този изход показва заглавието на дейността в картата за цитиране.
описание String Да Описанието на прозрението. Показва се като точки в резюмето на записа и е описанието на естествения език на прозренията на езика, който е посочен чрез заглавката Accept-Language . Ето един пример: Кени, Логан и двама други подписаха договора за подновяване на Contoso 2023 на 9/7/2023. Този изход показва описанието на прозренията.
dateTime Низ във формат "дата-час" Да Датата и часът на дейността във формат UTC. Ако дейността има както начален, така и краен час, приложението трябва да определи кой час да се покаже. Форматът следва OpenAPI спецификацията. Ето един пример: 2017-07-21T17:32:28Z. Този изход показва времето, свързано с прозренията.
URL адрес String No Валиден URL адрес за отваряне на дейността в партньорското приложение. Този изход показва URL адреса за отваряне на прозрения.
допълнителниСвойства Обект, който има стойности "Име на свойство" и "Стойност на свойство" от типа "Низ " No

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

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

Бележка

Въпреки че изискванията на API за разширяване на възможностите за обобщение на имейли и възможности за обобщение на записи може да изглеждат подобни, те трябва да бъдат добавени като отделни действия в конектора.

Пример

{
    "value": [
        {
            "title": "Contract signed",
            "description": "You have 5 connections in Fourth Coffee Inc",
            "dateTime": "2024-05-07T03:28:38.0667701Z",
            "url": null,
            "additionalProperties": {
                "Contract name": "50 Cafe-A-100 Automatic Renewal Contract",
                "Signed by": "Alberto Burgos, Tony",
                "Signed": "9/7/23"
            }
        },
        {
            "title": "Contract signed",
            "description": "Multiple stakeholders from Fourth Coffee have visited the Contoso website four times in the last four months",
            "dateTime": "2024-05-07T03:28:38.0669445Z",
            "url": null,
            "additionalProperties": {
                "Contract name": "50 Cafe-A-100 Automatic Renewal Contract",
                "Signed by": "Alberto Burgos, Tony",
                "Signed": "9/7/23"
            }
        }
    ],
    "hasMoreResults": false
}

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

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

Легенда:

  1. Раздел, който показва прозрения от партньорското приложение. Заглавието на раздела произлиза от името на конектора Microsoft Power Platform .
  2. Описания на информацията от отговора на API.
  3. Номера на цитирания, които могат да бъдат избрани, за да се видят подробности за прозренията.
  4. Карта за цитиране, която показва подробности за прозрението.
  5. Икона и заглавие на прозрението. Иконата се извлича от метаданните на Microsoft Power Platform конектора. Заглавният текст е заглавието на информацията от отговора на API.
  6. Допълнителни свойства на информацията от отговора на API.
  7. Име на партньорското приложение. Името, което се показва, е името на конектора Microsoft Power Platform .
  8. Връзка, която може да бъде избрана, за да видите подробности за прозрения в партньорското приложение. Тя се основава на URL адреса на информацията в отговора на API.

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