UltraMsg New Actions (#2348)

* ultramsg

* remove wrong dependencies

* cr improvements

* change package json main file

* Update "to" prop

* minors prop descriptions

* typo

Author: vellames

components/ultramsg/action/send-audio/send-audio.mjs

@@ -0,0 +1,38 @@
+import ultramsg from "../../ultramsg.app.mjs";
+
+export default {
+  name: "Send Audio",
+  description: "Send an audio file to a specified number. [See the docs here](https://docs.ultramsg.com/api/post/messages/audio)",
+  key: "ultramsg-send-audio",
+  version: "0.0.1",
+  type: "action",
+  props: {
+    ultramsg,
+    to: {
+      propDefinition: [
+        ultramsg,
+        "to",
+      ],
+    },
+    audio: {
+      type: "string",
+      label: "Audio",
+      description: "Public URL of your audio file",
+    },
+  },
+  async run({ $ }) {
+    const {
+      to,
+      audio,
+    } = this;
+
+    const data = {
+      to,
+      audio,
+    };
+    const res = await this.ultramsg.sendAudio(data, $);
+    $.export("$summary", `Audio successfully sent to "${to}"`);
+
+    return res;
+  },
+};

components/ultramsg/action/send-document/send-doucument.mjs

@@ -0,0 +1,45 @@
+import ultramsg from "../../ultramsg.app.mjs";
+
+export default {
+  name: "Send a Document",
+  description: "Send a document to a specified number. [See the docs here](https://docs.ultramsg.com/api/post/messages/document)",
+  key: "ultramsg-send-document",
+  version: "0.0.1",
+  type: "action",
+  props: {
+    ultramsg,
+    to: {
+      propDefinition: [
+        ultramsg,
+        "to",
+      ],
+    },
+    document: {
+      type: "string",
+      label: "Document",
+      description: "Public URL of your document",
+    },
+    filename: {
+      type: "string",
+      label: "Filename",
+      description: "The name of your file",
+    },
+  },
+  async run({ $ }) {
+    const {
+      to,
+      document,
+      filename,
+    } = this;
+
+    const data = {
+      to,
+      document,
+      filename,
+    };
+    const res = await this.ultramsg.sendDocument(data, $);
+    $.export("$summary", `Document successfully sent to "${to}"`);
+
+    return res;
+  },
+};

components/ultramsg/action/send-image/send-image.mjs

@@ -0,0 +1,46 @@
+import ultramsg from "../../ultramsg.app.mjs";
+
+export default {
+  name: "Send an Image",
+  description: "Send an image to a specified number. [See the docs here](https://docs.ultramsg.com/api/post/messages/image)",
+  key: "ultramsg-send-image",
+  version: "0.0.1",
+  type: "action",
+  props: {
+    ultramsg,
+    to: {
+      propDefinition: [
+        ultramsg,
+        "to",
+      ],
+    },
+    image: {
+      type: "string",
+      label: "Image",
+      description: "Public URL of your image",
+    },
+    caption: {
+      type: "string",
+      label: "Caption",
+      description: "Image Caption",
+      optional: true,
+    },
+  },
+  async run({ $ }) {
+    const {
+      to,
+      image,
+      caption,
+    } = this;
+
+    const data = {
+      to,
+      image,
+      caption: caption || "",
+    };
+    const res = await this.ultramsg.sendImage(data, $);
+    $.export("$summary", `Image successfully sent to "${to}"`);
+
+    return res;
+  },
+};

components/ultramsg/action/send-link/send-link.mjs

@@ -0,0 +1,38 @@
+import ultramsg from "../../ultramsg.app.mjs";
+
+export default {
+  name: "Send a Link",
+  description: "Send a link to a specified number. [See the docs here](https://docs.ultramsg.com/api/post/messages/link)",
+  key: "ultramsg-send-link",
+  version: "0.0.1",
+  type: "action",
+  props: {
+    ultramsg,
+    to: {
+      propDefinition: [
+        ultramsg,
+        "to",
+      ],
+    },
+    link: {
+      type: "string",
+      label: "Link",
+      description: "Link to be sent. (e.g., `https://example.com/`)",
+    },
+  },
+  async run({ $ }) {
+    const {
+      to,
+      link,
+    } = this;
+
+    const data = {
+      to,
+      link,
+    };
+    const res = await this.ultramsg.sendLink(data, $);
+    $.export("$summary", `Link successfully sent to "${to}"`);
+
+    return res;
+  },
+};

components/ultramsg/action/send-location/send-location.mjs

@@ -0,0 +1,52 @@
+import ultramsg from "../../ultramsg.app.mjs";
+
+export default {
+  name: "Send a Location",
+  description: "Send a location to a specified number. [See the docs here](https://docs.ultramsg.com/api/post/messages/location)",
+  key: "ultramsg-send-location",
+  version: "0.0.1",
+  type: "action",
+  props: {
+    ultramsg,
+    to: {
+      propDefinition: [
+        ultramsg,
+        "to",
+      ],
+    },
+    address: {
+      type: "string",
+      label: "Address",
+      description: "The address of your location. It will be used as a label",
+    },
+    lat: {
+      type: "string",
+      label: "Lat",
+      description: "The latitude of your location. (e.g., `25.197197`)",
+    },
+    lng: {
+      type: "string",
+      label: "Lng",
+      description: "The longitude of your location. (e.g., `55.2721877`)",
+    },
+  },
+  async run({ $ }) {
+    const {
+      to,
+      address,
+      lat,
+      lng,
+    } = this;
+
+    const data = {
+      to,
+      address,
+      lat,
+      lng,
+    };
+    const res = await this.ultramsg.sendLocation(data, $);
+    $.export("$summary", `Location successfully sent to "${to}"`);
+
+    return res;
+  },
+};

components/ultramsg/action/send-message/send-message.mjs

@@ -0,0 +1,48 @@
+import ultramsg from "../../ultramsg.app.mjs";
+import options from "../../common/options.mjs";
+
+export default {
+  name: "Send a Message",
+  description: "Send a message to a specified number. [See the docs here](https://docs.ultramsg.com/api/post/messages/chat)",
+  key: "ultramsg-send-message",
+  version: "0.0.1",
+  type: "action",
+  props: {
+    ultramsg,
+    to: {
+      propDefinition: [
+        ultramsg,
+        "to",
+      ],
+    },
+    body: {
+      type: "string",
+      label: "Body",
+      description: "Message content",
+    },
+    priority: {
+      type: "integer",
+      label: "priority",
+      description: "Priority on internal queue of your message",
+      default: 10,
+      options: options.priorities,
+    },
+  },
+  async run({ $ }) {
+    const {
+      to,
+      body,
+      priority,
+    } = this;
+
+    const data = {
+      to,
+      body,
+      priority,
+    };
+    const res = await this.ultramsg.sendMessage(data, $);
+    $.export("$summary", `Message successfully sent to "${to}"`);
+
+    return res;
+  },
+};

components/ultramsg/action/send-video/send-video.mjs

@@ -0,0 +1,38 @@
+import ultramsg from "../../ultramsg.app.mjs";
+
+export default {
+  name: "Send a Video",
+  description: "Send a video to a specified number. [See the docs here](https://docs.ultramsg.com/api/post/messages/video)",
+  key: "ultramsg-send-video",
+  version: "0.0.1",
+  type: "action",
+  props: {
+    ultramsg,
+    to: {
+      propDefinition: [
+        ultramsg,
+        "to",
+      ],
+    },
+    video: {
+      type: "string",
+      label: "Video",
+      description: "Public URL of your video",
+    },
+  },
+  async run({ $ }) {
+    const {
+      to,
+      video,
+    } = this;
+
+    const data = {
+      to,
+      video,
+    };
+    const res = await this.ultramsg.sendVideo(data, $);
+    $.export("$summary", `Video successfully sent to "${to}"`);
+
+    return res;
+  },
+};

components/ultramsg/common/options.mjs

@@ -0,0 +1,16 @@
+export default {
+  priorities: [
+    {
+      label: "0: for High priority like OTP messages.",
+      value: 0,
+    },
+    {
+      label: "5: used with general messages.",
+      value: 5,
+    },
+    {
+      label: "10: Non-urgent promotional offers and notifications to your customers",
+      value: 10,
+    },
+  ],
+};