crisp-api 8.5.0 → 9.1.0

package/CHANGELOG.md

@@ -1,6 +1,26 @@
 Changelog
 =========
 
+## v9.1.0
+
+### New Features
+
+* Added the new `CrispClient.website.listSpamConversation` method.
+* Added the new `CrispClient.website.resolveSpamConversationContent` method.
+* Added the new `CrispClient.website.submitSpamConversationDecision` method.
+
+## v9.0.0
+
+### Breaking Changes
+
+* ⚠️ Removed the `CrispClient.website.acquireAnalyticsPoints` method (API route has been removed).
+* ⚠️ Removed the `CrispClient.website.listAnalyticsFilters` method (API route has been removed).
+* ⚠️ Removed the `CrispClient.website.listAnalyticsClassifiers` method (API route has been removed).
+
+### New Features
+
+* Added the new `CrispClient.website.generateAnalytics` method.
+
 ## v8.5.0
 
 ### Breaking Changes

package/EXAMPLES.md

@@ -45,6 +45,35 @@ CrispClient.website.deleteSuggestedConversationDataKey(websiteID, key);
 
 =========================
 
+https://docs.crisp.chat/references/rest-api/v1/#list-spam-conversations
+
+var websiteID = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc";
+var pageNumber = 1;
+
+CrispClient.website.listSpamConversations(websiteID, pageNumber);
+
+=========================
+
+https://docs.crisp.chat/references/rest-api/v1/#resolve-spam-conversation-content
+
+var websiteID = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc";
+var spamID = "b45e7d75-61ab-416c-858b-1919b5fcfd10";
+
+CrispClient.website.resolveSpamConversationContent(websiteID, spamID);
+
+=========================
+
+https://docs.crisp.chat/references/rest-api/v1/#submit-spam-conversation-decision
+
+var websiteID = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc";
+var spamID = "b45e7d75-61ab-416c-858b-1919b5fcfd10";
+
+var action = "reject";
+
+CrispClient.website.submitSpamConversationDecision(websiteID, spamID, action);
+
+=========================
+
 https://docs.crisp.chat/references/rest-api/v1/#create-a-new-conversation
 
 var websiteID = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc";
@@ -1582,6 +1611,9 @@ var settings = {
   "name": "Crisp",
   "domain": "crisp.chat",
   "logo": "https://storage.crisp.chat/users/avatar/website/8c842203-7ed8-4e29-a608-7cf78a7d2fcc/b6c2948d-b061-405e-91a9-2fdf855d1cc0.png",
+  "audit": {
+    "log": true
+  },
   "contact": {
     "email": "contact@crisp.chat",
     "phone": "+33757905447"
@@ -1809,29 +1841,11 @@ CrispClient.website.listWebsiteOperatorAvailabilities(websiteID);
 
 =========================
 
-https://docs.crisp.chat/references/rest-api/v1/#acquire-analytics-points
-
-var websiteID = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc";
-
-CrispClient.website.acquireAnalyticsPoints(websiteID, pointType, pointMetric, dateFrom, dateTo, dateSplit, classifier, filterPrimary, filterSecondary, filterTertiary);
-
-=========================
-
-https://docs.crisp.chat/references/rest-api/v1/#list-analytics-filters
+https://docs.crisp.chat/references/rest-api/v1/#generate-analytics
 
 var websiteID = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc";
-var pageNumber = 1;
-
-CrispClient.website.listAnalyticsFilters(websiteID, pageNumber, pointType, pointMetric, dateFrom, dateTo);
-
-=========================
-
-https://docs.crisp.chat/references/rest-api/v1/#list-analytics-classifiers
-
-var websiteID = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc";
-var pageNumber = 1;
 
-CrispClient.website.listAnalyticsClassifiers(websiteID, pageNumber, pointType, pointMetric, dateFrom, dateTo);
+CrispClient.website.generateAnalytics(websiteID, query);
 
 =========================
 

package/README.md

@@ -6,7 +6,7 @@ The Crisp API Node wrapper. Authenticate, send messages, fetch conversations, ac
 
 Copyright 2023 Crisp IM SAS. See LICENSE for copying information.
 
-* **📝 Implements**: [REST API Reference (V1)](https://docs.crisp.chat/references/rest-api/v1/) at revision: 12/07/2024
+* **📝 Implements**: [REST API Reference (V1)](https://docs.crisp.chat/references/rest-api/v1/) at revision: 27/08/2024
 * **😘 Maintainers**: [@baptistejamin](https://github.com/baptistejamin), [@eliottvincent](https://github.com/eliottvincent), [@valeriansaliou](https://github.com/valeriansaliou)
 
 ## Installation
@@ -234,6 +234,47 @@ All methods that you will most likely need when building a Crisp integration are
       ```
       </details>
 
+  * **List Spam Conversations** [`user`]: [Reference](https://docs.crisp.chat/references/rest-api/v1/#list-spam-conversations)
+    * `CrispClient.website.listSpamConversations(websiteID, pageNumber)`
+    * <details>
+      <summary>See Example</summary>
+
+      ```javascript
+      var websiteID = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc";
+      var pageNumber = 1;
+
+      CrispClient.website.listSpamConversations(websiteID, pageNumber);
+      ```
+      </details>
+
+  * **Resolve Spam Conversation Content** [`user`]: [Reference](https://docs.crisp.chat/references/rest-api/v1/#resolve-spam-conversation-content)
+    * `CrispClient.website.resolveSpamConversationContent(websiteID, spamID)`
+    * <details>
+      <summary>See Example</summary>
+
+      ```javascript
+      var websiteID = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc";
+      var spamID = "b45e7d75-61ab-416c-858b-1919b5fcfd10";
+
+      CrispClient.website.resolveSpamConversationContent(websiteID, spamID);
+      ```
+      </details>
+
+  * **Submit Spam Conversation Decision** [`user`]: [Reference](https://docs.crisp.chat/references/rest-api/v1/#submit-spam-conversation-decision)
+    * `CrispClient.website.submitSpamConversationDecision(websiteID, spamID, action)`
+    * <details>
+      <summary>See Example</summary>
+
+      ```javascript
+      var websiteID = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc";
+      var spamID = "b45e7d75-61ab-416c-858b-1919b5fcfd10";
+
+      var action = "reject";
+
+      CrispClient.website.submitSpamConversationDecision(websiteID, spamID, action);
+      ```
+      </details>
+
 
 * #### **Website Conversation**
   * **⭐ Create A New Conversation** [`user`, `plugin`]: [Reference](https://docs.crisp.chat/references/rest-api/v1/#create-a-new-conversation)
@@ -2312,6 +2353,9 @@ _👉 Notice: The `peopleID` argument can be an email or the `peopleID`._
         "name": "Crisp",
         "domain": "crisp.chat",
         "logo": "https://storage.crisp.chat/users/avatar/website/8c842203-7ed8-4e29-a608-7cf78a7d2fcc/b6c2948d-b061-405e-91a9-2fdf855d1cc0.png",
+        "audit": {
+          "log": true
+        },
         "contact": {
           "email": "contact@crisp.chat",
           "phone": "+33757905447"
@@ -2605,41 +2649,15 @@ _👉 Notice: The `peopleID` argument can be an email or the `peopleID`._
 
 
 * #### **Website Analytics**
-  * **Acquire Analytics Points** [`user`]: [Reference](https://docs.crisp.chat/references/rest-api/v1/#acquire-analytics-points)
-    * `CrispClient.website.acquireAnalyticsPoints(websiteID, pointType, pointMetric, dateFrom, dateTo, dateSplit, classifier, filterPrimary, filterSecondary, filterTertiary)`
+  * **Generate Analytics** [`user`]: [Reference](https://docs.crisp.chat/references/rest-api/v1/#generate-analytics)
+    * `CrispClient.website.generateAnalytics(websiteID, query)`
     * <details>
       <summary>See Example</summary>
 
       ```javascript
       var websiteID = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc";
 
-      CrispClient.website.acquireAnalyticsPoints(websiteID, pointType, pointMetric, dateFrom, dateTo, dateSplit, classifier, filterPrimary, filterSecondary, filterTertiary);
-      ```
-      </details>
-
-  * **List Analytics Filters** [`user`]: [Reference](https://docs.crisp.chat/references/rest-api/v1/#list-analytics-filters)
-    * `CrispClient.website.listAnalyticsFilters(websiteID, pageNumber, pointType, pointMetric, dateFrom, dateTo)`
-    * <details>
-      <summary>See Example</summary>
-
-      ```javascript
-      var websiteID = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc";
-      var pageNumber = 1;
-
-      CrispClient.website.listAnalyticsFilters(websiteID, pageNumber, pointType, pointMetric, dateFrom, dateTo);
-      ```
-      </details>
-
-  * **List Analytics Classifiers** [`user`]: [Reference](https://docs.crisp.chat/references/rest-api/v1/#list-analytics-classifiers)
-    * `CrispClient.website.listAnalyticsClassifiers(websiteID, pageNumber, pointType, pointMetric, dateFrom, dateTo)`
-    * <details>
-      <summary>See Example</summary>
-
-      ```javascript
-      var websiteID = "8c842203-7ed8-4e29-a608-7cf78a7d2fcc";
-      var pageNumber = 1;
-
-      CrispClient.website.listAnalyticsClassifiers(websiteID, pageNumber, pointType, pointMetric, dateFrom, dateTo);
+      CrispClient.website.generateAnalytics(websiteID, query);
       ```
       </details>
 

package/lib/resources/WebsiteAnalytics.js

@@ -16,95 +16,19 @@
  */
 function WebsiteAnalytics(service, crisp) {
   /**
-   * Acquire Analytics Points
+   * Generate Analytics
    * @memberof WebsiteAnalytics
    * @public
-   * @method acquireAnalyticsPoints
+   * @method generateAnalytics
    * @param {string} websiteID
-   * @param {string} pointType
-   * @param {string} pointMetric
-   * @param {string} dateFrom
-   * @param {string} dateTo
-   * @param {string} dateSplit
-   * @param {string} classifier
-   * @param {string} filterSecondary
-   * @param {string} filterTertiary
+   * @param {object} query
    * @return {Promise}
    */
-  service.acquireAnalyticsPoints = function(
-    websiteID, pointType, pointMetric, dateFrom, dateTo, dateSplit, classifier,
-      filterPrimary, filterSecondary, filterTertiary
-  ) {
-    return crisp.get(
-      crisp._prepareRestUrl([
-        "website", websiteID, "analytics", pointType, pointMetric, "points"
-      ]),
+  service.generateAnalytics = function(websiteID, query) {
+    return crisp.post(
+      crisp._prepareRestUrl(["website", websiteID, "analytics", "generate"]),
 
-      {
-        date_from        : dateFrom,
-        date_to          : dateTo,
-        date_split       : dateSplit,
-        classifier       : classifier,
-        filter_primary   : filterPrimary,
-        filter_secondary : filterSecondary,
-        filter_tertiary  : filterTertiary
-      }
-    );
-  };
-
-  /**
-   * List Analytics Filters
-   * @memberof WebsiteAnalytics
-   * @public
-   * @method listAnalyticsFilters
-   * @param {string} websiteID
-   * @param {number} pageNumber
-   * @param {string} pointType
-   * @param {string} pointMetric
-   * @param {string} dateFrom
-   * @param {string} dateTo
-   * @return {Promise}
-   */
-  service.listAnalyticsFilters = function(
-    websiteID, pageNumber, pointType, pointMetric, dateFrom, dateTo
-  ) {
-    return crisp.get(
-      crisp._prepareRestUrl([
-        "website", websiteID, "analytics", pointType, pointMetric, "filters"
-      ]),
-
-      {
-        date_from : dateFrom,
-        date_to   : dateTo
-      }
-    );
-  };
-
-  /**
-   * List Analytics Classifiers
-   * @memberof WebsiteAnalytics
-   * @public
-   * @method listAnalyticsClassifiers
-   * @param {string} websiteID
-   * @param {number} pageNumber
-   * @param {string} pointType
-   * @param {string} pointMetric
-   * @param {string} dateFrom
-   * @param {string} dateTo
-   * @return {Promise}
-   */
-  service.listAnalyticsClassifiers = function(
-    websiteID, pageNumber, pointType, pointMetric, dateFrom, dateTo
-  ) {
-    return crisp.get(
-      crisp._prepareRestUrl([
-        "website", websiteID, "analytics", pointType, pointMetric, "classifiers"
-      ]),
-
-      {
-        date_from : dateFrom,
-        date_to   : dateTo
-      }
+      null, query
     );
   };
 }

package/lib/resources/WebsiteConversation.js

@@ -110,6 +110,64 @@ function WebsiteConversation(service, crisp) {
     );
   };
 
+  /**
+   * List Spam Conversations
+   * @memberof WebsiteConversation
+   * @public
+   * @method listSpamConversations
+   * @param {string} websiteID
+   * @param {number} pageNumber
+   * @return {Promise}
+   */
+  service.listSpamConversations = function(websiteID, pageNumber) {
+    return crisp.get(
+      crisp._prepareRestUrl([
+        "website", websiteID, "conversations", "spams", pageNumber
+      ])
+    );
+  };
+
+  /**
+   * Resolve Spam Conversation Content
+   * @memberof WebsiteConversation
+   * @public
+   * @method resolveSpamConversationContent
+   * @param {string} websiteID
+   * @param {string} spamID
+   * @return {Promise}
+   */
+  service.resolveSpamConversationContent = function(websiteID, spamID) {
+    return crisp.get(
+      crisp._prepareRestUrl([
+        "website", websiteID, "conversations", "spam", spamID, "content"
+      ])
+    );
+  };
+
+  /**
+   * Submit Spam Conversation Decision
+   * @memberof WebsiteConversation
+   * @public
+   * @method submitSpamConversationDecision
+   * @param {string} websiteID
+   * @param {string} spamID
+   * @param {string} action
+   * @return {Promise}
+   */
+  service.submitSpamConversationDecision = function(websiteID, spamID, action) {
+    return crisp.post(
+      crisp._prepareRestUrl([
+        "website", websiteID, "conversations", "spam", spamID, "decision"
+      ]),
+
+      null,
+
+      {
+        action : action
+      }
+    );
+  };
+
   /**
    * Create A New Conversation
    * @memberof WebsiteConversation

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "crisp-api",
   "description": "Crisp API wrapper for Node - official, maintained by Crisp",
-  "version": "8.5.0",
+  "version": "9.1.0",
   "homepage": "https://github.com/crisp-im/node-crisp-api",
   "license": "MIT",
   "author": {