Send SMS with Bandwidth API on New Inbound Fax (Instant) from RingCentral API

Pipedream makes it easy to connect APIs for Bandwidth, RingCentral and 2,000+ other apps remarkably fast.

Trigger workflow on

New Inbound Fax (Instant) from the RingCentral API

Next, do this

Send SMS with the Bandwidth API

No credit card required

▶

Watch us build a workflow

4 min

Watch now ➜

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

Developers ♥ Pipedream

Getting Started#

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

Select this integration
Configure the New Inbound Fax (Instant) trigger
1. Connect your RingCentral account
2. Select one or more Extensions
Configure the Send SMS action
1. Connect your Bandwidth account
2. Configure To
3. Configure From
4. Configure Message
5. Configure Messaging Application ID
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 Inbound Fax (Instant) on RingCentral

Description:Emit new event on each incoming fax

Version:0.1.5

Key:ringcentral-new-inbound-fax

View on GitHub

RingCentral Overview#

RingCentral is a comprehensive cloud communication platform that melds messaging, video, and phone services. Integrating RingCentral with Pipedream allows for automated workflows involving SMS sending, call management, and leveraging communication logs for data-driven insights. With Pipedream's serverless execution model, you can trigger actions based on specific RingCentral events or schedule tasks to run at predetermined intervals, all without writing extensive code.

Trigger Code#

import common from "../common/http-based.mjs";

export default {
  ...common,
  key: "ringcentral-new-inbound-fax",
  name: "New Inbound Fax (Instant)",
  description: "Emit new event on each incoming fax",
  version: "0.1.5",
  type: "source",
  props: {
    ...common.props,
    extensionId: {
      propDefinition: [
        common.props.ringcentral,
        "extensionId",
      ],
    },
  },
  methods: {
    ...common.methods,
    getSupportedNotificationTypes() {
      return new Set([
        "ringcentral-inbound-fax-event",
      ]);
    },
    getPropValues() {
      return {
        extensionId: this.extensionId,
      };
    },
    generateMeta(data) {
      const {
        body: eventDetails,
        timestamp,
        uuid: id,
      } = data;
      const { from: { phoneNumber: callerPhoneNumber } } = eventDetails;

      const maskedCallerNumber = this.getMaskedNumber(callerPhoneNumber);
      const summary = `New inbound fax from ${maskedCallerNumber}`;
      const ts = Date.parse(timestamp);

      return {
        id,
        summary,
        ts,
      };
    },
    isEventRelevant(event) {
      const { body: eventDetails } = event.body;
      const { messageStatus } = eventDetails;
      return messageStatus === "Received";
    },
  },
};

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
RingCentral	`ringcentral`	`app`	This component uses the RingCentral app.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
N/A	`http`	`$.interface.http`	This component uses `$.interface.http` to generate a unique URL when the component is first instantiated. Each request to the URL will trigger the `run()` method of the component.
Extensions	`extensionId`	`string[]`	Select a value from the drop down menu.

Trigger Authentication#

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

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

About RingCentral#

Experience Intelligent Phone, Meetings, Contact Center, and AI Solutions with RingCentral, the complete cloud communications platform.

Action#

Send SMS on Bandwidth

Description:Send an SMS message using Bandwidth's Messaging API

Version:1.0.0

Key:bandwidth-send-sms

View on GitHub

Bandwidth Overview#

The Bandwidth API opens up a world of possibilities for integrating telecom services into your applications. Bandwidth specializes in voice, messaging, and 911 access, making it possible to programmatically send and receive text messages, orchestrate calls, and implement emergency call routing. Linking the Bandwidth API with Pipedream allows you to automate these telecom features with various triggers and actions from other apps, creating seamless and powerful workflows.

Action Code#

const bandwidth = require("../../bandwidth.app.js");

module.exports = {
  key: "bandwidth-send-sms",
  name: "Send SMS",
  description: "Send an SMS message using Bandwidth's Messaging API",
  type: "action",
  version: "1.0.0",
  props: {
    bandwidth,
    messageTo: {
      propDefinition: [
        bandwidth,
        "messageTo",
      ],
    },
    from: {
      propDefinition: [
        bandwidth,
        "from",
      ],
    },
    message: {
      propDefinition: [
        bandwidth,
        "message",
      ],
    },
    messagingApplicationId: {
      propDefinition: [
        bandwidth,
        "messagingApplicationId",
      ],
    },
  },
  async run () {
    const response = await this.bandwidth.sendSms(
      this.messageTo,
      this.from,
      this.message,
      this.messagingApplicationId,
    );
    console.log("Status Code:", response.statusCode);
    console.log("Message ID:", response.result.id);
    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
Bandwidth	`bandwidth`	`app`	This component uses the Bandwidth app.
To	`messageTo`	`string`	The number the message will be sent to, in E164 format ex `+19195551234`
From	`from`	`string`	The number the call or message event will come from, in E164 format ex `+19195551234`
Message	`message`	`string`	The text message content
Messaging Application ID	`messagingApplicationId`	`string`	The ID from the messaging application created in the Bandwidth Dashboard. The application must be associated with the location that the `from` number lives on.

Send SMS with Bandwidth API on New Inbound Fax (Instant) from RingCentral API

Pipedream makes it easy to connect APIs for Bandwidth, RingCentral and 2,000+ other apps remarkably fast.

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

Developers ♥ Pipedream

1-24of2,000+apps by most popular

1
-
24
of
2,000+
apps by most popular