← Discord + Verifalia integrations

Verify Email Address with Verifalia API on New Message (Instant) from Discord API

Pipedream makes it easy to connect APIs for Verifalia, Discord and 1000+ other apps remarkably fast.

Trigger workflow on
New Message (Instant) from the Discord API
Next, do this
Verify Email Address with the Verifalia API
No credit card required
Into to Pipedream
Watch us build a workflow
Watch us build a workflow
7 min
Watch now ➜

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

Adyen logo
Brex logo
Carta logo
Checkr logo
Chameleon logo
DevRev logo
LinkedIn logo
Netflix logo
New Relic logo
OnDeck logo
Replicated logo
Scale AI logo
Teamwork logo
Warner Bros. logo
Xendit logo

Developers Pipedream

Getting Started

This integration creates a workflow with a Discord trigger and Verifalia 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 (Instant) trigger
    1. Connect your Discord account
    2. Configure Channels
    3. Configure discordApphook
  3. Configure the Verify Email Address action
    1. Connect your Verifalia account
    2. Configure Email address
    3. Optional- Select a Quality Level
    4. Optional- Configure Data Retention Period
  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 for each message posted to one or more channels in a Discord server
Version:1.0.1
Key:discord-new-message

Discord Overview

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

Trigger Code

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

export default {
  type: "source",
  key: "discord-new-message",
  name: "New Message (Instant)",
  description: "Emit new event for each message posted to one or more channels in a Discord server",
  version: "1.0.1",
  dedupe: "unique",
  props: {
    discord,
    channels: {
      type: "$.discord.channel[]",
      appProp: "discord",
      label: "Channels",
      description: "Select the channel(s) you'd like to be notified for",
    },
    // eslint-disable-next-line pipedream/props-label,pipedream/props-description
    discordApphook: {
      type: "$.interface.apphook",
      appProp: "discord",
      async eventNames() {
        return this.channels || [];
      },
    },
  },
  async run(event) {
    if (event.guildID != this.discord.$auth.guild_id) {
      return;
    }
    this.$emit(event, {
      id: event.id,
    });
  },
};

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
DiscorddiscordappThis component uses the Discord app.
Channelschannels$.discord.channel[]

Select the channel(s) you'd like to be notified for

discordApphook$.interface.apphook

Trigger Authentication

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

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

botemailidentifyguilds

About Discord

Use this app to create a Discord source that emits messages from your guild to a Pipedream workflow.

Action

Description:Verify an email address and check if it is properly formatted, really exists and can accept mails, flagging spam traps, disposable emails and much more. [See the docs](https://verifalia.com/developers#email-validations-creating) for more information
Version:1.0.4
Key:verifalia-verify-email

Verifalia Overview

The Verifalia API is a powerful and secure suite of tools designed to validate
& clean data and email addresses. It can be used to help reduce fraud, improve
data quality, and boost marketing campaigns.

Verifalia's API can be used to build the following:

  • Email Validation: Validate a list of email addresses and check for accuracy,
    validity, and deliverability.
  • Email Address Hygiene & Cleaning: Automatically clean a list of email
    addresses to remove duplicates, typos, and invalid addresses.
  • Email Address List Verification: Check a list of email addresses and verify
    them against a specific domain.
  • Email Spam Score & Analysis: Analyze a list of emails and determine the
    associated spam level.
  • Phone Number Validation: Automatically validate a list of phone numbers and
    check for accuracy and improper formatting.
  • Bulk Email Sending: Execute a bulk email campaign and track email delivery
    rate in real-time.
  • Private DNS Check & Domain Name Verification: Check a domain's reliability
    and identity, as well as DNS records and MX records.
  • Domain Catch-all Check & Delivery Confirmation: Determine if a domain is
    flagged as a catch-all and confirm if emails sent to that domain will be
    received by the intended recipient.

Action Code

import axios from "axios";
import verifalia from "../../verifalia.app.mjs";
import common from "../../common.mjs";

import {
  CancellationToken,
  OperationCanceledError,
} from "verifalia";

export default {
  name: "Verify Email Address",
  description: "Verify an email address and check if it is properly formatted, really exists and can accept mails, " +
        "flagging spam traps, disposable emails and much more. [See the docs](https://verifalia.com/developers#email-validations-creating) for more information",
  key: "verifalia-verify-email",
  version: "1.0.4",
  type: "action",
  props: {
    verifalia,
    emailAddress: {
      type: "string",
      label: "Email address",
      description: "Enter the email address to verify (e.g. `batman@gmail.com`)",
      optional: false,
    },
    quality: {
      type: "string",
      label: "Quality Level",
      description: "The higher the quality level the longer it could take to complete the verification; by default, we use the configured default quality level for your Verifalia user.",
      optional: true,
      options: common.qualityLevelOptions,
    },
    retention: {
      type: "string",
      label: "Data Retention Period",
      description: "The data retention period to observe for the validation job, expressed in the format `dd.hh:mm:ss` " +
                "(where dd: days, hh: hours, mm: minutes, ss: seconds); the initial `dd.` part is added only for periods of " +
                "more than 24 hours. The value has a minimum of 5 minutes (`0:5:0`) and a maximum of 30 days (`30.0:0:0`): " +
                "Verifalia will delete the job and its data once its data retention period is over, starting to count when " +
                "it gets completed.",
      optional: true,
    },
  },

  async run({ $ }) {
    const { run } = $.context;
    const verifaliaClient = this.verifalia.buildVerifaliaRestClient();

    // This component takes advantage of the new Pipedream's flow suspension: we handle
    // the first run vs. callback scenarios hereafter.

    if (run.runs === 1) {
      // Check the format of the data retention period and report a user-friendly error

      if (this.retention && !this.verifalia.isValidTimeSpan(this.retention)) {
        throw new Error(`The specified data retention period '${this.retention}' is incorrect: must be in the ` +
                    "format dd.hh:mm:ss (where dd: days, hh: hours, mm: minutes, ss: seconds).");
      }

      // HACK: Pausing a workflow is not supported in test mode, as the editor would just
      // output the message "Would have paused until...". To overcome this, we are *not*
      // suspending runs in test mode and, in that case, proceed with a standard polling
      // to the API, backed by the usual Promise support. If the execution time approaches
      // the one we are allowed by Pipedream, we just let the user know.

      let resumeUrl = null;
      let waitForResults = false;
      let cancellationToken = null;

      if ($.context.test) {
        // In test mode, we will wait for the verification results during this execution
        // and cancel the token after 20s (the actual lowest limit is 30s).
        // See: https://pipedream.com/docs/limits/#time-per-execution

        waitForResults = true;
        cancellationToken = new CancellationToken();
        setTimeout(() => cancellationToken.cancel(), 20 * 1000);
      } else {
        // In deployment mode, we won't wait for the verification results during this
        // execution and, instead, rely on the Verifalia completion callback support and
        // on the Pipedream's new ability to suspend execution flows.

        resumeUrl = $.flow.rerun(86400 * 1000, {}, 1).resume_url;
      }

      // Submit the verification to Verifalia

      let job;

      try {
        job = await this.verifalia.wrapVerifaliaApiInvocation(async () => {
          return await verifaliaClient
            .emailValidations
            .submit({
              quality: this.quality,
              entries: [
                {
                  inputData: this.emailAddress,
                },
              ],
              retention: this.retention,
              callback: {
                url: resumeUrl,
              },
            },
            waitForResults,
            cancellationToken);
        });
      } catch (error) {
        // If the error is an OperationCanceledError it means that we are in test mode and
        // have manually cancelled the submission: just let the user know why that happened.

        if (error instanceof OperationCanceledError) {
          // Had to replace the word req*ire with a synonym because of https://github.com/PipedreamHQ/pipedream/issues/3187 :)

          throw new Error("This operation would need some more time to complete and that would not work properly in " +
                        "Pipedream's test mode. Please deploy your workflow to get a meaningful email verification result.");
        }

        throw error;
      }

      // Handle the verification outcome, if available

      if (job.overview.status === "Completed") {
        if (!resumeUrl) {
          // We are in test mode and the validation just completed in a single request

          return job;
        }

        // TODO: If the validation completed, abort the suspension and return the results
        // Blocked by https://github.com/PipedreamHQ/pipedream/issues/3151

        // We are *not* in test mode and the job is complete: simulate an instantaneous
        // webhook completion callback, as the external one may take a few seconds to
        // fire and we wish to continue the flow as fast as possible.

        return await axios({
          method: "POST",
          url: resumeUrl,
          data: {
            event: {
              type: "email-validation.completed",
              data: {
                id: job.overview.id,
              },
            },
          },
        });
      }

      // If we are here, the validation is not yet completed and the flow is going to
      // be suspended by Pipedream.
    } else {
      const callbackRequest = run.callback_request;

      // We are only interested in a specific callback type

      if (callbackRequest.body.event.type === "email-validation.completed") {
        // Retrieve and return the job

        const jobId = callbackRequest.body.event.data.id;

        return await this.verifalia.wrapVerifaliaApiInvocation(() => verifaliaClient
          .emailValidations
          .get(jobId));
      }

      // We have just received a callback we weren't waiting for :/

      console.log(callbackRequest);
      throw new Error("An error occurred while processing your request, sorry.");
    }
  },
};

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
VerifaliaverifaliaappThis component uses the Verifalia app.
Email addressemailAddressstring

Enter the email address to verify (e.g. batman@gmail.com)

Quality LevelqualitystringSelect a value from the drop down menu:{ "label": "Standard quality", "value": "standard" }{ "label": "High quality", "value": "high" }{ "label": "Extreme quality", "value": "extreme" }
Data Retention Periodretentionstring

The data retention period to observe for the validation job, expressed in the format dd.hh:mm:ss (where dd: days, hh: hours, mm: minutes, ss: seconds); the initial dd. part is added only for periods of more than 24 hours. The value has a minimum of 5 minutes (0:5:0) and a maximum of 30 days (30.0:0:0): Verifalia will delete the job and its data once its data retention period is over, starting to count when it gets completed.

Action Authentication

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

In order to connect Verifalia with Pipedream, enter your Verifalia username and password below.

  • To learn more about how Verifalia handles authentication, see their documentation.
  • Make sure to use a strong and unique password for Verifalia.

About Verifalia

Verifalia is a fast and accurate email verification service which identifies deliverable, invalid, or otherwise risky email addresses in real-time: it stops bad and low-quality emails getting into your systems, reduces bounce rates and keeps your campaigns deliverable.

More Ways to Connect Verifalia + Discord

Delete Email Verification Job with Verifalia API on New Message from Discord API
Discord + Verifalia
 
Try it
Get Credits Balance with Verifalia API on New Message from Discord API
Discord + Verifalia
 
Try it
Delete Email Verification Job with Verifalia API on Message Deleted (Instant) from Discord API
Discord + Verifalia
 
Try it
Get Credits Balance with Verifalia API on Message Deleted (Instant) from Discord API
Discord + Verifalia
 
Try it
Verify Email Address with Verifalia API on Message Deleted (Instant) from Discord API
Discord + Verifalia
 
Try it
New Message (Instant) from the Discord API

Emit new event for each message posted to one or more channels in a Discord server

 
Try it
Message Deleted (Instant) from the Discord API

Emit new event for each message deleted

 
Try it
New Command Received (Instant) from the Discord API

Emit new event for each command posted to one or more channels in a Discord server

 
Try it
New Guild Member (Instant) from the Discord API

Emit new event for each new member added to a guild

 
Try it
Reaction Added (Instant) from the Discord API

Emit new event for each reaction added to a message

 
Try it
Send Message with the Discord API

Send a simple message to a Discord channel

 
Try it
Send Message (Advanced) with the Discord API

Send a simple or structured message (using embeds) to a Discord channel

 
Try it
Send Message With File with the Discord API

Post a message with an attached file

 
Try it
Delete Email Verification Job with the Verifalia API

Delete a previously submitted email verification job. See the docs for more information

 
Try it
Get Credits Balance with the Verifalia API

Get the number of credit packs and free daily credits available to the account. See the docs for more information

 
Try it