Збагачуйте зведення записів 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 | Додаткові властивості, які показані в детальному вигляді. Імена та значення властивостей надаються природною мовою на мові, яка вказується через { |
Цей вивід вказує на додаткові властивості, які відображаються в детальному поданні огляду. |
Нотатка
Хоча вимоги до 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 зіставляються зі зведенням запису.
Легенда:
- Розділ, який показує статистику з партнерської програми. Назва розділу походить від назви Microsoft Power Platform з’єднувача.
- Опис інсайтів з відповіді API.
- Номери цитат, які можна вибрати для перегляду детальної інформації про статистику.
- Картка цитування, яка показує подробиці про статистику.
- Піктограма і назва інсайту. Піктограма отримується з Microsoft Power Platform метаданих сполучника. Текст заголовку – це заголовок інсайта з відповіді API.
- Додаткові властивості інсайту з відповіді API.
- Назва партнерської програми. Назву, яка відображається, є назвою Microsoft Power Platform з’єднувача.
- Посилання, яке можна вибрати для перегляду деталей інсайтів у партнерському додатку. Він базується на URL-адресі інсайта у відповіді API.
Пов’язані відомості
Переглянути підсумок запису
Збагачуйте резюме електронною поштою інформацією з вашої програми
Збагачуйте чернетки електронних листів посиланнями на файли з вашої програми
Збагачуйте ключову інформацію про продажі статистикою зі своєї програми
Збагачуйте деталі запису CRM статистикою зі своєї програми
Розширюйте Microsoft 365 Copilot для продажів за допомогою партнерських додатків
Створіть Copilot для розширень Sales