Compagnon d'appel

Le compagnon d'appel est une fonctionnalité Dialogflow CX qui améliore l'expérience client en fournissant une interface visuelle interactive supplémentaire sur les appareils mobiles des utilisateurs finaux lors des interactions vocales avec les agents virtuels Dialogflow CX. Cette interface permet l'échange d'informations et les interactions avec les utilisateurs finaux.

Pour Contact Center AI Platform (CCAI Platform), l'intégration d'agents virtuels à l'infrastructure de téléphonie/SVI existante permet à la plate-forme d'offrir des interactions client plus personnalisées. De plus, en tirant parti des fonctionnalités existantes sans session de SMS, toutes les communications sont gérées via une plate-forme unique.

Prérequis

Avant de pouvoir utiliser le service de compagnon d'appel avec CCAI Platform, vous devez remplir les conditions préalables suivantes :

  1. Une instance CCAI Platform provisionnée.

  2. Un agent virtuel Dialogflow CX intégré à une file d'attente de SVI dans l'instance CCAI Platform.

  3. La fonctionnalité SMS est activée pour un numéro de téléphone désigné associé à l'instance de la plate-forme CCAI, et qui n'est pas utilisé pour le chat par SMS.

Limites

  • La fonctionnalité SMS ne peut pas utiliser le même numéro de téléphone que le SVI, car elle emploie une API SMS sans session.

  • L'API SMS est désactivée par défaut et doit être activée. Il ne peut pas être activé via l'interface utilisateur de CCAI Platform. Une solution de contournement est décrite ici :

    1. Ouvrez le navigateur Web Chrome, puis connectez-vous au portail de la plate-forme CCAI en tant qu'utilisateur disposant du rôle d'administrateur.

    2. Ouvrez Chrome .

    3. Cliquez sur l'onglet Console, puis copiez et collez à l'invite.

      var xhttp = new XMLHttpRequest();
      xhttp.open("PATCH", "/v1/settings/sms", true);
      xhttp.setRequestHeader("X-UJET-XSRF-TOKEN", localStorage.getItem('xsrf-token'));
      xhttp.setRequestHeader("X-XSRF-TOKEN", localStorage.getItem('xsrf-token'));
      xhttp.setRequestHeader("Accept", "application/json, text/plain, */*");
      xhttp.setRequestHeader("Content-Type", "application/json;charset=UTF-8");
      xhttp.send(JSON.stringify({"sessionless": {"enabled": true, "auto_response_message": "This message couldn't be delivered because the sender does not support responses"}}));
    

Architecture

Le workflow sera structuré comme suit :

  • L'utilisateur final appelle la file d'attente de téléphonie/RVI.

  • Le système de téléphonie lance une requête de session à l'API Dialogflow.

  • Dialogflow CX lance une conversation.

  • Dialogflow CX crée une URL de compagnon d'appel et déclenche un webhook pour envoyer un SMS à l'utilisateur à l'aide de l'API SMS sans session CCAI Platform.

  • Le serveur SMS CCAI Platform envoie le message SMS à l'utilisateur.

  • L'utilisateur final ouvre l'interface utilisateur Web du complément d'appel à l'aide de l'URL présente dans le SMS.

  • L'utilisateur final peut désormais interagir à l'aide du canal vocal ou de l'écran, en tirant parti de l'API Call Companion.

Configuration

Cette section décrit la procédure à suivre pour activer le service d'assistance téléphonique.

Activer les paramètres de données

Les paramètres de données seront utilisés pour transmettre les informations nécessaires de la plate-forme CCAI à l'agent virtuel Dialogflow CX.

  1. Accédez au portail CCAI Platform pour l'instance.

  2. Accédez à Paramètres > File d'attente.

  3. Cliquez sur Modifier/Afficher la file d'attente du SVI.

  4. Dans la file d'attente du SVI, recherchez celle à laquelle l'agent virtuel est attribué, puis cliquez sur Modifier les attributions d'agent virtuel.

  5. Vous pouvez ajouter des paramètres dans Transmettre des paramètres de données.

    1. Cliquez sur Ajouter un paramètre.

    2. Ajoutez les paramètres suivants :

Nom du paramètre Description Dynamique ou fixe Valeur
ccTo Numéro de téléphone auquel envoyer le SMS Dynamique Métadonnées de session : ANI
ccFrom Numéro de téléphone à partir duquel envoyer des SMS Fixe +13211231212
ccaipHost Nom d'hôte de votre plate-forme CCAI (sans https:// ni / à la fin) Fixe myccaip.uc1.ccaiplatform.com
projectID ID du projet Google Cloud dans lequel réside votre agent virtuel DF Fixe my-gcp-project

Créer des identifiants d'API

Pour pouvoir envoyer des SMS sortants à l'aide de l'API sans session de la plate-forme CCAI, vous devez suivre les étapes suivantes :

  1. Accédez au portail CCAI Platform pour l'instance.

  2. Accédez à Paramètres > Paramètres pour les développeurs.

  3. Accédez à la section Identifiants de l'API.

  4. Cliquez sur Ajouter des identifiants API.

  5. Attribuez un nom à ces identifiants d'API, par exemple SMS sans session. Un jeton d'API est généré et affiché.

  6. Copiez ce jeton d'API.

Configurer un webhook dans un agent virtuel Dialogflow CX

Les étapes suivantes vous permettront de configurer un webhook dans Dialogflow CX. Cela est nécessaire pour pouvoir envoyer des SMS sortants à l'aide de l'API SMS sans session de la plate-forme CCAI.

  1. Accédez à l'agent virtuel Dialogflow CX.

  2. Sélectionnez le projet Google Cloud dans la liste déroulante en haut de la page.

  3. Dans votre projet Google Cloud , sélectionnez votre agent virtuel Dialogflow CX.

  4. Dans l'onglet Gérer, vous trouverez l'option de section Webhooks.

  5. Cliquez sur Créer.

  6. Indiquez un nom à afficher pour le webhook, par exemple Send SMS (Envoyer un SMS).

  7. Définissez l'URL du webhook sur la valeur suivante :

    https://$session.params.ccaipHost/apps/api/v1/sessionless_sms

  8. Sélectionnez Flexible comme Sous-type.

  9. Sélectionnez Post comme méthode.

  10. Dans le corps de la requête, fournissez les informations suivantes :

    {
      "from_phone": "$session.params.ccFrom",
      "to_phones": [
        "$session.params.ccTo"
      ],
      "messages": [
        "Hello from Google Call Companion! To interact with the call visually click here g.co/cloud/df-callcompanion#$session.params.projectID%2Fglobal%2F$request.session-id&$session.params.call-companion-auth-code  Text STOP to stop all SMS."
      ]
    }
    
  11. Pour l'authentification Basic Auth, indiquez la première partie du nom d'hôte CCAI Platform. Par exemple, si l'hôte de votre instance CCAI Platform est myccaip-abc123.uc1.ccaiplatform.com, indiquez myccaip-abc123 comme nom d'utilisateur.

  12. Transmettez l'identifiant API que vous avez créé lors de l'étape précédente en tant que mot de passe.

  13. Cliquez sur le bouton Enregistrer en haut de la page.

Activer le webhook dans le flux de l'agent virtuel

Maintenant que le webhook a été créé dans l'agent virtuel à partir des étapes précédentes, modifiez l'agent virtuel pour qu'il utilise ce webhook au moment choisi de la conversation avec l'utilisateur final.

Certains clients choisissent d'envoyer ce message SMS au début de la session, lorsque l'utilisateur se connecte pour la première fois, tandis que d'autres choisissent de ne l'envoyer que pour certaines parties de la conversation ou de certains flux.

  1. Dans l'agent virtuel Dialogflow CX, accédez au flux de conversation sous Créer.

  2. Cliquez sur Routes sur la page.

  3. Sélectionnez un itinéraire pour afficher sa configuration.

  4. Accédez à la section Parameter presets (Préréglages des paramètres).

  5. Ajoutez un paramètre prédéfini avec le nom de paramètre call-companion-auth-code et la valeur $sys.func.URL_ENCODE($session.params.call-companion-auth-code). La fonction système Dialogflow CX $sys.func.URL_ENCODE encode l'URL du code d'authentification du complément d'appel, car elle peut contenir des valeurs qui doivent être encodées.

  6. Accédez à la section Webhook.

  7. Activez Webhook et sélectionnez le webhook créé pour l'envoi du SMS.

  8. Spécifiez le tag de traitement.

  9. Cliquez sur le bouton Enregistrer en haut de l'écran.

Activer l'assistant d'appel dans le profil de conversation

Pour que Dialogflow CX soit activé pour l'assistance Companion d'appel, il est nécessaire d'activer ce service dans le profil conversationnel.

  1. Dans l'agent virtuel Dialogflow CX, accédez à Ressources partagées, puis au profil de conversation.

  2. Sélectionnez l'agent virtuel.

  3. Activez l'option Assistant d'appel, puis cliquez sur le bouton Enregistrer.

Tester l'application associée pour les appels

Pour tester le complément d'appel, passez un appel vocal dans la file d'attente Contact Center AI Platform avec l'agent virtuel attribué.

Lorsque la conversation atteint le point où vous appelez le webhook, vous devriez recevoir le message SMS. À partir du contenu du SMS, vous pouvez ouvrir l'URL qui ouvrira l'interface utilisateur de l'assistant d'appel. Vous pourrez alors voir la conversation et interagir avec l'appel en cours. Vous pouvez interagir comme pour un appel vocal normal ou par chat.

Utiliser du contenu enrichi

L'interface du mode Compagnon pour les appels utilise Dialogflow CX Messenger. Cela permet de fournir du contenu enrichi, y compris des boutons.