{"id":1099,"date":"2021-05-22T16:35:48","date_gmt":"2021-05-22T08:35:48","guid":{"rendered":"\/?p=1099"},"modified":"2021-05-22T16:35:48","modified_gmt":"2021-05-22T08:35:48","slug":"create-a-custom-call-variable-layout-for-uccx-finesse-desktop","status":"publish","type":"post","link":"https:\/\/www.insecurewi.re\/index.php\/2021\/05\/22\/create-a-custom-call-variable-layout-for-uccx-finesse-desktop\/","title":{"rendered":"Create A Custom Call Variable Layout for UCCX Finesse Desktop"},"content":{"rendered":"

Continuing on with yet more Voice, I recently cutover to a new UCCX 12.5 cluster. As part of this cutover I had to build new UCCX scripts and setup a Finesse layout with custom call variables. Once I gathered the requirements from the business I set myself to task to build the new Finesse setup.<\/p>\n

Here is how I achieved this:<\/p>\n

1. Login to Cisco Finesse Administration and click on Call Variable Layout. Create a new layout.
\n2. Name your layout and here is where you configure which Expanded Call Context (ECC) variables will show to the agent when a call comes in. Finesse allows for five variables to show on the incoming call and then two columns of variables when the call is connected. In this example I named the layout CCC. Set your layout variables like so:
\n\"Finesse<\/a><\/p>\n

3. Launch the UCCX script editor. Open your script and then go to settings > expanded call variables. Create a new scalar string called ‘user.layout’. This setting controls which layout will be shown to the Finesse desktop. If user.layout is not configured then the default Finesse layout will be used.
\n4. Add variables to the script as follows:
\nLayout. String
\nCallingNumber String
\nCalledNumber String
\nOption_Selected String
\nDateNow Date
\nTimeCalledCameIn Time<\/p>\n

4. Add the step Get Call Contact Info, configure variables for calling and called numbers.
\n\"Vars\"<\/a>
\n5. Within your script you must have the step ‘Set Enterprise Call Info’. Here is where you configure the variables that will show to the agent. Add in CallingNumber, CalledNumber, DateNow, TimeCalledCameIn and Option_Selected. Be sure to assign them to the correct Call Variable number that you set in Finesse Admin in step 2.
\n\"var2\"<\/a>
\nClick on the tab for the Expanded Call Variables and set the layout that you configured in step 3. You must have a string variable to set against user.layout (we used the string Layout from step 4).
\n\"var3\"<\/a><\/p>\n

6. For the Option_Selected variable. Use the set step to overwrite the variable in different parts of your script. In this example I use it to set what the call type is going to be about after the user has gone through a menu.
\n\"Set<\/a>
\n7. Configure an Application \/ Trrigger in UCCX admin that uses the script you have created.
\nYou’ll now see the variables show on the call screen pop and the connected call:
\n\"Payment<\/a>
\n\"Payment<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"

Continuing on with yet more Voice, I recently cutover to a new UCCX 12.5 cluster. As part of this cutover I had to build new…<\/p>\n","protected":false},"author":2,"featured_media":1119,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[42,18],"tags":[52,62,67,75,88,102,183],"class_list":["post-1099","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-uccx","category-voip","tag-agent","tag-call","tag-cisco","tag-contact-centre","tag-desktop","tag-finesse","tag-uccx"],"acf":[],"yoast_head":"\nCreate A Custom Call Variable Layout for UCCX Finesse Desktop - Insecure Wire<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.insecurewi.re\/index.php\/2021\/05\/22\/create-a-custom-call-variable-layout-for-uccx-finesse-desktop\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Create A Custom Call Variable Layout for UCCX Finesse Desktop - Insecure Wire\" \/>\n<meta property=\"og:description\" content=\"Continuing on with yet more Voice, I recently cutover to a new UCCX 12.5 cluster. As part of this cutover I had to build new...\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.insecurewi.re\/index.php\/2021\/05\/22\/create-a-custom-call-variable-layout-for-uccx-finesse-desktop\/\" \/>\n<meta property=\"og:site_name\" content=\"Insecure Wire\" \/>\n<meta property=\"article:published_time\" content=\"2021-05-22T08:35:48+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/www.insecurewi.re\/wp-content\/uploads\/2021\/05\/Screen-Shot-2021-05-22-at-4.42.38-pm.png\" \/>\n\t<meta property=\"og:image:width\" content=\"1544\" \/>\n\t<meta property=\"og:image:height\" content=\"612\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"author\" content=\"nikonau\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@https:\/\/twitter.com\/insecurewire\" \/>\n<meta name=\"twitter:site\" content=\"@insecurewire\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"nikonau\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/www.insecurewi.re\/index.php\/2021\/05\/22\/create-a-custom-call-variable-layout-for-uccx-finesse-desktop\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/www.insecurewi.re\/index.php\/2021\/05\/22\/create-a-custom-call-variable-layout-for-uccx-finesse-desktop\/\"},\"author\":{\"name\":\"nikonau\",\"@id\":\"https:\/\/www.insecurewi.re\/#\/schema\/person\/8ba08b41fc754b971a948ead6ccb777d\"},\"headline\":\"Create A Custom Call Variable Layout for UCCX Finesse Desktop\",\"datePublished\":\"2021-05-22T08:35:48+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/www.insecurewi.re\/index.php\/2021\/05\/22\/create-a-custom-call-variable-layout-for-uccx-finesse-desktop\/\"},\"wordCount\":393,\"commentCount\":0,\"publisher\":{\"@id\":\"https:\/\/www.insecurewi.re\/#organization\"},\"image\":{\"@id\":\"https:\/\/www.insecurewi.re\/index.php\/2021\/05\/22\/create-a-custom-call-variable-layout-for-uccx-finesse-desktop\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/www.insecurewi.re\/wp-content\/uploads\/2021\/05\/Screen-Shot-2021-05-22-at-4.42.38-pm.png\",\"keywords\":[\"Agent\",\"Call\",\"Cisco\",\"Contact Centre\",\"Desktop\",\"Finesse\",\"UCCX\"],\"articleSection\":[\"UCCX\",\"VOIP\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/www.insecurewi.re\/index.php\/2021\/05\/22\/create-a-custom-call-variable-layout-for-uccx-finesse-desktop\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.insecurewi.re\/index.php\/2021\/05\/22\/create-a-custom-call-variable-layout-for-uccx-finesse-desktop\/\",\"url\":\"https:\/\/www.insecurewi.re\/index.php\/2021\/05\/22\/create-a-custom-call-variable-layout-for-uccx-finesse-desktop\/\",\"name\":\"Create A Custom Call Variable Layout for UCCX Finesse Desktop - Insecure Wire\",\"isPartOf\":{\"@id\":\"https:\/\/www.insecurewi.re\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/www.insecurewi.re\/index.php\/2021\/05\/22\/create-a-custom-call-variable-layout-for-uccx-finesse-desktop\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/www.insecurewi.re\/index.php\/2021\/05\/22\/create-a-custom-call-variable-layout-for-uccx-finesse-desktop\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/www.insecurewi.re\/wp-content\/uploads\/2021\/05\/Screen-Shot-2021-05-22-at-4.42.38-pm.png\",\"datePublished\":\"2021-05-22T08:35:48+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/www.insecurewi.re\/index.php\/2021\/05\/22\/create-a-custom-call-variable-layout-for-uccx-finesse-desktop\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.insecurewi.re\/index.php\/2021\/05\/22\/create-a-custom-call-variable-layout-for-uccx-finesse-desktop\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.insecurewi.re\/index.php\/2021\/05\/22\/create-a-custom-call-variable-layout-for-uccx-finesse-desktop\/#primaryimage\",\"url\":\"https:\/\/www.insecurewi.re\/wp-content\/uploads\/2021\/05\/Screen-Shot-2021-05-22-at-4.42.38-pm.png\",\"contentUrl\":\"https:\/\/www.insecurewi.re\/wp-content\/uploads\/2021\/05\/Screen-Shot-2021-05-22-at-4.42.38-pm.png\",\"width\":1544,\"height\":612,\"caption\":\"UCCX Script\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.insecurewi.re\/index.php\/2021\/05\/22\/create-a-custom-call-variable-layout-for-uccx-finesse-desktop\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.insecurewi.re\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create A Custom Call Variable Layout for UCCX Finesse Desktop\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.insecurewi.re\/#website\",\"url\":\"https:\/\/www.insecurewi.re\/\",\"name\":\"Insecure Wire\",\"description\":\"A Network Engineer\u2019s Perspective.\",\"publisher\":{\"@id\":\"https:\/\/www.insecurewi.re\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.insecurewi.re\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/www.insecurewi.re\/#organization\",\"name\":\"Insecure Wire\",\"url\":\"https:\/\/www.insecurewi.re\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.insecurewi.re\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/www.insecurewi.re\/wp-content\/uploads\/2023\/10\/cloud.png\",\"contentUrl\":\"https:\/\/www.insecurewi.re\/wp-content\/uploads\/2023\/10\/cloud.png\",\"width\":32,\"height\":32,\"caption\":\"Insecure Wire\"},\"image\":{\"@id\":\"https:\/\/www.insecurewi.re\/#\/schema\/logo\/image\/\"},\"sameAs\":[\"https:\/\/x.com\/insecurewire\"]},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.insecurewi.re\/#\/schema\/person\/8ba08b41fc754b971a948ead6ccb777d\",\"name\":\"nikonau\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.insecurewi.re\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/2d1b9d9dc90da4f6d3da31b870f418c6b3553ba9be48d53e8ee3a35b0adb1d35?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/2d1b9d9dc90da4f6d3da31b870f418c6b3553ba9be48d53e8ee3a35b0adb1d35?s=96&d=mm&r=g\",\"caption\":\"nikonau\"},\"sameAs\":[\"https:\/\/x.com\/https:\/\/twitter.com\/insecurewire\"],\"url\":\"https:\/\/www.insecurewi.re\/index.php\/author\/nikon\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Create A Custom Call Variable Layout for UCCX Finesse Desktop - Insecure Wire","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.insecurewi.re\/index.php\/2021\/05\/22\/create-a-custom-call-variable-layout-for-uccx-finesse-desktop\/","og_locale":"en_US","og_type":"article","og_title":"Create A Custom Call Variable Layout for UCCX Finesse Desktop - Insecure Wire","og_description":"Continuing on with yet more Voice, I recently cutover to a new UCCX 12.5 cluster. As part of this cutover I had to build new...","og_url":"https:\/\/www.insecurewi.re\/index.php\/2021\/05\/22\/create-a-custom-call-variable-layout-for-uccx-finesse-desktop\/","og_site_name":"Insecure Wire","article_published_time":"2021-05-22T08:35:48+00:00","og_image":[{"width":1544,"height":612,"url":"https:\/\/www.insecurewi.re\/wp-content\/uploads\/2021\/05\/Screen-Shot-2021-05-22-at-4.42.38-pm.png","type":"image\/png"}],"author":"nikonau","twitter_card":"summary_large_image","twitter_creator":"@https:\/\/twitter.com\/insecurewire","twitter_site":"@insecurewire","twitter_misc":{"Written by":"nikonau","Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.insecurewi.re\/index.php\/2021\/05\/22\/create-a-custom-call-variable-layout-for-uccx-finesse-desktop\/#article","isPartOf":{"@id":"https:\/\/www.insecurewi.re\/index.php\/2021\/05\/22\/create-a-custom-call-variable-layout-for-uccx-finesse-desktop\/"},"author":{"name":"nikonau","@id":"https:\/\/www.insecurewi.re\/#\/schema\/person\/8ba08b41fc754b971a948ead6ccb777d"},"headline":"Create A Custom Call Variable Layout for UCCX Finesse Desktop","datePublished":"2021-05-22T08:35:48+00:00","mainEntityOfPage":{"@id":"https:\/\/www.insecurewi.re\/index.php\/2021\/05\/22\/create-a-custom-call-variable-layout-for-uccx-finesse-desktop\/"},"wordCount":393,"commentCount":0,"publisher":{"@id":"https:\/\/www.insecurewi.re\/#organization"},"image":{"@id":"https:\/\/www.insecurewi.re\/index.php\/2021\/05\/22\/create-a-custom-call-variable-layout-for-uccx-finesse-desktop\/#primaryimage"},"thumbnailUrl":"https:\/\/www.insecurewi.re\/wp-content\/uploads\/2021\/05\/Screen-Shot-2021-05-22-at-4.42.38-pm.png","keywords":["Agent","Call","Cisco","Contact Centre","Desktop","Finesse","UCCX"],"articleSection":["UCCX","VOIP"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/www.insecurewi.re\/index.php\/2021\/05\/22\/create-a-custom-call-variable-layout-for-uccx-finesse-desktop\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/www.insecurewi.re\/index.php\/2021\/05\/22\/create-a-custom-call-variable-layout-for-uccx-finesse-desktop\/","url":"https:\/\/www.insecurewi.re\/index.php\/2021\/05\/22\/create-a-custom-call-variable-layout-for-uccx-finesse-desktop\/","name":"Create A Custom Call Variable Layout for UCCX Finesse Desktop - Insecure Wire","isPartOf":{"@id":"https:\/\/www.insecurewi.re\/#website"},"primaryImageOfPage":{"@id":"https:\/\/www.insecurewi.re\/index.php\/2021\/05\/22\/create-a-custom-call-variable-layout-for-uccx-finesse-desktop\/#primaryimage"},"image":{"@id":"https:\/\/www.insecurewi.re\/index.php\/2021\/05\/22\/create-a-custom-call-variable-layout-for-uccx-finesse-desktop\/#primaryimage"},"thumbnailUrl":"https:\/\/www.insecurewi.re\/wp-content\/uploads\/2021\/05\/Screen-Shot-2021-05-22-at-4.42.38-pm.png","datePublished":"2021-05-22T08:35:48+00:00","breadcrumb":{"@id":"https:\/\/www.insecurewi.re\/index.php\/2021\/05\/22\/create-a-custom-call-variable-layout-for-uccx-finesse-desktop\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.insecurewi.re\/index.php\/2021\/05\/22\/create-a-custom-call-variable-layout-for-uccx-finesse-desktop\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.insecurewi.re\/index.php\/2021\/05\/22\/create-a-custom-call-variable-layout-for-uccx-finesse-desktop\/#primaryimage","url":"https:\/\/www.insecurewi.re\/wp-content\/uploads\/2021\/05\/Screen-Shot-2021-05-22-at-4.42.38-pm.png","contentUrl":"https:\/\/www.insecurewi.re\/wp-content\/uploads\/2021\/05\/Screen-Shot-2021-05-22-at-4.42.38-pm.png","width":1544,"height":612,"caption":"UCCX Script"},{"@type":"BreadcrumbList","@id":"https:\/\/www.insecurewi.re\/index.php\/2021\/05\/22\/create-a-custom-call-variable-layout-for-uccx-finesse-desktop\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.insecurewi.re\/"},{"@type":"ListItem","position":2,"name":"Create A Custom Call Variable Layout for UCCX Finesse Desktop"}]},{"@type":"WebSite","@id":"https:\/\/www.insecurewi.re\/#website","url":"https:\/\/www.insecurewi.re\/","name":"Insecure Wire","description":"A Network Engineer\u2019s Perspective.","publisher":{"@id":"https:\/\/www.insecurewi.re\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.insecurewi.re\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/www.insecurewi.re\/#organization","name":"Insecure Wire","url":"https:\/\/www.insecurewi.re\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.insecurewi.re\/#\/schema\/logo\/image\/","url":"https:\/\/www.insecurewi.re\/wp-content\/uploads\/2023\/10\/cloud.png","contentUrl":"https:\/\/www.insecurewi.re\/wp-content\/uploads\/2023\/10\/cloud.png","width":32,"height":32,"caption":"Insecure Wire"},"image":{"@id":"https:\/\/www.insecurewi.re\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/x.com\/insecurewire"]},{"@type":"Person","@id":"https:\/\/www.insecurewi.re\/#\/schema\/person\/8ba08b41fc754b971a948ead6ccb777d","name":"nikonau","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.insecurewi.re\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/2d1b9d9dc90da4f6d3da31b870f418c6b3553ba9be48d53e8ee3a35b0adb1d35?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/2d1b9d9dc90da4f6d3da31b870f418c6b3553ba9be48d53e8ee3a35b0adb1d35?s=96&d=mm&r=g","caption":"nikonau"},"sameAs":["https:\/\/x.com\/https:\/\/twitter.com\/insecurewire"],"url":"https:\/\/www.insecurewi.re\/index.php\/author\/nikon\/"}]}},"_links":{"self":[{"href":"https:\/\/www.insecurewi.re\/index.php\/wp-json\/wp\/v2\/posts\/1099","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.insecurewi.re\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.insecurewi.re\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.insecurewi.re\/index.php\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.insecurewi.re\/index.php\/wp-json\/wp\/v2\/comments?post=1099"}],"version-history":[{"count":0,"href":"https:\/\/www.insecurewi.re\/index.php\/wp-json\/wp\/v2\/posts\/1099\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.insecurewi.re\/index.php\/wp-json\/wp\/v2\/media\/1119"}],"wp:attachment":[{"href":"https:\/\/www.insecurewi.re\/index.php\/wp-json\/wp\/v2\/media?parent=1099"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.insecurewi.re\/index.php\/wp-json\/wp\/v2\/categories?post=1099"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.insecurewi.re\/index.php\/wp-json\/wp\/v2\/tags?post=1099"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}