Add Comment with Front API on New Conversation from Drift API

Pipedream makes it easy to connect APIs for Front, Drift and 2,700+ other apps remarkably fast.

Trigger workflow on

New Conversation from the Drift API

Next, do this

Add Comment with the Front 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 Drift trigger and Front action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New Conversation trigger
1. Connect your Drift account
2. Configure Polling Interval
Configure the Add Comment action
1. Connect your Front account
2. Select a Conversation ID
3. Configure Body
4. Optional- Select a Author ID
5. Optional- Configure Is Pinned?
6. Optional- Configure Attachments
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 Conversation on Drift

Description:Emit new when a new conversation is started in Drift. [See the documentations](https://devdocs.drift.com/docs/retrieve-a-conversation)

Version:0.0.1

Key:drift-new-conversation

View on GitHub

Drift Overview#

The Drift API, contrary to the customer messaging platform, is actually a geocoding service provided by Geocod.io. It allows you to convert physical addresses to geographic coordinates and vice versa, enrich addresses with detailed location data, and offers batch geocoding features for processing multiple addresses simultaneously. With Pipedream, you can harness this API for a variety of location-based automations, enriching customer data with geographical insights, automating logistics, or enhancing marketing campaigns with location targeting.

Trigger Code#

import drift from "../../drift.app.mjs";
import { DEFAULT_POLLING_SOURCE_TIMER_INTERVAL } from "@pipedream/platform";

export default {
  key: "drift-new-conversation",
  name: "New Conversation",
  description: "Emit new when a new conversation is started in Drift. [See the documentations](https://devdocs.drift.com/docs/retrieve-a-conversation)",
  version: "0.0.1",
  type: "source",
  dedupe: "unique",
  props: {
    drift,
    db: "$.service.db",
    timer: {
      type: "$.interface.timer",
      label: "Polling Interval",
      description: "How often to poll Drift for new conversations.",
      default: {
        intervalSeconds: DEFAULT_POLLING_SOURCE_TIMER_INTERVAL,
      },
    },
  },

  async run({ $ }) {
    const {
      db, drift,
    } = this;

    const conversations = [];

    const result = await drift._makeRequest({
      $,
      path: "/conversations/list?limit=100&statusId=1",
    });

    if (!result.data.length) {
      console.log("No conversations found.");
      return;
    };

    const lastConversation = await db.get("lastConversation");

    if (!lastConversation) {
      await db.set("lastConversation", result.data[0].id);
      console.log(`Initialized with ID ${result.data[0].id}.`);
      return;
    };

    let isEnough = result.data.some((obj) => obj.id === lastConversation);

    conversations.push(...result.data);

    let nextUrl = result.links?.next;

    while (!isEnough && nextUrl) {
      const next = await drift.getNextPage($, nextUrl);
      isEnough = next.data.some((obj) => obj.id === lastConversation);
      conversations.push(...next.data);
      nextUrl = next.links?.next;
    };

    conversations.sort((a, b) => a.id - b.id);

    const lastConvIndex = conversations.findIndex((obj) => obj.id === lastConversation);

    if (lastConvIndex === -1) {
      throw new Error ("lastConversation not found in fetched data. Skipping emit.");
    };

    if (lastConvIndex + 1 === conversations.length) {
      console.log("No new conversations found");
      return;
    };

    for (let i = lastConvIndex + 1; i < conversations.length; i++) {

      this.$emit(conversations[i], {
        id: conversations[i].id,
        summary: `New conversation with ID ${conversations[i].contactId}`,
        ts: conversations[i].createdAt,
      });

    };

    const lastConvId = conversations[conversations.length - 1].id;
    await db.set("lastConversation", lastConvId);
  },
};

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
Drift	`drift`	`app`	This component uses the Drift app.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
Polling Interval	`timer`	`$.interface.timer`	How often to poll Drift for new conversations.

Trigger Authentication#

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

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

contact_readcontact_writeall_contact_readconversation_writeconversation_readuser_writeuser_readaccount_readaccount_writeplaybook_read

About Drift#

The New Way Businesses Buy From Businesses

Action#

Add Comment on Front

Description:Add a comment to a conversation. [See the documentation](https://dev.frontapp.com/reference/add-comment)

Version:0.0.1

Key:frontapp-add-comment

View on GitHub

Front Overview#

The Front API empowers you to automate the handling of your team's email inbox, collaborate on conversations, and streamline communication workflows. By harnessing this API on Pipedream, you can craft custom integrations that trigger actions in Front in response to events, synchronize data across platforms, and augment your team's productivity with automated tasks. This can include creating or updating conversations and contacts, managing tags, or firing off custom automation rules within Front.

Action Code#

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

export default {
  key: "frontapp-add-comment",
  name: "Add Comment",
  description: "Add a comment to a conversation. [See the documentation](https://dev.frontapp.com/reference/add-comment)",
  version: "0.0.1",
  type: "action",
  props: {
    frontApp,
    conversationId: {
      propDefinition: [
        frontApp,
        "conversationId",
      ],
    },
    body: {
      type: "string",
      label: "Body",
      description: "Content of the comment. Can include markdown formatting.",
    },
    authorId: {
      propDefinition: [
        frontApp,
        "teammateId",
      ],
      label: "Author ID",
      optional: true,
    },
    isPinned: {
      type: "boolean",
      label: "Is Pinned?",
      description: "Whether or not the comment is pinned in its conversation",
      optional: true,
    },
    attachments: {
      propDefinition: [
        frontApp,
        "attachments",
      ],
    },
  },
  async run({ $ }) {
    const response = await this.frontApp.addComment({
      $,
      conversationId: this.conversationId,
      data: {
        body: this.body,
        author_id: this.authorId,
        is_pinned: this.isPinned,
        attachments: this.attachments,
      },
      headers: utils.hasArrayItems(this.attachments) && {
        "Content-Type": "multipart/form-data",
      },
    });
    $.export("$summary", `Successfully created comment 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.

Label	Prop	Type	Description
Front	`frontApp`	`app`	This component uses the Front app.
Conversation ID	`conversationId`	`string`	Select a value from the drop down menu.
Body	`body`	`string`	Content of the comment. Can include markdown formatting.
Author ID	`authorId`	`string`	Select a value from the drop down menu.
Is Pinned?	`isPinned`	`boolean`	Whether or not the comment is pinned in its conversation
Attachments	`attachments`	`string[]`	File paths of files previously downloaded in Pipedream E.g. (`/tmp/my-image.jpg`). Download a file to the `/tmp` directory

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: