Збагачуйте ключову інформацію про продажі статистикою зі своєї програми (попередній перегляд)
Важливо
- Це підготовча функція, готова до використання у виробничому середовищі.
- Готові до виробництва попередні версії регулюються додатковими умовами використання.
[Ця стаття стосується інструкції до попередньої версії, і її буде змінено.]
Поки продавці читають і складають електронні листи в Outlook, вони можуть використовувати Copilot для продажів, щоб переглядати ключову інформацію про продажі про контакти, облікові записи та можливості, пов’язані з електронною поштою. Ключова інформація про продажі базується на одному з таких джерел:
- Можливість, яка підключена до електронної пошти
- Найактуальніша можливість, виходячи з контактів та облікових записів у листі
Ви можете розширити можливості ключової інформації про продажі, яку надає Copilot for Sales, за допомогою статистики з вашої власної програми.
Опис API
Ви повинні додати до дії наступний опис API. Таким чином, Copilot for Sales може визначити правильний API, який потрібно викликати для збагачення можливостей.
Ця дія отримує додаткові статистичні дані про продажі, які відображатимуться на картці з ключовою інформацією про продаж C4S у програмі Outlook. Дія посилює існуючі навички другого пілота для продажів.
Робота API
Цей API використовує тип операції: GET
Вхідні параметри
Copilot for Sales призначений для надання наступних вхідних параметрів для ваших API.
Ім'я | Тип/формат даних | Обов'язковий | Докладні відомості | Опис для додавання в дію |
---|---|---|---|---|
recordType | String | Так | Тип запису в управлінні взаємовідносинами з клієнтами (CRM). У записі може бути вказано обліковий запис, потенційну угоду, потенційного клієнта або контактну особу, пов’язану з електронною поштою. | Ці вхідні дані визначають тип запису в CRM, для якого запитується ключова інформація про продаж. |
recordId | String | Так | Ідентифікатор запису в CRM. | Ці вхідні дані містять унікальний ідентифікатор запису CRM, для якого запитується ключова інформація про продажі. |
crmType | String | No | Тип CRM-системи. Допустимими значеннями є Salesforce і Dynamics 365. | Цей вхідний сигнал вказує на тип CRM, у якому існує запис CRM, для якого запитується ключова інформація про продажі. |
crmOrgUrl | String | No | URL-адреса організації CRM. | Цей вхідний сигнал вказує URL-адресу середовища CRM, у якому існує запис CRM, для якого запитується ключова інформація про продажі. |
перші | Ціле число | No | Кількість інсайтів, які потрібно отримати. | Цей вхідний сигнал вказує на кількість основних моментів продажу, які потрібно отримати. |
пропустити | Ціле число | No | Кількість інсайтів, які потрібно пропустити. | Цей вхідний сигнал вказує на кількість товарів, які слід пропустити під час отримання основних показників продажу. |
Параметри виводу
Copilot for Sales очікує отримати список інсайтів (об’єктів) з ваших API, і він очікує, що кожен інсайт матиме конкретні параметри. Щоб гарантувати, що Copilot for Sales може правильно аналізувати вихідні дані, структура відповіді повинна дотримуватися вказівок у наступній таблиці.
Параметр | Тип даних | Обов'язковий | Докладні відомості |
---|---|---|---|
значення | Масив | Так | Список інсайтів (об’єктів), які визначені так, як описано в розділі Схема для інсайтів . |
hasMoreResults | Boolean | No | Значення, яке вказує, чи доступні додаткові результати. |
Схема для інсайтів
Ім'я | Тип/формат даних | Обов'язковий | Докладні відомості | Опис для додавання в дію |
---|---|---|---|---|
заголовок | String | Так | Назва картки цитування зі статистикою продажів. Він повинен включати тільки ім’я партнера і може мати до 20 символів. | Цей вивід вказує назву картки цитування для інсайту. |
опис | String | Так | Опис інсайту продажів. Він відображається як маркер на панелі "Ключова інформація про продажі" та може містити до 130 символів. Ось приклад :Валідація: Наступні кроки: Узгодження з часовими рамками та критеріями успіху. | Цей вихідний сигнал вказує на текст аналітичних даних, які мають бути включені в ключову інформацію про продаж. |
URL-адреса | String | No | Дійсна URL-адреса для відкриття статистики в партнерській програмі. | У цьому виводі вказується URL-адреса, за якою можна дізнатися більше про статистику. |
dateTime | DateTime | No | Дата та час проведення активності у форматі UTC. Якщо активність має час початку та завершення, програма має визначити, о котрій годині показувати. Формат відповідає OpenAPI специфікації. Ось приклад: 2017-07-21T17:32:28Z. | Цей вихід вказує на час, пов’язаний з інсайтом. |
Додаткові властивості | Об’єкт, який має значення Property Name та Property Value типу String | No | Набір пар ім’я-значення, які вказують на додаткові властивості пов’язаної статистики, яку повертає дія. Ця інформація відображається на спливаючій картці, коли користувачі вибирають статистику в області «Ключова інформація про продаж». | Цей вивід вказує додаткові властивості як пари ім’я-значення кожної пов’язаної статистики, що повертається дією. |
Приклад
{
"value": [
{
"title": "Contract signed",
"description": "Kenny Smith sent Renewal Contract on 04/23/2023 related to 50 Cafe A-100 Automatic",
"dateTime": "2023-09-07T03:42:35.4662309Z",
"url": https://contosohub.com,
"additionalProperties": {
"Contract name": "Renewal contract for Fourth Coffee",
"Signed by": "Alberto Burgos, Tony Benis",
"Signed": "9/7/23",
"Related Opportunity": "50 CafeA-100 Automatic"
}
}
],
"hasMoreResults": false
}
У прикладі на наступному зображенні показано, як вихідні дані API зіставляються з ключовою інформацією про продажі.
Легенда:
- Розділ, який показує статистику з партнерської програми. Назва розділу походить від назви Microsoft Power Platform з’єднувача.
- Опис інсайтів з відповіді API.
- Номери цитат, які можна вибрати для перегляду детальної інформації про статистику.
- Картка цитування, яка показує подробиці про статистику.
- Піктограма і назва інсайту. Піктограма отримується з Microsoft Power Platform метаданих сполучника. Заголовок — це заголовок інсайта з відповіді API.
- Додаткові властивості інсайту з відповіді API.
- Назва партнерської програми. Назву, яка відображається, є назвою Microsoft Power Platform з’єднувача.
- Посилання, яке можна вибрати для перегляду деталей інсайтів у партнерському додатку. Він базується на URL-адресі інсайта у відповіді API.
Пов’язані відомості
Переглядайте ключову інформацію про продажі в Copilot для продажів
Збагачуйте резюме електронною поштою інформацією з вашої програми
Збагачуйте чернетки електронних листів посиланнями на файли з вашої програми
Збагачуйте деталі запису CRM статистикою зі своєї програми
Збагачуйте зведення записів CRM статистикою зі своєї програми
Розширюйте Microsoft 365 Copilot для продажів за допомогою партнерських додатків
Створіть Copilot для розширень Sales