← Mercury + Twilio integrations

Send MMS with Twilio API on New Transaction from Mercury API

Pipedream makes it easy to connect APIs for Twilio, Mercury and 1000+ other apps remarkably fast.

Trigger workflow on
New Transaction from the Mercury API
Next, do this
Send MMS with the Twilio API
No credit card required
Into to Pipedream
Watch us build a workflow
Watch us build a workflow
7 min
Watch now ➜

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

Adyen logo
Brex logo
Carta logo
Checkr logo
Chameleon logo
DevRev logo
LinkedIn logo
Netflix logo
New Relic logo
OnDeck logo
Replicated logo
Scale AI logo
Teamwork logo
Warner Bros. logo
Xendit logo

Developers Pipedream

Getting Started

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

  1. Select this integration
  2. Configure the New Transaction trigger
    1. Connect your Mercury account
    2. Configure timer
    3. Select a Account
  3. Configure the Send MMS action
    1. Connect your Twilio account
    2. Select a From
    3. Configure To
    4. Configure Message Body
    5. Optional- Configure Media URL
  4. Deploy the workflow
  5. Send a test event to validate your setup
  6. 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

Description:Emits an event for each new transaction in an account.
Version:0.0.2
Key:mercury-new-transaction

Mercury Overview

With the Mercury API, you can build:

  • Applications to read and analyze articles
  • Content supplements such as summaries, image captions, and video transcripts
  • A customizeable newsfeed for your website or application
  • Your own news curation and content discovery tool

Trigger Code

const mercury = require("../../mercury.app.js");
const { DEFAULT_POLLING_SOURCE_TIMER_INTERVAL } = require("@pipedream/platform");

module.exports = {
  key: "mercury-new-transaction",
  name: "New Transaction",
  description: "Emits an event for each new transaction in an account.",
  version: "0.0.2",
  dedupe: "unique",
  type: "source",
  props: {
    mercury,
    db: "$.service.db",
    timer: {
      type: "$.interface.timer",
      default: {
        intervalSeconds: DEFAULT_POLLING_SOURCE_TIMER_INTERVAL,
      },
    },
    account: {
      propDefinition: [
        mercury,
        "account",
      ],
    },
  },
  methods: {
    getMeta(transaction) {
      const {
        id, counterpartyName: summary, postedAt,
      } = transaction;
      const ts = new Date(postedAt).getTime();
      return {
        id,
        summary,
        ts,
      };
    },
  },
  async run() {
    const lastRunTime = this.db.get("lastRunTime")
      ? new Date(this.db.get("lastRunTime"))
      : this.mercury.daysAgo(1);
    const params = {
      limit: 100,
      offset: 0,
      start: lastRunTime.toISOString().split("T")[0],
    };
    let totalTransactions = params.limit;
    while (totalTransactions == params.limit) {
      const results = await this.mercury.getTransactions(this.account, params);
      const { transactions } = results;
      totalTransactions = transactions.length;
      for (const transaction of transactions) {
        this.$emit(transaction, this.getMeta(transaction));
      }
      params.offset += params.limit;
    }
    this.db.set("lastRunTime", new Date());
  },
};

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.
LabelPropTypeDescription
MercurymercuryappThis component uses the Mercury app.
N/Adb$.service.dbThis component uses $.service.db to maintain state between executions.
timer$.interface.timer
AccountaccountstringSelect a value from the drop down menu.

Trigger Authentication

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

In order to get Mercury's API key, log into your Mercury account and go to the Settings page to generate a new one.

Action

Description:Send an SMS with text and media files. [See the docs](https://www.twilio.com/docs/sms/api/message-resource#create-a-message-resource) for more information
Version:0.1.1
Key:twilio-send-mms

Twilio Overview

With the Twilio API, you can build telephone applications that make and receive
phone calls, as well astext messaging applications that send and receive text
messages.

Some examples of applications you could build include:

  • A phone call application that allows you to make and receive phone calls over
    the internet
  • A text messaging application that allows you to send and receive text
    messages over the internet
  • A voicemail application that allows you to leave and receive voicemails over
    the internet

Action Code

import { phone } from "phone";
import twilio from "../../twilio.app.mjs";
import { messageToString } from "../../common/utils.mjs";

export default {
  key: "twilio-send-mms",
  name: "Send MMS",
  description: "Send an SMS with text and media files. [See the docs](https://www.twilio.com/docs/sms/api/message-resource#create-a-message-resource) for more information",
  type: "action",
  version: "0.1.1",
  props: {
    twilio,
    from: {
      propDefinition: [
        twilio,
        "from",
      ],
    },
    to: {
      propDefinition: [
        twilio,
        "to",
      ],
    },
    body: {
      propDefinition: [
        twilio,
        "body",
      ],
    },
    mediaUrl: {
      propDefinition: [
        twilio,
        "mediaUrl",
      ],
    },
  },
  async run({ $ }) {
    // Parse the given number into its E.164 equivalent
    // The E.164 phone number will be included in the first element
    // of the array, but the array will be empty if parsing fails.
    // See https://www.npmjs.com/package/phone
    const toParsed = phone(this.to);
    if (!toParsed || !toParsed.phoneNumber) {
      throw new Error(`Phone number ${this.to} couldn't be parsed as a valid number.`);
    }

    const data = {
      to: toParsed.phoneNumber,
      from: this.from,
      body: this.body,
      mediaUrl: this.mediaUrl,
    };

    const resp = await this.twilio.getClient().messages.create(data);
    $.export("$summary", `Successfully sent a new MMS, "${messageToString(resp)}"`);
    return resp;
  },
};

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.

LabelPropTypeDescription
TwiliotwilioappThis component uses the Twilio app.
FromfromstringSelect a value from the drop down menu.
Totostring

The destination phone number in E.164 format. Format with a + and country code (e.g., +16175551212).

Message Bodybodystring

The text of the message you want to send, limited to 1600 characters.

Media URLmediaUrlstring[]

The URL of the media you wish to send out with the message. The media size limit is 5MB. You may provide up to 10 media URLs per message.

Action Authentication

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

To connect your Twilio account to Pipedream,

First, create an API key in Twilio.

  • There are two types of keys: Master and Standard. You'll need a Master key to interact with certain API endpoints, like /Accounts.
  • If you don't need to interact with those endpoints, you can use a Standard key.

After creating your key, you'll see fields for Sid and Secret. Enter those in the fields below.

About Twilio

Cloud communications platform for building SMS, Voice & Messaging applications on an API built for global scale

More Ways to Connect Twilio + Mercury

Make a Phone Call with Twilio API on New Transaction from Mercury API
Mercury + Twilio
 
Try it
Send SMS with Twilio API on New Transaction from Mercury API
Mercury + Twilio
 
Try it
Delete Call with Twilio API on New Transaction from Mercury API
Mercury + Twilio
 
Try it
Delete Message with Twilio API on New Transaction from Mercury API
Mercury + Twilio
 
Try it
Download Recording Media with Twilio API on New Transaction from Mercury API
Mercury + Twilio
 
Try it
New Transaction from the Mercury API

Emits an event for each new transaction in an account.

 
Try it
New Incoming SMS (Instant) from the Twilio API

Emit new event every time an SMS is sent to the phone number set. Configures a webhook in Twilio, tied to an incoming phone number.

 
Try it
New Call (Instant) from the Twilio API

Emit new event each time a call to the phone number is completed. Configures a webhook in Twilio, tied to a phone number.

 
Try it
New Phone Number from the Twilio API

Emit new event when you add a new phone number to your account

 
Try it
New Recording from the Twilio API

Emit new event when a new call recording is created

 
Try it
Send SMS with the Twilio API

Send a simple text-only SMS. See the docs for more information

 
Try it
Make a Phone Call with the Twilio API

Make a phone call, passing text that Twilio will speak to the recipient of the call. See the docs for more information

 
Try it
Send MMS with the Twilio API

Send an SMS with text and media files. See the docs for more information

 
Try it
Delete Call with the Twilio API

Remove a call record from your account. See the docs for more information

 
Try it
Delete Message with the Twilio API

Delete a message record from your account. See the docs for more information

 
Try it