Wzbogacanie podsumowania rekordów CRM dzięki szczegółowym informacjom z aplikacji użytkownika (wersja zapoznawcza)
Ważne
- Jest to gotowa do produkcji funkcja w wersji zapoznawczej.
- Gotowe do produkcji wersje zapoznawcze podlegają dodatkowym warunkom użytkowania.
[Ten artykuł stanowi wstępną wersję dokumentacji i może ulec zmianie.]
Aby lepiej zrozumieć kontekst spotkania, do którego się przygotowują, lub wiadomości e-mail, którą czytają, sprzedawcy potrzebują odpowiednich informacji dotyczących zarządzania relacjami z klientami (CRM), takich jak zapytania, wątpliwości i uwagi klientów. Aplikacja Copilot dla działów sprzedaży wykorzystuje sztuczną inteligencję do generowania podsumowania każdego rekordu CRM. To podsumowanie podkreśla kluczowe szczegóły, takie jak etap sprzedaży, budżet i przewidywana data zamknięcia. Funkcje podsumowania rekordów CRM dostarczane przez Copilot dla działów sprzedaży ze szczegółowymi informacjami można rozszerzyć za pomocą posiadanych aplikacji.
Opis modelu API
Do akcji należy dodać następujący opis interfejsu API. W ten sposób Copilot dla działów sprzedaży może zidentyfikować poprawny interfejs API, który musi zostać wywołany w celu wzbogacenia tej funkcji.
Ta akcja powoduje pobranie dodatkowych informacji o sprzedaży związanych z rekordem CRM, które będą wyświetlane na karcie podsumowania rekordu C4S. Akcja wzmacnia dotychczasowe funkcje Copilot dla działów sprzedaży.
Parametry wejściowe
Copilot dla działów sprzedaży został zaprojektowany w taki sposób, aby do interfejsów API dostarczał następujące parametry wejściowe.
| Nazwa/nazwisko | Typ danych / format | Wymagania | Details | Opis, który należy dodać w akcji |
|---|---|---|---|---|
| recordType | String | Tak | Typ encji lub obiektu w systemie CRM, dla którego są wymagane powiązane dane szczegółowe, takie jak działania. Wartość zawiera niezależną od języka unikatową nazwę jednostki lub typu obiektu, a nie nazwę wyświetlaną, którą można zlokalizować. Przykłady obejmują klienta i szansę sprzedaży. | Te dane wejściowe wskazują typ encji lub obiektu w systemie CRM, dla którego są wymagane informacje szczegółowe. |
| recordId | String | Tak | Identyfikator unikatowy rekordu CRM. | Te dane wejściowe wskazują unikatowy identyfikator rekordu CRM, dla których wymagane są szczegółowe informacje. |
| startDateTime | Ciąg w formacie daty i godziny | Nie. | Data i godzina rozpoczęcia wyszukiwania szczegółowych informacji. Format jest zgodny ze specyfikacją OpenAPI. Oto przykład: 2017-07-21T17:32:28Z. | Te dane wejściowe wskazują datę i czas rozpoczęcia wymaganych szczegółowych informacji. |
| endDateTime | Ciąg w formacie daty i godziny | Nie. | Data i godzina zakończenia wyszukiwania szczegółowych informacji. Format jest zgodny ze specyfikacją OpenAPI. Oto przykład: 2017-07-21T17:32:28Z. | Te dane wejściowe wskazują datę i czas zakończenia wymaganych szczegółowych informacji. |
| najpopularniejsze | Integer | Nie. | Liczba szczegółowych informacji do pobrania. | Te dane wejściowe wskazują liczbę szczegółowych informacji, które należy pobrać. |
| skip | Integer | Nie. | Liczba szczegółowych informacji do pominięcia. | Te dane wejściowe wskazują liczbę szczegółowych informacji, które należy pominąć. |
| crmType | String | Nie. | Prawidłowe wartości to Salesforce i Dynamics 365 | Te dane wejściowe wskazują typ systemu CRM, w którym istnieje rekord programu CRM, dla którego wymagane są szczegółowe informacje. |
| crmOrgUrl | String | Nie. | Nazwa hosta CRM organizacji, na przykład contoso.crm.dynamics.com. | Te dane wejściowe wskazują adres URL środowiska CRM, w którym istnieje rekord programu CRM, dla którego wymagane są szczegółowe informacje. |
Parametry wyjściowe
Copilot dla działów sprzedaży oczekuje, że otrzyma listę szczegółowych informacji (obiektów) z interfejsów API i oczekuje, że każdy wgląd będzie miał określone parametry. Aby zapewnić Copilot dla działów sprzedaży dane wyjściowe poprawnie, kluczowe znaczenie ma zgodność ze wskazówkami podanymi w poniższej tabeli.
| Parametr | Typ danych | Wymagania | Details |
|---|---|---|---|
| value | Tablica | Tak | Lista szczegółowych informacji (obiektów) zdefiniowanych zgodnie z opisem w sekcji Schemat szczegółowych informacji. |
| hasMoreResults | Wartość logiczna | Nie. | Wartość wskazująca, czy jest więcej dostępnych wyników. |
Schemat dla szczegółowych informacji
| Nazwa/nazwisko | Typ danych / format | Wymagania | Details | Opis, który należy dodać w akcji |
|---|---|---|---|---|
| title | String | Tak | Tytuł szczegółowych informacji na karcie odwołania. Jest to tytuł w języku naturalnym dla szczegółowych informacji w języku określonym w nagłówku żądania Accept-Language. Oto przykład: Umowa podpisana. |
Te dane wyjściowe wskazują tytuł działania na karcie odwołania. |
| description | String | Tak | Opis szczegółowych informacji. Jest on wyświetlany jako wypunktowanie w podsumowaniu rekordu i jest opisem szczegółowych informacji w języku naturalnym w języku określonym w nagłówku Accept-Language. Oto przykład: Kenny, Logan i dwie inne osoby podpisały odnowienie umowy z Contoso 2023 w dniu 07.09.2023 r. |
Te dane wyjściowe wskazują opis szczegółowych informacji. |
| dateTime | Ciąg w formacie daty i godziny | Tak | Data i godzina aktywności w tej lokalizacji w formacie UTC. Jeśli działanie ma zarówno godzinę rozpoczęcia, jak i godzinę zakończenia, aplikacja musi określić, która godzina ma być wyświetlana. Format jest zgodny ze specyfikacją OpenAPI. Oto przykład: 2017-07-21T17:32:28Z. | Te dane wyjściowe oznaczają czas skojarzony ze szczegółowymi informacjami. |
| adres URL | String | Nie. | Prawidłowy adres URL w celu otwarcia działania w aplikacji partnera. | Te dane wyjściowe wskazują adres URL w celu otwarcia szczegółowych informacji. |
| additionalProperties | Obiekt, który ma wartości Nazwa właściwości i Wartość właściwości typu Ciąg znaków | Nie. | Dodatkowe właściwości, które są wyświetlane w widoku szczegółowym. Nazwy i wartości właściwości są w języku naturalnym w języku określonym w nagłówku { |
Te dane wyjściowe wskazują dodatkowe właściwości wyświetlane w szczegółowym widoku analizy. |
Notatka
Choć wymagania interfejsu API dotyczące rozszerzania funkcji podsumowania wiadomości e-mail i podsumowania rekordów mogą wyglądać podobnie, muszą zostać dodane jako oddzielne akcje w łączniku.
Przykład
{
"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
}
Na poniższym obrazie przedstawiono przykład mapowania danych wyjściowych API na podsumowanie rekordu.
Legenda:
- Sekcja pokazująca szczegółowe informacje z aplikacji partnerskiej. Tytuł sekcji jest uzyskiwany z nazwy łącznika Microsoft Power Platform.
- Opisy (szczegółowych informacji) w odpowiedzi interfejsu API.
- Numery cytowań, które można wybrać, aby wyświetlić szczegóły szczegółowych informacjach.
- Karta odwołania przedstawiająca szczegóły szczegółowych informacji.
- Ikona i tytuł szczegółowych informacji. Ikona jest pobierana z metadanych łącznika Microsoft Power Platform. Tekst tytułu to tytuł szczegółowych informacji z odpowiedzi interfejsu API.
- Dodatkowe właściwości szczegółowych informacji z odpowiedzi interfejsu API.
- Nazwa aplikacji partnera. Wyświetlana nazwa jest nazwą łącznika Microsoft Power Platform.
- Łącze, które można wybrać, aby wyświetlić szczegóły szczegółowych informacji w aplikacji partnera. Jest ono oparte na adresie URL odpowiedzi interfejsu API.
Informacje pokrewne
Wyświetl podsumowanie rekordu
Dodawanie nowych możliwości pytań i odpowiedzi do czatu sprzedaży
Wzbogać podsumowanie wiadomości e-mail o szczegółowe informacje ze swojej aplikacji
Wzbogać kluczowe informacje o sprzedaży dzięki szczegółowym informacjom z aplikacji (wersja zapoznawcza)
Wzbogać szczegóły rekordów CRM dzięki szczegółowym informacjom z aplikacji
Rozszerzanie Microsoft 365 Copilot dla działów sprzedaży za pomocą aplikacji partnerskich
Tworzenie rozszerzeń Copilot dla działów sprzedaży (wersja zapoznawcza)