List Contacts with Mailjet API on New Direct Message from Slack Bot API

Pipedream makes it easy to connect APIs for Mailjet, Slack Bot and 2,700+ other apps remarkably fast.

Trigger workflow on

New Direct Message from the Slack Bot API

Next, do this

List Contacts with the Mailjet 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 Slack Bot trigger and Mailjet action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New Direct Message trigger
1. Connect your Slack Bot account
2. Configure Polling schedule
3. Select a User Channel
Configure the List Contacts action
1. Connect your Mailjet account
2. Optional- Configure Limit
3. Optional- Configure Offset
4. Optional- Configure Max
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 Direct Message on Slack Bot

Description:Emit new event when a message is posted in a direct message channel (Bot). To open a conversation, use the Pipedream Action "Send a Direct Message" to send a message from the Bot, or enable direct messages to the Bot in your App Settings (Settings->App Home->Show Tabs->Messages Tab), and send a direct message to the Bot.

Version:0.0.4

Key:slack_bot-new-direct-message

View on GitHub

Slack Bot Overview#

The Slack Bot API allows you to build rich, interactive bots for Slack workspaces. These bots can respond to messages, post updates, and interact with users in various ways. With the Slack Bot API on Pipedream, developers can create automated workflows that trigger on specific events in Slack, such as new messages or reactions, and then perform defined actions, like sending data to other apps or processing the information within Pipedream's serverless platform. This tight integration with Pipedream enables both simple and complex automations, leveraging Pipedream's ability to connect with numerous apps and its powerful built-in code steps.

Trigger Code#

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

export default {
  ...common,
  key: "slack_bot-new-direct-message",
  name: "New Direct Message",
  version: "0.0.4",
  description: "Emit new event when a message is posted in a direct message channel (Bot). To open a conversation, use the Pipedream Action \"Send a Direct Message\" to send a message from the Bot, or enable direct messages to the Bot in your App Settings (Settings->App Home->Show Tabs->Messages Tab), and send a direct message to the Bot.",
  type: "source",
  dedupe: "unique",
  props: {
    ...common.props,
    channelId: {
      propDefinition: [
        common.props.app,
        "channelId",
        () => ({
          types: [
            constants.CHANNEL_TYPE.IM,
          ],
        }),
      ],
      label: "User Channel",
      description: `Events will only be emitted for direct messages between this user and the Bot. ${utils.CONVERSATION_PERMISSION_MESSAGE}`,
    },
  },
  methods: {
    ...common.methods,
    getResourceName() {
      return constants.RESOURCE_NAME.MESSAGES;
    },
    getResourceFn() {
      return this.app.conversationsHistory;
    },
    getResourceFnArgs() {
      return {
        channel: this.channelId,
        limit: constants.LIMIT,
        oldest: this.getLastTimestamp(),
        inclusive: false,
      };
    },
    generateMeta(resource) {
      return {
        id: resource.ts,
        ts: resource.ts,
        summary: `New Message Timestamp ${resource.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
Slack Bot	`app`	`app`	This component uses the Slack Bot app.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
Polling schedule	`timer`	`$.interface.timer`	How often to poll the Slack API
User Channel	`channelId`	`string`	Select a value from the drop down menu.

Trigger Authentication#

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

In the settings for your Slack app, visit the OAuth & Permissions section on the left. You'll see a token labeled Bot User OAuth Access Token. Copy and paste that below.

See Slack's docs on Bot User Tokens for more info.

About Slack Bot#

Interact with Slack with your own bot user

Action#

List Contacts on Mailjet

Description:Retrieve details for all contact lists - name, subscriber count, creation timestamp, deletion status. [See the docs here](https://dev.mailjet.com/email/reference/contacts/contact-list/#v3_get_contactslist)

Version:0.0.2

Key:mailjet-list-contacts

View on GitHub

Mailjet Overview#

Mailjet's API offers the power to craft, send, and track emails with finesse. You can wield it to automate email sequences, synchronize email lists with your databases, and send transactional emails with personalized content. It's a playground for creating tailored email campaigns and dissecting campaign performance with rich analytics.

Action Code#

import mailjetApp from "../../mailjet.app.mjs";

export default {
  key: "mailjet-list-contacts",
  name: "List Contacts",
  description: "Retrieve details for all contact lists - name, subscriber count, creation timestamp, deletion status. [See the docs here](https://dev.mailjet.com/email/reference/contacts/contact-list/#v3_get_contactslist)",
  type: "action",
  version: "0.0.2",
  props: {
    mailjetApp,
    limit: {
      type: "integer",
      label: "Limit",
      description: "Limit the response to a select number of returned objects.",
      optional: true,
    },
    offset: {
      type: "integer",
      label: "Offset",
      description: "Retrieve a list of objects starting from a certain offset. Combine this query parameter with Limit to retrieve a specific section of the list of objects.",
      optional: true,
    },
    max: {
      type: "integer",
      label: "Max",
      description: "Maximum number of objects to return.",
      optional: true,
    },
  },
  async run({ $ }) {
    try {
      const contacts = [];

      const resourcesStream =
        await this.mailjetApp.getResourcesStream({
          resourceFn: this.mailjetApp.listContacts,
          resourceFnArgs: {
            params: {
              Limit: this.limit,
              Offset: this.offset,
            },
          },
          max: this.max,
        });

      for await (const contact of resourcesStream) {
        contacts.push(contact);
      }

      $.export("$summary", `Successfully retrieved ${contacts.length} contacts.`);

      return contacts;

    } catch (error) {
      throw error.response?.res?.statusMessage ?? error;
    }
  },
};

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
Mailjet	`mailjetApp`	`app`	This component uses the Mailjet app.
Limit	`limit`	`integer`	Limit the response to a select number of returned objects.
Offset	`offset`	`integer`	Retrieve a list of objects starting from a certain offset. Combine this query parameter with Limit to retrieve a specific section of the list of objects.
Max	`max`	`integer`	Maximum number of objects to return.

Action Authentication#

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

You can get your API and Secret Keys in the API Key Management page in your Mailjet account.

About Mailjet#

Mailjet is an easy-to-use all-in-one e-mail platform. With our transactional and marketing e-mail solution, it’s never been easier to get your emails into the inbox!

More Ways to Connect Mailjet + Slack Bot#

Other Popular Integrations#

Create Contact with Mailjet API on New Message In Channel from Slack Bot API

Slack Bot + Mailjet

Try it

List Contacts with Mailjet API on New Message In Channel from Slack Bot API

Slack Bot + Mailjet

Try it

Send Message with Mailjet API on New Message In Channel from Slack Bot API

Slack Bot + Mailjet

Try it

Update Contact with Mailjet API on New Message In Channel from Slack Bot API

Slack Bot + Mailjet

Try it

Create Contact with Mailjet API on New Direct Message from Slack Bot API

Slack Bot + Mailjet

Try it

Popular Triggers#

New Direct Message from the Slack Bot API

Emit new event when a message is posted in a direct message channel (Bot). To open a conversation, use the Pipedream Action "Send a Direct Message" to send a message from the Bot, or enable direct messages to the Bot in your App Settings (Settings->App Home->Show Tabs->Messages Tab), and send a direct message to the Bot.

Try it

New Message In Channel from the Slack Bot API

Emit new event when a new message is posted to a public, private or group channel (Bot)

Try it

Contact Created from the Mailjet API

Emit new event when a contact is created. See the docs here

Try it