{"id":2906,"date":"2022-10-07T09:53:08","date_gmt":"2022-10-07T07:53:08","guid":{"rendered":"https:\/\/help.ino.cx\/?post_type=ht_kb&p=2906"},"modified":"2026-06-04T15:21:31","modified_gmt":"2026-06-04T13:21:31","slug":"interaction-tags-how-to-use-them","status":"publish","type":"ht_kb","link":"https:\/\/help.ino.cx\/index.php\/help-center\/interaction-tags-how-to-use-them\/","title":{"rendered":"Checkpoints"},"content":{"rendered":"\n
\"Smart<\/figure>\n\n\n\n

[Reading time: 5 minutes<\/em>]<\/p>\n\n\n\n

Overview<\/h2>\n\n\n\n

A Checkpoint<\/strong> is a marker placed on an interaction by a Smart Routing flow to record a milestone in the customer journey. Checkpoints are not interactive \u2014 neither the customer nor the advisor sets them manually: they are attached automatically when the Smart Routing tree runs through an Add a checkpoint<\/strong> action.<\/p>\n\n\n\n

Each interaction can accumulate several checkpoints during its life. Once attached, the list of checkpoints is visible in the interaction details, with the date and the name of the action that set each one. This gives a clear, chronological trail of where the interaction has been in the routing.<\/p>\n\n\n\n

Typical use cases include marking that:<\/p>\n\n\n\n

    \n
  • The interaction has passed a given identification step (recognised customer, opt-in collected, etc.).<\/li>\n\n\n\n
  • The customer was offered a callback or an upsell.<\/li>\n\n\n\n
  • The interaction reached a specific branch of the routing tree, for later audit or statistics.<\/li>\n\n\n\n
  • A campaign or A\/B test target has been crossed.<\/li>\n<\/ul>\n\n\n\n
    \"\"<\/figure>\n\n\n\n

    1. Access and permissions<\/h2>\n\n\n\n

    Checkpoints are configured in the Maker<\/strong>, in the Toolbox<\/strong> module. From the left menu, open Toolbox > Checkpoints<\/strong>.<\/p>\n\n\n\n

    To access and configure checkpoints, the user\u2019s role must include the appropriate rights on the Checkpoints<\/strong> entity:<\/p>\n\n\n\n

      \n
    • Read<\/strong> \u2013 view the list and details of checkpoints.<\/li>\n\n\n\n
    • Create<\/strong> \u2013 create a new checkpoint.<\/li>\n\n\n\n
    • Modify<\/strong> \u2013 edit an existing checkpoint.<\/li>\n\n\n\n
    • Delete<\/strong> \u2013 delete a single checkpoint or several at once.<\/li>\n<\/ul>\n\n\n\n

      These permissions are managed in the Roles<\/strong> module of the Maker. Checkpoints are part of the Smart licence.<\/p>\n\n\n\n

      2. Create a checkpoint<\/h2>\n\n\n\n

      To create a new checkpoint:<\/p>\n\n\n\n

        \n
      1. Go to Maker > Toolbox > Checkpoints<\/strong>.<\/li>\n\n\n\n
      2. Click the +<\/strong> button at the top right.<\/li>\n\n\n\n
      3. Fill out the form:<\/li>\n<\/ol>\n\n\n\n
        Field<\/th>Required<\/th>Description<\/th><\/tr><\/thead>
        Name<\/strong><\/td>Yes<\/td>Display name of the checkpoint.<\/td><\/tr>
        Reference<\/strong><\/td>Yes<\/td>Unique identifier used to reference the checkpoint in your Smart Routings and integrations. Must be unique and may contain only the following special characters: _ + . @ -<\/code><\/td><\/tr>
        Alias<\/strong><\/td>No<\/td>Short label attached to the interaction when the checkpoint is set. The alias is what appears in the interaction\u2019s tag list \u2014 choose something concise.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
          \n
        1. Click Save<\/strong>.<\/li>\n<\/ol>\n\n\n\n

          The new checkpoint appears in the list. It is now available to be added in a Smart Routing.<\/p>\n\n\n\n

          The list itself shows the columns Name<\/strong>, Reference<\/strong> and Alias<\/strong>. A search bar at the top lets you find a checkpoint by its name or reference.<\/p>\n\n\n\n

          3. Use a checkpoint in a Smart Routing<\/h2>\n\n\n\n

          A checkpoint is set on an interaction through a Smart Routing action of type Add a checkpoint<\/strong>. The action is available in voice, email and messaging Smart Routings.<\/p>\n\n\n\n

          In the Smart Routing editor:<\/p>\n\n\n\n

            \n
          1. Add an Add a checkpoint<\/strong> action to the routing tree, at the step where you want the checkpoint to be set.<\/li>\n\n\n\n
          2. Pick the checkpoint to apply. You can either:\n
              \n
            • Select the checkpoint<\/strong> directly from the list of checkpoints configured in the Toolbox, or<\/em><\/li>\n\n\n\n
            • Specify the checkpoint reference<\/strong> as a code \u2014 useful when the checkpoint is determined dynamically from a variable.<\/li>\n<\/ul>\n<\/li>\n\n\n\n
            • Wire the outcome branches of the action.<\/li>\n<\/ol>\n\n\n\n

              The action has two possible outcomes that can be connected to different branches of the routing:<\/p>\n\n\n\n

              Outcome<\/th>Meaning<\/th><\/tr><\/thead>
              OK<\/strong><\/td>The checkpoint has been successfully attached to the interaction.<\/td><\/tr>
              Reference not found<\/strong><\/td>The provided checkpoint reference does not match any existing checkpoint (typically when the reference is built from a variable and the result does not exist).<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

              When the action fires, the system records on the interaction:<\/p>\n\n\n\n

                \n
              • The checkpoint Name<\/strong> and Reference<\/strong>.<\/li>\n\n\n\n
              • The Alias<\/strong>, which is also added to the interaction\u2019s tag list.<\/li>\n\n\n\n
              • The exact timestamp<\/strong> when the checkpoint was attached.<\/li>\n\n\n\n
              • The Smart Routing action that triggered it (so you can trace which step set it).<\/li>\n<\/ul>\n\n\n\n

                The same checkpoint cannot be added twice to the same interaction \u2014 if a checkpoint is already attached, the action is ignored for that one and the routing continues on the OK branch.<\/p>\n\n\n\n

                \"\"<\/figure>\n\n\n\n

                4. Edit, duplicate or delete a checkpoint<\/h2>\n\n\n\n

                From the Checkpoints<\/strong> list, each row provides the following actions:<\/p>\n\n\n\n

                Action<\/th>Description<\/th><\/tr><\/thead>
                Edit<\/strong><\/td>Modify the Name, Reference or Alias of the checkpoint. Changing the Reference will impact any Smart Routing action configured to use that reference as a code.<\/td><\/tr>
                Duplicate<\/strong><\/td>Create a copy of the checkpoint. The Name and Reference of the copy must be updated to keep references unique.<\/td><\/tr>
                Delete<\/strong><\/td>Remove the checkpoint. Before deleting a checkpoint that is still referenced by a Smart Routing action, detach it from the action first, otherwise the action will fall on the Reference not found<\/em> outcome at runtime.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

                Several checkpoints can be deleted at once by selecting them in the list and using the bulk delete action.<\/p>\n\n\n\n

                5. Where checkpoints appear on an interaction<\/h2>\n\n\n\n

                Once a checkpoint has been set, it is visible on the interaction itself:<\/p>\n\n\n\n

                  \n
                • In the Checkpoints<\/strong> section of the interaction details, with the list of every checkpoint attached, in chronological order, the date and the name of the Smart Routing action that set each one.<\/li>\n<\/ul>\n\n\n\n
                    \n
                  • In the Information<\/strong> tab, a Checkpoints section showing the Alias<\/strong> of every attached checkpoint as a small tag chip. Useful to see the journey at a glance, on any interaction.<\/li>\n\n\n\n
                  • In the Data<\/strong> tab of the interaction details page (in the interaction during interaction or in interaction history after interaction), the detailed list of every checkpoint attached to the interaction, in chronological order, with the date and time when it was set and the name of the Smart Routing action that triggered it. Each row links to the checkpoint configuration page.<\/li>\n<\/ul>\n\n\n\n
                    \"\"<\/figure>\n","protected":false},"excerpt":{"rendered":"

                    The interaction tags are statistical tools: created in the Maker, they are then inserted in a Smart Routing and their data are used in the Reporter dashboards.<\/p>\n","protected":false},"author":3,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"ht-kb-category":[107],"ht-kb-tag":[131,123],"class_list":["post-2906","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-configuring","ht_kb_tag-maker","ht_kb_tag-smart-routing"],"_links":{"self":[{"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/ht-kb\/2906","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/comments?post=2906"}],"version-history":[{"count":7,"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/ht-kb\/2906\/revisions"}],"predecessor-version":[{"id":6638,"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/ht-kb\/2906\/revisions\/6638"}],"wp:attachment":[{"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/media?parent=2906"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/ht-kb-category?post=2906"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/ht-kb-tag?post=2906"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}