Transcribe Audio with Deepgram API on New Submission (Instant) from Jotform API

Pipedream makes it easy to connect APIs for Deepgram, Jotform and 2,400+ other apps remarkably fast.

Trigger workflow on

New Submission (Instant) from the Jotform API

Next, do this

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

Select this integration
Configure the New Submission (Instant) trigger
1. Connect your Jotform account
2. Optional- Select a Team
3. Select a Form
Configure the Transcribe Audio action
1. Connect your Deepgram account
2. Optional- Configure URL
3. Optional- Configure File Path
4. Optional- Select a Tier
5. Optional- Select a Model
6. Optional- Configure Version
7. Optional- Select a Language
8. Configure Detect Language
9. Optional- Configure Punctuate
10. Optional- Configure Profanity Filter
11. Optional- Select a Redact
12. Optional- Configure Diarize
13. Optional- Configure Diarize Version
14. Configure Smart Format
15. Optional- Configure MultiChannel
16. Optional- Configure Alternatives
17. Optional- Configure Numerals
18. Optional- Configure Search
19. Optional- Configure Replace
20. Optional- Configure Callback
21. Optional- Configure Keywords
22. Optional- Configure Paragraph
23. Optional- Configure Summarize
24. Optional- Configure Detect Topics
25. Optional- Configure Detect Entities
26. Optional- Configure Utterances
27. Optional- Configure Utt Split
28. Optional- Configure Tag
29. Optional- Configure Callback with Suspend
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 Submission (Instant) on Jotform

Description:Emit new event when a form is submitted

Version:0.1.5

Key:jotform-new-submission

View on GitHub

Jotform Overview#

Jotform’s API is a powerhouse for automating form and survey data management. With Pipedream, harness this API to trigger workflows from new form submissions, manipulate and analyze your form data, and sync it across various platforms. Think streamlined data entry to CRMs, instant notifications for new leads or feedback, and timely data backups to cloud storage.

Trigger Code#

import jotform from "../../jotform.app.mjs";
import sampleEmit from "./test-event.mjs";

export default {
  key: "jotform-new-submission",
  name: "New Submission (Instant)",
  description: "Emit new event when a form is submitted",
  version: "0.1.5",
  type: "source",
  dedupe: "unique",
  props: {
    jotform,
    http: "$.interface.http",
    teamId: {
      propDefinition: [
        jotform,
        "teamId",
      ],
    },
    formId: {
      propDefinition: [
        jotform,
        "formId",
        (c) => ({
          teamId: c.teamId,
          excludeDeleted: true,
        }),
      ],
    },
  },
  hooks: {
    async deploy() {
      const { content: form } = await this.jotform.getForm(this.formId, this.teamId);
      const { content: submissions } = await this.jotform.getFormSubmissions({
        formId: this.formId,
        teamId: this.teamId,
        params: {
          limit: 25,
          orderby: "created_at",
        },
      });
      for (let submission of submissions.reverse()) {
        const meta = {
          id: submission.id,
          summary: form.title,
          ts: Date.now(),
        };
        this.$emit(submission, meta);
      }
    },
    async activate() {
      return (await this.jotform.createHook({
        endpoint: this.http.endpoint,
        formId: this.formId,
        teamId: this.teamId,
      }));
    },
    async deactivate() {
      return (await this.jotform.deleteHook({
        endpoint: this.http.endpoint,
        formId: this.formId,
        teamId: this.teamId,
      }));
    },
  },
  async run(event) {
    const { body } = event;
    let { content: submission } = await this.jotform.getFormSubmission({
      submissionId: body.submissionID,
      teamId: this.teamId,
    });

    // insert answers from the webhook event
    const rawRequest = JSON.parse(body.rawRequest);
    for (const key of Object.keys(rawRequest)) {
      const regex = /^q(\d+)_/;
      const match = key.match(regex);
      if (match && match[1]) {
        submission.answers[match[1]].answer = rawRequest[key];
      }
    }

    this.$emit(submission, {
      summary: body.formTitle || JSON.stringify(body),
      id: body.submissionID,
      ts: Date.now(),
    });
  },
  sampleEmit,
};

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
Jotform	`jotform`	`app`	This component uses the Jotform app.
N/A	`http`	`$.interface.http`	This component uses `$.interface.http` to generate a unique URL when the component is first instantiated. Each request to the URL will trigger the `run()` method of the component.
Team	`teamId`	`string`	Select a value from the drop down menu.
Form	`formId`	`string`	Select a value from the drop down menu.

Trigger Authentication#

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

About Jotform#

Jotform enables you to create online forms, collect responses directly in your email, and create fillable PDF forms.

Action#

Transcribe Audio on Deepgram

Description:Transcribes the specified audio file. [See the documentation](https://developers.deepgram.com/api-reference/transcription/#transcribe-pre-recorded-audio)

Version:0.0.4

Key:deepgram-transcribe-audio

View on GitHub

Deepgram Overview#

The Deepgram API offers powerful speech recognition capabilities, enabling you to transcribe, search, and analyze audio data with ease. With its cutting-edge machine learning models, you can uncover insights from voice conversations, automate content moderation, and enhance user experience by converting spoken words into text. Pipedream, as a serverless integration platform, empowers you to craft custom workflows that harness the potential of Deepgram. By connecting to various apps, you can automate complex tasks, analyze audio data on-the-fly, and respond to audio-driven events.

Action Code#

import deepgram from "../../deepgram.app.mjs";
import { ConfigurationError } from "@pipedream/platform";
import fs from "fs";

export default {
  key: "deepgram-transcribe-audio",
  name: "Transcribe Audio",
  description: "Transcribes the specified audio file. [See the documentation](https://developers.deepgram.com/api-reference/transcription/#transcribe-pre-recorded-audio)",
  version: "0.0.4",
  type: "action",
  props: {
    deepgram,
    url: {
      type: "string",
      label: "URL",
      description: "URL of audio file to transcribe",
      optional: true,
    },
    filePath: {
      type: "string",
      label: "File Path",
      description: "The path to the file saved to the `/tmp` directory (e.g. `/tmp/example.mp3`). [See the documentation](https://pipedream.com/docs/workflows/steps/code/nodejs/working-with-files/#the-tmp-directory).",
      optional: true,
    },
    tier: {
      propDefinition: [
        deepgram,
        "tier",
      ],
    },
    model: {
      propDefinition: [
        deepgram,
        "model",
      ],
    },
    version: {
      type: "string",
      label: "Version",
      description: "Version of the model to use. Default: `latest`",
      default: "latest",
      optional: true,
    },
    language: {
      propDefinition: [
        deepgram,
        "language",
      ],
    },
    detectLanguage: {
      type: "boolean",
      label: "Detect Language",
      description: "Indicates whether to detect the language of the provided audio",
      default: true,
    },
    punctuate: {
      type: "boolean",
      label: "Punctuate",
      description: "Indicates whether to add punctuation and capitalization to the transcript",
      optional: true,
    },
    profanityFilter: {
      type: "boolean",
      label: "Profanity Filter",
      description: "Indicates whether to remove profanity from the transcript",
      optional: true,
    },
    redact: {
      propDefinition: [
        deepgram,
        "redact",
      ],
    },
    diarize: {
      type: "boolean",
      label: "Diarize",
      description: "Indicates whether to recognize speaker changes. When set to `true`, each word in the transcript will be assigned a speaker number starting at 0. To use the legacy diarization feature, set the `diarize_version` parameter set to `2021-07-14.0`.",
      optional: true,
    },
    diarizeVersion: {
      type: "string",
      label: "Diarize Version",
      description: "Indicates the version of the diarization feature to use. To use the legacy diarization feature, set the parameter value to `2021-07-14.0`. Only used when the diarization feature is enabled.",
      optional: true,
    },
    smartFormat: {
      type: "boolean",
      label: "Smart Format",
      description: "Applies additional formatting to transcripts to optimize them for human readability.",
      default: true,
    },
    multiChannel: {
      type: "boolean",
      label: "MultiChannel",
      description: "Indicates whether to transcribe each audio channel independently",
      optional: true,
    },
    alternatives: {
      type: "integer",
      label: "Alternatives",
      description: "Maximum number of transcript alternatives to return",
      optional: true,
    },
    numerals: {
      type: "boolean",
      label: "Numerals",
      description: "Indicates whether to convert numbers from written format (e.g., one) to numerical format (e.g., 1).",
      optional: true,
    },
    search: {
      type: "string[]",
      label: "Search",
      description: "Terms or phrases to search for in the submitted audio",
      optional: true,
    },
    replace: {
      type: "string[]",
      label: "Replace",
      description: "Terms or phrases to search for in the submitted audio and replace.",
      optional: true,
    },
    callback: {
      type: "string",
      label: "Callback",
      description: "Callback URL to provide if you would like your submitted audio to be processed asynchronously",
      optional: true,
    },
    keywords: {
      type: "string[]",
      label: "Keywords",
      description: "Keywords to which the model should pay particular attention to boosting or suppressing to help it understand context",
      optional: true,
    },
    paragraph: {
      type: "boolean",
      label: "Paragraph",
      description: "Indicates whether Deepgram will split audio into paragraphs to improve transcript readability. When paragraphs is set to `true`, you must also set either `punctuate`, `diarize`, or `multichannel` to `true`.",
      optional: true,
    },
    summarize: {
      type: "boolean",
      label: "Summarize",
      description: "Indicates whether Deepgram will provide summaries for sections of content. When `summarize` is set to `true`, `punctuate` will be set to `true` by default.",
      optional: true,
    },
    detectTopics: {
      type: "boolean",
      label: "Detect Topics",
      description: "Indicates whether Deepgram will identify and extract key topics for sections of content. When `detect_topics` is set to `true`, `punctuate` will be set to `true` by default.",
      optional: true,
    },
    detectEntities: {
      type: "boolean",
      label: "Detect Entities",
      description: "Indicates whether Deepgram will identify and extract key entities for sections of content. When `detect_entities` is set to `true`, `punctuate` will be set to true by default.",
      optional: true,
    },
    utterances: {
      type: "boolean",
      label: "Utterances",
      description: "Indicates whether Deepgram will segment speech into meaningful semantic units, which allows the model to interact more naturally and effectively with speakers’ spontaneous speech patterns",
      optional: true,
    },
    uttSplit: {
      type: "string",
      label: "Utt Split",
      description: "Length of time in seconds of silence between words that Deepgram will use when determining where to split utterances. Used when utterances is enabled.",
      optional: true,
    },
    tag: {
      type: "string",
      label: "Tag",
      description: "Tag to associate with the request",
      optional: true,
    },
    callbackWithSuspend: {
      type: "boolean",
      label: "Callback with Suspend",
      description: "Use the `$.flow.suspend` Node.js helper to suspend the workflow until the transcription is completed. Overrides the `callback` parameter to Deepgram.",
      optional: true,
    },
  },
  async run({ $ }) {
    if (!this.url && !this.filePath) {
      throw new ConfigurationError("Either URL or File Path must be provided.");
    }

    let callback  = this.callback;
    if (this.callbackWithSuspend) {
      ({ resume_url: callback } = $.flow.suspend());
    }

    const params = {
      tier: this.tier,
      model: this.model,
      version: this.version,
      language: this.language,
      detect_language: this.detectLanguage,
      punctuate: this.punctuate,
      profanity_filter: this.profanityFilter,
      redact: this.redact,
      diarize: this.diarize,
      diarize_version: this.diarizeVersion,
      smart_format: this.smartFormat,
      multi_channel: this.multiChannel,
      alternatives: this.alternatives,
      numerals: this.numerals,
      search: this.search,
      replace: this.replace,
      callback,
      keywords: this.keywords,
      paragraph: this.paragraph,
      summarize: this.summarize,
      detect_topics: this.detectTopics,
      detect_entities: this.detectEntities,
      utterances: this.utterances,
      utt_split: this.uttSplit,
      tag: this.tag,
    };

    const config = {
      params,
      $,
    };

    if (this.url) {
      config.data = {
        url: this.url,
      };
    }
    if (this.filePath) {
      config.data = fs.readFileSync(this.filePath.includes("tmp/")
        ? this.filePath
        : `/tmp/${this.filePath}`);
      config.headers = {
        "Content-Type": "application/octet-stream",
      };
    }

    const response = await this.deepgram.transcribeAudio(config);

    if (response) {
      $.export("$summary", "Successfully transcribed audio");
    }

    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
Deepgram	`deepgram`	`app`	This component uses the Deepgram app.
URL	`url`	`string`	URL of audio file to transcribe
File Path	`filePath`	`string`	The path to the file saved to the `/tmp` directory (e.g. `/tmp/example.mp3`). See the documentation.
Tier	`tier`	`string`	Select a value from the drop down menu:`{ "label": "These are our newest and most powerful speech-to-text models on the market today", "value": "nova" }{ "label": "These are still some of our most powerful ASR models", "value": "enhanced" }{ "label": "Applies our Base models, which are built on our signature end-to-end deep learning speech model architecture", "value": "base" }`
Model	`model`	`string`	Select a value from the drop down menu:`{ "label": "Optimized for everyday audio processing. TIERS: nova, enhanced, base", "value": "general" }{ "label": "Optimized for conference room settings. TIERS: enhanced beta, base", "value": "meeting" }{ "label": "Optimized for low-bandwidth audio phone calls. TIERS: nova, enhanced, base", "value": "phonecall" }{ "label": "Optimized for low-bandwidth audio clips with a single speaker. TIERS: base", "value": "voicemail" }{ "label": "Optimized for multiple speakers with varying audio quality. TIERS: enhanced, base", "value": "finance" }{ "label": "Optimized to allow artificial intelligence technologies. TIERS: base", "value": "conversationalai" }{ "label": "Optimized for audio sourced from videos. TIERS: base", "value": "video" }{ "label": "Deepgram’s hosted version of OpenAI’s Whisper model. TIERS: not-applicable", "value": "whisper" }`
Version	`version`	`string`	Version of the model to use. Default: `latest`
Language	`language`	`string`	Select a value from the drop down menu:`{ "value": "da", "label": "Danish" }{ "value": "de", "label": "German Germany" }{ "value": "en-AU", "label": "English Australia" }{ "value": "en-IN", "label": "English India" }{ "value": "en-NZ", "label": "English New Zealand" }{ "value": "en-GB", "label": "English United Kingdom" }{ "value": "en-US", "label": "English United States" }{ "value": "es", "label": "Spanish Spain" }{ "value": "es-419", "label": "Spanish Latin America" }{ "value": "fr-CA", "label": "French Canada" }{ "value": "fr", "label": "French France" }{ "value": "hi", "label": "Hindi India" }{ "value": "hi-Latn", "label": "Hindi Roman Script" }{ "value": "id", "label": "Indonesian Indonesia" }{ "value": "it", "label": "Italian Italy" }{ "value": "ja", "label": "Japanese Japan" }{ "value": "ko", "label": "Korean Republic of Korea" }{ "value": "nl", "label": "Dutch" }{ "value": "no", "label": "Norwegian Norway" }{ "value": "pl", "label": "Polish Poland" }{ "value": "pt-BR", "label": "Portuguese Brazil" }{ "value": "pt-PT", "label": "Portuguese Portugal" }{ "value": "ru", "label": "Russian Russian Federation" }{ "value": "sv", "label": "Swedish Sweden" }{ "value": "tr", "label": "Turkish Turkey" }{ "value": "zh-CN", "label": "Chinese China" }{ "value": "zh-TW", "label": "Chinese Taiwan" }{ "value": "uk", "label": "Ukranian" }`
Detect Language	`detectLanguage`	`boolean`	Indicates whether to detect the language of the provided audio
Punctuate	`punctuate`	`boolean`	Indicates whether to add punctuation and capitalization to the transcript
Profanity Filter	`profanityFilter`	`boolean`	Indicates whether to remove profanity from the transcript
Redact	`redact`	`string`	Select a value from the drop down menu:`{ "label": "Redacts sensitive credit card information", "value": "pci" }{ "label": "Aggressively redacts strings of numerals", "value": "numbers" }{ "label": "Redacts social security numbers", "value": "ssn" }`
Diarize	`diarize`	`boolean`	Indicates whether to recognize speaker changes. When set to `true`, each word in the transcript will be assigned a speaker number starting at 0. To use the legacy diarization feature, set the `diarize_version` parameter set to `2021-07-14.0`.
Diarize Version	`diarizeVersion`	`string`	Indicates the version of the diarization feature to use. To use the legacy diarization feature, set the parameter value to `2021-07-14.0`. Only used when the diarization feature is enabled.
Smart Format	`smartFormat`	`boolean`	Applies additional formatting to transcripts to optimize them for human readability.
MultiChannel	`multiChannel`	`boolean`	Indicates whether to transcribe each audio channel independently
Alternatives	`alternatives`	`integer`	Maximum number of transcript alternatives to return
Numerals	`numerals`	`boolean`	Indicates whether to convert numbers from written format (e.g., one) to numerical format (e.g., 1).
Search	`search`	`string[]`	Terms or phrases to search for in the submitted audio
Replace	`replace`	`string[]`	Terms or phrases to search for in the submitted audio and replace.
Callback	`callback`	`string`	Callback URL to provide if you would like your submitted audio to be processed asynchronously
Keywords	`keywords`	`string[]`	Keywords to which the model should pay particular attention to boosting or suppressing to help it understand context
Paragraph	`paragraph`	`boolean`	Indicates whether Deepgram will split audio into paragraphs to improve transcript readability. When paragraphs is set to `true`, you must also set either `punctuate`, `diarize`, or `multichannel` to `true`.
Summarize	`summarize`	`boolean`	Indicates whether Deepgram will provide summaries for sections of content. When `summarize` is set to `true`, `punctuate` will be set to `true` by default.
Detect Topics	`detectTopics`	`boolean`	Indicates whether Deepgram will identify and extract key topics for sections of content. When `detect_topics` is set to `true`, `punctuate` will be set to `true` by default.
Detect Entities	`detectEntities`	`boolean`	Indicates whether Deepgram will identify and extract key entities for sections of content. When `detect_entities` is set to `true`, `punctuate` will be set to true by default.
Utterances	`utterances`	`boolean`	Indicates whether Deepgram will segment speech into meaningful semantic units, which allows the model to interact more naturally and effectively with speakers’ spontaneous speech patterns
Utt Split	`uttSplit`	`string`	Length of time in seconds of silence between words that Deepgram will use when determining where to split utterances. Used when utterances is enabled.
Tag	`tag`	`string`	Tag to associate with the request
Callback with Suspend	`callbackWithSuspend`	`boolean`	Use the `$.flow.suspend` Node.js helper to suspend the workflow until the transcription is completed. Overrides the `callback` parameter to Deepgram.

Try it

Get Project with Deepgram API on New Submission (Instant) from Jotform API

Jotform + Deepgram

Try it

Get Request with Deepgram API on New Submission (Instant) from Jotform API

Jotform + Deepgram

Try it

List Balances with Deepgram API on New Submission (Instant) from Jotform API

Jotform + Deepgram

Try it

List Projects with Deepgram API on New Submission (Instant) from Jotform API

Jotform + Deepgram

Try it

Popular Triggers#

New Submission (Instant) from the Jotform API

Emit new event when a form is submitted

Try it

Popular Actions#

Get Form Submissions with the Jotform API

Gets a list of form responses See the docs here

Try it

Get Monthly User Usage with the Jotform API

Gets number of form submissions received this month. Also, get number of SSL form submissions, payment form submissions and upload space used by user See the docs here

Try it

Get User Submissions with the Jotform API

Gets a list of all submissions for all forms on the account See the docs here

Try it

Get Balance with the Deepgram API

Retrieves details about the specified balance. See the documentation

Try it

Get Project with the Deepgram API

Retrieves basic information about the specified project. See the documentation

Try it