Send a Message with UltraMsg API on New File from Dropbox API

Pipedream makes it easy to connect APIs for UltraMsg, Dropbox and 2,900+ other apps remarkably fast.

Trigger workflow on

New File from the Dropbox API

Next, do this

Send a Message with the UltraMsg API

No credit card required

▶

Watch us build a workflow

8 min

Watch now ➜

Trusted by 1,000,000+ developers from startups to Fortune 500 companies

Developers ♥ Pipedream

Getting Started#

This integration creates a workflow with a Dropbox trigger and UltraMsg action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New File trigger
1. Connect your Dropbox account
2. Select a Path
3. Configure Recursive
4. Configure dropboxApphook
5. Configure Include Media Info
6. Configure Include Link
Configure the Send a Message action
1. Connect your UltraMsg account
2. Select a To
3. Configure Body
4. Select a priority
Deploy the workflow
Send a test event to validate your setup
Turn on the trigger

Details#

This integration uses pre-built, source-available components from Pipedream's GitHub repo. These components are developed by Pipedream and the community, and verified and maintained by Pipedream.

To contribute an update to an existing component or create a new component, create a PR on GitHub. If you're new to Pipedream component development, you can start with quickstarts for trigger span and action development, and then review the component API reference.

Trigger#

New File on Dropbox

Description:Emit new event when a new file is added to your account or a specific folder. Make sure the number of files/folders in the watched folder does not exceed 4000.

Version:0.0.20

Key:dropbox-new-file

View on GitHub

Dropbox Overview#

The Dropbox API on Pipedream enables you to automate file and folder operations, streamlining workflows that involve storing, syncing, and sharing content. With this API, you can programmatically manage files, set up event-driven triggers based on changes within Dropbox, and leverage Pipedream's capabilities to connect with hundreds of other apps for extended automation scenarios. It's ideal for building custom file management solutions, archiving systems, or collaborative content workflows without writing extensive code.

Trigger Code#

import common from "../common/common.mjs";
import sampleEmit from "./test-event.mjs";

export default {
  ...common,
  dedupe: "unique",
  type: "source",
  key: "dropbox-new-file",
  name: "New File",
  version: "0.0.20",
  description: "Emit new event when a new file is added to your account or a specific folder. Make sure the number of files/folders in the watched folder does not exceed 4000.",
  props: {
    ...common.props,
    includeMediaInfo: {
      label: "Include Media Info",
      type: "boolean",
      description: "Emit media info for photos and videos (incurs an additional API call)",
      default: false,
    },
    includeLink: {
      label: "Include Link",
      type: "boolean",
      description: "Emit temporary download link to file (incurs an additional API call)",
      default: false,
    },
  },
  hooks: {
    async activate() {
      await this.getHistoricalEvents([
        "file",
      ]);
      const startTime = new Date();
      const state = await this.dropbox.initState(this);
      this._setLastFileModTime(startTime);
      this._setDropboxState(state);
    },
  },
  methods: {
    ...common.methods,
    _setLastFileModTime(time) {
      this.db.set("last_file_mod_time", time);
    },
    _getLastFileModTime() {
      return this.db.get("last_file_mod_time");
    },
  },
  async run() {
    const lastFileModTime = this._getLastFileModTime();
    const state = this._getDropboxState();
    let currFileModTime = "";
    const {
      ret: updates, state: newState,
    } = await this.dropbox.getUpdates(this, state);
    this._setDropboxState(newState);
    for (let update of updates) {
      let file = {
        ...update,
      };
      if (update[".tag"] !== "file") {
        continue;
      }
      if (update.server_modified > currFileModTime) {
        currFileModTime = update.server_modified;
      }
      const isNewFile = await this.isNewFile(update, lastFileModTime);
      if (!isNewFile) {
        continue;
      }
      if (this.includeMediaInfo) {
        file = await this.getMediaInfo(update);
      }
      if (this.includeLink) {
        file.link = await this.getTemporaryLink(update);
      }
      this.$emit(file, this.getMeta(file.id, file.path_display || file.id));
    }
    if (currFileModTime != "") {
      this._setLastFileModTime(currFileModTime);
    }
  },
  sampleEmit,
};

Trigger Configuration#

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI and CLI.

Label	Prop	Type	Description
Dropbox	`dropbox`	`app`	This component uses the Dropbox app.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
Path	`path`	`string`	Select a value from the drop down menu.
Recursive	`recursive`	`boolean`	Also watch sub-directories and their contents.
	`dropboxApphook`	`$.interface.apphook`
Include Media Info	`includeMediaInfo`	`boolean`	Emit media info for photos and videos (incurs an additional API call)
Include Link	`includeLink`	`boolean`	Emit temporary download link to file (incurs an additional API call)

Trigger Authentication#

Dropbox uses OAuth authentication. When you connect your Dropbox account, Pipedream will open a popup window where you can sign into Dropbox and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any Dropbox API.

Pipedream requests the following authorization scopes when you connect your account:

About Dropbox#

Dropbox gives you secure access to all your files. Collaborate with friends, family, and coworkers from any device.

Action#

Send a Message on UltraMsg

Description:Send a message to a specified number. [See the docs here](https://docs.ultramsg.com/api/post/messages/chat)

Version:0.0.1

Key:ultramsg-send-message

View on GitHub

UltraMsg Overview#

UltraMsg API offers a suite of messaging capabilities that let you automate WhatsApp messaging. With it, you can send and receive messages, create WhatsApp chatbots, and manage media, enabling a wide range of automated interactions with users. Pipedream acts as a powerful accelerator here, letting you connect UltraMsg to hundreds of other apps to craft custom workflows.

Action Code#

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;
  },
};

Action Configuration#

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI.

Label	Prop	Type	Description
UltraMsg	`ultramsg`	`app`	This component uses the UltraMsg app.
To	`to`	`string`	Select a value from the drop down menu.
Body	`body`	`string`	Message content
priority	`priority`	`integer`	Select a value from the drop down menu:`{ "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 }`

Action Authentication#

UltraMsg uses API keys for authentication. When you connect your UltraMsg account, Pipedream securely stores the keys so you can easily authenticate to UltraMsg APIs in both code and no-code steps.

To connect your UltraMsg account with Pipedream, get your Instance Id and Token on the Instances page within your UltraMsg account.

About UltraMsg#

Ultramsg is a WhatsApp API provider and a gateway for working with messages.

More Ways to Connect UltraMsg + Dropbox#

Other Popular Integrations#

Send Audio with UltraMsg API on New or Modified File or Folder from Dropbox API

Dropbox + UltraMsg

Try it

Send a Document with UltraMsg API on New or Modified File or Folder from Dropbox API

Dropbox + UltraMsg

Try it

Send an Image with UltraMsg API on New or Modified File or Folder from Dropbox API

Dropbox + UltraMsg

Try it

Send a Link with UltraMsg API on New or Modified File or Folder from Dropbox API

Dropbox + UltraMsg

Try it

Send Audio with UltraMsg API on New or Modified File or Folder from Dropbox API

Dropbox + UltraMsg

Try it

Popular Triggers#

New File from the Dropbox API

Emit new event when a new file is added to your account or a specific folder. Make sure the number of files/folders in the watched folder does not exceed 4000.

Try it

New Folder from the Dropbox API

Emit new event when a new folder is created. Make sure the number of files/folders in the watched folder does not exceed 4000.

Try it

New or Modified File or Folder from the Dropbox API

Emit new event when a file or folder is added or modified. Make sure the number of files/folders in the watched folder does not exceed 4000.

Try it