Korzystanie z interfejsu API CCaaS_CreateProactiveVoiceDelivery

Za pomocą CCaaS_CreateProactiveVoiceDelivery interfejsu API można inicjować proaktywne wychodzące połączenia głosowe z klientami lub zezwalać klientom na planowanie wywołań zwrotnych za pośrednictwem usługi proaktywnego zaangażowania.

Wymagania wstępne

• Aby wywołać ten interfejs API, musisz mieć rolę Agent obsługi wielokanałowej lub Opiekun obsługi wielokanałowej.
• Skonfigurowano proaktywne zaangażowanie. Dowiedz się więcej w Konfiguruj proaktywne zaangażowanie.

Inicjowanie proaktywnych połączeń wychodzących

Proaktywne zaangażowanie umożliwia organizacjom usprawnienie interakcji z klientami poprzez inicjowanie komunikacji wychodzącej za pośrednictwem kanału głosowego. Proaktywne zaangażowanie można skonfigurować przy użyciu procesu pozyskiwania klientów Customer Insights lub .CCaaS_CreateProactiveVoiceDelivery

Interfejs CCaaS_CreateProactiveVoiceDelivery API umożliwia organizacjom inicjowanie proaktywnych wychodzących połączeń głosowych z klientami za pośrednictwem usługi proaktywnego zaangażowania. Interfejs API wyzwala wychodzące połączenia głosowe za pośrednictwem systemu Voice Runtime. Połączenia są nawiązywane zgodnie ze skonfigurowanym trybem wybierania numerów natychmiast (jeśli nie określono żadnych okien czasowych) lub w wyznaczonych oknach czasowych określonych przez użytkownika.

Ten interfejs API umożliwia centrom kontaktowym docieranie do klientów we właściwym czasie z odpowiednimi informacjami, przypomnieniami lub powiadomieniami, poprawiając jakość obsługi klienta przy jednoczesnej optymalizacji wydajności operacyjnej.

Szczegóły żądania

• Adres URL:https://<orgurl>/api/data/v9.2/CCaaS_CreateProactiveVoiceDelivery
• , metoda: POST
• Wersja: 1.0
• Operacja OData: Akcja
• Typ OData: Niepowiązany
• Poproś o autoryzację: wymagane. Musi zawierać prawidłowy token okaziciela usługi Azure AD dla użytkownika wykonującego wywołanie interfejsu API. Ten token musi być wystawiony z tej samej dzierżawy usługi Azure AD co wystąpienie Customer Service.

Nagłówki zapytań

Obiekt systemu Windows

Przykładowe żądanie

{
  "ApiVersion": "1.0",
  "ProactiveEngagementConfigId": "cbbac510-3e66-ef11-a671-6045bd03d9d8",
  "DestinationPhoneNumber": "+123456798",
  "ContactId": "761e062f-c734-ef11-8e4f-00224808a166",
  "Windows": [
    {
      "Start": "2024-09-10T13:00:00.000Z",
      "End": "2024-09-10T15:59:59.999Z"
    },
    {
      "Start": "2024-09-11T13:00:00.000Z",
      "End": "2024-09-11T15:59:59.999Z"
    }
  ],
  "InputAttributes": {
    "orderNumber": "ORD123456789",
    "type": "callback",
    "isFinalAttempt": "false"
  }
}

Szczegóły odpowiedzi

Jeśli to się powiedzie, ta metoda zwróci wartość DeliveryId. Identyfikator dostawy to unikatowy identyfikator przypisywany do każdego żądania proaktywnego zaangażowania, które jest akceptowane przez interfejs API i przechowywane w tabeli msdyn_proactive_delivery.

Przykładowa odpowiedź jest następująca:

{
	"@odata.context": "[Organization URI]api/data/v9.2/$metadata#Microsoft.Dynamics.CRM.CCaaS_CreateProactiveVoiceDeliveryResponse",
	"DeliveryId": "9838deee-0b4e-4116-bf73-ecb80474568d"
}

Zaplanuj oddzwanianie z dowolnej platformy

Za pomocą rozwiązania Proactive Engagement możesz zaplanować oddzwanianie z różnych platform, w tym z Internetu, aplikacji mobilnych, agentów głosowych i czatu. Można to zrobić w następujący sposób:

• Utwórz przepływ Power Automate na podstawie agenta Copilot Studio.
• Zintegruj interfejs API zaplanuj wywołanie zwrotne ze swoją witryną.

Tworzenie przepływu Power Automate na podstawie agenta Copilot

Możesz utworzyć przepływ Power Automate z agenta Copilot, aby zaplanować wywołania zwrotne. Wykonaj następujące kroki:

1. Wykonaj kroki opisane w temacie Tworzenie przepływu, którego można użyć z agentem o następujących parametrach:

• Określ Wykonaj akcję niepowiązaną jako akcję.
• Wybierz CCaaS_CreateProactiveVoiceDelivery jako nazwę akcji.
• W polu Parametry zaawansowane określ następujące pola obowiązkowe:
  • Item/DestinationPhoneNumber: numer telefonu klienta, do którego należy zadzwonić.
  • Item/ProactiveEngagementConfigId: identyfikator konfiguracji proaktywnego zaangażowania do użycia. Wskazuje typ trybu wybierania numerów, strumień pracy i profil ruchu wychodzącego, które mają być używane podczas kontaktowania się z klientem. Ten identyfikator można skopiować z tabeli> w tabelach PowerApps>.
  • Pozycja/ApiVersion: 1.0
  • Item/ContactId: Identyfikator kontaktu klienta w programie Dynamics CRM.
  • Opcjonalnie można określić atrybuty Item/InputAttributes. To pole powinno zawierać obiekt JSON, który jest używany przez agenta Copilot. Na przykład { "msdyn_CaseTitle" : "Vitre cassée", "msdyn_CustomerName" : "Sarah", "msdyn_CustomerPhone" : "+1234567890", "msdyn_CustomerId" : "cfaa617b-2fc1-ef11-b8e8-000d3a5bcd16" }.

Planowanie wywołań zwrotnych za pomocą interfejsu API

Zintegruj CCaaS_CreateProactiveVoiceDelivery API ze swoją stroną internetową, aby umożliwić klientom zwrócenie się o pomoc w najdogodniejszym dla nich czasie.

Przykładowe żądanie

{
  "ApiVersion": "1.0",
  "ProactiveEngagementConfigId": "cbbac510-3e66-ef11-a671-6045bd03d9d8",
  "DestinationPhoneNumber": "+123456798",
  "ContactId": "761e062f-c734-ef11-8e4f-00224808a166",
  "Windows": [
    {
      "Start": "2024-09-10T13:00:00.000Z",
      "End": "2024-09-10T15:59:59.999Z"
    },
    {
      "Start": "2024-09-11T13:00:00.000Z",
      "End": "2024-09-11T15:59:59.999Z"
    }
  ],
  "InputAttributes": {
     "type": "callback"
    "isLastAttempt": "false"
  }
}

CCaaS_CreateOperation

Zawieszenie, wznowienie i anulowanie.

Status wdrożenia: W trakcie rozwoju

Klucze żądań HTTP

Przykładowy ładunek

{ 
  "ApiVersion": "1.0", 
  "ProactiveEngagementConfigId": "47089bbe-deb7-ef11-b8e6-000d3a36a6b3", 
  "Operation ": "Resume"
}

Status odpowiedzi HTTP

Informacje pokrewne

Używanie tabel proaktywnego zaangażowania do raportowania