Dial Number with Telnyx API on New Email from Email API

Pipedream makes it easy to connect APIs for Telnyx, Email and 2,200+ other apps remarkably fast.

Trigger workflow on

New Email from the Email API

Next, do this

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

Select this integration
Configure the New Email trigger
1. Connect your Email account
Configure the Dial Number action
1. Connect your Telnyx account
2. Select a Call Control Application ID
3. Select a Phone Number
4. Configure To
5. Optional- Configure From Display Name
6. Optional- Configure Audio URL
7. Optional- Configure Webhook 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 Email on Email

Description:Get a unique address where you can send emails to trigger your workflow.

Version:0.0.1

Key:email-new-email

View on GitHub

Trigger Code#

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

export default {
  name: "New Email",
  version: "0.0.1",
  key: "email-new-email",
  description: "Get a unique address where you can send emails to trigger your workflow.",
  props: {
    email,
  },
  type: "source",
  methods: {},
  async run() {},
};

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
Email	`email`	`app`	This component uses the Email app.

Trigger Authentication#

The Email API does not require authentication.

About Email#

Trigger workflows on new emails, and send emails to yourself as part of a Pipedream workflow.

Action#

Dial Number on Telnyx

Description:Dial a number or SIP URI from a given Call Control App. [See the documentation](https://developers.telnyx.com/api/call-control/dial-call)

Version:0.0.1

Key:telnyx-dial-number

View on GitHub

Telnyx Overview#

The Telnyx API offers a suite of telecommunication features enabling developers to manage voice, SMS, and other real-time communications. With Telnyx, you can programmatically send and receive text messages, handle voice calls, and control other telephony services using their robust API. Leveraging Pipedream's capabilities, this API can be hooked into workflows to automate complex tasks, react to incoming messages or calls, and integrate with countless other services for analytics, customer support, and more.

Action Code#

import telnyxApp from "../../telnyx.app.mjs";

export default {
  key: "telnyx-dial-number",
  name: "Dial Number",
  description: "Dial a number or SIP URI from a given Call Control App. [See the documentation](https://developers.telnyx.com/api/call-control/dial-call)",
  version: "0.0.1",
  type: "action",
  props: {
    telnyxApp,
    callControlAppId: {
      propDefinition: [
        telnyxApp,
        "callControlAppId",
      ],
    },
    phoneNumber: {
      propDefinition: [
        telnyxApp,
        "phoneNumber",
      ],
    },
    to: {
      type: "string",
      label: "To",
      description: "The DID or SIP URI to dial out to",
    },
    fromDisplayName: {
      type: "string",
      label: "From Display Name",
      description: "The string to be used as the caller id name (SIP From Display Name) presented to the destination (to number).",
      optional: true,
    },
    audioUrl: {
      type: "string",
      label: "Audio URL",
      description: "The URL of a file to be played back to the callee when the call is answered. The URL can point to either a WAV or MP3 file.",
      optional: true,
    },
    webhookUrl: {
      type: "string",
      label: "Webhook URL",
      description: "Use this field to override the URL to which Telnyx will send subsequent webhooks for this call.",
      optional: true,
    },
  },
  async run({ $ }) {
    const response = await this.telnyxApp.dialNumber({
      $,
      data: {
        connection_id: this.callControlAppId,
        from: this.phoneNumber,
        to: this.to,
        from_display_name: this.fromDisplayName,
        audio_url: this.audioUrl,
        webhook_url: this.webhookUrl,
      },
    });
    $.export("$summary", "Successfully dialed number.");
    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
Telnyx	`telnyxApp`	`app`	This component uses the Telnyx app.
Call Control Application ID	`callControlAppId`	`string`	Select a value from the drop down menu.
Phone Number	`phoneNumber`	`string`	Select a value from the drop down menu.
To	`to`	`string`	The DID or SIP URI to dial out to
From Display Name	`fromDisplayName`	`string`	The string to be used as the caller id name (SIP From Display Name) presented to the destination (to number).
Audio URL	`audioUrl`	`string`	The URL of a file to be played back to the callee when the call is answered. The URL can point to either a WAV or MP3 file.
Webhook URL	`webhookUrl`	`string`	Use this field to override the URL to which Telnyx will send subsequent webhooks for this call.