API de récapitulatif

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 35 minutes de lecture
  • L’API Wrap Up fournit des points de terminaison pour la gestion de la fonctionnalité de récapitulatif pour les systèmes ou les espaces de travail CCaaS (Contact Center as a Service) externesServiceNow AI Platform.

    Cette API nécessite le module d’extension Gestion des interactions (com.glide.interaction). Pour appeler cette API, vous devez disposer du rôle interaction_integration_user.

    Lorsque les agents ferment une interaction, la fonctionnalité de récapitulatif leur permet de saisir les détails de clôture et les codes de récapitulatif pour référence ultérieure. Pour plus d’informations sur la fonctionnalité de récapitulatif, reportez-vous à la section Wrap up overview.

    Pour utiliser l’API Wrap Up pour le récapitulatif segmenté des interactions à partir de systèmes externes, vous devez implémenter le point d’extension scripté InteractionSegment pour créer et récupérer des enregistrements de segments dans la table choisie. Si vous utilisez OpenFrame, le point d’extension dispose d’une implémentation existante pour créer et récupérer des enregistrements de segments dans la table Journal téléphonique [sn_openframe_phone_log].

    Récapitulatif : GET /now/wrapup/code/{code_id}

    Récupère les détails d’un code de récapitulatif spécifié.

    Format d'URL

    URL versionnée : /api/now/{api_version}/wrapup/code/{code_id}

    URL par défaut : /api/now/wrapup/code/{code_id}

    Paramètres de demande pris en charge

    Tableau 1. Paramètres de chemin d'accès
    Nom Description
    api_version Facultatif. Version du point de terminaison auquel accéder. Par exemple, v1 ou v2. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière.

    Type de données : chaîne

    code_id Sys_id du code de récapitulatif.

    Type de données : chaîne

    Table : Code récapitulatif de l’interaction [interaction_wrap_up_code]

    Tableau 2. Paramètres de requête
    Nom Description
    Aucun
    Tableau 3. Paramètres de corps de demande (XML ou JSON)
    Nom Description
    Aucun

    En-têtes

    Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

    Tableau 4. En-têtes de demandes
    En-tête Description
    Accepter Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml.

    Valeur par défaut : application/json

    Tableau 5. En-têtes de réponses
    En-tête Description
    Aucun

    Codes d'état

    Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

    Tableau 6. Codes d'état
    Code d'état Description
    200 Réussi. La demande a été correctement traitée.
    400 Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté.
    401 Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises.
    500 Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur.

    Paramètres du corps de la réponse (JSON ou XML)

    Nom Description
    résultat Objet contenant des informations sur la demande d’API et le code de récapitulatif.

    Type de données : objet

    "result": {
       "message": "String",
       "resultMap": {Object},
       "success": Boolean
    }
    résultat.message Message qui décrit le résultat de la demande d’API.

    Type de données : chaîne

    result.result_map Objet contenant le code de récapitulatif.

    Type de données : objet

    "result_map": {
       "wrap_up_code": {Object}
    }
    result.result_map.wrap_up_code Objet contenant des détails sur le code de récapitulatif.

    Type de données : objet

    "wrap_up_code": {
       "active": Boolean,
       "code": "String",
       "description": "String",
       "external": Boolean,
       "sys_id": "String",
       "translated_code": "String",
       "translated_description": "String"
    }
    result.result_map.wrap_up_code.active Marqueur indiquant si le code de récapitulatif est actif.
    Valeurs valides :
    • true : le code de récapitulatif est actif.
    • false : le code de récapitulatif n’est pas actif.

    Type de données : booléennes

    Par défaut : true

    result.result_map.wrap_up_code.code Étiquette du code de récapitulatif.

    Type de données : chaîne

    result.result_map.wrap_up_code.description Description du code de récapitulatif.

    Type de données : chaîne

    result.result_map.wrap_up_code.external Marqueur indiquant si le code de récapitulatif provient d’un système externe.
    Valeurs valides :
    • true : le code de récapitulatif provient d’un système externe.
    • false : le code de récapitulatif est interne.

    Type de données : booléennes

    result.result_map.wrap_up_code.sys_id Sys_id du code de récapitulatif.

    Type de données : chaîne

    Table : Code récapitulatif de l’interaction [interaction_wrap_up_code]

    result.result_map.wrap_up_code.translated_code Traduction de l’étiquette du code de récapitulatif.

    Type de données : chaîne

    result.result_map.code_wrap_up.translated_description Traduction de la description du code de récapitulatif.

    Type de données : chaîne

    Résultat.Réussite Marqueur indiquant si la demande d’API a été traitée avec succès.
    Valeurs valides :
    • vrai : la demande d’API a réussi.
    • faux : la demande d’API a échoué.

    Type de données : booléennes

    Demande cURL

    Cet exemple récupère les détails d’un code de récapitulatif spécifié.

    curl "https://instance.service-now.com/api/now/v1/wrapup/code/49c27b679f201210c89656effa0a1cd7" \
    --request GET \
    --header "Accept:application/json" \
    --user 'username':'password'

    Corps de la réponse.

    {
      "result": {
        "message": "Wrap up code found.",
        "result_map": {
          "wrap_up_code": {
            "code": "Billing Issue",
            "description": "A code for billing issues",
            "active": true,
            "external": true,
            "sys_id": "49c27b679f201210c89656effa0a1cd7",
            "translated_code": "Abrechnungsproblem",
            "translated_description": "Ein code für Abrechnungsprobleme"
          }
        },
        "success": true
      }
    }

    Récapitulatif : GET /now/wrapup/segment/{segment_id}

    Récupère les détails d’un segment de récapitulatif spécifié.

    Format d'URL

    URL versionnée : /api/now/{api_version}/wrapup/segment/{segment_id}

    URL par défaut : /api/now/wrapup/segment/{segment_id}

    Paramètres de demande pris en charge

    Tableau 7. Paramètres de chemin d'accès
    Nom Description
    api_version Facultatif. Version du point de terminaison auquel accéder. Par exemple, v1 ou v2. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière.

    Type de données : chaîne

    segment_id Sys_id du segment de récapitulatif dans la table Segment de récapitulatif d’interaction [interaction_wrap_up_segment], ou identificateur représentant le segment d’interaction sur le système externe.

    Type de données : chaîne

    Tableau 8. Paramètres de requête
    Nom Description
    Aucun
    Tableau 9. Paramètres de corps de demande (XML ou JSON)
    Nom Description
    Aucun

    En-têtes

    Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

    Tableau 10. En-têtes de demandes
    En-tête Description
    Accepter Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml.

    Valeur par défaut : application/json

    Tableau 11. En-têtes de réponses
    En-tête Description
    Aucun

    Codes d'état

    Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

    Tableau 12. Codes d'état
    Code d'état Description
    200 Réussi. La demande a été correctement traitée.
    400 Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté.
    401 Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises.
    500 Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur.

    Paramètres du corps de la réponse (JSON ou XML)

    Nom Description
    message Message qui décrit le résultat de la demande d’API.

    Type de données : chaîne

    segment Objet contenant des données sur le segment d’interaction et de récapitulatif.

    Type de données : objet

    "segment": {
      "agent": "String",
      "awaiting_confirmation": Boolean,
      "confirmed_on": "String",
      "external": Boolean,
      "interaction": "String",
      "opened_on": "String",
      "segmented": Boolean,
      "segment_id": "String",
      "segment_table": "String",
      "state": "String",
      "submitted_on": "String",
      "sys_id": "String",
      "wrap_up_configuration": {Object} 
    }
    segment.agent Sys_id de l’agent affecté à l’interaction.

    Type de données : chaîne

    Table : Utilisateur [sys_user]

    segment.awaiting_confirmation Marqueur indiquant si le segment de récapitulatif soumis par l’agent est en attente de confirmation qu’il a été traité par le système CCaaS externe.
    Valeurs valides :
    • vrai : le segment de récapitulatif est en attente de confirmation.
    • false : le segment de récapitulatif a été traité par le système externe.

    Type de données : booléennes

    segment.confirmed_on Date et heure auxquelles le segment de récapitulatif soumis est traité dans le système CCaaS externe.

    Type de données : chaîne

    Segment.Externe Marqueur indiquant si le segment d’interaction provient d’un système externe.
    Valeurs valides :
    • vrai : le segment d’interaction provient d’un système externe.
    • faux : le segment d’interaction est interne.

    Type de données : booléennes

    Valeur par défaut : false

    segment.interaction Sys_id de l’interaction.

    Type de données : chaîne

    Table : Interaction [interaction]

    segment.opened_on Date et heure de début de la période de récapitulatif en fonction du système externe.

    Type de données : chaîne

    Segment.Segmenté Marqueur indiquant si le récapitulatif est segmenté.
    Valeurs valides :
    • true : le récapitulatif est segmenté en plusieurs parties.
    • faux : Le récapitulatif est un segment complet.

    Type de données : booléennes

    Valeur par défaut : false

    segment.segment_id Sys_id du segment d’interaction.

    Type de données : chaîne

    segment.segment_table Nom de la table contenant le segment d’interaction.

    Type de données : chaîne

    segment.état État du segment d’interaction.

    Type de données : chaîne

    segment.submitted_on Date et heure auxquelles l’agent a soumis le segment de récapitulatif.

    Type de données : chaîne

    segment.sys_id Sys_id du segment de récapitulatif.

    Type de données : chaîne

    Table : segment récapitulatif de l’interaction [interaction_wrap_up_segment]

    segment.wrap_up_configuration Objet contenant des détails sur la configuration de récapitulatif utilisée pour le segment de récapitulatif.

    Type de données : objet

    "wrap_up_configuration": {  
      "allowed_codes": [Array],
      "default_code": {Object},
      "enable_codes": Boolean
    }
    segment.wrap_up_configuration.allowed_codes Tableau d’objets représentant chacun un code de récapitulatif que l’agent est autorisé à utiliser.

    Type de données : tableau

    "allowed_codes": [
      {
        "active": Boolean, 
        "code": "String",
        "description": "String",
        "external": Boolean,
        "sys_id": "String",
        "translated_code": "String",
        "translated_description": "String"
      }
    ]
    segment.wrap_up_configuration.allowed_codes.active Marqueur indiquant si le code de récapitulatif est actif.
    Valeurs valides :
    • true : le code de récapitulatif est actif.
    • false : le code de récapitulatif n’est pas actif.

    Type de données : booléennes

    Par défaut : true

    segment.wrap_up_configuration.allowed_codes.code Étiquette du code de récapitulatif.

    Type de données : chaîne

    segment.wrap_up_configuration.codes_autorisés.description Description du code de récapitulatif.

    Type de données : chaîne

    segment.wrap_up_configuration.codes_autorisés.externe Marqueur indiquant si le code de récapitulatif provient d’un système externe.
    Valeurs valides :
    • true : le code de récapitulatif provient d’un système externe.
    • false : le code de récapitulatif est interne.

    Type de données : booléennes

    segment.wrap_up_configuration.allowed_codes.sys_id Sys_id du code de récapitulatif.

    Type de données : chaîne

    Table : Code récapitulatif de l’interaction [interaction_wrap_up_code]

    segment.wrap_up_configuration.codes_autorisés.code_traduits Traduction de l’étiquette du code de récapitulatif.

    Type de données : chaîne

    segment.wrap_up_configuration.codes_autorisés.description_traduite Traduction de la description du code de récapitulatif.

    Type de données : chaîne

    segment.wrap_up_configuration.default_code Objet contenant le code de récapitulatif à utiliser par défaut.

    Type de données : objet

    "default_code": {
      "active": Boolean,
      "code": "String",
      "description": "String",
      "external": Boolean,
      "sys_id": "String",
      "translated_code": "String",
      "translated_description": "String"
    }
    segment.wrap_up_configuration.default_code.active Marqueur indiquant si le code de récapitulatif est actif.
    Valeurs valides :
    • true : le code de récapitulatif est actif.
    • false : le code de récapitulatif n’est pas actif.

    Type de données : booléennes

    Par défaut : true

    segment.wrap_up_configuration.code_default.code Étiquette du code de récapitulatif.

    Type de données : chaîne

    segment.wrap_up_configuration.default_code.description Description du code de récapitulatif.

    Type de données : chaîne

    segment.wrap_up_configuration.default_code.external Marqueur indiquant si le code de récapitulatif provient d’un système externe.
    Valeurs valides :
    • true : le code de récapitulatif provient d’un système externe.
    • false : le code de récapitulatif est interne.

    Type de données : booléennes

    segment.wrap_up_configuration.default_code.sys_id Sys_id du code de récapitulatif.

    Type de données : chaîne

    Table : Code récapitulatif de l’interaction [interaction_wrap_up_code]

    segment.wrap_up_configuration.code_default.translated_code Traduction de l’étiquette du code de récapitulatif.

    Type de données : chaîne

    segment.wrap_up_configuration.default_code.translated_description Traduction de la description du code de récapitulatif.

    Type de données : chaîne

    segment.wrap_up_configuration.enable_codes Marqueur indiquant si l’agent doit sélectionner un code de récapitulatif.
    Valeurs valides :
    • vrai : l’agent doit sélectionner un code de récapitulatif.
    • faux : l’agent n’est pas tenu de sélectionner un code de récapitulatif.

    Type de données : booléennes

    Valeur par défaut : false

    segment_id Sys_id du segment de récapitulatif.

    Type de données : chaîne

    Table : segment récapitulatif de l’interaction [interaction_wrap_up_segment]

    réussite Marqueur indiquant si la demande d’API a été traitée avec succès.
    Valeurs valides :
    • vrai : la demande d’API a réussi.
    • faux : la demande d’API a échoué.

    Type de données : booléennes

    Demande cURL

    Cet exemple récupère les détails d’un segment de récapitulatif spécifié.

    curl "https://instance.service-now.com/api/now/v1/wrapup/segment/dgajbcef12345678defdbxef123435678" \
    --request GET \
    --header "Accept:application/json" \
    --user 'username':'password'

    Corps de la réponse.

    {
      "success": true,
      "message": "Wrap up segment retrieved successfully.",
      "segment_id": "dgajbcef12345678defdbxef123435678",
      "segment": {
        "agent": "123412345678567890ab90abcdefcdef",
        "segment_table": "sn_openframe_phone_log",
        "segment_id": "dgajbcef12345678defdbxef123435678",
        "external": true,
        "interaction": "213412345678567890ab90abcdefcdef",
        "state": "closed",
        "wrap_up_configuration": {
          "enable_codes": true,
          "allowed_codes": [
            {
              "code": "Billing Issue",
              "description": "",
              "active": true,
              "external": true,
              "sys_id": "49c27b679f201210c89656effa0a1cd7",
              "translated_code": "Abrechnungsproblem",
              "translated_description": ""
            },
            {
              "code": "Store Issue",
              "description": "",
              "active": true,
              "external": true,
              "sys_id": "54327b679f201210c89656effa0a1cd7",
              "translated_code": " Einkaufsproblem",
              "translated_description": ""
            }
          ],
          "default_code": {
            "code": "Billing Issue",
            "description": "",
            "active": true,
            "external": true,
            "sys_id": "49c27b679f201210c89656effa0a1cd7",
            "translated_code": "Abrechnungsproblem",
            "translated_description": ""
          }
        },
        "segmented": true,
        "sys_id": "dgajbcef12345678defdbxef123435678",
        "opened_on": "2024-09-16 17:52:01",
        "submitted_on": "2024-09-16 18:51:59",
        "confirmed_on": "2024-09-16 18:52:01",
        "awaiting_confirmation": false
      }
    }

    Récapitulatif : GET /now/wrapup/segment/agent/{agent_id}/interaction/{interaction_id}

    Récupère les détails d’un segment de récapitulatif en fonction d’un agent et d’une interaction spécifiés.

    Format d'URL

    URL versionnée : /api/now/{api_version}/wrapup/segment/agent/{agent_id}/interaction/{interaction_id}

    URL par défaut : /api/now/wrapup/segment/agent/{agent_id}/interaction/{interaction_id}

    Paramètres de demande pris en charge

    Tableau 13. Paramètres de chemin d'accès
    Nom Description
    api_version Facultatif. Version du point de terminaison auquel accéder. Par exemple, v1 ou v2. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière.

    Type de données : chaîne

    agent_id Sys_id de l’agent affecté à l’interaction.

    Type de données : chaîne

    Table : Utilisateur [sys_user]

    interaction_id Sys_id de l’interaction.

    Type de données : chaîne

    Table : Interaction [interaction]

    Tableau 14. Paramètres de requête
    Nom Description
    Aucun
    Tableau 15. Paramètres de corps de demande (XML ou JSON)
    Nom Description
    Aucun

    En-têtes

    Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

    Tableau 16. En-têtes de demandes
    En-tête Description
    Accepter Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml.

    Valeur par défaut : application/json

    Tableau 17. En-têtes de réponses
    En-tête Description
    Aucun

    Codes d'état

    Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

    Tableau 18. Codes d'état
    Code d'état Description
    200 Réussi. La demande a été correctement traitée.
    400 Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté.
    401 Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises.
    500 Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur.

    Paramètres du corps de la réponse (JSON ou XML)

    Nom Description
    message Message qui décrit le résultat de la demande d’API.

    Type de données : chaîne

    segment Objet contenant des données sur le segment d’interaction et de récapitulatif.

    Type de données : objet

    "segment": {
      "agent": "String",
      "awaiting_confirmation": Boolean,
      "confirmed_on": "String",
      "external": Boolean,
      "interaction": "String",
      "opened_on": "String",
      "segmented": Boolean,
      "segment_id": "String",
      "segment_table": "String",
      "state": "String",
      "submitted_on": "String",
      "sys_id": "String",
      "wrap_up_configuration": {Object} 
    }
    segment.agent Sys_id de l’agent affecté à l’interaction.

    Type de données : chaîne

    Table : Utilisateur [sys_user]

    segment.awaiting_confirmation Marqueur indiquant si le segment de récapitulatif soumis par l’agent est en attente de confirmation qu’il a été traité par le système CCaaS externe.
    Valeurs valides :
    • vrai : le segment de récapitulatif est en attente de confirmation.
    • false : le segment de récapitulatif a été traité par le système externe.

    Type de données : booléennes

    segment.confirmed_on Date et heure auxquelles le segment de récapitulatif soumis est traité dans le système CCaaS externe.

    Type de données : chaîne

    Segment.Externe Marqueur indiquant si le segment d’interaction provient d’un système externe.
    Valeurs valides :
    • vrai : le segment d’interaction provient d’un système externe.
    • faux : le segment d’interaction est interne.

    Type de données : booléennes

    Valeur par défaut : false

    segment.interaction Sys_id de l’interaction.

    Type de données : chaîne

    Table : Interaction [interaction]

    segment.opened_on Date et heure de début de la période de récapitulatif en fonction du système externe.

    Type de données : chaîne

    Segment.Segmenté Marqueur indiquant si le récapitulatif est segmenté.
    Valeurs valides :
    • true : le récapitulatif est segmenté en plusieurs parties.
    • faux : Le récapitulatif est un segment complet.

    Type de données : booléennes

    Valeur par défaut : false

    segment.segment_id Sys_id du segment d’interaction.

    Type de données : chaîne

    segment.segment_table Nom de la table contenant le segment d’interaction.

    Type de données : chaîne

    segment.état État du segment d’interaction.

    Type de données : chaîne

    segment.submitted_on Date et heure auxquelles l’agent a soumis le segment de récapitulatif.

    Type de données : chaîne

    segment.sys_id Sys_id du segment de récapitulatif.

    Type de données : chaîne

    Table : segment récapitulatif de l’interaction [interaction_wrap_up_segment]

    segment.wrap_up_configuration Objet contenant des détails sur la configuration de récapitulatif utilisée pour le segment de récapitulatif.

    Type de données : objet

    "wrap_up_configuration": {  
      "allowed_codes": [Array],
      "default_code": {Object},
      "enable_codes": Boolean
    }
    segment.wrap_up_configuration.allowed_codes Tableau d’objets représentant chacun un code de récapitulatif que l’agent est autorisé à utiliser.

    Type de données : tableau

    "allowed_codes": [
      {
        "active": Boolean, 
        "code": "String",
        "description": "String",
        "external": Boolean,
        "sys_id": "String",
        "translated_code": "String",
        "translated_description": "String"
      }
    ]
    segment.wrap_up_configuration.allowed_codes.active Marqueur indiquant si le code de récapitulatif est actif.
    Valeurs valides :
    • true : le code de récapitulatif est actif.
    • false : le code de récapitulatif n’est pas actif.

    Type de données : booléennes

    Par défaut : true

    segment.wrap_up_configuration.allowed_codes.code Étiquette du code de récapitulatif.

    Type de données : chaîne

    segment.wrap_up_configuration.codes_autorisés.description Description du code de récapitulatif.

    Type de données : chaîne

    segment.wrap_up_configuration.codes_autorisés.externe Marqueur indiquant si le code de récapitulatif provient d’un système externe.
    Valeurs valides :
    • true : le code de récapitulatif provient d’un système externe.
    • false : le code de récapitulatif est interne.

    Type de données : booléennes

    segment.wrap_up_configuration.allowed_codes.sys_id Sys_id du code de récapitulatif.

    Type de données : chaîne

    Table : Code récapitulatif de l’interaction [interaction_wrap_up_code]

    segment.wrap_up_configuration.codes_autorisés.code_traduits Traduction de l’étiquette du code de récapitulatif.

    Type de données : chaîne

    segment.wrap_up_configuration.codes_autorisés.description_traduite Traduction de la description du code de récapitulatif.

    Type de données : chaîne

    segment.wrap_up_configuration.default_code Objet contenant le code de récapitulatif à utiliser par défaut.

    Type de données : objet

    "default_code": {
      "active": Boolean,
      "code": "String",
      "description": "String",
      "external": Boolean,
      "sys_id": "String",
      "translated_code": "String",
      "translated_description": "String"
    }
    segment.wrap_up_configuration.default_code.active Marqueur indiquant si le code de récapitulatif est actif.
    Valeurs valides :
    • true : le code de récapitulatif est actif.
    • false : le code de récapitulatif n’est pas actif.

    Type de données : booléennes

    Par défaut : true

    segment.wrap_up_configuration.code_default.code Étiquette du code de récapitulatif.

    Type de données : chaîne

    segment.wrap_up_configuration.default_code.description Description du code de récapitulatif.

    Type de données : chaîne

    segment.wrap_up_configuration.default_code.external Marqueur indiquant si le code de récapitulatif provient d’un système externe.
    Valeurs valides :
    • true : le code de récapitulatif provient d’un système externe.
    • false : le code de récapitulatif est interne.

    Type de données : booléennes

    segment.wrap_up_configuration.default_code.sys_id Sys_id du code de récapitulatif.

    Type de données : chaîne

    Table : Code récapitulatif de l’interaction [interaction_wrap_up_code]

    segment.wrap_up_configuration.code_default.translated_code Traduction de l’étiquette du code de récapitulatif.

    Type de données : chaîne

    segment.wrap_up_configuration.default_code.translated_description Traduction de la description du code de récapitulatif.

    Type de données : chaîne

    segment.wrap_up_configuration.enable_codes Marqueur indiquant si l’agent doit sélectionner un code de récapitulatif.
    Valeurs valides :
    • vrai : l’agent doit sélectionner un code de récapitulatif.
    • faux : l’agent n’est pas tenu de sélectionner un code de récapitulatif.

    Type de données : booléennes

    Valeur par défaut : false

    segment_id Sys_id du segment de récapitulatif.

    Type de données : chaîne

    Table : segment récapitulatif de l’interaction [interaction_wrap_up_segment]

    réussite Marqueur indiquant si la demande d’API a été traitée avec succès.
    Valeurs valides :
    • vrai : la demande d’API a réussi.
    • faux : la demande d’API a échoué.

    Type de données : booléennes

    Demande cURL

    Cet exemple récupère les détails d’un segment de récapitulatif en fonction d’un agent et d’une interaction spécifiés.

    curl "https://instance.service-now.com/api/now/v1/wrapup/segment/agent/123412345678567890ab90abcdefcdef/interaction/213412345678567890ab90abcdefcdef" \
    --request GET \
    --header "Accept:application/json" \
    --user 'username':'password'

    Corps de la réponse.

    {
      "success": true,
      "message": "Wrap up segment retrieved successfully.",
      "segment_id": "dgajbcef12345678defdbxef123435678",
      "segment": {
        "agent": "123412345678567890ab90abcdefcdef",
        "segment_table": "sn_openframe_phone_log",
        "segment_id": "dgajbcef12345678defdbxef123435678",
        "external": true,
        "interaction": "213412345678567890ab90abcdefcdef",
        "state": "closed",
        "wrap_up_configuration": {
          "enable_codes": true,
          "allowed_codes": [
            {
              "code": "Billing Issue",
              "description": "",
              "active": true,
              "external": true,
              "sys_id": "49c27b679f201210c89656effa0a1cd7",
              "translated_code": "Abrechnungsproblem",
              "translated_description": ""
            },
            {
              "code": "Store Issue",
              "description": "",
              "active": true,
              "external": true,
              "sys_id": "54327b679f201210c89656effa0a1cd7",
              "translated_code": " Einkaufsproblem",
              "translated_description": ""
            }
          ],
          "default_code": {
            "code": "Billing Issue",
            "description": "",
            "active": true,
            "external": true,
            "sys_id": "49c27b679f201210c89656effa0a1cd7",
            "translated_code": "Abrechnungsproblem",
            "translated_description": ""
          }
        },
        "segmented": true,
        "sys_id": "dgajbcef12345678defdbxef123435678",
        "opened_on": "2024-09-16 17:52:01",
        "submitted_on": "2024-09-16 18:51:59",
        "confirmed_on": "2024-09-16 18:52:01",
        "awaiting_confirmation": false
      }
    }

    Récapitulatif : PUBLIER /now/wrapup/code

    Crée ou met à jour des codes de récapitulatif.

    Les codes de récapitulatif sont créés dans la table Code de récapitulatif d’interaction [interaction_wrap_up_code].

    Format d'URL

    URL versionnée : /api/now/{api_version}/wrapup/code

    URL par défaut : /api/now/wrapup/code

    Paramètres de demande pris en charge

    Tableau 19. Paramètres de chemin d'accès
    Nom Description
    api_version Facultatif. Version du point de terminaison auquel accéder. Par exemple, v1 ou v2. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière.

    Type de données : chaîne

    Tableau 20. Paramètres de requête
    Nom Description
    Aucun
    Tableau 21. Paramètres de corps de demande (XML ou JSON)
    Nom Description
    codes Requis. Tableau d’objets représentant chacun un code de récapitulatif.

    Type de données : tableau

    "codes": [
       {
          "active": Boolean,
          "code": "String",
          "description": "String",
          "translations": [Array]
       }
    ]
    codes.actifs Marqueur indiquant si le code de récapitulatif est actif.
    Valeurs valides :
    • true : le code de récapitulatif est actif.
    • false : le code de récapitulatif n’est pas actif.

    Type de données : booléennes

    Par défaut : true

    codes.code Requis. Étiquette du code de récapitulatif.

    Type de données : chaîne

    codes.description Description du code de récapitulatif.

    Type de données : chaîne

    Codes.Traductions Tableau d’objets représentant chacun une traduction du code de récapitulatif.

    Type de données : tableau

    "translations": [
       {    
          "code": "Abrechnungsproblem",
          "description": "Ein code für Abrechnungsprobleme",
          "language": "de"
       }
    ]
    codes.traductions.code Traduction de l’étiquette du code de récapitulatif (codes.code). Requis si le codes.translations paramètre est utilisé.

    Type de données : chaîne

    Codes.Traductions.Description Traduction de la description du code de récapitulatif (codes.description). Requis si le codes.translations paramètre et une valeur ont été fournis pour codes.description.

    Type de données : chaîne

    codes.traductions.langue Code à deux lettres pour la langue utilisée dans la traduction. Requis si le codes.translations paramètre est utilisé.

    Type de données : chaîne

    En-têtes

    Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

    Tableau 22. En-têtes de demandes
    En-tête Description
    Accepter Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml.

    Valeur par défaut : application/json

    Type de contenu Format de données du corps de la demande. Types pris en charge : application/json ou application/xml.

    Valeur par défaut : application/json

    Tableau 23. En-têtes de réponses
    En-tête Description
    Aucun

    Codes d'état

    Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

    Tableau 24. Codes d'état
    Code d'état Description
    200 Réussi. La demande a été correctement traitée.
    207 Réussi. Quelques codes de récapitulatif créés avec succès. Des erreurs de validation se sont produites lors de la création d’autres personnes.
    400 Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté.
    401 Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises.
    500 Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur.

    Paramètres du corps de la réponse (JSON ou XML)

    Nom Description
    résultat Objet contenant des informations sur la demande d’API et les codes de récapitulatif créés.

    Type de données : objet

    "result": {
       "message": "String",
       "resultMap": {Object},
       "success": Boolean
    }
    résultat.message Message qui décrit le résultat de la demande d’API.

    Type de données : chaîne

    result.result_map Objet contenant un tableau des codes de récapitulatif créés.

    Type de données : objet

    "result_map": {
       "created_wrap_up_codes": [Array]
    }
    result.result_map.created_wrap_up_codes Tableau d’objets représentant chacun un code de récapitulatif créé.

    Type de données : tableau

    "created_wrap_up_codes": [
       {
          "active": Boolean,
          "code": "String",
          "description": "String",
          "external": Boolean,
          "sys_id": "String",
          "translated_code": "String",
          "translated_description": "String"
       }
    ]
    result.result_map.created_wrap_up_codes.active Marqueur indiquant si le code de récapitulatif est actif.
    Valeurs valides :
    • true : le code de récapitulatif est actif.
    • false : le code de récapitulatif n’est pas actif.

    Type de données : booléennes

    Par défaut : true

    result.result_map.created_wrap_up_codes.code Étiquette du code de récapitulatif.

    Type de données : chaîne

    result.result_map.created_wrap_up_codes.description Description du code de récapitulatif.

    Type de données : chaîne

    result.result_map.created_wrap_up_codes.external Marqueur indiquant si le code de récapitulatif provient d’un système externe.
    Valeurs valides :
    • true : le code de récapitulatif provient d’un système externe.
    • false : le code de récapitulatif est interne.

    Type de données : booléennes

    result.result_map.created_wrap_up_codes.sys_id Sys_id du code de récapitulatif.

    Type de données : chaîne

    Table : Code récapitulatif de l’interaction [interaction_wrap_up_code]

    result.result_map.created_wrap_up_codes.translated_code Traduction de l’étiquette du code de récapitulatif.

    Type de données : chaîne

    result.result_map.created_wrap_up_codes.translated_description Traduction de la description du code de récapitulatif.

    Type de données : chaîne

    Résultat.Réussite Marqueur indiquant si la demande d’API a été traitée avec succès.
    Valeurs valides :
    • vrai : la demande d’API a réussi.
    • faux : la demande d’API a échoué.

    Type de données : booléennes

    Demande cURL

    Cet exemple crée un code de récapitulatif pour les problèmes de facturation avec une traduction en allemand.

    curl "https://instance.service-now.com/api/now/v1/wrapup/code" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
      \"codes\": [
        {
          \"code\": \"Billing Issue\",
          \"description\": \"A code for billing issues\",
          \"translations\": [
            {
              \"language\": \"de\",
              \"code\": \"Abrechnungsproblem\",
              \"description\": \"Ein code für Abrechnungsprobleme\"
            }
          ]
        }
      ]
    }" \
    --user 'username':'password'

    Corps de la réponse.

    {
      "result": {
        "message": "All wrap up codes created successfully.",
        "result_map": {
          "created_wrap_up_codes": [
            {
              "code": "Billing Issue",
              "description": "A code for billing issues",
              "active": true,
              "external": true,
              "sys_id": "49c27b679f201210c89656effa0a1cd7",
              "translated_code": "Abrechnungsproblem",
              "translated_description": "Ein code für Abrechnungsprobleme"
            }
          ]
        },
        "success": true
      }
    }

    Récapitulatif : PUBLIER /now/wrapup/segment/create

    Ouvre un segment de récapitulatif pour une interaction.

    Les récapitulatifs sont créés dans la table Segment de récapitulatif de l’interaction [interaction_wrap_up_segment].

    Format d'URL

    URL versionnée : /api/now/{api_version}/wrapup/segment/create

    URL par défaut : /api/now/wrapup/segment/create

    Paramètres de demande pris en charge

    Tableau 25. Paramètres de chemin d'accès
    Nom Description
    api_version Facultatif. Version du point de terminaison auquel accéder. Par exemple, v1 ou v2. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière.

    Type de données : chaîne

    Tableau 26. Paramètres de requête
    Nom Description
    Aucun
    Tableau 27. Paramètres de corps de demande (XML ou JSON)
    Nom Description
    agent_sys_id Requis. Sys_id de l’agent affecté à l’interaction.

    Type de données : chaîne

    Table : Utilisateur [sys_user]

    configuration Objet contenant les détails du code et de la durée d’un récapitulatif externe. Requis si external a la valeur vrai.

    Type de données : objet

    "configuration": {  
       "allowed_codes": [Array], 
       "default_code": "String", 
       "duration": "String", 
       "enable_codes": Boolean  
    }
    configuration.allowed_codes Tableau d’objets représentant chacun un code de récapitulatif que l’agent est autorisé à utiliser. Obligatoire si external et configuration.enable_codes sont tous les deux vrais.

    Type de données : tableau

    "allowed_codes": [ 
       { 
          "code": "String", 
          "translation": {Object}  
       } 
    ]
    configuration.allowed_codes.code Étiquette du code de récapitulatif. Requis si le configuration.allowed_codes paramètre est utilisé.

    Type de données : chaîne

    configuration.allowed_codes.traduction Traduction du code de récapitulatif.

    Type de données : objet

    "translation": {  
       "code": "String",
       "language": "String"  
    }
    configuration.allowed_codes.traduction.code Traduction de l’étiquette du code de récapitulatif.

    Type de données : chaîne

    configuration.allowed_codes.traduction.langue Code à deux lettres pour la langue utilisée dans la traduction.

    Type de données : chaîne

    configuration.default_code Étiquette du code de récapitulatif à utiliser par défaut. Obligatoire si external et configuration.enable_codes sont tous les deux vrais.

    Type de données : chaîne

    Table : Code récapitulatif de l’interaction [interaction_wrap_up_code]

    Champ : Code

    configuration.duration Durée maximale autorisée du récapitulatif.

    Type de données : chaîne

    Unité : Secondes

    Par défaut : chaîne vide (aucune limite de temps).

    configuration.enable_codes Marqueur indiquant si l’agent doit sélectionner un code de récapitulatif.
    Valeurs valides :
    • vrai : l’agent doit sélectionner un code de récapitulatif.
    • faux : l’agent n’est pas tenu de sélectionner un code de récapitulatif.

    Type de données : booléennes

    Valeur par défaut : false

    externe Marqueur indiquant si le segment d’interaction provient d’un système externe.
    Valeurs valides :
    • vrai : le segment d’interaction provient d’un système externe.
    • faux : le segment d’interaction est interne.

    Type de données : booléennes

    Valeur par défaut : false

    external_segment_id Identificateur représentant le segment d’interaction sur le système externe. Requis si external a la valeur vrai.

    Type de données : chaîne

    interaction_sys_id Requis. Sys_id de l’interaction.

    Type de données : chaîne

    Table : Interaction [interaction]

    opened_on Date et heure de début de la période de récapitulatif en fonction du système externe. Requis si le configuration.duration paramètre est utilisé.

    Type de données : chaîne

    segmenté Marqueur indiquant si le récapitulatif est segmenté.
    Valeurs valides :
    • true : le récapitulatif est segmenté en plusieurs parties.
    • faux : Le récapitulatif est un segment complet.

    Type de données : booléennes

    Valeur par défaut : false

    segment_id Sys_id du segment d’interaction. Obligatoire si external et segmented sont tous les deux vrais.
    Remarque :
    Vous devez implémenter le point d’extension scripté InteractionSegment pour créer et récupérer des enregistrements de segments dans la table choisie ou utiliser l’implémentation OpenFrame pour créer et récupérer des enregistrements de segments dans la table Journal de téléphone [sn_openframe_phone_log].

    Type de données : chaîne

    segment_table Nom de la table contenant le segment d’interaction. Obligatoire si external et segmented sont tous les deux vrais.

    Type de données : chaîne

    wrap_up_configuration_sys_id Sys_id de la configuration de récapitulatif à utiliser. Requis si external est faux.

    Type de données : chaîne

    Table : Configuration du récapitulatif de l’interaction [interaction_wrap_up_configuration]

    En-têtes

    Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

    Tableau 28. En-têtes de demandes
    En-tête Description
    Accepter Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml.

    Valeur par défaut : application/json

    Type de contenu Format de données du corps de la demande. Types pris en charge : application/json ou application/xml.

    Valeur par défaut : application/json

    Tableau 29. En-têtes de réponses
    En-tête Description
    Aucun

    Codes d'état

    Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

    Tableau 30. Codes d'état
    Code d'état Description
    200 Réussi. La demande a été correctement traitée.
    400 Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté.
    401 Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises.
    500 Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur.

    Paramètres du corps de la réponse (JSON ou XML)

    Nom Description
    message Message qui décrit le résultat de la demande d’API.

    Type de données : chaîne

    segment Objet contenant des données sur le segment d’interaction et de récapitulatif.

    Type de données : objet

    "segment": {
      "agent": "String",
      "external": Boolean,
      "interaction": "String",
      "opened_on": "String",
      "segmented": Boolean,
      "segment_id": "String",
      "segment_table": "String",
      "state": "String",
      "sys_id": "String",
      "wrap_up_configuration": {Object} 
    }
    segment.agent Sys_id de l’agent affecté au segment d’interaction.

    Type de données : chaîne

    Table : Utilisateur [sys_user]

    Segment.Externe Marqueur indiquant si le segment d’interaction provient d’un système externe.
    Valeurs valides :
    • vrai : le segment d’interaction provient d’un système externe.
    • faux : le segment d’interaction est interne.

    Type de données : booléennes

    Valeur par défaut : false

    segment.interaction Sys_id de l’interaction.

    Type de données : chaîne

    Table : Interaction [interaction]

    segment.opened_on Date et heure de début de la période de récapitulatif en fonction du système externe.

    Type de données : chaîne

    Segment.Segmenté Marqueur indiquant si le récapitulatif est segmenté.
    Valeurs valides :
    • true : le récapitulatif est segmenté en plusieurs parties.
    • faux : Le récapitulatif est un segment complet.

    Type de données : booléennes

    Valeur par défaut : false

    segment.segment_id Sys_id du segment d’interaction.

    Type de données : chaîne

    segment.segment_table Nom de la table contenant le segment d’interaction.

    Type de données : chaîne

    segment.état État du segment d’interaction. Les segments d’interaction créés avec succès par l’API Récapitulatif sont à l’état ouvert.

    Type de données : chaîne

    segment.sys_id Sys_id du segment de récapitulatif.

    Type de données : chaîne

    Table : segment récapitulatif de l’interaction [interaction_wrap_up_segment]

    segment.wrap_up_configuration Objet contenant des détails sur la configuration de récapitulatif utilisée pour le segment de récapitulatif.

    Type de données : objet

    "wrap_up_configuration": {  
      "allowed_codes": [Array],
      "default_code": {Object},
      "enable_codes": Boolean
    }
    segment.wrap_up_configuration.allowed_codes Tableau d’objets représentant chacun un code de récapitulatif que l’agent est autorisé à utiliser.

    Type de données : tableau

    "allowed_codes": [
      {
        "active": Boolean, 
        "code": "String",
        "description": "String",
        "external": Boolean,
        "sys_id": "String",
        "translated_code": "String",
        "translated_description": "String"
      }
    ]
    segment.wrap_up_configuration.allowed_codes.active Marqueur indiquant si le code de récapitulatif est actif.
    Valeurs valides :
    • true : le code de récapitulatif est actif.
    • false : le code de récapitulatif n’est pas actif.

    Type de données : booléennes

    Par défaut : true

    segment.wrap_up_configuration.allowed_codes.code Étiquette du code de récapitulatif.

    Type de données : chaîne

    segment.wrap_up_configuration.codes_autorisés.description Description du code de récapitulatif.

    Type de données : chaîne

    segment.wrap_up_configuration.codes_autorisés.externe Marqueur indiquant si le code de récapitulatif provient d’un système externe.
    Valeurs valides :
    • true : le code de récapitulatif provient d’un système externe.
    • false : le code de récapitulatif est interne.

    Type de données : booléennes

    segment.wrap_up_configuration.allowed_codes.sys_id Sys_id du code de récapitulatif.

    Type de données : chaîne

    Table : Code récapitulatif de l’interaction [interaction_wrap_up_code]

    segment.wrap_up_configuration.codes_autorisés.code_traduits Traduction de l’étiquette du code de récapitulatif.

    Type de données : chaîne

    segment.wrap_up_configuration.codes_autorisés.description_traduite Traduction de la description du code de récapitulatif.

    Type de données : chaîne

    segment.wrap_up_configuration.default_code Objet contenant le code de récapitulatif à utiliser par défaut.

    Type de données : objet

    "default_code": {
      "active": Boolean,
      "code": "String",
      "description": "String",
      "external": Boolean,
      "sys_id": "String",
      "translated_code": "String",
      "translated_description": "String"
    }
    segment.wrap_up_configuration.default_code.active Marqueur indiquant si le code de récapitulatif est actif.
    Valeurs valides :
    • true : le code de récapitulatif est actif.
    • false : le code de récapitulatif n’est pas actif.

    Type de données : booléennes

    Par défaut : true

    segment.wrap_up_configuration.code_default.code Étiquette du code de récapitulatif.

    Type de données : chaîne

    segment.wrap_up_configuration.default_code.description Description du code de récapitulatif.

    Type de données : chaîne

    segment.wrap_up_configuration.default_code.external Marqueur indiquant si le code de récapitulatif provient d’un système externe.
    Valeurs valides :
    • true : le code de récapitulatif provient d’un système externe.
    • false : le code de récapitulatif est interne.

    Type de données : booléennes

    segment.wrap_up_configuration.default_code.sys_id Sys_id du code de récapitulatif.

    Type de données : chaîne

    Table : Code récapitulatif de l’interaction [interaction_wrap_up_code]

    segment.wrap_up_configuration.code_default.translated_code Traduction de l’étiquette du code de récapitulatif.

    Type de données : chaîne

    segment.wrap_up_configuration.default_code.translated_description Traduction de la description du code de récapitulatif.

    Type de données : chaîne

    segment.wrap_up_configuration.enable_codes Marqueur indiquant si l’agent doit sélectionner un code de récapitulatif.
    Valeurs valides :
    • vrai : l’agent doit sélectionner un code de récapitulatif.
    • faux : l’agent n’est pas tenu de sélectionner un code de récapitulatif.

    Type de données : booléennes

    Valeur par défaut : false

    réussite Marqueur indiquant si la demande d’API a été traitée avec succès.
    Valeurs valides :
    • vrai : la demande d’API a réussi.
    • faux : la demande d’API a échoué.

    Type de données : booléennes

    sys_id Sys_id du segment de récapitulatif.

    Type de données : chaîne

    Table : segment récapitulatif de l’interaction [interaction_wrap_up_segment]

    Demande cURL

    Cet exemple ouvre un segment de récapitulatif pour une interaction.

    curl "https://instance.service-now.com/api/now/v1/wrapup/segment/create" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
      \"agent_sys_id\": \"123412345678567890ab90abcdefcdef\",
      \"interaction_sys_id\": \"213412345678567890ab90abcdefcdef\",
      \"external\": \"true\",
      \"segmented\": \"true\",
      \"segment_table\": \"sn_openframe_phone_log\",
      \"segment_id\": \"dgajbcef12345678defdbxef123435678\",
      \"external_segment_id\": \"PL_402548\",
      \"configuration\": {
        \"enable_codes\": true,
        \"allowed_codes\": [
          {
            \"code\": \"Billing Issue\",
            \"translation\": {
              \"language\": \"de\",
              \"code\": \"Abrechnungsproblem\"
            }
          },
          {
            \"code\": \"Store Issue\",
            \"translation\": {
              \"language\": \"de\",
              \"code\": \"Einkaufsproblem\"
            }
          }
        ],
        \"default_code\": \"Billing Issue\",
        \"duration\": \"30\"
      },
      \"opened_on\": \"2024-09-16 17:52:01\"
    }" \
    --user 'username':'password'

    Corps de la réponse.

    {
      "success": true,
      "message": "Open wrap-up segment successfully created.",
      "sys_id": "98769876543254321fed1fedcba0cba0",
      "segment": {
        "agent": "123412345678567890ab90abcdefcdef",
        "segment_table": "sn_openframe_phone_log",
        "segment_id": "dgajbcef12345678defdbxef123435678",
        "external": true,
        "interaction": "213412345678567890ab90abcdefcdef",
        "state": "open",
        "wrap_up_configuration": {
          "enable_codes": true,
          "allowed_codes": [
            {
              "code": "Billing Issue",
              "description": "",
              "active": true,
              "external": true,
              "sys_id": "49c27b679f201210c89656effa0a1cd7",
              "translated_code": "Abrechnungsproblem",
              "translated_description": ""
            },
            {
              "code": "Store Issue",
              "description": "",
              "active": true,
              "external": true,
              "sys_id": "54327b679f201210c89656effa0a1cd7",
              "translated_code": " Einkaufsproblem",
              "translated_description": ""
            }
          ],
          "default_code": {
            "code": "Billing Issue",
            "description": "",
            "active": true,
            "external": true,
            "sys_id": "49c27b679f201210c89656effa0a1cd7",
            "translated_code": "Abrechnungsproblem",
            "translated_description": ""
          }
        },
        "segmented": true,
        "sys_id": "98769876543254321fed1fedcba0cba0",
        "opened_on": "2024-09-16 17:52:01"
      }
    }

    Récapitulatif : PUT /now/wrapup/segment/update

    Met à jour et ferme un segment de récapitulatif pour une interaction.

    Format d'URL

    URL versionnée : /api/now/{api_version}/wrapup/segment/update

    URL par défaut : /api/now/wrapup/segment/update

    Paramètres de demande pris en charge

    Tableau 31. Paramètres de chemin d'accès
    Nom Description
    api_version Facultatif. Version du point de terminaison auquel accéder. Par exemple, v1 ou v2. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière.

    Type de données : chaîne

    Tableau 32. Paramètres de requête
    Nom Description
    agent_sys_id Sys_id de l’agent affecté à l’interaction. Requis avec si interaction_sys_id ni ni segment_sys_id ne external_segment_id sont fournis.

    Type de données : chaîne

    Table : Utilisateur [sys_user]

    external_segment_id Identificateur représentant le segment d’interaction sur le système externe. Utilisé pour identifier le segment de récapitulatif à mettre à jour s’il segment_sys_id n’est pas fourni.
    interaction_sys_id Sys_id de l’interaction. Requis avec si agent_sys_id ni ni segment_sys_id ne external_segment_id sont fournis.

    Type de données : chaîne

    Table : Interaction [interaction]

    segment_sys_id Sys_id du segment de récapitulatif.

    Type de données : chaîne

    Table : segment récapitulatif de l’interaction [interaction_wrap_up_segment]

    Tableau 33. Paramètres de corps de demande (XML ou JSON)
    Nom Description
    confirmed_on Date et heure de fin de la période de récapitulatif en fonction du système externe.

    Type de données : chaîne

    notes Notes supplémentaires ajoutées au récapitulatif par l’agent.

    Type de données : chaîne

    wrap_up_code Étiquette du code de récapitulatif sélectionné par l’agent. Si l’agent ne sélectionne pas de code, le code par défaut configuré est utilisé.

    Type de données : chaîne

    Table : Code récapitulatif de l’interaction [interaction_wrap_up_code]

    Champ : Code

    En-têtes

    Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

    Tableau 34. En-têtes de demandes
    En-tête Description
    Accepter Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml.

    Valeur par défaut : application/json

    Type de contenu Format de données du corps de la demande. Types pris en charge : application/json ou application/xml.

    Valeur par défaut : application/json

    Tableau 35. En-têtes de réponses
    En-tête Description
    Aucun

    Codes d'état

    Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

    Tableau 36. Codes d'état
    Code d'état Description
    200 Réussi. La demande a été correctement traitée.
    400 Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté.
    401 Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises.
    500 Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur.

    Paramètres du corps de la réponse (JSON ou XML)

    Nom Description
    message Message qui décrit le résultat de la demande d’API.

    Type de données : chaîne

    segment Objet contenant des données sur le segment d’interaction et de récapitulatif.

    Type de données : objet

    "segment": {
      "agent": "String",
      "awaiting_confirmation": Boolean,
      "code": {Object},
      "confirmed_on": "String",
      "external": Boolean,
      "interaction": "String",
      "notes": "String",
      "opened_on": "String",
      "segmented": Boolean,
      "segment_id": "String",
      "segment_table": "String",
      "state": "String",
      "submitted_on": "String",
      "sys_id": "String",
      "wrap_up_configuration": {Object} 
    }
    segment.agent Sys_id de l’agent affecté à l’interaction.

    Type de données : chaîne

    Table : Utilisateur [sys_user]

    segment.awaiting_confirmation Marqueur indiquant si le segment de récapitulatif soumis par l’agent est en attente de confirmation qu’il a été traité par le système CCaaS externe.
    Valeurs valides :
    • vrai : le segment de récapitulatif est en attente de confirmation.
    • false : le segment de récapitulatif a été traité par le système externe.

    Type de données : booléennes

    code.segment Objet contenant le code de récapitulatif sélectionné par l’agent.

    Type de données : objet

    "code": {
      "active": Boolean,
      "code": "String",
      "description": "String",
      "external": Boolean,
      "sys_id": "String",
      "translated_code": "String",
      "translated_description": "String"
    }
    segment.code.active Marqueur indiquant si le code de récapitulatif est actif.
    Valeurs valides :
    • true : le code de récapitulatif est actif.
    • false : le code de récapitulatif n’est pas actif.

    Type de données : booléennes

    Par défaut : true

    segment.code.code Étiquette du code de récapitulatif.

    Type de données : chaîne

    Segment.Code.Description Description du code de récapitulatif.

    Type de données : chaîne

    segment.code.externe Marqueur indiquant si le code de récapitulatif provient d’un système externe.
    Valeurs valides :
    • true : le code de récapitulatif provient d’un système externe.
    • false : le code de récapitulatif est interne.

    Type de données : booléennes

    segment.code.sys_id Sys_id du code de récapitulatif.

    Type de données : chaîne

    Table : Code récapitulatif de l’interaction [interaction_wrap_up_code]

    segment.code.translated_code Traduction de l’étiquette du code de récapitulatif.

    Type de données : chaîne

    segment.code.translated_description Traduction de la description du code de récapitulatif.

    Type de données : chaîne

    segment.confirmed_on Date et heure auxquelles le segment de récapitulatif soumis est traité dans le système CCaaS externe.

    Type de données : chaîne

    Segment.Externe Marqueur indiquant si le segment d’interaction provient d’un système externe.
    Valeurs valides :
    • vrai : le segment d’interaction provient d’un système externe.
    • faux : le segment d’interaction est interne.

    Type de données : booléennes

    Valeur par défaut : false

    segment.interaction Sys_id de l’interaction.

    Type de données : chaîne

    Table : Interaction [interaction]

    segment.notes Notes supplémentaires ajoutées au récapitulatif par l’agent.

    Type de données : chaîne

    segment.opened_on Date et heure de début de la période de récapitulatif en fonction du système externe.

    Type de données : chaîne

    Segment.Segmenté Marqueur indiquant si le récapitulatif est segmenté.
    Valeurs valides :
    • true : le récapitulatif est segmenté en plusieurs parties.
    • faux : Le récapitulatif est un segment complet.

    Type de données : booléennes

    Valeur par défaut : false

    segment.segment_id Sys_id du segment d’interaction.

    Type de données : chaîne

    segment.segment_table Nom de la table contenant le segment d’interaction.

    Type de données : chaîne

    segment.état État du segment d’interaction. Les segments d’interaction que ce point de terminaison met à jour avec succès sont à l’état Fermé.

    Type de données : chaîne

    segment.submitted_on Date et heure auxquelles l’agent a soumis le segment de récapitulatif.

    Type de données : chaîne

    segment.sys_id Sys_id du segment de récapitulatif.

    Type de données : chaîne

    Table : segment récapitulatif de l’interaction [interaction_wrap_up_segment]

    segment.wrap_up_configuration Objet contenant des détails sur la configuration de récapitulatif utilisée pour le segment de récapitulatif.

    Type de données : objet

    "wrap_up_configuration": {  
      "allowed_codes": [Array],
      "default_code": {Object},
      "enable_codes": Boolean
    }
    segment.wrap_up_configuration.allowed_codes Tableau d’objets représentant chacun un code de récapitulatif que l’agent est autorisé à utiliser.

    Type de données : tableau

    "allowed_codes": [
      {
        "active": Boolean, 
        "code": "String",
        "description": "String",
        "external": Boolean,
        "sys_id": "String",
        "translated_code": "String",
        "translated_description": "String"
      }
    ]
    segment.wrap_up_configuration.allowed_codes.active Marqueur indiquant si le code de récapitulatif est actif.
    Valeurs valides :
    • true : le code de récapitulatif est actif.
    • false : le code de récapitulatif n’est pas actif.

    Type de données : booléennes

    Par défaut : true

    segment.wrap_up_configuration.allowed_codes.code Étiquette du code de récapitulatif.

    Type de données : chaîne

    segment.wrap_up_configuration.codes_autorisés.description Description du code de récapitulatif.

    Type de données : chaîne

    segment.wrap_up_configuration.codes_autorisés.externe Marqueur indiquant si le code de récapitulatif provient d’un système externe.
    Valeurs valides :
    • true : le code de récapitulatif provient d’un système externe.
    • false : le code de récapitulatif est interne.

    Type de données : booléennes

    segment.wrap_up_configuration.allowed_codes.sys_id Sys_id du code de récapitulatif.

    Type de données : chaîne

    Table : Code récapitulatif de l’interaction [interaction_wrap_up_code]

    segment.wrap_up_configuration.codes_autorisés.code_traduits Traduction de l’étiquette du code de récapitulatif.

    Type de données : chaîne

    segment.wrap_up_configuration.codes_autorisés.description_traduite Traduction de la description du code de récapitulatif.

    Type de données : chaîne

    segment.wrap_up_configuration.default_code Objet contenant le code de récapitulatif à utiliser par défaut.

    Type de données : objet

    "default_code": {
      "active": Boolean,
      "code": "String",
      "description": "String",
      "external": Boolean,
      "sys_id": "String",
      "translated_code": "String",
      "translated_description": "String"
    }
    segment.wrap_up_configuration.default_code.active Marqueur indiquant si le code de récapitulatif est actif.
    Valeurs valides :
    • true : le code de récapitulatif est actif.
    • false : le code de récapitulatif n’est pas actif.

    Type de données : booléennes

    Par défaut : true

    segment.wrap_up_configuration.code_default.code Étiquette du code de récapitulatif.

    Type de données : chaîne

    segment.wrap_up_configuration.default_code.description Description du code de récapitulatif.

    Type de données : chaîne

    segment.wrap_up_configuration.default_code.external Marqueur indiquant si le code de récapitulatif provient d’un système externe.
    Valeurs valides :
    • true : le code de récapitulatif provient d’un système externe.
    • false : le code de récapitulatif est interne.

    Type de données : booléennes

    segment.wrap_up_configuration.default_code.sys_id Sys_id du code de récapitulatif.

    Type de données : chaîne

    Table : Code récapitulatif de l’interaction [interaction_wrap_up_code]

    segment.wrap_up_configuration.code_default.translated_code Traduction de l’étiquette du code de récapitulatif.

    Type de données : chaîne

    segment.wrap_up_configuration.default_code.translated_description Traduction de la description du code de récapitulatif.

    Type de données : chaîne

    segment.wrap_up_configuration.enable_codes Marqueur indiquant si l’agent doit sélectionner un code de récapitulatif.
    Valeurs valides :
    • vrai : l’agent doit sélectionner un code de récapitulatif.
    • faux : l’agent n’est pas tenu de sélectionner un code de récapitulatif.

    Type de données : booléennes

    Valeur par défaut : false

    réussite Marqueur indiquant si la demande d’API a été traitée avec succès.
    Valeurs valides :
    • vrai : la demande d’API a réussi.
    • faux : la demande d’API a échoué.

    Type de données : booléennes

    sys_id Sys_id du segment de récapitulatif.

    Type de données : chaîne

    Table : segment récapitulatif de l’interaction [interaction_wrap_up_segment]

    Demande cURL

    Cet exemple met à jour et ferme un segment de récapitulatif pour une interaction.

    curl "https://instance.service-now.com/api/now/v1/wrapup/segment/update?segment_sys_id=98769876543254321fed1fedcba0cba0&agent_sys_id=123412345678567890ab90abcdefcdef&interaction_sys_id=213412345678567890ab90abcdefcde" \
    --request PUT \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
      \"wrap_up_code\": \"Billing Issue\",
      \"notes\": \"Customer's credit card expired. Had to switch to another one.\",
      \"confirmed_on\": \"2024-09-16 18:52:01\"
    }" \
    --user 'username':'password'

    Corps de la réponse.

    {
      "success": true,
      "message": "Wrap-up segment updated successfully.",
      "sys_id": "98769876543254321fed1fedcba0cba0",
      "segment": {
        "agent": "123412345678567890ab90abcdefcdef",
        "segment_table": "sn_openframe_phone_log",
        "segment_id": "dgajbcef12345678defdbxef123435678",
        "external": true,
        "interaction": "213412345678567890ab90abcdefcdef",
        "state": "closed",
        "wrap_up_configuration": {
          "enable_codes": true,
          "allowed_codes": [
            {
              "code": "Billing Issue",
              "description": "",
              "active": true,
              "external": true,
              "sys_id": "49c27b679f201210c89656effa0a1cd7",
              "translated_code": "Abrechnungsproblem",
              "translated_description": ""
            },
            {
              "code": "Store Issue",
              "description": "",
              "active": true,
              "external": true,
              "sys_id": "54327b679f201210c89656effa0a1cd7",
              "translated_code": " Einkaufsproblem",
              "translated_description": ""
            }
          ],
          "default_code": {
            "code": "Billing Issue",
            "description": "",
            "active": true,
            "external": true,
            "sys_id": "49c27b679f201210c89656effa0a1cd7",
            "translated_code": "Abrechnungsproblem",
            "translated_description": ""
          }
        },
        "code": {
          "code": "Billing Issue",
          "description": "",
          "active": true,
          "external": true,
          "sys_id": "49c27b679f201210c89656effa0a1cd7",
          "translated_code": "Abrechnungsproblem",
          "translated_description": ""
        },
        "notes": "Customer's credit card expired. Had to switch to another one.",
        "segmented": true,
        "sys_id": "dgajbcef12345678defdbxef123435678",
        "opened_on": "2024-09-16 17:52:01",
        "submitted_on": "2024-09-16 18:51:59",
        "confirmed_on": "2024-09-16 18:52:01",
        "awaiting_confirmation": false
      }
    }