← Typeform + Telegram Bot integrations

Edit a Media Message with Telegram Bot API on New Submission from Typeform API

Pipedream makes it easy to connect APIs for Telegram Bot, Typeform and 1000+ other apps remarkably fast.

Trigger workflow on
New Submission from the Typeform API
Next, do this
Edit a Media Message with the Telegram Bot API
No credit card required
Into to Pipedream
Watch us build a workflow
Watch us build a workflow
7 min
Watch now ➜
Trusted by 250,000+ developers from startups to Fortune 500 companies:
Trusted by 250,000+ developers from startups to Fortune 500 companies

Developers Pipedream

Getting Started

This integration creates a workflow with a Typeform trigger and Telegram Bot 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 Submission trigger
    1. Connect your Typeform account
    2. Select a Form
  3. Configure the Edit a Media Message action
    1. Connect your Telegram Bot account
    2. Configure Chat ID
    3. Configure Message ID
    4. Select a Media Type
    5. Optional- Configure Caption
    6. Optional- Configure File Name
    7. Configure Media
    8. Optional- Select a Parse Mode
    9. Optional- Configure Reply Markup
  4. Deploy the workflow
  5. Send a test event to validate your setup
  6. Turn on the trigger

Details

This integration uses pre-built, open source 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 submission
Version:0.0.5
Key:typeform-new-submission

Typeform Overview

With the Typeform API, you can easily create beautiful, interactive forms that
allow people to share their information with you in an engaging way. Here are
some examples of what you can build with the Typeform API:

  • A contact form for your website that allows people to easily get in touch
    with you
  • An order form for your product or service that allows people to place orders
    easily and securely
  • A survey form that allows you to collect data and feedback from people
  • A registration form for your event or conference that allows people to sign
    up easily and securely

Trigger Code

import { createHmac } from "crypto";
import { uuid } from "uuidv4";
import common from "../common.mjs";
import constants from "../../constants.mjs";
import utils from "../utils.mjs";

const { typeform } = common.props;
const { parseIsoDate } = utils;

export default {
  ...common,
  key: "typeform-new-submission",
  name: "New Submission",
  version: "0.0.5",
  type: "source",
  description: "Emit new submission",
  props: {
    ...common.props,
    http: "$.interface.http",
    db: "$.service.db",
    formId: {
      propDefinition: [
        typeform,
        "formId",
      ],
    },
  },
  methods: {
    ...common.methods,
    generateSecret() {
      return "" + Math.random();
    },
  },
  hooks: {
    ...common.hooks,
    async activate() {
      const secret = this.generateSecret();
      this._setSecret(secret);

      let tag = this._getTag();
      if (!tag) {
        tag = uuid();
        this._setTag(tag);
      }

      return await this.typeform.createHook({
        endpoint: this.http.endpoint,
        formId: this.formId,
        tag,
        secret,
      });
    },
    async deactivate() {
      const tag = this._getTag();

      return await this.typeform.deleteHook({
        formId: this.formId,
        tag,
      });
    },
  },
  async run(event) {
    const {
      body,
      headers,
    } = event;

    const { [constants.TYPEFORM_SIGNATURE]: typeformSignature } = headers;

    if (typeformSignature) {
      const secret = this._getSecret();

      const hmac =
        createHmac(constants.ALGORITHM, secret)
          .update(body)
          .digest(constants.ENCODING);

      const signature = `${constants.ALGORITHM}=${hmac}`;

      if (typeformSignature !== signature) {
        throw new Error("signature mismatch");
      }
    }

    let formResponseString = "";
    const data = Object.assign({}, body.form_response);
    data.form_response_parsed = {};

    for (let i = 0; i < body.form_response.answers.length; i++) {
      const field = body.form_response.definition.fields[i];
      const answer = body.form_response.answers[i];

      let parsedAnswer;
      let value = answer[answer.type];

      if (value.label) {
        parsedAnswer = value.label;

      } else if (value.labels) {
        parsedAnswer = value.labels.join();

      } else if (value.choice) {
        parsedAnswer = value.choice;

      } else if (value.choices) {
        parsedAnswer = value.choices.join();

      } else {
        parsedAnswer = value;
      }

      data.form_response_parsed[field.title] = parsedAnswer;
      formResponseString += `### ${field.title}\n${parsedAnswer}\n`;
    }

    data.form_response_string = formResponseString;
    data.raw_webhook_event = body;

    if (data.landed_at) {
      data.landed_at = parseIsoDate(data.landed_at);
    }

    if (data.submitted_at) {
      data.submitted_at = parseIsoDate(data.submitted_at);
    }

    data.form_title = body.form_response.definition.title;
    delete data.answers;
    delete data.definition;

    this.$emit(data, {
      summary: JSON.stringify(data),
      id: data.token,
    });
  },
};

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
TypeformtypeformappThis component uses the Typeform app.
N/Ahttp$.interface.httpThis 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.
N/Adb$.service.dbThis component uses $.service.db to maintain state between component invocations.
FormformIdstringSelect a value from the drop down menu.

Trigger Authentication

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

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

offlineaccounts:readforms:writeforms:readimages:writeimages:readthemes:writethemes:readresponses:readresponses:writewebhooks:readwebhooks:writeworkspaces:readworkspaces:write

About Typeform

People-Friendly Forms and Surveys

Action

Description:Edits photo or video messages. [See the docs](https://core.telegram.org/bots/api#editmessagemedia) for more information
Version:0.0.5
Key:telegram_bot_api-edit-media-message

Telegram Bot Overview

With the Telegram Bot API, you can build bots that perform a variety of tasks,
including:

  • Sending and receiving messages
  • Social networking
  • Content management
  • File sharing
  • Location sharing
  • Bot administration
  • And more!

Action Code

import {
  TELEGRAM_BOT_API_MEDIA_PHOTO,
  TELEGRAM_BOT_API_MEDIA_VIDEO,
} from "../../common/constants.mjs";
import telegramBotApi from "../../telegram_bot_api.app.mjs";

export default {
  key: "telegram_bot_api-edit-media-message",
  name: "Edit a Media Message",
  description: "Edits photo or video messages. [See the docs](https://core.telegram.org/bots/api#editmessagemedia) for more information",
  version: "0.0.5",
  type: "action",
  props: {
    telegramBotApi,
    chatId: {
      propDefinition: [
        telegramBotApi,
        "chatId",
      ],
    },
    messageId: {
      propDefinition: [
        telegramBotApi,
        "messageId",
      ],
    },
    type: {
      propDefinition: [
        telegramBotApi,
        "type",
      ],
      options: [
        {
          label: "Photo",
          value: TELEGRAM_BOT_API_MEDIA_PHOTO,
        },
        {
          label: "Video",
          value: TELEGRAM_BOT_API_MEDIA_VIDEO,
        },
      ],
    },
    caption: {
      propDefinition: [
        telegramBotApi,
        "caption",
      ],
    },
    filename: {
      propDefinition: [
        telegramBotApi,
        "filename",
      ],
    },
    media: {
      propDefinition: [
        telegramBotApi,
        "media",
      ],
      label: "Media",
    },
    parse_mode: {
      propDefinition: [
        telegramBotApi,
        "parse_mode",
      ],
    },
    reply_markup: {
      propDefinition: [
        telegramBotApi,
        "reply_markup",
      ],
    },
  },
  async run({ $ }) {
    const resp = await this.telegramBotApi.editMessageMedia({
      type: this.type,
      media: this.media,
      caption: this.caption,
      parse_mode: this.parse_mode,
    }, {
      chatId: this.chatId,
      messageId: this.messageId,
      reply_markup: this.reply_markup,
    });
    $.export("$summary", `Successfully edited the ${this.type || "media"} message in chat, "${this.chatId}"`);
    return resp;
  },
};

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
Telegram BottelegramBotApiappThis component uses the Telegram Bot app.
Chat IDchatIdstring

Enter the unique identifier for the target chat (e.g. 1035597319) or username of the target public chat (in the format @channelusername or @supergroupusername). For example, if the group's public link is t.me/mygroup, the username is @mygroup.

Message IDmessageIdstring

Enter the message ID.

Media TypetypestringSelect a value from the drop down menu:{ "label": "Photo", "value": "photo" }{ "label": "Video", "value": "video" }
Captioncaptionstring

Enter the caption.

File Namefilenamestring

Enter a filename.

Mediamediastring

File to send. Pass a file_id to send a file that exists on the Telegram servers, pass an HTTP URL for Telegram to get a file from the Internet, or pass the path to the file (e.g., /tmp/myFile.ext) to upload a new one using a file downloaded to /tmp. File must meet Telegram's requirements for MIME type and size.

Parse Modeparse_modestringSelect a value from the drop down menu:MarkdownV2HTMLMarkdown
Reply Markupreply_markupstring

Enter additional interface options that are a JSON-serialized object including an inline keyboard, a custom reply keyboard, instructions to remove the reply keyboard or instructions to force a reply from the user, e.g. {"inline_keyboard":[[{"text":"Some button text 2","url":"https://botpress.org"}]]} or {"keyboard":[["Yes","No"],["Maybe"]]}. Note: keyboard cannot be used with channels. See the docs for more information.

Action Authentication

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

To use the Telegram Bot API, you must first create a new bot by chatting with the BotFather.


Telegram Bot how to

After you create your bot, copy the bot token and add it below.

About Telegram Bot

Telegram is a cloud-based instant messaging and voice over IP service

More Ways to Connect Telegram Bot + Typeform

Create a Form with Typeform API on Channel Updates (Instant) from Telegram Bot API
Telegram Bot + Typeform
 
Try it
Create a Form with Typeform API on Message Updates (Instant) from Telegram Bot API
Telegram Bot + Typeform
 
Try it
Create an Image with Typeform API on Channel Updates (Instant) from Telegram Bot API
Telegram Bot + Typeform
 
Try it
Create an Image with Typeform API on Message Updates (Instant) from Telegram Bot API
Telegram Bot + Typeform
 
Try it
Delete an Image with Typeform API on Channel Updates (Instant) from Telegram Bot API
Telegram Bot + Typeform
 
Try it
New Submission from the Typeform API

Emit new submission

 
Try it
New Bot Command Received (Instant) from the Telegram Bot API

Emit new event each time a Telegram Bot command is received.

 
Try it
New Channel Updates (Instant) from the Telegram Bot API

Emit new event each time a channel post is created or updated.

 
Try it
New Message Updates (Instant) from the Telegram Bot API

Emit new event each time a Telegram message is created or updated.

 
Try it
New Updates (Instant) from the Telegram Bot API

Emit new event for each new Telegram event.

 
Try it
Create a Form with the Typeform API

Creates a form with its corresponing fields. See the docs here

 
Try it
Create an Image with the Typeform API

Adds an image in your Typeform account. See the docs here

 
Try it
Delete an Image with the Typeform API

Deletes an image from your Typeform account. See the docs here

 
Try it
Delete Form with the Typeform API

Select a form to be deleted. See the docs here.

 
Try it
Duplicate a Form with the Typeform API

Duplicates an existing form in your Typeform account and adds "(copy)" to the end of the title. See the docs here

 
Try it