{"id":3322,"date":"2023-05-12T14:02:36","date_gmt":"2023-05-12T12:02:36","guid":{"rendered":"https:\/\/help.ino.cx\/?post_type=ht_kb&p=3322"},"modified":"2026-09-10T10:24:23","modified_gmt":"2026-09-10T08:24:23","slug":"webhooks","status":"publish","type":"ht_kb","link":"https:\/\/help.ino.cx\/index.php\/help-center\/webhooks\/","title":{"rendered":"Webhooks – Client account settings"},"content":{"rendered":"\n
\"\"<\/figure>\n\n\n\n

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

This article covers the four sub-tabs of the Webhooks part of the client account settings: Settings, History, Documentation and Webhook rights.<\/em><\/p>\n\n\n\n

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

The Webhooks<\/strong> tab sits in the Maker, in the client account settings. Open your user capsule, click Client account settings<\/strong>, then Webhooks<\/strong> in the left-hand menu.<\/p>\n\n\n\n

For an overview of the client account settings and all of its tabs, see the Client account settings<\/a> article.<\/p>\n\n\n\n

A webhook notifies your own system as soon as an event happens on the platform: a call starting, a case created, a campaign launched. INO cx calls the address you give it and passes the event on, which lets you connect your business tools to the platform without having to query INO cx in a loop.<\/p>\n\n\n\n

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

The setup order is as follows:<\/p>\n\n\n\n

    \n
  • In Settings<\/strong>, enable the integration and enter your address.<\/li>\n\n\n\n
  • In Webhook rights<\/strong>, choose the events you want to receive. As long as none is enabled, nothing goes out.<\/li>\n\n\n\n
  • In History<\/strong>, check that your events are arriving.<\/li>\n\n\n\n
  • Documentation<\/strong> gives you the detail of the data sent, event by event.<\/li>\n<\/ul>\n\n\n\n

    Warning:<\/strong> the address you enter must start with https:\/\/<\/code>. An http:\/\/<\/code> address is refused.<\/em><\/p>\n\n\n\n

    1.<\/strong> Prerequisites<\/h2>\n\n\n\n
      \n
    • A Smart<\/strong> licence.<\/li>\n\n\n\n
    • The read<\/strong> right on Webhooks<\/strong> must be enabled on your role to see the tab, and the edit<\/strong> right to change the settings and the webhook rights.<\/li>\n\n\n\n
    • The execute<\/strong> right on Webhooks<\/strong> is required to retry a webhook from the history. It is a separate right from edit.<\/li>\n\n\n\n
    • An https:\/\/<\/code> address, on your system, ready to receive the events.<\/li>\n<\/ul>\n\n\n\n

      2.<\/strong> Open the Webhooks tab<\/h2>\n\n\n\n
        \n
      • In the Maker, open your user capsule and click Client account settings<\/strong>.<\/li>\n\n\n\n
      • In the left-hand menu, click Webhooks<\/strong>, then pick the sub-tab you need.<\/li>\n<\/ul>\n\n\n\n
        \"\"<\/figure>\n\n\n\n

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

        Click Edit mode<\/strong> at the top of the page to make the fields editable.<\/p>\n\n\n\n

        3.1.<\/strong> Webhook integration<\/h3>\n\n\n\n

        The Webhook integration<\/strong> field is set to Enabled<\/strong> or Disabled<\/strong>. As long as it is on Disabled<\/strong>, every other field stays out of reach and no event goes out.<\/p>\n\n\n\n

        3.2.<\/strong> URL<\/h3>\n\n\n\n

        Enter the address where you want to receive the events. It must start with https:\/\/<\/code>, otherwise the message “The URL is invalid.” appears. It becomes required as soon as the integration is enabled: left empty, you get “The URL is required.”.<\/p>\n\n\n\n

        3.3.<\/strong> Authentication<\/h3>\n\n\n\n

        The Authentication<\/strong> field is set to Yes<\/strong> or No<\/strong>. On Yes<\/strong>, two fields appear:<\/p>\n\n\n\n

          \n
        • Login<\/strong>: between 1 and 255 characters.<\/li>\n\n\n\n
        • Password<\/strong>: between 1 and 45 characters. An icon lets you reveal what you type so you can check it.<\/li>\n<\/ul>\n\n\n\n

          Important:<\/strong> the password is never shown back to you. In display mode you always see six dots, even when no password is stored, and in edit mode the field is empty. Since it is required as soon as authentication is on Yes<\/strong>, you have to enter it again on every save, even when you are only changing the URL.<\/em><\/p>\n\n\n\n

          3.4.<\/strong> Save then test<\/h3>\n\n\n\n

          Click Save<\/strong>. The message “The webhook information has been successfully modified.” confirms the change.<\/p>\n\n\n\n

          The Test the connection<\/strong> button then appears, under two conditions: the integration must be Enabled<\/strong> and you must have left edit mode. It checks the values already saved<\/strong>, not what you have just typed: so save first, then run the test.<\/p>\n\n\n\n

            \n
          • “Authentication successful.”: your system answered and accepted the credentials.<\/li>\n\n\n\n
          • “Authentication failed.”: it did not answer, refused the credentials, or the address is not filled in.<\/li>\n<\/ul>\n\n\n\n

            4.<\/strong> History<\/h2>\n\n\n\n

            4.1.<\/strong> Choose the period and search<\/h3>\n\n\n\n

            The table opens on the current day. Widen the period to go further back. The search field covers the address called and the name of the event.<\/p>\n\n\n\n

            Warning:<\/strong> the history is kept for 10 days<\/strong>. An automatic process runs every night and removes older entries. Do not rely on this tab for tracking beyond that.<\/em><\/p>\n\n\n\n

            4.2.<\/strong> Read the table<\/h3>\n\n\n\n
            Column<\/th>Content<\/th><\/tr><\/thead>
            Date<\/strong><\/td>When the event was sent.<\/td><\/tr>
            Webhook trigger<\/strong><\/td>The name of the event, for example interaction:start<\/code>.<\/td><\/tr>
            URL<\/strong><\/td>The address called at that moment.<\/td><\/tr>
            Authentication<\/strong><\/td>Yes<\/strong> or No<\/strong>, depending on whether the call carried credentials.<\/td><\/tr>
            HTTP response code<\/strong><\/td>Your system’s answer, with a colour cue: green below 300, orange from 300 to 499, red above. Empty if your system did not answer.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

            INO cx waits 2 seconds for your system’s answer. Beyond that, the call counts as unanswered.<\/p>\n\n\n\n

            4.3.<\/strong> See what was sent<\/h3>\n\n\n\n

            The See details<\/strong> button expands the line and shows the Query body<\/strong>, that is the data passed for that event. Handy to compare with what your system received.<\/p>\n\n\n\n

            4.4.<\/strong> See the attempts of one send<\/h3>\n\n\n\n

            The Open<\/strong> button shows the list of attempts for that send, each with its Date<\/strong> and its HTTP response code<\/strong>. Only the 10 most recent attempts are kept.<\/p>\n\n\n\n

            4.5.<\/strong> Retry a webhook<\/h3>\n\n\n\n

            The Retry<\/strong> button sends the same event to the same address again. The message “The webhook has been successfully relaunched.” confirms it went out, and a new attempt is added to the line.<\/p>\n\n\n\n

              \n
            • You need the execute<\/strong> right on Webhooks<\/strong>. Without it, the button does not appear.<\/li>\n\n\n\n
            • A 10 second<\/strong> delay applies between two attempts on the same line. Before the delay is over, the button does not respond and shows “Please wait 10 seconds before relaunching the webhook.”.<\/li>\n<\/ul>\n\n\n\n

              Note:<\/strong> there is no automatic retry. If your system was unavailable when the event was sent, the event is lost unless you relaunch it yourself from this tab. That is another reason the 10 day retention matters.<\/em><\/p>\n\n\n\n

              5.<\/strong> Documentation<\/h2>\n\n\n\n

              This sub-tab is the technical reference to pass on to whoever will connect your system. It opens on Webhooks: Documentation<\/strong> and contains:<\/p>\n\n\n\n

                \n
              • A general presentation of what webhooks are on INO cx.<\/li>\n\n\n\n
              • Protocol<\/strong>: the reminder that the address must be exclusively in HTTPS.<\/li>\n\n\n\n
              • Enable the webhooks<\/strong>: the setup steps, the same as in this article.<\/li>\n\n\n\n
              • Authentication<\/strong>: how to enter the credentials, with the reminder that only the Basic method is available.<\/li>\n\n\n\n
              • To know<\/strong>, which contains the Structure<\/strong> shared by every event and an Example<\/strong> of NodeJS code to retrieve an event.<\/li>\n<\/ul>\n\n\n\n

                Every event shares the same structure: a unique identifier for the event, the name of the event, and a set containing its data.<\/p>\n\n\n\n

                Then comes one block per event, with its name, its description, the Event data<\/strong> table and an Example<\/strong> of what is sent. A navigation menu lets you jump straight to the event you care about.<\/p>\n\n\n\n

                6.<\/strong> Webhook rights<\/h2>\n\n\n\n

                6.1.<\/strong> Choose the events<\/h3>\n\n\n\n

                This is where you decide what you receive. Nothing goes out for an event left on No<\/strong>, even with the integration enabled and a valid address.<\/p>\n\n\n\n

                The events are split across twelve modules, shown as sub-tabs:<\/p>\n\n\n\n

                  \n
                • Users<\/strong>, Payment<\/strong>, Interaction<\/strong>, Voice campaign<\/strong>, CRM<\/strong>, Entry points<\/strong><\/li>\n\n\n\n
                • Document center<\/strong>, SMS campaign<\/strong>, Cases<\/strong>, Toolbox<\/strong>, WhatsApp campaign<\/strong>, Scheduled reports<\/strong><\/li>\n<\/ul>\n\n\n\n

                  Each module is split into sub-parts, and every event carries its own Yes<\/strong> or No<\/strong> switch. The Interaction<\/strong> module is the largest: it covers distribution, transfers, participants, recordings, SMART voice mailboxes, IVR recorders, SMS, Smart Routing and qualification, among others.<\/p>\n\n\n\n

                  6.2.<\/strong> Save<\/h3>\n\n\n\n

                  Click Edit mode<\/strong>, set the switches you want, then Save<\/strong>. The message “The webhook rights have been successfully modified.” confirms the change. Cancel<\/strong> drops your changes.<\/p>\n\n\n\n

                  Note:<\/strong> only enable the events you actually need. Each enabled event triggers a call to your system, and all those calls fill up the history.<\/em><\/p>\n","protected":false},"excerpt":{"rendered":"

                  A webhook is data that is sent to you when someone performs an action on INO: log in, change activity, decline a call, etc. These are detailed and precise logs that you choose to receive.
                  \nIn this article we will see how to activate webhooks and configure them.<\/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],"class_list":["post-3322","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\/3322","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=3322"}],"version-history":[{"count":5,"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/ht-kb\/3322\/revisions"}],"predecessor-version":[{"id":7029,"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/ht-kb\/3322\/revisions\/7029"}],"wp:attachment":[{"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/media?parent=3322"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/ht-kb-category?post=3322"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/ht-kb-tag?post=3322"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}