{
    "userId": "{{user_id}}",
    "message": {
        "attachment": {
                "clientAttachmentId": "{{request_id}}",
                "contentType": "video/mp4",
                "fileName": "sample.mp4",
                "url": "https://sample-videos.com/video123/mp4/720/big_buck_bunny_720p_1mb.mp4",
                "headers": {
                    "header 1": "value 1"
                }
            },
        "text": "along with text",
        "typed": true
    }
}

1. Chargez le fichier à l’aide de l’API multimédia. Pour plus d'informations, consultez CCCIF Media Resource API.
   L’API média renvoie une URL. Voici un exemple de réponse :

   {
     "result": {
       "mediaUrl": "<instance>/api/now/v1/cs/media/JOBBfkqSq6kDiFzxyinvHhke73O4TZ0j",
       "name": "image.png",
       "state": "available",
       "attachmentId": "e8671b9193209210a755b8e86cba104b"
     }
   }

2. Utilisez l’URL du média dans API Agent virtuel la demande. Voici un exemple JSON :

   {
     "userId": "user123",
     "message": {
       "attachment": {
         "contentType": "image/png",
         "fileName": "image.png",
         "url": "<instance>/api/now/v1/cs/media/JOBBfkqSq6kDiFzxyinvHhke73O4TZ0j"
       },
       "text": "Here is the image",
       "typed": true
     }
   }

1. Utilisez l’URL du fichier dans la API Agent virtuel demande.
   • URL de fichier direct :

     {
       "userId": "user123",
       "message": {
         "attachment": {
           "contentType": "application/pdf",
           "fileName": "report.pdf",
           "url": "https://publicserver.com/files/report.pdf"
         },
         "text": "Document attached",
         "typed": true
       }
     }

   • URL de fichier protégé :

     {
       "userId": "user123",
       "message": {
         "attachment": {
           "contentType": "application/pdf",
           "fileName": "confidential.pdf",
           "url": "https://secureserver.com/files/confidential.pdf",
           "headers": {
             "Authorization": "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
             "X-Custom-Header": "custom-value"
           }
         },
         "text": "Secure document attached",
         "typed": true
       }
     }

2. Utilisation de l’API média (comme suit en mode synchrone).

1. L’authentification du message est obligatoire.
   • Sans authentification de message dans sys_cs_provider_application, la liaison utilisateur ne fonctionne pas.
   • Vous devez configurer correctement l’authentification du message. (Voir la section sur l’authentification.)
2. Champs de demande requis.
   • userId doit être présent et unique.
   • emailId doit être présent et valide.

• L’enregistrement existe dans la table sys_user .
• Le champ E-mail correspond exactement.
• L’utilisateur est actif. (actif = vrai)
• L’utilisateur n’est pas verrouillé. (locked_out=faux)
• Un seul enregistrement utilisateur correspond à ces conditions.

1. Vérifiez la configuration du fournisseur.
   • Accédez à la table sys_cs_provider et ouvrez l’enregistrement « VA bot to bot provider ».

   • Tableau 3. Paramètre requis

     Champ	Valeur attendue
     automatic_link_enabled	VRAI
     automatic_link_action	sn_va_as_service.agent_virtuel__bot_à_bot_auto_link_account
     link_account_enabled	VRAI

2. Vérifiez la carte utilisateur du fournisseur.
   • Accédez à la table provider_user_map .
   • Filtrer par : active=false ET channel_user_id={userId de la demande}.
   • Problème : si l’enregistrement existe avec active=false, l’utilisateur ne peut pas être lié automatiquement.
   • Solution : l’administrateur doit supprimer manuellement l’enregistrement inactif et réessayer la demande de liaison.
3. Recherchez les personnalisations.
   • Vérifiez les personnalisations en exécutant le script sn_va_as_service.virtual_agent__bot_to_bot_auto_link_account .
   • Vérifiez les problèmes de personnalisation courants :
     • Logique empêchant la liaison automatique
     • Contrôles de validation supplémentaires
     • Mappages de champs modifiés