Adding new actions

Author: GTFalcao

components/help_scout/actions/get-conversation-details/get-conversation-details.mjs

@@ -0,0 +1,36 @@
+import helpScout from "../../help_scout.app.mjs";
+
+export default {
+  key: "help_scout-get-conversation-details",
+  name: "Get Conversation Details",
+  description: "Retrieves the details of a specific conversation. [See the documentation](https://developer.helpscout.com/mailbox-api/endpoints/conversations/get/)",
+  version: "0.0.1",
+  type: "action",
+  props: {
+    helpScout,
+    conversationId: {
+      propDefinition: [
+        helpScout,
+        "conversationId",
+      ],
+    },
+    embed: {
+      type: "boolean",
+      label: "Embed",
+      description: "If true, the response will include the threads of the conversation.",
+      optional: true,
+    },
+  },
+  async run({ $ }) {
+    const response = await this.helpScout.getConversation({
+      $,
+      conversationId: this.conversationId,
+      params: {
+        embed: this.embed,
+      },
+    });
+
+    $.export("$summary", `Successfully retrieved conversation details (ID: ${this.conversationId})`);
+    return response;
+  },
+};

components/help_scout/actions/get-conversation-threads/get-conversation-threads.mjs

@@ -0,0 +1,27 @@
+import helpScout from "../../help_scout.app.mjs";
+
+export default {
+  key: "help_scout-get-conversation-threads",
+  name: "Get Conversation Threads",
+  description: "Retrieves the threads of a specific conversation. [See the documentation](https://developer.helpscout.com/mailbox-api/endpoints/conversations/threads/list/)",
+  version: "0.0.1",
+  type: "action",
+  props: {
+    helpScout,
+    conversationId: {
+      propDefinition: [
+        helpScout,
+        "conversationId",
+      ],
+    },
+  },
+  async run({ $ }) {
+    const response = (await this.helpScout.getConversationThreads({
+      $,
+      conversationId: this.conversationId,
+    }))?._embedded?.threads;
+
+    $.export("$summary", `Successfully retrieved ${response?.length || 0} threads for conversation ID: ${this.conversationId}`);
+    return response;
+  },
+};

components/help_scout/help_scout.app.mjs

@@ -146,5 +146,21 @@ export default {
         ...opts,
       });
     },
+    getConversation({
+      conversationId, ...opts
+    }) {
+      return this._makeRequest({
+        path: `/conversations/${conversationId}`,
+        ...opts,
+      });
+    },
+    getConversationThreads({
+      conversationId, ...opts
+    }) {
+      return this._makeRequest({
+        path: `/conversations/${conversationId}/threads`,
+        ...opts,
+      });
+    },
   },
 };