Get Referring Domains with Ahrefs API on New Direct Message from Slack Bot API

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

Trigger workflow on

New Direct Message from the Slack Bot API

Next, do this

Get Referring Domains with the Ahrefs 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 Ahrefs 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 Get Referring Domains action
1. Connect your Ahrefs account
2. Configure target
3. Optional- Select a mode
4. Optional- Configure limit
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#

Get Referring Domains on Ahrefs

Description:Get the referring domains that contain backlinks to the target URL or domain.

Version:0.0.17

Key:ahrefs-get-referring-domains

View on GitHub

Ahrefs Overview#

Ahrefs API taps into the vast data reserves of Ahrefs, a robust SEO tool, to programmatically access insights into backlink profiles, keyword rankings, and SEO health. With Pipedream's capabilities, you can automate SEO monitoring, integrate with content management systems, trigger alerts for new or lost backlinks, or gather intelligence for keyword research—all without manual intervention. This unlocks the potential for real-time SEO strategy adjustments and the integration of SEO data into broader business processes or analytics platforms.

Action Code#

const ahrefs = require("../../ahrefs.app.js");
const axios = require("axios");

module.exports = {
  name: "Get Referring Domains",
  description: "Get the referring domains that contain backlinks to the target URL or domain.",
  key: "ahrefs-get-referring-domains",
  version: "0.0.17",
  type: "action",
  props: {
    ahrefs,
    target: {
      propDefinition: [
        ahrefs,
        "target",
      ],
    },
    mode: {
      propDefinition: [
        ahrefs,
        "mode",
      ],
    },
    limit: {
      propDefinition: [
        ahrefs,
        "limit",
      ],
    },
  },
  async run() {
    return (await axios({
      url: "https://apiv2.ahrefs.com",
      params: {
        token: this.ahrefs.$auth.oauth_access_token,
        from: "refdomains",
        target: this.target,
        mode: this.mode,
        limit: this.limit,
        order_by: "domain_rating:desc",
        output: "json",
      },
    })).data;
  },
};

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
Ahrefs	`ahrefs`	`app`	This component uses the Ahrefs app.
target	`target`	`string`	Enter a domain or URL.
mode	`mode`	`string`	Select a value from the drop down menu:`{ "label": "Exact", "value": "exact" }{ "label": "Domain", "value": "domain" }{ "label": "Subdomain", "value": "subdomains" }{ "label": "Prefix", "value": "prefix" }`
limit	`limit`	`integer`	Number of results to return.

Action Authentication#

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

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

api

About Ahrefs#

SEO Tools & Resources

More Ways to Connect Ahrefs + Slack Bot#

Other Popular Integrations#

Get Backlinks One Per Domain with Ahrefs API on New Message In Channel from Slack Bot API

Slack Bot + Ahrefs

Try it

Get Backlinks with Ahrefs API on New Message In Channel from Slack Bot API

Slack Bot + Ahrefs

Try it

Get Referring Domains with Ahrefs API on New Message In Channel from Slack Bot API

Slack Bot + Ahrefs

Try it

Get Backlinks One Per Domain with Ahrefs API on New Direct Message from Slack Bot API

Slack Bot + Ahrefs

Try it

Get Backlinks with Ahrefs API on New Direct Message from Slack Bot API

Slack Bot + Ahrefs

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