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


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

Важливо

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

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

Опис API

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

Ця дія отримує додаткову статистику продажів, пов’язану із записом CRM, яка відображатиметься у зведеній картці запису C4S. Дія посилює існуючі навички другого пілота для продажів.

Робота API

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

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

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

Ім'я Тип/формат даних Обов'язковий Докладні відомості Опис для додавання в дію
recordType String Так Тип сутності або об’єкта в CRM, для якого запитуються пов’язані аналітичні дані, наприклад дії. Значення включає незалежне від мови унікальне ім’я сутності або типу об’єкта, а не відображуване ім’я, яке можна локалізувати. Наприклад , обліковий запис і потенційна угода. Цей вхідний сигнал вказує на сутність або тип об’єкта в CRM, для якого запитуються статистичні дані.
recordId String Так Унікальний ідентифікатор запису CRM. Цей вхідний сигнал вказує на унікальний ідентифікатор запису CRM, для якого запитуються статистичні дані.
startDateTime Рядок у форматі ’date-time’ No Дата початку та час для пошуку статистичних даних. Формат відповідає OpenAPI специфікації. Ось приклад: 2017-07-21T17:32:28Z. Цей вхідний сигнал вказує на дату початку та час запитуваної статистики.
endDateTime Рядок у форматі ’date-time’ No Кінцева дата й час для пошуку статистичних даних. Формат відповідає OpenAPI специфікації. Ось приклад: 2017-07-21T17:32:28Z. Цей вхідний сигнал вказує на дату завершення та час запитуваної статистики.
перші Ціле число No Кількість інсайтів, які потрібно отримати. Цей вхідний сигнал вказує на кількість аналітичних даних, які потрібно отримати.
пропустити Ціле число 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 може правильно аналізувати вихідні дані, структура відповіді повинна дотримуватися вказівок у наступній таблиці.

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

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

Ім'я Тип/формат даних Обов'язковий Докладні відомості Опис, який буде додано в дію
заголовок String Так Назва інсайту на картці цитати. Це заголовок на природній мові інсайта на мові, який вказується через Accept-Language заголовок запиту. Ось приклад :Договір підписано. Цей вивід вказує назву вправи в картці цитування.
опис String Так Опис інсайту. Він відображається у вигляді маркерів у підсумку запису і є описом думки мовою природною мовою, яка вказується в Accept-Language заголовку. Ось приклад: Кенні, Логан та двоє інших підписали контракт про продовження Contoso 2023 07.09.2023. Цей вихід вказує на опис інсайту.
dateTime Рядок у форматі ’date-time’ Так Дата та час проведення активності у форматі UTC. Якщо активність має час початку та завершення, програма має визначити, о котрій годині показувати. Формат відповідає OpenAPI специфікації. Ось приклад: 2017-07-21T17:32:28Z. Цей вихід вказує на час, пов’язаний з інсайтом.
URL-адреса String No Дійсна URL-адреса для відкриття активності в партнерському додатку. Цей вивід вказує URL-адресу для відкриття статистики.
Додаткові властивості Об’єкт, який має значення Property Name та Property Value типу String 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 для розширень Sales