Send SMS or MMS with FracTEL API on New or Updated Event from Teamup API

Pipedream makes it easy to connect APIs for FracTEL, Teamup and 2,700+ other apps remarkably fast.

Trigger workflow on

New or Updated Event from the Teamup API

Next, do this

Send SMS or MMS with the FracTEL 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 Teamup trigger and FracTEL action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New or Updated Event trigger
1. Connect your Teamup account
2. Configure timer
3. Configure Calendar Key
4. Optional- Select one or more Sub-calendars
Configure the Send SMS or MMS action
1. Connect your FracTEL account
2. Select a Phone Number
3. Configure To
4. Optional- Configure Message
5. Optional- Configure Media URL
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 or Updated Event on Teamup

Description:Emit new event when an event is created or updated on a specified calendar.

Version:0.0.1

Key:teamup-new-or-updated-event

View on GitHub

Teamup Overview#

The TeamUp API provides an interface to interact with TeamUp's calendar services, allowing for robust management of schedules, events, and calendars. Leveraging this API within Pipedream, you can create automated workflows that handle event synchronization, notifications, and calendar data manipulation. Pipedream's serverless platform facilitates seamless integration with various services to enhance the capabilities of TeamUp, such as triggering actions on a schedule or in response to events, and connecting with other apps like Slack or Google Sheets for extended functionality.

Trigger Code#

import base from "../common/base.mjs";

export default {
  ...base,
  key: "teamup-new-or-updated-event",
  name: "New or Updated Event",
  description: "Emit new event when an event is created or updated on a specified calendar.",
  version: "0.0.1",
  type: "source",
  dedupe: "unique",
  methods: {
    ...base.methods,
    getParams(lastTs) {
      return {
        modifiedSince: lastTs
          ? lastTs
          : Date.parse(this.teamup.getFormattedDate(-29)) / 1000,
      };
    },
    getTsField(event) {
      return event.update_dt
        ? "update_dt"
        : "creation_dt";
    },
    isRelevant({
      event, lastTs,
    }) {
      return event?.update_dt
        ? Date.parse(event.update_dt) / 1000 > lastTs
        : Date.parse(event.creation_dt) / 1000 > lastTs;
    },
    generateMeta(event) {
      const ts = Date.parse(event.update_dt);
      return {
        id: `${event.id}${ts}`,
        summary: `Updated Event - ${event.title}`,
        ts,
      };
    },
  },
};

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
Teamup	`teamup`	`app`	This component uses the Teamup app.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
	`timer`	`$.interface.timer`
Calendar Key	`calendarKey`	`string`	Key associated with a calendar. Calendar keys are managed using the Web-based calendar settings application. Look for the Sharing tab.
Sub-calendars	`subCalendarIds`	`string[]`	Select a value from the drop down menu.

Trigger Authentication#

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

About Teamup#

Teamup makes it easy to manage schedules, availability, and events that involve many people and resources. It helps streamline schedule-driven business operations. It’s scalable, customizable, and easy for anyone to use.

Action#

Send SMS or MMS on FracTEL

Description:Allows to send an SMS or MMS to a particular phone number. [See the documentation](https://developer.fonestorm.com/reference/sendmessage)

Version:0.0.1

Key:fractel-send-sms-mms

View on GitHub

FracTEL Overview#

The FracTEL API enables integration of advanced telecommunications features into applications, allowing for the management of voice and messaging functionalities. This API can be particularly powerful when used on Pipedream, where it can be combined with hundreds of other apps to create robust, automated workflows. These can range from triggering calls based on specific events to automating SMS notifications for critical alerts.

Action Code#

import { parseObject } from "../../common/utils.mjs";
import fractel from "../../fractel.app.mjs";

export default {
  key: "fractel-send-sms-mms",
  name: "Send SMS or MMS",
  description: "Allows to send an SMS or MMS to a particular phone number. [See the documentation](https://developer.fonestorm.com/reference/sendmessage)",
  version: "0.0.1",
  type: "action",
  props: {
    fractel,
    phoneNumber: {
      propDefinition: [
        fractel,
        "phoneNumber",
      ],
      description: "The phone number to send the message to, including country code.",
    },
    to: {
      propDefinition: [
        fractel,
        "to",
      ],
    },
    message: {
      propDefinition: [
        fractel,
        "message",
      ],
      description: "The message content for SMS or MMS.",
      optional: true,
    },
    media: {
      propDefinition: [
        fractel,
        "media",
      ],
      optional: true,
    },
  },
  async run({ $ }) {
    if (!this.message && !this.media) {
      throw new Error("Either message or media must be provided.");
    }
    const response = await this.fractel.sendMessage({
      $,
      data: {
        to: this.to,
        fonenumber: this.phoneNumber,
        message: this.message,
        media: this.media && parseObject(this.media),
      },
    });

    $.export("$summary", `Successfully sent ${this.message
      ? "SMS"
      : "MMS"} with Id: ${response.message.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
FracTEL	`fractel`	`app`	This component uses the FracTEL app.
Phone Number	`phoneNumber`	`string`	Select a value from the drop down menu.
To	`to`	`string`	The recipient phone number, including country code.
Message	`message`	`string`	The message content for SMS or MMS.
Media URL	`media`	`string`	Media URL of the media file for MMS.

Action Authentication#

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

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