Поділитися через

Збагачуйте деталі запису CRM статистикою зі своєї програми (попередній перегляд)

  • Стаття

Важливо

[Ця стаття стосується інструкції до попередньої версії, і її буде змінено.]

Продавці можуть переглядати відомості про збережений контакт разом із пов’язаними записами, як-от облікові записи та потенційні угоди. Ви можете розширити можливість керування взаємовідносинами з клієнтами (CRM), яку Copilot for Sales надає за допомогою статистики з вашої власної програми.

Опис API

Ви повинні додати до дії наступний опис API. Таким чином, Copilot for Sales може визначити правильний API, який потрібно викликати для збагачення можливостей.

Ця дія отримує записи, пов’язані із записом CRM. Дія покращує існуючі навички Copilot for Sales.

Робота API

Цей API використовує тип операції: GET

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

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

Ім'я Тип/формат даних Обов'язковий Докладні відомості Опис для додавання в дію
recordType String Так Тип сутності або об’єкта в CRM, для якого запитуються пов’язані записи. Значення включає незалежне від мови унікальне ім’я сутності або типу об’єкта, а не відображуване ім’я, яке можна локалізувати. Наприклад , обліковий запис і потенційна угода. Цей вхідний сигнал визначає тип запису в CRM, для якого запитуються пов’язані записи.
recordId String Так Унікальний ідентифікатор запису CRM. Цей вхідний сигнал надає унікальний ідентифікатор запису CRM, для якого запитуються пов’язані записи.
перші Ціле число No Кількість дій, які потрібно отримати. Цей вхідний сигнал вказує на кількість пов’язаних записів, які потрібно отримати.
пропустити Ціле число 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 може правильно аналізувати вихідні дані, структура відповіді повинна дотримуватися вказівок у наступній таблиці.

Параметр Тип даних Обов'язковий Докладні відомості
значення Масив Так Список інсайтів (об’єктів), які визначені так, як описано в розділі Схема для інсайтів .
hasMoreResults Boolean No Значення, яке вказує, чи доступні додаткові результати.

Схема для інсайтів

Ім'я Тип/формат даних Обов'язковий Докладні відомості Опис для додавання в дію
recordId String Так Унікальний ідентифікатор запису. Цей вивід унікально ідентифікує кожен пов’язаний запис, повернутий дією.
recordTypeDisplayName String Так Коротке ім’я типу запису, наприклад Контракт. Він повинен бути локалізований на тій мові, яка вказана через Accept-Language заголовок. Цей вивід вказує ім’я відображення типу запису кожного пов’язаного запису, повернутого дією.
recordTypePluralDisplayName String Так Відображуване ім’я типу запису у множині, наприклад Контракти. Він повинен бути локалізований на тій мові, яка вказана через Accept-Language заголовок. Цей вивід вказує ім’я відображення у множині типу запису кожного пов’язаного запису, повернутого дією.
recordType String Так Системне ім’я типу запису, наприклад контракт. Цей вихідний сигнал вказує тип кожного пов’язаного запису, який повертається дією.
recordTitle String Так Назва запису, наприклад Contoso 2023 Renewal Contract. Цей вивід вказує назву кожного пов’язаного запису, який повертається дією.
URL-адреса String No Дійсна URL-адреса для відкриття запису в партнерській програмі. Цей вивід вказує URL-адресу кожного пов’язаного запису, повернутого дією.
Додаткові властивості Об’єкт, який має значення Property Name та Property Value типу String 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 для розширень Sales