← Slack + Lumin PDF integrations

Send Signature Request with Lumin PDF API on New Message In Channels (Instant) from Slack API

Pipedream makes it easy to connect APIs for Lumin PDF, Slack and 2,800+ other apps remarkably fast.

Trigger workflow on
New Message In Channels (Instant) from the Slack API
Next, do this
Send Signature Request with the Lumin PDF API
No credit card required
Intro to Pipedream
Watch us build a workflow
Watch us build a workflow
8 min
Watch now ➜

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

Adyen logo
Appcues logo
Bandwidth logo
Checkr logo
ChartMogul logo
Dataminr logo
Gopuff logo
Gorgias logo
LinkedIn logo
Logitech logo
Replicated logo
Rudderstack logo
SAS logo
Scale AI logo
Webflow logo
Warner Bros. logo
Adyen logo
Appcues logo
Bandwidth logo
Checkr logo
ChartMogul logo
Dataminr logo
Gopuff logo
Gorgias logo
LinkedIn logo
Logitech logo
Replicated logo
Rudderstack logo
SAS logo
Scale AI logo
Webflow logo
Warner Bros. logo

Developers Pipedream

Getting Started

This integration creates a workflow with a Slack trigger and Lumin PDF 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 Message In Channels (Instant) trigger
    1. Connect your Slack account
    2. Optional- Select one or more Channels
    3. Configure slackApphook
    4. Optional- Configure Resolve Names
    5. Optional- Configure Ignore Bots
    6. Optional- Configure Ignore replies in threads
  3. Configure the Send Signature Request action
    1. Connect your Lumin PDF account
    2. Optional- Configure File URL
    3. Optional- Configure File
    4. Optional- Configure File URLs
    5. Optional- Configure Files
    6. Optional- Configure Signers
    7. Optional- Configure Viewers
    8. Configure Title
    9. Configure Expires At
    10. Optional- Configure Use Text Tags
    11. Optional- Select a Signing Type
    12. Optional- Configure Sender Email
    13. Optional- Configure Subject
    14. Optional- Configure Custom Email Title
    15. Optional- Configure syncDir
  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:Emit new event when a new message is posted to one or more channels
Version:1.0.25
Key:slack-new-message-in-channels

Slack Overview

The Pipedream app for Slack enables you to build event-driven workflows that interact with the Slack API. Once you authorize the app's access to your workspace, you can use Pipedream workflows to perform common Slack actions or write your own code against the Slack API.

The Pipedream app for Slack is not a typical app. You don't interact with it directly as a bot, and it doesn't add custom functionality to your workspace out of the box. It makes it easier to automate anything you'd typically use the Slack API for, using Pipedream workflows.

  • Automate posting updates to your team channels
  • Create a bot to answer common questions
  • Integrate with your existing tools and services
  • And much more!

Trigger Code

import common from "../common/base.mjs";
import constants from "../common/constants.mjs";
import sampleEmit from "./test-event.mjs";

export default {
  ...common,
  key: "slack-new-message-in-channels",
  name: "New Message In Channels (Instant)",
  version: "1.0.25",
  description: "Emit new event when a new message is posted to one or more channels",
  type: "source",
  dedupe: "unique",
  props: {
    ...common.props,
    conversations: {
      propDefinition: [
        common.props.slack,
        "conversation",
      ],
      type: "string[]",
      label: "Channels",
      description: "Select one or more channels to monitor for new messages.",
      optional: true,
    },
    // eslint-disable-next-line pipedream/props-description,pipedream/props-label
    slackApphook: {
      type: "$.interface.apphook",
      appProp: "slack",
      async eventNames() {
        return this.conversations || [
          "message",
        ];
      },
    },
    resolveNames: {
      propDefinition: [
        common.props.slack,
        "resolveNames",
      ],
    },
    ignoreBot: {
      propDefinition: [
        common.props.slack,
        "ignoreBot",
      ],
    },
    ignoreThreads: {
      type: "boolean",
      label: "Ignore replies in threads",
      description: "Ignore replies to messages in threads",
      optional: true,
    },
  },
  methods: {
    ...common.methods,
    getSummary() {
      return "New message in channel";
    },
    async processEvent(event) {
      if (event.type !== "message") {
        console.log(`Ignoring event with unexpected type "${event.type}"`);
        return;
      }
      if (event.subtype && !constants.ALLOWED_MESSAGE_IN_CHANNEL_SUBTYPES.includes(event.subtype)) {
        // This source is designed to just emit an event for each new message received.
        // Due to inconsistencies with the shape of message_changed and message_deleted
        // events, we are ignoring them for now. If you want to handle these types of
        // events, feel free to change this code!!
        console.log("Ignoring message with subtype.");
        return;
      }
      if ((this.ignoreBot) && (event.subtype == "bot_message" || event.bot_id)) {
        return;
      }
      // There is no thread message type only the thread_ts field
      // indicates if the message is part of a thread in the event.
      if (this.ignoreThreads && event.thread_ts) {
        console.log("Ignoring reply in thread");
        return;
      }
      if (this.resolveNames) {
        if (event.user) {
          event.user_id = event.user;
          event.user = await this.getUserName(event.user);
        } else if (event.bot_id) {
          event.bot = await this.getBotName(event.bot_id);
        }
        event.channel_id = event.channel;
        event.channel = await this.getConversationName(event.channel);
        if (event.team) {
          event.team_id = event.team;
          event.team = await this.getTeamName(event.team);
        }
      }
      return event;
    },
  },
  sampleEmit,
};

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
SlackslackappThis component uses the Slack app.
N/Adb$.service.dbThis component uses $.service.db to maintain state between executions.
Channelsconversationsstring[]Select a value from the drop down menu.
slackApphook$.interface.apphook
Resolve NamesresolveNamesboolean

Instead of returning channel, team, and user as IDs, return their human-readable names.

Ignore BotsignoreBotboolean

Ignore messages from bots

Ignore replies in threadsignoreThreadsboolean

Ignore replies to messages in threads

Trigger Authentication

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

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

channels:historychannels:readchannels:writeemoji:readgroups:historygroups:readgroups:writeim:historyim:readim:writelinks:readlinks:writempim:historympim:readmpim:writereactions:readreactions:writereminders:readreminders:writestars:readteam:readusergroups:readusergroups:writeusers:readusers:read.emailusers:writechat:write:botchat:write:userfiles:write:userfiles:readcommandsusers.profile:writeusers.profile:readsearch:read

About Slack

Slack is a channel-based messaging platform. With Slack, people can work together more effectively, connect all their software tools and services, and find the information they need to do their best work — all within a secure, enterprise-grade environment.

Action

Description:Send a signature request to signers. [See the documentation](https://developers.luminpdf.com/api/send-signature-request/)
Version:0.0.1
Key:lumin_pdf-send-signature-request

Action Code

import {
  ConfigurationError,
  getFileStreamAndMetadata,
} from "@pipedream/platform";
import FormData from "form-data";
import { parseObject } from "../../common/utils.mjs";
import luminPdf from "../../lumin_pdf.app.mjs";

export default {
  key: "lumin_pdf-send-signature-request",
  name: "Send Signature Request",
  description: "Send a signature request to signers. [See the documentation](https://developers.luminpdf.com/api/send-signature-request/)",
  version: "0.0.1",
  type: "action",
  props: {
    luminPdf,
    fileUrl: {
      type: "string",
      label: "File URL",
      description: "The URL of a single file to be downloaded and signed. This field is mutually exclusive with `file`, `files`, and `File URLs`. Only one of these fields should be provided in the request.",
      optional: true,
    },
    file: {
      type: "string",
      label: "File",
      description: "A single path to a file in the `/tmp` directory (for example, `/tmp/myFile.pdf`) to be sent for signature. This field is mutually exclusive with `File URL`, `Files`, and `File URLs`. Only one of these fields should be provided in the request.",
      optional: true,
    },
    fileUrls: {
      type: "string[]",
      label: "File URLs",
      description: "An array of URLs of files to be downloaded and signed. This field is mutually exclusive with `File`, `Files`, and `File URL`. Only one of these fields should be provided in the request.",
      optional: true,
    },
    files: {
      type: "string[]",
      label: "Files",
      description: "An array of path to files in the `/tmp` directory (for example, `/tmp/myFile.pdf`) to be sent for signature. This field is mutually exclusive with `File URL`, `Files`, and `File URLs`. Only one of these fields should be provided in the request.",
      optional: true,
    },
    signers: {
      type: "string[]",
      label: "Signers",
      description: "A list of objects of signers to add to your Signature Request. Format: `[{'email_address': 'email@example.com', 'name': 'John Doe', 'group': 1}, {'email_address': 'email2@example.com', 'name': 'Jane Doe', 'group': 2}]`. [See the documentation](https://developers.luminpdf.com/api/send-signature-request/) for more information.",
      optional: true,
    },
    viewers: {
      type: "string[]",
      label: "Viewers",
      description: "A list of objects of viewers to add to your Signature Request. Format: `[{'email_address': 'email@example.com', 'name': 'John Doe'}, {'email_address': 'email2@example.com', 'name': 'Jane Doe'}]`. [See the documentation](https://developers.luminpdf.com/api/send-signature-request/) for more information.",
      optional: true,
    },
    title: {
      type: "string",
      label: "Title",
      description: "The title you want to give the Signature Request.",
    },
    expiresAt: {
      type: "string",
      label: "Expires At",
      description: "When the Signature Request will expire. Should be later than today. In ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ).",
    },
    useTextTags: {
      type: "boolean",
      label: "Use Text Tags",
      description: "Set to `true` to enable Text Tag parsing in your document. Your Text Tags will be converted into UI components for the user to interact with.",
      optional: true,
    },
    signingType: {
      type: "string",
      label: "Signing Type",
      description: "The signing order for the Signature Request.",
      options: [
        "SAME_TIME",
        "ORDER",
      ],
      optional: true,
    },
    senderEmail: {
      type: "string",
      label: "Sender Email",
      description: "The email address of the sender.",
      optional: true,
    },
    subject: {
      type: "string",
      label: "Subject",
      description: "The subject of the email.",
      optional: true,
    },
    customEmailTitle: {
      type: "string",
      label: "Custom Email Title",
      description: "The title of the email.",
      optional: true,
    },
    syncDir: {
      type: "dir",
      accessMode: "read",
      sync: true,
      optional: true,
    },
  },
  methods: {
    async appendFile(formData, fieldName, file) {
      const {
        stream,
        metadata,
      } = await getFileStreamAndMetadata(file);
      formData.append(fieldName, stream, {
        contentType: metadata.contentType,
        knownLength: metadata.size,
        filename: metadata.name,
      });
    },
  },
  async run({ $ }) {
    const formData = new FormData();
    const checkFiles = {};
    if (this.file) checkFiles.file = this.file;
    if (this.files) checkFiles.files = this.files;
    if (this.fileUrl) checkFiles.fileUrl = this.fileUrl;
    if (this.fileUrls) checkFiles.fileUrls = this.fileUrls;

    if (Object.keys(checkFiles).length > 1) {
      throw new ConfigurationError("Only one of `File URL`, `File`, `File URLs`, or `Files` should be provided in the request.");
    }
    if (Object.keys(checkFiles).length === 0) {
      throw new ConfigurationError("At least one of `File URL`, `File`, `File URLs`, or `Files` should be provided in the request.");
    }

    if (this.file) {
      await this.appendFile(formData, "file", this.file);
    }
    if (this.files) {
      for (const [
        index,
        file,
      ] of this.files.entries()) {
        await this.appendFile(formData, `files[${index}]`, file);
      }
    }
    if (this.fileUrl) {
      formData.append("file_url", this.fileUrl);
    }
    if (this.fileUrls) {
      for (const [
        index,
        fileUrl,
      ] of this.fileUrls.entries()) {
        formData.append(`file_urls[${index}]`, fileUrl);
      }
    }
    if (this.signers) {
      for (const [
        index,
        signer,
      ] of parseObject(this.signers).entries()) {
        for (const item of Object.keys(signer)) {
          formData.append(`signers[${index}][${item}]`, signer[item]);
        }
      }
    }
    if (this.viewers) {
      for (const [
        index,
        viewer,
      ] of parseObject(this.viewers).entries()) {
        for (const item of Object.keys(viewer)) {
          formData.append(`viewers[${index}][${item}]`, viewer[item]);
        }
      }
    }
    if (this.title) formData.append("title", this.title);
    if (this.expiresAt) formData.append("expires_at", Date.parse(this.expiresAt));
    if (this.useTextTags) formData.append("use_text_tags", `${this.useTextTags}`);
    if (this.signingType) formData.append("signing_type", this.signingType);
    if (this.senderEmail) formData.append("custom_email[sender_email]", this.senderEmail);
    if (this.senderEmail) formData.append("custom_email[subject_name]", this.subject);
    if (this.senderEmail) formData.append("custom_email[title]", this.customEmailTitle);

    const response = await this.luminPdf.sendSignatureRequest({
      $,
      headers: formData.getHeaders(),
      data: formData,
    });

    if (response) {
      $.export("$summary", `Successfully sent signature request ${response.signature_request.signature_request_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.

LabelPropTypeDescription
Lumin PDFluminPdfappThis component uses the Lumin PDF app.
File URLfileUrlstring

The URL of a single file to be downloaded and signed. This field is mutually exclusive with file, files, and File URLs. Only one of these fields should be provided in the request.

Filefilestring

A single path to a file in the /tmp directory (for example, /tmp/myFile.pdf) to be sent for signature. This field is mutually exclusive with File URL, Files, and File URLs. Only one of these fields should be provided in the request.

File URLsfileUrlsstring[]

An array of URLs of files to be downloaded and signed. This field is mutually exclusive with File, Files, and File URL. Only one of these fields should be provided in the request.

Filesfilesstring[]

An array of path to files in the /tmp directory (for example, /tmp/myFile.pdf) to be sent for signature. This field is mutually exclusive with File URL, Files, and File URLs. Only one of these fields should be provided in the request.

Signerssignersstring[]

A list of objects of signers to add to your Signature Request. Format: [{'email_address': 'email@example.com', 'name': 'John Doe', 'group': 1}, {'email_address': 'email2@example.com', 'name': 'Jane Doe', 'group': 2}]. See the documentation for more information.

Viewersviewersstring[]

A list of objects of viewers to add to your Signature Request. Format: [{'email_address': 'email@example.com', 'name': 'John Doe'}, {'email_address': 'email2@example.com', 'name': 'Jane Doe'}]. See the documentation for more information.

Titletitlestring

The title you want to give the Signature Request.

Expires AtexpiresAtstring

When the Signature Request will expire. Should be later than today. In ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ).

Use Text TagsuseTextTagsboolean

Set to true to enable Text Tag parsing in your document. Your Text Tags will be converted into UI components for the user to interact with.

Signing TypesigningTypestringSelect a value from the drop down menu:SAME_TIMEORDER
Sender EmailsenderEmailstring

The email address of the sender.

Subjectsubjectstring

The subject of the email.

Custom Email TitlecustomEmailTitlestring

The title of the email.

syncDirsyncDirdir

Action Authentication

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

About Lumin PDF

Collaborate and Share PDFs

More Ways to Connect Lumin PDF + Slack

Cancel Signature Request with Lumin PDF API on New Channel Created (Instant) from Slack API
Slack + Lumin PDF
 
Try it
Cancel Signature Request with Lumin PDF API on New Direct Message (Instant) from Slack API
Slack + Lumin PDF
 
Try it
Cancel Signature Request with Lumin PDF API on New Interaction Events (Instant) from Slack API
Slack + Lumin PDF
 
Try it
Cancel Signature Request with Lumin PDF API on New Keyword Mention (Instant) from Slack API
Slack + Lumin PDF
 
Try it
Cancel Signature Request with Lumin PDF API on New Message In Channels (Instant) from Slack API
Slack + Lumin PDF
 
Try it
New Message In Channels (Instant) from the Slack API

Emit new event when a new message is posted to one or more channels

 
Try it
New Channel Created (Instant) from the Slack API

Emit new event when a new channel is created.

 
Try it
New Direct Message (Instant) from the Slack API

Emit new event when a message was posted in a direct message channel

 
Try it
New Interaction Events (Instant) from the Slack API

Emit new events on new Slack interactivity events sourced from Block Kit interactive elements, Slash commands, or Shortcuts

 
Try it
New Keyword Mention (Instant) from the Slack API

Emit new event when a specific keyword is mentioned in a channel

 
Try it
Send Message to Channel with the Slack API

Send a message to a public or private channel. See the documentation

 
Try it
Send Message with the Slack API

Send a message to a user, group, private channel or public channel. See the documentation

 
Try it
Build and Send a Block Kit Message with the Slack API

Configure custom blocks and send to a channel, group, or user. See the documentation

 
Try it
Reply to a Message Thread with the Slack API

Send a message as a threaded reply. See postMessage or scheduleMessage docs here

 
Try it
Send Message to User or Group with the Slack API

Send a message to a user or group. See the documentation

 
Try it

Explore Other Apps

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

HTTP / Webhook
HTTP / Webhook
Get a unique URL where you can send HTTP or webhook requests
Node
Node
Anything you can do with Node.js, you can do in a Pipedream workflow. This includes using most of npm's 400,000+ packages.
Python
Python
Anything you can do in Python can be done in a Pipedream Workflow. This includes using any of the 350,000+ PyPi packages available in your Python powered workflows.
Schedule
Schedule
Trigger workflows on an interval or cron schedule.
Pipedream Utils
Pipedream Utils
Utility functions to use within your Pipedream workflows
Notion
Notion
Notion is a new tool that blends your everyday work apps into one. It's the all-in-one workspace for you and your team.
OpenAI (ChatGPT)
OpenAI (ChatGPT)
OpenAI is an AI research and deployment company with the mission to ensure that artificial general intelligence benefits all of humanity. They are the makers of popular models like ChatGPT, DALL-E, and Whisper.
Anthropic (Claude)
Anthropic (Claude)
AI research and products that put safety at the frontier. Introducing Claude, a next-generation AI assistant for your tasks, no matter the scale.
Google Sheets
Google Sheets
Use Google Sheets to create and edit online spreadsheets. Get insights together with secure sharing in real-time and from any device.
Telegram
Telegram
Telegram, is a cloud-based, cross-platform, encrypted instant messaging (IM) service.
Google Drive
Google Drive
Google Drive is a file storage and synchronization service which allows you to create and share your work online, and access your documents from anywhere.
Google Calendar
Google Calendar
With Google Calendar, you can quickly schedule meetings and events and get reminders about upcoming activities, so you always know what’s next.
Shopify
Shopify
Shopify is a complete commerce platform that lets anyone start, manage, and grow a business. You can use Shopify to build an online store, manage sales, market to customers, and accept payments in digital and physical locations.
Supabase
Supabase
Supabase is an open source Firebase alternative.
MySQL
MySQL
MySQL is an open-source relational database management system.
PostgreSQL
PostgreSQL
PostgreSQL is a free and open-source relational database management system emphasizing extensibility and SQL compliance.
Premium
AWS
AWS
Amazon Web Services (AWS) offers reliable, scalable, and inexpensive cloud computing services.
Premium
Twilio SendGrid
Twilio SendGrid
Send marketing and transactional email through the Twilio SendGrid platform with the Email API, proprietary mail transfer agent, and infrastructure for scalable delivery.
Amazon SES
Amazon SES
Amazon SES is a cloud-based email service provider that can integrate into any application for high volume email automation
Premium
Klaviyo
Klaviyo
Email Marketing and SMS Marketing Platform
Premium
Zendesk
Zendesk
Zendesk is award-winning customer service software trusted by 200K+ customers. Make customers happy via text, mobile, phone, email, live chat, social media.
Premium
ServiceNow
ServiceNow
The smarter way to workflow
Slack
Slack
Slack is a channel-based messaging platform. With Slack, people can work together more effectively, connect all their software tools and services, and find the information they need to do their best work — all within a secure, enterprise-grade environment.
Microsoft Teams
Microsoft Teams
Microsoft Teams has communities, events, chats, channels, meetings, storage, tasks, and calendars in one place.