Run FFmpeg Command with Rendi API on New Job Overdue from Senta API

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

Trigger workflow on

New Job Overdue from the Senta API

Next, do this

Run FFmpeg Command with the Rendi 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 Senta trigger and Rendi action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New Job Overdue trigger
1. Connect your Senta account
2. Configure timer
3. Configure Client View ID
4. Select a Client
Configure the Run FFmpeg Command action
1. Connect your Rendi account
2. Configure Input File URL(s)
3. Configure Output File Name(s)
4. Configure FFmpeg Command
5. Optional- Configure Max Command Run Seconds
6. Optional- Configure Wait for Completion
7. Configure syncDir
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 Job Overdue on Senta

Description:Emit new event when a job becomes overdue.

Version:0.0.1

Key:senta-job-overdue

View on GitHub

Senta Overview#

The Senta API allows you to automate and integrate practice management tasks within the Senta platform. Leveraging Pipedream's capabilities, you can create workflows that streamline client onboarding, automate communication, task management, and synchronize data with other services. With Pipedream's serverless platform, these workflows can be triggered by various events, such as incoming emails, schedule timings, or actions from other apps, offering a seamless way to enhance your practice management operations.

Trigger Code#

import senta from "../../senta.app.mjs";
import { DEFAULT_POLLING_SOURCE_TIMER_INTERVAL } from "@pipedream/platform";

export default {
  key: "senta-job-overdue",
  name: "New Job Overdue",
  description: "Emit new event when a job becomes overdue.",
  version: "0.0.1",
  type: "source",
  dedupe: "unique",
  props: {
    senta,
    timer: {
      type: "$.interface.timer",
      default: {
        intervalSeconds: DEFAULT_POLLING_SOURCE_TIMER_INTERVAL,
      },
    },
    clientViewId: {
      propDefinition: [
        senta,
        "clientViewId",
      ],
    },
    clientId: {
      propDefinition: [
        senta,
        "clientId",
        (c) => ({
          clientViewId: c.clientViewId,
        }),
      ],
    },
  },
  methods: {
    generateMeta(job) {
      return {
        id: job._id,
        summary: job.title,
        ts: Date.now(),
      };
    },
  },
  async run() {
    const { docs } = await this.senta.listJobs({
      params: {
        cid: this.clientId,
        status: "overdue",
      },
    });
    for (const doc of docs) {
      const meta = this.generateMeta(doc);
      this.$emit(doc, meta);
    }
  },
};

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
Senta	`senta`	`app`	This component uses the Senta app.
	`timer`	`$.interface.timer`
Client View ID	`clientViewId`	`string`	Take any publicly-browsable client list, e.g. `https://acme.senta.co/c/l/v08a361263f4a` - the `v08a361263f4a` is the "viewId", i.e. the unique id of the client list that has been created by the practice.
Client	`clientId`	`string`	Select a value from the drop down menu.

Trigger Authentication#

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

To generate and copy your API Key,

Navigate to your Senta account and sign in
Click the “Settings” menu with the gear icon on the top right
Click “Add Integration”
Click “Generate API Key”

Your subdomain is 1234 if your Senta workspace URL is https://1234.senta.co

About Senta#

Practice management software for accountants and bookkeepers from £29 per user, per month. Officially the friendliest software of the year.

Action#

Run FFmpeg Command on Rendi

Description:Submit an FFmpeg command for processing with input and output file specifications. [See the documentation](https://docs.rendi.dev/api-reference/endpoint/run-ffmpeg-command)

Version:0.0.3

Key:rendi-run-ffmpeg-command

View on GitHub

Action Code#

import rendi from "../../rendi.app.mjs";
import { ConfigurationError } from "@pipedream/platform";
import { parseObject } from "../../common/utils.mjs";
import { axios } from "@pipedream/platform";
import fs from "fs";

export default {
  key: "rendi-run-ffmpeg-command",
  name: "Run FFmpeg Command",
  description: "Submit an FFmpeg command for processing with input and output file specifications. [See the documentation](https://docs.rendi.dev/api-reference/endpoint/run-ffmpeg-command)",
  version: "0.0.3",
  annotations: {
    destructiveHint: false,
    openWorldHint: true,
    readOnlyHint: false,
  },
  type: "action",
  props: {
    rendi,
    inputFiles: {
      type: "object",
      label: "Input File URL(s)",
      description: "Dictionary mapping file aliases to their publicly accessible paths, file name should appear in the end of the url, keys must start with 'in_'. You can use public file urls, google drive, dropbox, rendi stored files, s3 stored files, etc. as long as they are publicly accessible. [See the documentation](https://docs.rendi.dev/api-reference/endpoint/run-ffmpeg-command) for more information",
    },
    outputFiles: {
      type: "object",
      label: "Output File Name(s)",
      description: "Dictionary mapping file aliases to their desired output file names, keys must start with 'out_'. [See the documentation](https://docs.rendi.dev/api-reference/endpoint/run-ffmpeg-command) for more information",
    },
    command: {
      type: "string",
      label: "FFmpeg Command",
      description: "FFmpeg command string using {{alias}} placeholders for input and output files. `{{}}` is a reserved string, instead you can use `\\{\\{\\}\\}` , so for example `{{in_1}}` should be `\\{\\{in_1\\}\\}`. Example: `-i \\{\\{in_1\\}\\} \\{\\{out_1\\}\\}`",
    },
    maxCommandRunSeconds: {
      type: "string",
      label: "Max Command Run Seconds",
      description: "Maximum allowed runtime in seconds for a single FFmpeg command, the default is 300 seconds",
      optional: true,
    },
    waitForCompletion: {
      type: "boolean",
      label: "Wait for Completion",
      description: "Set to `true` to poll the API in 3-second intervals until the command is completed",
      optional: true,
      reloadProps: true,
    },
    syncDir: {
      type: "dir",
      accessMode: "write",
      sync: true,
    },
  },
  additionalProps() {
    if (this.waitForCompletion) {
      return {
        downloadFilesToTmp: {
          type: "boolean",
          label: "Download Files to /tmp",
          description: "Set to `true` to download the output files to the workflow's /tmp directory",
          optional: true,
        },
      };
    }
    return {};
  },
  async run({ $ }) {
    const inputFiles = parseObject(this.inputFiles);
    const outputFiles = parseObject(this.outputFiles);

    if (Object.keys(inputFiles).some((key) => !key.startsWith("in_"))) {
      throw new ConfigurationError("Input file keys must start with 'in_'");
    }
    if (Object.keys(outputFiles).some((key) => !key.startsWith("out_"))) {
      throw new ConfigurationError("Output file keys must start with 'out_'");
    }

    let response = await this.rendi.runFfmpegCommand({
      $,
      data: {
        input_files: inputFiles,
        output_files: outputFiles,
        ffmpeg_command: this.command,
        max_command_run_seconds: this.maxCommandRunSeconds,
      },
    });

    if (this.waitForCompletion) {
      const commandId = response.command_id;
      const timer = (ms) => new Promise((res) => setTimeout(res, ms));
      while (response?.status !== "SUCCESS" && response?.status !== "FAILED") {
        response = await this.rendi.getFfmpegCommand({
          $,
          commandId,
        });
        await timer(3000);
      }
      if (response?.status === "SUCCESS" && this.downloadFilesToTmp) {
        response.tmpFiles = [];
        for (const value of Object.values(response.output_files)) {
          const resp = await axios($, {
            url: value.storage_url,
            responseType: "arraybuffer",
          });
          const filename = value.storage_url.split("/").pop();
          const downloadedFilepath =
            `${process.env.STASH_DIR || "/tmp"}/${filename}`;
          fs.writeFileSync(downloadedFilepath, resp);

          response.tmpFiles.push({
            filename,
            downloadedFilepath,
          });
        }
      }

      if (response?.error_message) {
        throw new ConfigurationError(response.error_message);
      }
    }

    $.export("$summary", `FFmpeg command ${this.waitForCompletion
      ? "submitted and completed"
      : "submitted"} successfully`);
    return response;
  },
};

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
Rendi	`rendi`	`app`	This component uses the Rendi app.
Input File URL(s)	`inputFiles`	`object`	Dictionary mapping file aliases to their publicly accessible paths, file name should appear in the end of the url, keys must start with 'in_'. You can use public file urls, google drive, dropbox, rendi stored files, s3 stored files, etc. as long as they are publicly accessible. See the documentation for more information
Output File Name(s)	`outputFiles`	`object`	Dictionary mapping file aliases to their desired output file names, keys must start with 'out_'. See the documentation for more information
FFmpeg Command	`command`	`string`	FFmpeg command string using {{alias}} placeholders for input and output files. `{{}}` is a reserved string, instead you can use `\{\{\}\}` , so for example `{{in_1}}` should be `\{\{in_1\}\}`. Example: `-i \{\{in_1\}\} \{\{out_1\}\}`
Max Command Run Seconds	`maxCommandRunSeconds`	`string`	Maximum allowed runtime in seconds for a single FFmpeg command, the default is 300 seconds
Wait for Completion	`waitForCompletion`	`boolean`	Set to `true` to poll the API in 3-second intervals until the command is completed
syncDir	`syncDir`	`dir`