Detect Intent with Google Dialogflow API on New SMS Message Received from Bird API

Pipedream makes it easy to connect APIs for Google Dialogflow, Bird and 2,700+ other apps remarkably fast.

Trigger workflow on

New SMS Message Received from the Bird API

Next, do this

Detect Intent with the Google Dialogflow 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 Bird trigger and Google Dialogflow action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New SMS Message Received trigger
1. Connect your Bird account
2. Configure timer
Configure the Detect Intent action
1. Connect your Google Dialogflow account
2. Configure Session ID
3. Optional- Configure Query Params
4. Optional- Configure Query Input
5. Optional- Configure Output Audio Config
6. Optional- Configure Output Audio Config Mask
7. Optional- Configure Input Audio File or URL
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 SMS Message Received on Bird

Description:Emit new event when a new SMS message is received. [See the documentation](https://developers.messagebird.com/api/sms-messaging/#list-messages)

Version:0.0.1

Key:message_bird-new-sms-message-received

View on GitHub

Bird Overview#

Message Bird is a communications platform offering a suite of API solutions for sending messages, making voice calls, and conducting video conferences. With Pipedream, you can harness these capabilities to automate personalized notifications, streamline customer support, and facilitate global communication workflows. Message Bird's API on Pipedream allows you to send real-time alerts, trigger voice messages based on customer actions, and integrate with other services to create powerful, multi-channel communication systems.

Trigger Code#

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

export default {
  key: "message_bird-new-sms-message-received",
  name: "New SMS Message Received",
  description: "Emit new event when a new SMS message is received. [See the documentation](https://developers.messagebird.com/api/sms-messaging/#list-messages)",
  version: "0.0.1",
  dedupe: "unique",
  type: "source",
  props: {
    messagebird,
    db: "$.service.db",
    timer: {
      type: "$.interface.timer",
      default: {
        intervalSeconds: DEFAULT_POLLING_SOURCE_TIMER_INTERVAL,
      },
    },
  },
  methods: {
    _getLastTs() {
      return this.db.get("lastTs");
    },
    _setLastTs(lastTs) {
      this.db.set("lastTs", lastTs);
    },
    generateMeta(message) {
      return {
        id: message.id,
        summary: `New Message ID: ${message.id}`,
        ts: Date.parse(message.createdDatetime),
      };
    },
  },
  async run() {
    let lastTs = this._getLastTs();

    const { items } = await this.messagebird.listSMSMessages({
      params: {
        direction: "mo", // mt = sent, mo = received
        type: "sms",
        from: lastTs,
      },
    });

    if (!items?.length) {
      return;
    }

    for (const message of items) {
      const meta = this.generateMeta(message);
      this.$emit(message, meta);

      if (!lastTs || Date.parse(message.createdDatetime) > Date.parse(lastTs)) {
        lastTs = message.createdDatetime;
      }
    }

    this._setLastTs(lastTs);
  },
};

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
Bird	`messagebird`	`app`	This component uses the Bird app.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
	`timer`	`$.interface.timer`

Trigger Authentication#

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

Once you sign in, the API key information are available in the Developer Settings, which is shown as Manage API Keys in the middle right of the Dashboard

About Bird#

Business in a box. Grow, Manage, Automate your company. Everything you need in one app.

Action#

Detect Intent on Google Dialogflow

Description:Processes a natural language query and returns structured, actionable data as a result, [See REST docs](https://cloud.google.com/dialogflow/es/docs/reference/rest/v2/projects.agent.sessions/detectIntent) and [client API](https://googleapis.dev/nodejs/dialogflow/latest/google.cloud.dialogflow.v2beta1.Sessions.html#detectIntent2)

Version:1.0.0

Key:google_dialogflow-detect-intent

View on GitHub

Google Dialogflow Overview#

Google Dialogflow API empowers you to create conversational interfaces for websites, apps, and messaging platforms. Think chatbots that can engage in human-like dialogue, provide customer support, guide through sales processes, or control smart home devices with voice commands. With Pipedream's integration capabilities, you can create automated workflows that trigger actions in other apps based on Dialogflow's processed input, enabling seamless interaction across a plethora of services.

Action Code#

import googleDialogflow from "../../google_dialogflow.app.mjs";
import utils from "../../common/utils.mjs";

export default {
  type: "action",
  key: "google_dialogflow-detect-intent",
  version: "1.0.0",
  name: "Detect Intent",
  description: "Processes a natural language query and returns structured, actionable data as a result, [See REST docs](https://cloud.google.com/dialogflow/es/docs/reference/rest/v2/projects.agent.sessions/detectIntent) and [client API](https://googleapis.dev/nodejs/dialogflow/latest/google.cloud.dialogflow.v2beta1.Sessions.html#detectIntent2)",
  props: {
    googleDialogflow,
    sessionId: {
      propDefinition: [
        googleDialogflow,
        "sessionId",
      ],
    },
    queryParams: {
      label: "Query Params",
      description: "Properties of Query Parameters, See [client API](https://googleapis.dev/nodejs/dialogflow/latest/google.cloud.dialogflow.v2beta1.IQueryParameters.html)",
      type: "object",
      optional: true,
    },
    queryInput: {
      label: "Query Input",
      description: "Properties of a Query Input, See [client API](https://googleapis.dev/nodejs/dialogflow/latest/google.cloud.dialogflow.v2beta1.IQueryInput.html). For example `{\"text\":{\"text\":\"Hi, what are you doing?\",\"languageCode\":\"en-EN\"}}`",
      type: "object",
      optional: true,
    },
    outputAudioConfig: {
      label: "Output Audio Config",
      description: "Properties of an Output Audio Config, See [client API](https://googleapis.dev/nodejs/dialogflow/latest/google.cloud.dialogflow.v2beta1.IOutputAudioConfig.html)",
      type: "object",
      optional: true,
    },
    outputAudioConfigMask: {
      label: "Output Audio Config Mask",
      description: "Properties of a Field Mask, See [client API](https://googleapis.dev/nodejs/dialogflow/latest/google.protobuf.IFieldMask.html)",
      type: "object",
      optional: true,
    },
    inputAudioFile: {
      label: "Input Audio File or URL",
      description: "Provide a file URL or a path to a file in the `/tmp` directory.",
      type: "string",
      optional: true,
    },
  },
  async run({ $ }) {
    const response = await this.googleDialogflow.detectIntent({
      sessionId: this.sessionId,
      queryParams: utils.parseObject(this.queryParams),
      queryInput: utils.parseObject(this.queryInput),
      outputAudioConfig: utils.parseObject(this.outputAudioConfig),
      outputAudioConfigMask: utils.parseObject(this.outputAudioConfigMask),
      inputAudioFile: this.inputAudioFile,
    });
    $.export("$summary", `Configured query has been sent and received response with ID(${response[0]?.responseId}).`);
    return response[0]; //It always returns an array[3] with no info in index 1, 2
  },
};

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
Google Dialogflow	`googleDialogflow`	`app`	This component uses the Google Dialogflow app.
Session ID	`sessionId`	`string`	A unique session ID, ID of the session created when a context created can be used, e.g. `acb92b1d-0a8c-4369-a5fa-ddd7954b2b46`
Query Params	`queryParams`	`object`	Properties of Query Parameters, See client API
Query Input	`queryInput`	`object`	Properties of a Query Input, See client API For example `{"text":{"text":"Hi, what are you doing?","languageCode":"en-EN"}}`
Output Audio Config	`outputAudioConfig`	`object`	Properties of an Output Audio Config, See client API
Output Audio Config Mask	`outputAudioConfigMask`	`object`	Properties of a Field Mask, See client API
Input Audio File or URL	`inputAudioFile`	`string`	Provide a file URL or a path to a file in the `/tmp` directory.