{"id":6606,"date":"2026-07-30T11:16:10","date_gmt":"2026-07-30T09:16:10","guid":{"rendered":"https:\/\/help.ino.cx\/?post_type=ht_kb&p=6606"},"modified":"2026-07-30T11:16:11","modified_gmt":"2026-07-30T09:16:11","slug":"workflows-set-them-up","status":"publish","type":"ht_kb","link":"https:\/\/help.ino.cx\/index.php\/help-center\/workflows-set-them-up\/","title":{"rendered":"Workflows \u2013 Set them up"},"content":{"rendered":"\n
\"Smart<\/figure>\n\n\n\n

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

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

A Workflow<\/strong> is an automated process that runs in the background when a specific event happens \u2014 for example when an incoming webhook is received, when an outgoing campaign has run, when a database row changes, or when another rule fires it. From the entity description in the platform: \u201cConfigure actions to carry out when specific events take place.\u201d<\/em><\/p>\n\n\n\n

Concretely, a workflow is:<\/p>\n\n\n\n

    \n
  • A sequence (tree) of actions<\/strong> \u2014 calling a web service, reading or writing a database, sending an SMS or email, creating a CRM card or a task, inserting a target in a campaign, etc.<\/li>\n\n\n\n
  • Wired to one or several triggers<\/strong> (webhook events) that decide when it runs.<\/li>\n\n\n\n
  • Versioned: each workflow has development versions you can iterate on safely, one version in production, and a history of backup versions you can roll back to.<\/li>\n<\/ul>\n\n\n\n

    Workflows are the way to automate business processes inside the platform without writing custom code. They share the same visual editor and most of the action library with Smart Routings, but they run outside of an interaction\u2019s lifecycle \u2014 they react to events rather than to live interactions.<\/p>\n\n\n\n

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

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

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

    To access and configure workflows, the user\u2019s role must include the appropriate rights on the Workflows<\/strong> entity (Read \/ Create \/ Modify \/ Delete). These permissions are managed in the Roles<\/strong> module of the Maker.<\/p>\n\n\n\n

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

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

      \n
    1. Go to Maker > Routing > Workflows<\/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 workflow.<\/td><\/tr>
      Reference<\/strong><\/td>Yes<\/td>Unique identifier used to reference the workflow in your configurations. Must be unique and may contain only the following special characters: _ + . @ -<\/code><\/td><\/tr>
      Description<\/strong><\/td>No<\/td>Free text describing the purpose of the workflow.<\/td><\/tr>
      Time zone<\/strong><\/td>No<\/td>Time zone used by the actions of the workflow (for example for date\/time computations). Leave on By default<\/em> to use the time zone of the object that triggered the workflow, or the customer account default.<\/td><\/tr>
      Language<\/strong><\/td>No<\/td>Language used by the actions of the workflow (for example for templates). Leave on By default<\/em> to use the customer account default.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
        \n
      1. Click Save<\/strong>.<\/li>\n<\/ol>\n\n\n\n

        The new workflow appears in the list with the columns Name<\/strong>, Reference<\/strong>, Time zone<\/strong> and Language<\/strong>. Click on its name to open the details page, which is split into three tabs: Settings<\/strong>, Triggers<\/strong> and Versions<\/strong>.<\/p>\n\n\n\n

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

        3. Settings tab<\/h2>\n\n\n\n

        The Settings<\/strong> tab is where you set the global parameters that apply to every execution of the workflow. <\/p>\n\n\n\n

          \n
        • Name<\/strong>, Reference<\/strong> and Description<\/strong> \u2014 modifiable at any time. Changing the Reference impacts any place that already references the workflow by its code (for example a Smart Routing action Distribution to a workflow<\/em> configured by reference).<\/li>\n\n\n\n
        • Time zone<\/strong> \u2014 used by every action that computes a date or a time (Test a schedule<\/em>, Date and time (retrieval and calculations)<\/em>, Reschedule an attempt<\/em>, etc.) and by communication actions to time messages correctly. Leave on By default<\/em> to use the time zone of the object that triggered the workflow (for example, the interaction\u2019s queue) \u2014 if the trigger object has none, the customer account default is used.<\/li>\n\n\n\n
        • Language<\/strong> \u2014 used when an action picks a localised resource (an email template, an SMS template, a sound file). Leave on By default<\/em> to use the customer account default.<\/li>\n<\/ul>\n\n\n\n

          Below the general info, a block lets you declare a list of key\/value pairs<\/strong> that the workflow itself stores, and that any action of the workflow can reference.<\/p>\n\n\n\n

          Each row is numbered (Setting 1<\/em>, Setting 2<\/em>\u2026) and contains:<\/p>\n\n\n\n

            \n
          • Key<\/strong> \u2014 a unique identifier of the setting (for example support_email<\/code>, api_url<\/code>, retry_limit<\/code>). Two settings cannot share the same key.<\/li>\n\n\n\n
          • Value<\/strong> \u2014 the actual value. The value field accepts variables in the {{variable}}<\/code> notation (for example {{card.email}}<\/code> or {{interaction.id}}<\/code>), so you can derive a setting from data passed by the trigger.<\/li>\n<\/ul>\n\n\n\n

            Both fields are required when a row is added. Use the +<\/strong> button at the end of the last row to add another setting, and the delete<\/strong> icon to remove one.<\/p>\n\n\n\n

            Settings are useful to centralise the constants used by your workflow \u2014 when you need to change one, you only edit it here instead of every action that references it. They are also the way to expose configuration to your business team without giving them access to the action tree.<\/p>\n\n\n\n

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

            4. Triggers tab<\/h2>\n\n\n\n

            A workflow does not run on its own \u2014 it has to be fired<\/strong> by something. The Triggers<\/strong> tab is where you declare what fires it.<\/p>\n\n\n\n

            4.1. What is a trigger?<\/h3>\n\n\n\n

            A trigger is a predefined event<\/strong> emitted by the platform when something noteworthy happens. The platform ships with a catalogue of webhook triggers grouped by category, including for example:<\/p>\n\n\n\n

            Category<\/th>Examples of triggers<\/th><\/tr><\/thead>
            User & agents<\/strong><\/td>An advisor logs in \/ logs out, an advisor changes activity, etc.<\/td><\/tr>
            Interaction<\/strong><\/td>An interaction starts, ends, is transferred, enters a queue, leaves a queue, is recorded, is joined by an extra participant, etc.<\/td><\/tr>
            Payment<\/strong><\/td>A payment succeeds, an installment is collected, etc.<\/td><\/tr>
            Voice campaign \/ SMS campaign<\/strong><\/td>A campaign target is processed, an attempt fails, the campaign ends, etc.<\/td><\/tr>
            CRM & cases<\/strong><\/td>A CRM card is created \/ updated \/ deleted, a case is created or updated, etc.<\/td><\/tr>
            WhatsApp campaign<\/strong><\/td>A target is inserted or updated, the campaign starts or stops, etc.<\/td><\/tr>
            Tools<\/strong><\/td>A calendar item or a values-table item is edited, etc.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

            You cannot create your own trigger \u2014 you pick from the catalogue. When the corresponding event occurs anywhere on the platform, every workflow that has subscribed to it is fired one after another. Each firing receives the contextual data of the event (for example an interaction:end<\/em> trigger provides the interaction, the customer, the queue, the duration, the result, etc.), which the workflow can use in its actions through variables.<\/p>\n\n\n\n

            4.2. Attach a trigger to the workflow<\/h3>\n\n\n\n

            From the Triggers tab:<\/p>\n\n\n\n

              \n
            1. Click Add triggers<\/strong>.<\/li>\n\n\n\n
            2. Pick one or several triggers from the catalogue (the modal shows the triggers that have not been associated yet).<\/li>\n\n\n\n
            3. Confirm.<\/li>\n<\/ol>\n\n\n\n

              The newly attached triggers appear in the Triggers list with an Active<\/strong> toggle next to each one. Two situations:<\/p>\n\n\n\n

                \n
              • Active<\/strong>: every time the event fires somewhere on the platform, this workflow runs.<\/li>\n\n\n\n
              • Inactive<\/strong>: the workflow stays attached to the trigger but no longer runs \u2014 useful to pause a workflow temporarily without losing its configuration.<\/li>\n<\/ul>\n\n\n\n

                Triggers can also be removed<\/strong> individually or in bulk from the same tab.<\/p>\n\n\n\n

                4.3. No trigger or no production version = no run<\/h3>\n\n\n\n

                For a trigger to actually do something, two conditions must be met:<\/p>\n\n\n\n

                  \n
                • The trigger must be active<\/strong> on the workflow.<\/li>\n\n\n\n
                • The workflow must have a production<\/strong> version (or a scheduled production version that has reached its date).<\/li>\n<\/ul>\n\n\n\n

                  If a trigger fires while the workflow only has development versions, nothing happens. A reminder is displayed when you wire a trigger: \u201cRemember to check that the selected workflow has a production or test version. If this is not the case, then the workflow will not run.\u201d<\/em><\/p>\n\n\n\n

                  4.4. Other ways to fire a workflow<\/h3>\n\n\n\n

                  Triggers are the standard way to launch a workflow, but two other paths exist:<\/p>\n\n\n\n

                    \n
                  • From a Smart Routing<\/strong>: the action Distribution to a workflow<\/em> launches a workflow inline during an interaction\u2019s routing tree.<\/li>\n\n\n\n
                  • Manually<\/strong>: from the workflow details page, a Start the workflow<\/strong> action lets you launch the production version on demand. If the workflow has Settings with values still empty, a small form asks you to provide them. This is mostly used to test a freshly-promoted workflow.<\/li>\n<\/ul>\n\n\n\n
                    \"\"<\/figure>\n\n\n\n

                    5. Versions tab<\/h2>\n\n\n\n

                    The Versions<\/strong> tab is where you build and manage the actual logic of the workflow. A workflow can contain several versions at the same time, each one in a different lifecycle state:<\/p>\n\n\n\n

                    Status<\/th>Description<\/th><\/tr><\/thead>
                    In production<\/strong><\/td>The version currently executed when a trigger fires. Only one version can be in production at any time. A production version cannot be edited directly \u2014 to make changes, create a development copy.<\/td><\/tr>
                    Development<\/strong><\/td>Draft versions you can edit freely. As many as you need, within the configured limit. Used to design and test changes before promoting them to production.<\/td><\/tr>
                    Backup<\/strong><\/td>Previous production versions that have been replaced. A backup version can be put back into production at any time, which is the way to roll back to an earlier behaviour. The number of backups kept is capped by a configurable limit.<\/td><\/tr>
                    Scheduled for production<\/strong><\/td>A development version that has been planned for an automatic switch to production at a future date. Useful to align a behaviour change with a business deadline.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

                    Each row of the Versions tab shows the version\u2019s status, the date it was last modified and the available actions (open, modify, put in production, schedule, delete, etc.).<\/p>\n\n\n\n

                    6. Build a version \u2014 the action tree<\/h2>\n\n\n\n

                    Open a development version to access the action tree editor<\/strong>, the same visual editor used by Smart Routings. Each node of the tree is an action, and links between nodes describe the order \u2014 and the conditional branches \u2014 in which actions are executed.<\/p>\n\n\n\n

                    Every version starts from a Start<\/strong> node that is created automatically. From there, you add actions and connect them.<\/p>\n\n\n\n

                    6.1. Add an action<\/h3>\n\n\n\n

                    A new action is added either by clicking the +<\/strong> output handle of an existing action (or of the Start<\/strong> node, for the very first action), or by right-clicking on an existing action and selecting Add an action<\/strong>.<\/p>\n\n\n\n

                    The action form then opens in the side panel with a choice between two creation modes:<\/p>\n\n\n\n

                      \n
                    • From zero<\/strong>: start from an empty action and configure it.<\/li>\n\n\n\n
                    • Copy an existing action<\/strong>: duplicate an action that already exists in the version.<\/li>\n<\/ul>\n\n\n\n

                      6.2. Available actions<\/h3>\n\n\n\n

                      A workflow version can chain about thirty action kinds. They cover most of the operations needed to automate a business process:<\/p>\n\n\n\n

                      Category<\/th>Examples of actions<\/th><\/tr><\/thead>
                      Variables and data<\/strong><\/td>Assign values to variables<\/em>, Values table<\/em>, Fill in the variables from a database<\/em>, Save values to a database<\/em>, Modify database values<\/em>, Date and time (retrieval and calculations)<\/em>.<\/td><\/tr>
                      Tests and branches<\/strong><\/td>Test a value(s)<\/em>, Test a schedule<\/em>, Test if the number is mobile<\/em>, Test if it is an even or odd week<\/em>.<\/td><\/tr>
                      Communication<\/strong><\/td>Send an email<\/em>, Send a SMS<\/em>.<\/td><\/tr>
                      Cases & CRM<\/strong><\/td>Create a new case and associate it with the interaction<\/em>, Modify a case<\/em>, Associate the interaction with a CRM card<\/em>, Create a CRM card<\/em>, Associate the interaction with a CRM V2 card<\/em>, Create a CRM V2 card<\/em>.<\/td><\/tr>
                      Tasks & checkpoints<\/strong><\/td>Create a task<\/em>, Add a checkpoint<\/em>.<\/td><\/tr>
                      Campaigns<\/strong><\/td>Insert a target in a voice campaign<\/em>, Insert a target in the SMS campaign<\/em>, Insert a target into a WhatsApp campaign<\/em>, Check the number of target attempts<\/em>, Check the result of the target attempts<\/em>, Reschedule an attempt<\/em>.<\/td><\/tr>
                      Integrations<\/strong><\/td>Web service<\/em>, Node<\/em>.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

                      Not every Smart Routing action is available in a workflow. Channel-specific actions (voice announcement, ASR, recording controls, distribution to a queue, distribution to a user, voicemail, etc.) live in Smart Routings only, since they manipulate a live interaction. Workflows focus on data and back-office automation.<\/p>\n\n\n\n

                      6.3. Link the actions<\/h3>\n\n\n\n

                      Each action exposes one or several outgoing branches (success, failure, conditional results, etc.) that you connect to the next action. Each branch has its own +<\/strong> output handle: click the +<\/strong> to add the next action \u2014 the link to that new action is created at the same time. You don’t need to draw the link separately.<\/p>\n\n\n\n

                      Two types of links can coexist:<\/p>\n\n\n\n

                        \n
                      • Normal link<\/strong>: forward progression created when you add a new child action from a +<\/strong> output.<\/li>\n\n\n\n
                      • Unnatural link<\/strong>: a link that goes back to a previous action or jumps across branches, to handle loops or shortcuts. To create one, drag<\/strong> the +<\/strong> of the source branch and drop it onto an existing action<\/strong> in the tree \u2014 the link is created without adding a new node.<\/li>\n<\/ul>\n\n\n\n

                        Existing links remain editable: click on a link to open its side panel and reassign it, or delete it from the right-click menu of the link itself. Actions can be modified (Modify this action<\/em>) or removed (Delete this action<\/em> \/ Delete this action and its entire branch<\/em>) at any time on a development version.<\/p>\n\n\n\n

                        7. Put a version in production<\/h2>\n\n\n\n

                        Once a development version is ready, two options switch it to In production<\/em>:<\/p>\n\n\n\n

                          \n
                        • Immediate production<\/strong>: the version becomes the production version straight away. If a previous version was in production, it is automatically moved to Backup<\/em>.<\/li>\n\n\n\n
                        • Scheduled production<\/strong>: pick a future date and time. The version moves to Scheduled for production<\/em>, and the platform automatically swaps it in at the scheduled time. Two versions cannot share the same scheduled production date.<\/li>\n<\/ul>\n\n\n\n

                          To roll back, open a Backup<\/em> version and put it back in production \u2014 the current production version then goes to Backup itself.<\/p>\n\n\n\n

                          8. Edit, duplicate or delete a workflow<\/h2>\n\n\n\n

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

                          Action<\/th>Description<\/th><\/tr><\/thead>
                          Edit<\/strong><\/td>Edit the Name, Reference, Description, Time zone and Language of the workflow. Versions and triggers are managed from the details page.<\/td><\/tr>
                          Duplicate<\/strong><\/td>Create a copy of the workflow, including its versions, triggers and configuration. The copy is created without triggers \u2014 re-associate triggers manually if needed.<\/td><\/tr>
                          Delete<\/strong><\/td>Remove the workflow. Deleting a workflow also removes its versions and its trigger associations. As a good practice, make sure it is no longer referenced (for example from a Smart Routing action Distribution to a workflow) before deleting it.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

                          Several workflows can be deleted at once by selecting them in the list and using the bulk delete action.<\/p>\n","protected":false},"excerpt":{"rendered":"

                          [Reading time: 12 minutes] Overview A Workflow is an automated process that runs in the background when a specific event happens \u2014 for example when an incoming webhook is received, when an outgoing campaign has run, when a database row changes, or when another rule fires it. From the entity description in…<\/p>\n","protected":false},"author":5,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"ht-kb-category":[107],"ht-kb-tag":[131],"class_list":["post-6606","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-configuring","ht_kb_tag-maker"],"_links":{"self":[{"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/ht-kb\/6606","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\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/comments?post=6606"}],"version-history":[{"count":6,"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/ht-kb\/6606\/revisions"}],"predecessor-version":[{"id":6724,"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/ht-kb\/6606\/revisions\/6724"}],"wp:attachment":[{"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/media?parent=6606"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/ht-kb-category?post=6606"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/ht-kb-tag?post=6606"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}