← GitHub + Front integrations

Send New Message with Front API on New Mention from GitHub API

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

Trigger workflow on
New Mention from the GitHub API
Next, do this
Send New Message with the Front 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 GitHub trigger and Front 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 Mention trigger
    1. Connect your GitHub account
    2. Configure timer
  3. Configure the Send New Message action
    1. Connect your Front account
    2. Select a Channel ID
    3. Select a Author ID
    4. Optional- Configure Sender Name
    5. Optional- Configure Subject
    6. Configure Body
    7. Optional- Configure Text
    8. Optional- Configure Attachments
    9. Optional- Select one or more Tag IDs
    10. Optional- Configure Is Archive
    11. Configure To
    12. Optional- Configure CC
    13. Optional- Configure BCC
  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 events when you are @mentioned in a new commit, comment, issue or pull request
Version:0.1.6
Key:github-new-mention

Trigger Code

import common from "../common/common-polling.mjs";

export default {
  ...common,
  key: "github-new-mention",
  name: "New Mention",
  description: "Emit new events when you are @mentioned in a new commit, comment, issue or pull request",
  version: "0.1.6",
  type: "source",
  hooks: {
    async activate() {
      const user = await this.github.getAuthenticatedUser();
      this._setUserLogin(user.login);
    },
  },
  dedupe: "unique",
  methods: {
    ...common.methods,
    _getUserLogin() {
      return this.db.get("userLogin");
    },
    _setUserLogin(userLogin) {
      this.db.set("userLogin", userLogin);
    },
  },
  async run() {
    const login = this._getUserLogin();

    const notifications = await this.github.getFilteredNotifications({
      reason: "mention",
      data: {
        participating: true,
        all: true,
      },
    });

    for (const notification of notifications) {
      const subject = await this.github.getFromUrl({
        url: notification?.subject?.url,
      });

      if (!subject.comments_url) continue;

      const comments = await this.github.getFromUrl({
        url: subject.comments_url,
      });

      for (const comment of comments) {
        if (comment?.body?.includes(`@${login}`)) {
          this.$emit(comment, {
            id: comment.id,
            summary: `New notification ${comment.id}`,
            ts: Date.parse(comment.created_at),
          });
        }
      }
    }
  },
};

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
GitHubgithubappThis component uses the GitHub app.
timer$.interface.timer
N/Adb$.service.dbThis component uses $.service.db to maintain state between executions.

Trigger Authentication

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

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

repoadmin:orgadmin:public_keyadmin:org_hookgistprojectnotificationsuserwrite:discussionwrite:packagesread:packagesadmin:repo_hook

About GitHub

Where the world builds software. Millions of developers and companies build, ship, and maintain their software on GitHub—the largest and most advanced development platform in the world.

Action

Description:Sends a new message from a channel. It will create a new conversation. [See the docs here](https://dev.frontapp.com/reference/post_channels-channel-id-messages).
Version:0.2.2
Key:frontapp-send-new-message

Front Overview

With the Front API, you can build a variety of applications and integrations to
help you and your team manage your email inboxes. Here are a few examples of
what you can build:

  • A personalized email assistant that can help you triage and respond to emails
  • An integration with your CRM that automatically adds emails from customers to
    your CRM
  • A tool that flags important emails and sends you notifications about them
  • An app that helps you find emails from a specific sender or with a certain
    subject line
  • A script that archives all of your old emails

These are just a few examples of what you can build with the Front API – the
possibilities are really only limited by your imagination!

Action Code

import frontApp from "../../frontapp.app.mjs";
import utils from "../../common/utils.mjs";

export default {
  key: "frontapp-send-new-message",
  name: "Send New Message",
  description: "Sends a new message from a channel. It will create a new conversation. [See the docs here](https://dev.frontapp.com/reference/post_channels-channel-id-messages).",
  version: "0.2.2",
  type: "action",
  props: {
    frontApp,
    channelId: {
      propDefinition: [
        frontApp,
        "channelId",
      ],
    },
    authorId: {
      propDefinition: [
        frontApp,
        "teammateId",
      ],
      label: "Author ID",
      description: "ID of the teammate on behalf of whom the answer is sent",
    },
    senderName: {
      type: "string",
      label: "Sender Name",
      description: "Name used for the sender info of the message",
      optional: true,
    },
    subject: {
      type: "string",
      label: "Subject",
      description: "Subject of the message for email message",
      optional: true,
    },
    body: {
      type: "string",
      label: "Body",
      description: "Body of the message",
    },
    text: {
      type: "string",
      label: "Text",
      description: "Text version of the body for messages with non-text body",
      optional: true,
    },
    attachments: {
      propDefinition: [
        frontApp,
        "attachments",
      ],
    },
    optionsTagIds: {
      propDefinition: [
        frontApp,
        "tagIds",
      ],
      description: "List of tag names to add to the conversation (unknown tags will automatically be created)",
    },
    optionsIsArchive: {
      type: "boolean",
      label: "Is Archive",
      description: "Archive the conversation right when sending the message (Default: true)",
      optional: true,
    },
    to: {
      propDefinition: [
        frontApp,
        "to",
      ],
    },
    cc: {
      propDefinition: [
        frontApp,
        "cc",
      ],
    },
    bcc: {
      propDefinition: [
        frontApp,
        "bcc",
      ],
    },
  },
  async run({ $ }) {
    const {
      channelId,
      authorId,
      senderName,
      subject,
      body,
      text,
      optionsIsArchive,
    } = this;

    const to = utils.parse(this.to);
    const cc = utils.parse(this.cc);
    const bcc = utils.parse(this.bcc);
    const tagIds = utils.parse(this.optionsTagIds);
    const attachments = utils.parse(this.attachments);

    const hasAttachments = utils.hasArrayItems(attachments);
    const hasCc = utils.hasArrayItems(cc);
    const hasBcc = utils.hasArrayItems(bcc);

    const data = utils.reduceProperties({
      initialProps: {
        to,
        body,
      },
      additionalProps: {
        cc: [
          cc,
          hasCc,
        ],
        bcc: [
          bcc,
          hasBcc,
        ],
        sender_name: senderName,
        subject,
        author_id: authorId,
        body,
        text,
        options: {
          tag_ids: tagIds,
          archive: optionsIsArchive ?? true,
        },
        attachments: [
          attachments,
          hasAttachments,
        ],
      },
    });

    const args = utils.reduceProperties({
      initialProps: {
        channelId,
        data,
      },
      additionalProps: {
        headers: [
          {
            "Content-Type": "multipart/form-data",
          },
          hasAttachments,
        ],
      },
    });

    const response = await this.frontApp.sendMessage(args);

    $.export("$summary", `Successfully sent new message to channel with ID ${response.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
FrontfrontAppappThis component uses the Front app.
Channel IDchannelIdstringSelect a value from the drop down menu.
Author IDauthorIdstringSelect a value from the drop down menu.
Sender NamesenderNamestring

Name used for the sender info of the message

Subjectsubjectstring

Subject of the message for email message

Bodybodystring

Body of the message

Texttextstring

Text version of the body for messages with non-text body

Attachmentsattachmentsstring[]

File paths of files previously downloaded in Pipedream E.g. (/tmp/my-image.jpg). Download a file to the /tmp directory

Tag IDsoptionsTagIdsstring[]Select a value from the drop down menu.
Is ArchiveoptionsIsArchiveboolean

Archive the conversation right when sending the message (Default: true)

Totostring[]

List of recipient handles who received the message.

CCccstring[]

List of recipient handles who received a copy of the message.

BCCbccstring[]

List of the recipeient handles who received a blind copy of the message.

Action Authentication

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

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

About Front

Customer communication platform

More Ways to Connect Front + GitHub

Send new message with Front API on New Commit from GitHub API
GitHub + Front
 
Try it
Send new message with Front API on New Gist from GitHub API
GitHub + Front
 
Try it
Send new message with Front API on New Notification from GitHub API
GitHub + Front
 
Try it
Send new message with Front API on New Organization from GitHub API
GitHub + Front
 
Try it
Send new message with Front API on New Repository from GitHub API
GitHub + Front
 
Try it
New Branch (Instant) from the GitHub API

Emit new events when a new branch is created

 
Try it
New Card in Column (Classic Projects) from the GitHub API

Emit new event when a (classic) project card is created or moved to a specific column. For Projects V2 use New Issue with Status trigger. More information here

 
Try it
New Collaborator (Instant) from the GitHub API

Emit new events when collaborators are added to a repo

 
Try it
New Commit (Instant) from the GitHub API

Emit new events on new commits to a repo or branch

 
Try it
New Commit Comment (Instant) from the GitHub API

Emit new events on new commit comments

 
Try it
Create Issue with the GitHub API

Create a new issue in a Gihub repo. See docs here

 
Try it
Search Issues and Pull Requests with the GitHub API

Find issues and pull requests by state and keyword. See docs here

 
Try it
Create Branch with the GitHub API

Create a new branch in a Github repo. See docs here

 
Try it
Create Issue Comment with the GitHub API

Create a new comment in a issue. See docs here

 
Try it
Create or update file contents with the GitHub API

Create or update a file in a repository. This will replace an existing file. See docs here

 
Try it