Send message with Sendbird API on Weekly schedule from Schedule API

Pipedream makes it easy to connect APIs for Sendbird, Schedule and 2,400+ other apps remarkably fast.

Trigger workflow on

Weekly schedule from the Schedule API

Next, do this

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

Select this integration
Configure the Weekly schedule trigger
1. Connect your Schedule account
2. Configure Cron Schedule
Configure the Send message action
1. Connect your Sendbird account
2. Configure Application Id
3. Select a Channel Type
4. Select a Channel URL
5. Select a User Id
6. Optional- Configure Send Push
7. Optional- Select a Mention Type
8. Optional- Select one or more Mentioned User Ids
9. Optional- Configure Is Silent
10. Optional- Configure Dedup Id
11. Select a Message Type
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#

Weekly schedule on Schedule

Description:Trigger your workflow on one or more days each week at a specific time (with timezone support).

Version:0.0.1

Key:schedule-weekly

View on GitHub

Schedule Overview#

The Schedule app in Pipedream is a powerful tool that allows you to trigger workflows at regular intervals, ranging from every minute to once a year. This enables the automation of repetitive tasks and the scheduling of actions to occur without manual intervention. By leveraging this API, you can execute code, run integrations, and process data on a reliable schedule, all within Pipedream's serverless environment.

Trigger Code#

import schedule from "../../schedule.app.mjs";

export default {
  name: "Weekly schedule",
  version: "0.0.1",
  key: "schedule-weekly",
  type: "source",
  description: "Trigger your workflow on one or more days each week at a specific time (with timezone support).",
  props: {
    schedule,
    cron: {
      propDefinition: [
        schedule,
        "cron",
      ],
      default: {
        cron: "0 10 * * 1",
      },
    },
  },
};

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
Schedule	`schedule`	`app`	This component uses the Schedule app.
Cron Schedule	`cron`	`$.interface.timer`	Enter a cron expression

Trigger Authentication#

The Schedule API does not require authentication.

About Schedule#

Trigger workflows on an interval or cron schedule.

Action#

Send message on Sendbird

Description:Sends a message to a channel. [See the docs here](https://sendbird.com/docs/chat/v3/platform-api/message/messaging-basics/send-a-message)

Version:0.0.1

Key:sendbird-send-message

View on GitHub

Sendbird Overview#

The Sendbird API provides programmatic access to advanced chat features, enabling the creation and management of in-app messaging for community forums, customer support, or any other chat-based interaction. By leveraging the Sendbird API on Pipedream, you can automate user management, message and channel handling, and event tracking. Pipedream's serverless platform simplifies these automations, offering a way to integrate chat functionalities with other services, trigger workflows from chat events, and handle real-time data processing without writing extensive infrastructure code.

Action Code#

import app from "../../sendbird.app.mjs";
import { ConfigurationError } from "@pipedream/platform";

export default {
  key: "sendbird-send-message",
  name: "Send message",
  description: "Sends a message to a channel. [See the docs here](https://sendbird.com/docs/chat/v3/platform-api/message/messaging-basics/send-a-message)",
  version: "0.0.1",
  type: "action",
  props: {
    app,
    applicationId: {
      propDefinition: [
        app,
        "applicationId",
      ],
    },
    channelType: {
      propDefinition: [
        app,
        "channelType",
      ],
    },
    channelUrl: {
      propDefinition: [
        app,
        "channelUrl",
        (c) => ({
          applicationId: c.applicationId,
          channelType: c.channelType,
        }),
      ],
    },
    userId: {
      propDefinition: [
        app,
        "userId",
        (c) => ({
          applicationId: c.applicationId,
        }),
      ],
    },
    sendPush: {
      propDefinition: [
        app,
        "sendPush",
      ],
    },
    mentionType: {
      propDefinition: [
        app,
        "mentionType",
      ],
    },
    mentionedUserIds: {
      propDefinition: [
        app,
        "mentionedUserIds",
        (c) => ({
          applicationId: c.applicationId,
        }),
      ],
    },
    isSilent: {
      propDefinition: [
        app,
        "isSilent",
      ],
    },
    dedupId: {
      propDefinition: [
        app,
        "dedupId",
      ],
    },
    messageType: {
      propDefinition: [
        app,
        "messageType",
      ],
      description: "Specifies the type of the message.",
      optional: false,
      reloadProps: true,
    },
  },
  async additionalProps() {
    if (!this.messageType) {
      return {};
    }
    if (this.messageType === "FILE") {
      return {
        url: {
          type: "string",
          label: "URL",
          description: "Specifies the URL of the file hosted on the server of your own or other third-party companies.",
        },
        fileName: {
          type: "string",
          label: "File Name",
          description: "The file name can be set to any string you want using the file name request property. If no file name is supplied, the name response property defaults to an empty string.",
          optional: true,
        },
      };
    }
    return {
      message: {
        type: "string",
        label: "Message",
        description: "Specifies the content of the message.",
      },
    };
  },
  async run({ $ }) {
    const opts = {
      message: this.message,
      url: this.url,
      file_name: this.fileName,
      user_id: this.userId,
      message_type: this.messageType,
      send_push: this.sendPush,
      mention_type: this.mentionType,
      mentioned_user_ids: this.mentionedUserIds,
      is_silent: this.isSilent,
      dedup_id: this.dedupId,
    };
    try {
      const message = await this.app.sendMessage(
        this.applicationId,
        this.channelType,
        this.channelUrl,
        opts,
      );
      $.export("$summary", `Successfully sent message with ID: ${message.message_id}`);
      return message;
    } catch (ex) {
      throw new ConfigurationError(ex?.body?.message);
    }
  },
};

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
Sendbird	`app`	`app`	This component uses the Sendbird app.
Application Id	`applicationId`	`string`	Specifies the unique ID of the Application. To find the application ID, sign in to Sendbird Dashboard, go to Settings > Application > General, and then check Application ID.
Channel Type	`channelType`	`string`	Select a value from the drop down menu:`{ "label": "Open Channels", "value": "open_channels" }{ "label": "Group Channels", "value": "group_channels" }`
Channel URL	`channelUrl`	`string`	Select a value from the drop down menu.
User Id	`userId`	`string`	Select a value from the drop down menu.
Send Push	`sendPush`	`boolean`	Determines whether to send a push notification for the message to the members of the channel (applicable to group channels only). Unlike text and file messages, a push notification for an admin message is not sent by default. (Default: true)
Mention Type	`mentionType`	`string`	Select a value from the drop down menu:`{ "label": "Users", "value": "users" }{ "label": "Channel", "value": "channel" }`
Mentioned User Ids	`mentionedUserIds`	`string[]`	Select a value from the drop down menu.
Is Silent	`isSilent`	`boolean`	Determines whether to send a message without updating some of the channel properties. If a message is sent in a channel, with this property set to true, the channel's last_message is updated only for the sender while its unread_message_count remains unchanged for all channel members.
Dedup Id	`dedupId`	`string`	Specifies the unique message ID created by other system. In general, this property is used to prevent the same message data from getting inserted when migrating the messages of the other system to Sendbird server. If specified, the server performs a duplicate check using the property value.
Message Type	`messageType`	`string`	Select a value from the drop down menu:`{ "label": "Message", "value": "MESG" }{ "label": "File", "value": "FILE" }{ "label": "Admin Message", "value": "ADMM" }`

Action Authentication#

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

To connect Sendbird, you will need to provide two keys.

In your organization's settings, please locate and copy your Organization API Key located in Settings the top-right corner under API Key.
Please navigate to the app that you have created, under "Applications" >> "Settings" >> "API Tokens", please copy your Master API Token.

Learn more at Sendbird API documentation