Utiliser l’API CCaaS_CreateProactiveVoiceDelivery

Vous pouvez utiliser l’API CCaaS_CreateProactiveVoiceDelivery pour lancer des appels vocaux sortants proactifs aux clients ou permettre aux derniers de planifier des rappels via le service d’engagement proactif.

Plusieurs API sont disponibles pour créer des livraisons proactives. Utilisez les conseils suivants pour choisir le bon :

  • CCaaS_CreateProactiveBulkDelivery : Utilisez cette API pour envoyer plusieurs enregistrements dans une seule requête (environ 15 000 enregistrements). Il ne supporte pas les appels de compte.
  • CCaaS_CreateProactiveDelivery : Cette API est la plus polyvalente. Il prend en compte toutes les fonctionnalités et canaux, ainsi que les appels de comptes (plusieurs contacts dans le cadre d’une même requête). Utilisez cette API pour la plupart des scénarios.
  • CCaaS_CreateSimpleProactiveDelivery : Cette version ne nécessite pas de nid JSON complexe et convient mieux aux surfaces comme Power Automate.
  • CCaaS_CreateProactiveVoiceDelivery : Cette API est une API vocale de première génération qui ne prend pas en charge les fonctionnalités plus récentes. Tant qu’il est supporté, migrez vers CCaaS_CreateProactiveDelivery pour les dernières fonctionnalités.
  • CCaaS_CreateProactiveSMSDelivery : Cette API est une API SMS de première génération qui ne prend pas en charge les fonctionnalités plus récentes. Tant qu’il est supporté, migrez vers CCaaS_CreateProactiveDelivery pour les dernières fonctionnalités.

Note

Cette API ne prend pas en charge des fonctionnalités d’engagement proactif comme les retentatives, les fenêtres de contact, la priorité personnalisée et la limitation de fréquence. Utilisez l’API CCaaS_CreateProactiveDelivery si vous souhaitez exploiter ces fonctionnalités.

Important

Si une organisation utilise l’API CCaaS_CreateProactiveVoiceDelivery pour lancer un appel vocal sortant, elle est responsable de la gestion du consentement, y compris de la mise à jour manuelle des listes de numéros de téléphone exclus pour définir les heures de silence pour le contact avec le client. Vérifiez que les conditions suivantes sont remplies :

  • Le consentement est obtenu avant que les clients ne soient contactés.
  • Les clients ne sont contactés que pendant les heures autorisées.

Prerequisites

  • Vous devez avoir le rôle d’agent omnicanal ou de superviseur omnicanal pour appeler cette API.
  • L’engagement proactif est configuré. En savoir plus dans Configurer l’engagement proactif.

Détails de la demande

  • URL : https://<orgurl>/api/data/v9.2/CCaaS_CreateProactiveVoiceDelivery
  • Méthode : POST
  • Version : 1.0
  • Opération OData : Action
  • Type OData : Non borné
  • Demande d’autorisation : Obligatoire. Doit contenir un jeton porteur Azure AD valide pour l’utilisateur effectuant l’appel API. Ce jeton doit être émis depuis le même locataire Azure AD que l’instance du Service Client.

En-têtes de demande

Key Type Description
ApiVersion String La version de l’API CCaaS.
ProactiveEngagementConfigId String ID de la configuration de l’engagement proactif à utiliser. Cela spécifie le type de mode de numérotation, le flux de travail et le profil sortant à utiliser. Pour obtenir cet ID, procédez comme suit :
  1. Allez dans Power Apps et sélectionnez l’environnement requis.
  2. Sélectionner les tables>Configuration proactive de l’engagement
  3. Sélectionnez l’ID de l’enregistrement requis.
NuméroDeTéléphoneDeDestination String Numéro de téléphone du client à appeler.
ContactId String ID du contact client dans Dynamics CRM.
Fenêtres Tableau JSON d’objets Window Spécifie les périodes valides pendant lesquelles l’appel sortant peut être passé. S’il n’est pas fourni, le système affiche par défaut une fenêtre de 24 heures commençant immédiatement (de l’heure actuelle à 24 heures plus tard).
InputAttributes Objet JSON de chaînes clé-valeur Optional. Variables pouvant être référencées dans les flux d’agents assistant Copilot pour personnaliser le comportement, piloter la logique conditionnelle ou récupérer des informations personnalisées à partir des enregistrements Dataverse.

Objet Windows

Key Type Description
Démarrer String Horodatage de début de cette fenêtre. Doit être spécifié en UTC dans le yyyy-MM-ddTHH:mm:ss.fffZ format.
Terminer String Horodatage de fin de cette fenêtre. Doit être spécifié en UTC dans le yyyy-MM-ddTHH:mm:ss.fffZ format.

Important

Certains clients nécessitent un format spécifique comme "Windows": "[{\"Start\":\"2025-01-30T16:32:45.930Z\",\"End\":\"2025-06-25T16:32:45.930Z\"}]". Nous vous recommandons de tester en conséquence.

Exemple de requête

{
  "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"
  }
}

Détails de la réponse

Si elle réussit, cette méthode retourne DeliveryId. L’ID de diffusion est un identificateur unique attribué à chaque demande d’engagement proactif qui est acceptée via l’API et stocké dans la table msdyn_proactive_delivery.

L’exemple de réponse est le suivant :

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

Utiliser des tableaux d’engagement proactif pour la création de rapports

  • Dernière mise à jour :