← Miro Developer App + OpenAI (ChatGPT) integrations

Chat with OpenAI (ChatGPT) API on Item Position Changed from Miro Developer App API

Pipedream makes it easy to connect APIs for OpenAI (ChatGPT), Miro Developer App and 2,400+ other apps remarkably fast.

Trigger workflow on
Item Position Changed from the Miro Developer App API
Next, do this
Chat with the OpenAI (ChatGPT) API
No credit card required
Intro to Pipedream
Watch us build a workflow
Watch us build a workflow
8 min
Watch now ➜

Trusted by 1,000,000+ developers from startups to Fortune 500 companies

Adyen logo
Appcues logo
Bandwidth logo
Checkr logo
ChartMogul logo
Dataminr logo
Gopuff logo
Gorgias logo
LinkedIn logo
Logitech logo
Replicated logo
Rudderstack logo
SAS logo
Scale AI logo
Webflow logo
Warner Bros. logo
Adyen logo
Appcues logo
Bandwidth logo
Checkr logo
ChartMogul logo
Dataminr logo
Gopuff logo
Gorgias logo
LinkedIn logo
Logitech logo
Replicated logo
Rudderstack logo
SAS logo
Scale AI logo
Webflow logo
Warner Bros. logo

Developers Pipedream

Getting Started

This integration creates a workflow with a Miro Developer App trigger and OpenAI (ChatGPT) 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 Item Position Changed trigger
    1. Connect your Miro Developer App account
    2. Configure timer
    3. Optional- Configure Team ID
    4. Select a Board ID
  3. Configure the Chat action
    1. Connect your OpenAI (ChatGPT) account
    2. Select a Model
    3. Configure User Message
    4. Optional- Configure Max Tokens
    5. Optional- Configure Temperature
    6. Optional- Configure Top P
    7. Optional- Configure N
    8. Optional- Configure Stop
    9. Optional- Configure Presence Penalty
    10. Optional- Configure Frequency Penalty
    11. Optional- Configure User
    12. Optional- Configure System Instructions
    13. Optional- Configure Prior Message History
    14. Optional- Configure Images
    15. Optional- Configure Audio
    16. Optional- Select a Response Format
    17. Optional- Select one or more Tool Types
  4. Deploy the workflow
  5. Send a test event to validate your setup
  6. 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

Description:Emit new event when an item's position changes in a Miro Custom App.
Version:0.0.1
Key:miro_custom_app-item-position-changed

Miro Developer App Overview

The Miro Developer App API lets you extend the functionality of Miro, an online collaborative whiteboarding platform. On Pipedream, you can automate interactions with Miro boards, such as creating or updating content, and extracting data for reporting or integration purposes. This can streamline collaboration and project management by automating repetitive tasks and connecting Miro with other tools and services.

Trigger Code

import common from "../common/base.mjs";

export default {
  ...common,
  key: "miro_custom_app-item-position-changed",
  name: "Item Position Changed",
  description: "Emit new event when an item's position changes in a Miro Custom App.",
  version: "0.0.1",
  type: "source",
  dedupe: "unique",
  props: {
    ...common.props,
    teamId: {
      propDefinition: [
        common.props.miro,
        "teamId",
      ],
    },
    boardId: {
      propDefinition: [
        common.props.miro,
        "boardId",
        ({ teamId }) => ({
          teamId,
        }),
      ],
    },
  },
  methods: {
    ...common.methods,
    _getPositions() {
      return this.db.get("positions") || {};
    },
    _setPositions(positions) {
      this.db.set("positions", positions);
    },
    generateMeta(item) {
      const ts = Date.parse(item.modifiedAt);
      return {
        id: `${item.id}-${ts}`,
        summary: `Item ${item.id} position changed`,
        ts,
      };
    },
  },
  async run() {
    const positions = this._getPositions();
    const newPositions = {};
    const items = this.paginate({
      resourceFn: this.miro.listItems,
      args: {
        boardId: this.boardId,
      },
    });
    for await (const item of items) {
      const position = JSON.stringify(item.position);
      if (positions[item.id] && positions[item.id] !== position) {
        const meta = this.generateMeta(item);
        this.$emit(item, meta);
      }
      newPositions[item.id] = position;
    }

    this._setPositions(newPositions);
  },
};

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
Miro Developer AppmiroappThis component uses the Miro Developer App app.
N/Adb$.service.dbThis component uses $.service.db to maintain state between executions.
timer$.interface.timer
Team IDteamIdstring

The team_id for which you want to retrieve the list of boards.

Board IDboardIdstringSelect a value from the drop down menu.

Trigger Authentication

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

Connecting a Miro app to Pipedream

With this connection you can build your own Miro App and connect it to Pipedream.

Follow the REST API app quickstart guide on Miro to create an app that can interact with your Miro team over the Miro REST API.

This will produce a unique Access Token for accessing your boards. Once you have finished those steps, paste that Access Token in to the field below.

About Miro Developer App

The Visual Collaboration Platform for Every Team.

Action

Description:The Chat API, using the `gpt-3.5-turbo` or `gpt-4` model. [See the documentation](https://platform.openai.com/docs/api-reference/chat)
Version:0.2.3
Key:openai-chat

OpenAI (ChatGPT) Overview

OpenAI provides a suite of powerful AI models through its API, enabling developers to integrate advanced natural language processing and generative capabilities into their applications. Here’s an overview of the services offered by OpenAI's API:

Use Python or Node.js code to make fully authenticated API requests with your OpenAI account:

Action Code

import openai from "../../openai.app.mjs";
import common from "../common/common.mjs";
import constants from "../../common/constants.mjs";
import { ConfigurationError } from "@pipedream/platform";

export default {
  ...common,
  name: "Chat",
  version: "0.2.3",
  key: "openai-chat",
  description: "The Chat API, using the `gpt-3.5-turbo` or `gpt-4` model. [See the documentation](https://platform.openai.com/docs/api-reference/chat)",
  type: "action",
  props: {
    openai,
    modelId: {
      propDefinition: [
        openai,
        "chatCompletionModelId",
      ],
    },
    userMessage: {
      label: "User Message",
      type: "string",
      description: "The user messages provide instructions to the assistant. They can be generated by the end users of an application, or set by a developer as an instruction.",
    },
    ...common.props,
    systemInstructions: {
      label: "System Instructions",
      type: "string",
      description: "The system message helps set the behavior of the assistant. For example: \"You are a helpful assistant.\" [See these docs](https://platform.openai.com/docs/guides/chat/instructing-chat-models) for tips on writing good instructions.",
      optional: true,
    },
    messages: {
      label: "Prior Message History",
      type: "string[]",
      description: "_Advanced_. Because [the models have no memory of past chat requests](https://platform.openai.com/docs/guides/chat/introduction), all relevant information must be supplied via the conversation. You can provide [an array of messages](https://platform.openai.com/docs/guides/chat/introduction) from prior conversations here. If this param is set, the action ignores the values passed to **System Instructions** and **Assistant Response**, appends the new **User Message** to the end of this array, and sends it to the API.",
      optional: true,
    },
    images: {
      label: "Images",
      type: "string[]",
      description: "Provide one or more images to [OpenAI's vision model](https://platform.openai.com/docs/guides/vision). Accepts URLs or base64 encoded strings. Compatible with the `gpt4-vision-preview` model",
      optional: true,
    },
    audio: {
      type: "string",
      label: "Audio",
      description: "Provide the file path to an audio file in the `/tmp` directory. For use with the `gpt-4o-audio-preview` model. Currently supports `wav` and `mp3` files.",
      optional: true,
    },
    responseFormat: {
      type: "string",
      label: "Response Format",
      description: "Specify the format that the model must output. \n- **Text** (default): Returns unstructured text output.\n- **JSON Object**: Ensures the model's output is a valid JSON object.\n- **JSON Schema** (GPT-4o and later): Enables you to define a specific structure for the model's output using a JSON schema. Supported with models `gpt-4o-2024-08-06` and later, and `gpt-4o-mini-2024-07-18` and later.",
      options: Object.values(constants.CHAT_RESPONSE_FORMAT),
      default: constants.CHAT_RESPONSE_FORMAT.TEXT.value,
      optional: true,
      reloadProps: true,
    },
    toolTypes: {
      type: "string[]",
      label: "Tool Types",
      description: "The types of tools to enable on the assistant",
      options: constants.TOOL_TYPES.filter((toolType) => toolType === "function"),
      optional: true,
      reloadProps: true,
    },
  },
  additionalProps() {
    const {
      responseFormat,
      toolTypes,
      numberOfFunctions,
    } = this;
    const props = {};

    if (responseFormat === constants.CHAT_RESPONSE_FORMAT.JSON_SCHEMA.value) {
      props.jsonSchema = {
        type: "string",
        label: "JSON Schema",
        description: "Define the schema that the model's output must adhere to. [See the documentation here](https://platform.openai.com/docs/guides/structured-outputs/supported-schemas).",
      };
    }

    if (toolTypes?.includes("function")) {
      props.numberOfFunctions = {
        type: "integer",
        label: "Number of Functions",
        description: "The number of functions to define",
        optional: true,
        reloadProps: true,
        default: 1,
      };

      for (let i = 0; i < (numberOfFunctions || 1); i++) {
        props[`functionName_${i}`] = {
          type: "string",
          label: `Function Name ${i + 1}`,
          description: "The name of the function to be called. Must be a-z, A-Z, 0-9, or contain underscores and dashes, with a maximum length of 64.",
        };
        props[`functionDescription_${i}`] = {
          type: "string",
          label: `Function Description ${i + 1}`,
          description: "A description of what the function does, used by the model to choose when and how to call the function.",
          optional: true,
        };
        props[`functionParameters_${i}`] = {
          type: "object",
          label: `Function Parameters ${i + 1}`,
          description: "The parameters the functions accepts, described as a JSON Schema object. See the [guide](https://platform.openai.com/docs/guides/text-generation/function-calling) for examples, and the [JSON Schema reference](https://json-schema.org/understanding-json-schema/) for documentation about the format.",
          optional: true,
        };
      }
    }

    return props;
  },
  methods: {
    ...common.methods,
    _buildTools() {
      const tools = this.toolTypes?.filter((toolType) => toolType !== "function")?.map((toolType) => ({
        type: toolType,
      })) || [];
      if (this.toolTypes?.includes("function")) {
        const numberOfFunctions = this.numberOfFunctions || 1;
        for (let i = 0; i < numberOfFunctions; i++) {
          tools.push({
            type: "function",
            function: {
              name: this[`functionName_${i}`],
              description: this[`functionDescription_${i}`],
              parameters: this[`functionParameters_${i}`],
            },
          });
        }
      }
      return tools.length
        ? tools
        : undefined;
    },
  },
  async run({ $ }) {
    if (this.audio && !this.modelId.includes("gpt-4o-audio-preview")) {
      throw new ConfigurationError("Use of audio files requires using the `gpt-4o-audio-preview` model.");
    }

    const args = this._getChatArgs();

    const response = await this.openai.createChatCompletion({
      $,
      data: {
        ...args,
        tools: this._buildTools(),
      },
    });

    if (response) {
      $.export("$summary", `Successfully sent chat with id ${response.id}`);
    }

    const { messages } = args;
    return {
      original_messages: messages,
      original_messages_with_assistant_response: messages.concat(response.choices[0]?.message),
      ...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.

LabelPropTypeDescription
OpenAI (ChatGPT)openaiappThis component uses the OpenAI (ChatGPT) app.
ModelmodelIdstringSelect a value from the drop down menu.
User MessageuserMessagestring

The user messages provide instructions to the assistant. They can be generated by the end users of an application, or set by a developer as an instruction.

Max TokensmaxTokensinteger

The maximum number of tokens to generate in the completion.

Temperaturetemperaturestring

Optional. What sampling temperature to use. Higher values means the model will take more risks. Try 0.9 for more creative applications, and 0 (argmax sampling) for ones with a well-defined answer.

Top PtopPstring

An alternative to sampling with temperature, called nucleus sampling, where the model considers the results of the tokens with top_p probability mass. So 0.1 means only the tokens comprising the top 10% probability mass are considered. We generally recommend altering this or temperature but not both.

Nninteger

How many completions to generate for each prompt

Stopstopstring[]

Up to 4 sequences where the API will stop generating further tokens. The returned text will not contain the stop sequence.

Presence PenaltypresencePenaltystring

Number between -2.0 and 2.0. Positive values penalize new tokens based on whether they appear in the text so far, increasing the model's likelihood to talk about new topics.

Frequency PenaltyfrequencyPenaltystring

Number between -2.0 and 2.0. Positive values penalize new tokens based on their existing frequency in the text so far, decreasing the model's likelihood to repeat the same line verbatim.

Useruserstring

A unique identifier representing your end-user, which can help OpenAI to monitor and detect abuse. Learn more here.

System InstructionssystemInstructionsstring

The system message helps set the behavior of the assistant. For example: "You are a helpful assistant." See these docs for tips on writing good instructions.

Prior Message Historymessagesstring[]

Advanced. Because the models have no memory of past chat requests, all relevant information must be supplied via the conversation. You can provide an array of messages from prior conversations here. If this param is set, the action ignores the values passed to System Instructions and Assistant Response, appends the new User Message to the end of this array, and sends it to the API.

Imagesimagesstring[]

Provide one or more images to OpenAI's vision model. Accepts URLs or base64 encoded strings. Compatible with the gpt4-vision-preview model

Audioaudiostring

Provide the file path to an audio file in the /tmp directory. For use with the gpt-4o-audio-preview model. Currently supports wav and mp3 files.

Response FormatresponseFormatstringSelect a value from the drop down menu:{ "label": "Text", "value": "text" }{ "label": "JSON Object", "value": "json_object" }{ "label": "JSON Schema", "value": "json_schema" }
Tool TypestoolTypesstring[]Select a value from the drop down menu:function

Action Authentication

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

About OpenAI (ChatGPT)

OpenAI is an AI research and deployment company with the mission to ensure that artificial general intelligence benefits all of humanity. They are the makers of popular models like ChatGPT, DALL-E, and Whisper.

More Ways to Connect OpenAI (ChatGPT) + Miro Developer App

Create Board with Miro Developer App API on New Fine Tuning Job Created from OpenAI (ChatGPT) API
OpenAI (ChatGPT) + Miro Developer App
 
Try it
Create Shape with Miro Developer App API on New Fine Tuning Job Created from OpenAI (ChatGPT) API
OpenAI (ChatGPT) + Miro Developer App
 
Try it
Create Sticky Note with Miro Developer App API on New Fine Tuning Job Created from OpenAI (ChatGPT) API
OpenAI (ChatGPT) + Miro Developer App
 
Try it
Delete Board with Miro Developer App API on New Fine Tuning Job Created from OpenAI (ChatGPT) API
OpenAI (ChatGPT) + Miro Developer App
 
Try it
Delete Item with Miro Developer App API on New Fine Tuning Job Created from OpenAI (ChatGPT) API
OpenAI (ChatGPT) + Miro Developer App
 
Try it
Item Position Changed from the Miro Developer App API

Emit new event when an item's position changes in a Miro Custom App.

 
Try it
New Batch Completed from the OpenAI (ChatGPT) API

Emit new event when a new batch is completed in OpenAI. See the documentation

 
Try it
New File Created from the OpenAI (ChatGPT) API

Emit new event when a new file is created in OpenAI. See the documentation

 
Try it
New Fine Tuning Job Created from the OpenAI (ChatGPT) API

Emit new event when a new fine-tuning job is created in OpenAI. See the documentation

 
Try it
New Run State Changed from the OpenAI (ChatGPT) API

Emit new event every time a run changes its status. See the documentation

 
Try it
Create Board with the Miro Developer App API

Creates a Miro board. See the docs.

 
Try it
Create Shape with the Miro Developer App API

Creates a shape on a Miro board. See the docs.

 
Try it
Create Sticky Note with the Miro Developer App API

Creates a sticky note on a Miro board. See the docs.

 
Try it
Delete Board with the Miro Developer App API

Deletes a Miro board. See the docs.

 
Try it
Delete Item with the Miro Developer App API

Deletes an item from a Miro board. See the docs.

 
Try it

Explore Other Apps

1
-
24
of
2,400+
apps by most popular

HTTP / Webhook
HTTP / Webhook
Get a unique URL where you can send HTTP or webhook requests
Node
Node
Anything you can do with Node.js, you can do in a Pipedream workflow. This includes using most of npm's 400,000+ packages.
Python
Python
Anything you can do in Python can be done in a Pipedream Workflow. This includes using any of the 350,000+ PyPi packages available in your Python powered workflows.
OpenAI (ChatGPT)
OpenAI (ChatGPT)
OpenAI is an AI research and deployment company with the mission to ensure that artificial general intelligence benefits all of humanity. They are the makers of popular models like ChatGPT, DALL-E, and Whisper.
Premium
Salesforce
Salesforce
Web services API for interacting with Salesforce
Premium
HubSpot
HubSpot
HubSpot's CRM platform contains the marketing, sales, service, operations, and website-building software you need to grow your business.
Premium
Zoho CRM
Zoho CRM
Zoho CRM is an online Sales CRM software that manages your sales, marketing, and support in one CRM platform.
Premium
Stripe
Stripe
Stripe powers online and in-person payment processing and financial solutions for businesses of all sizes.
Shopify
Shopify
Shopify is a complete commerce platform that lets anyone start, manage, and grow a business. You can use Shopify to build an online store, manage sales, market to customers, and accept payments in digital and physical locations.
Premium
WooCommerce
WooCommerce
WooCommerce is the open-source ecommerce platform for WordPress.
Premium
Snowflake
Snowflake
A data warehouse built for the cloud
Premium
MongoDB
MongoDB
MongoDB is an open source NoSQL database management program.
Supabase
Supabase
Supabase is an open source Firebase alternative.
MySQL
MySQL
MySQL is an open-source relational database management system.
PostgreSQL
PostgreSQL
PostgreSQL is a free and open-source relational database management system emphasizing extensibility and SQL compliance.
Premium
AWS
AWS
Amazon Web Services (AWS) offers reliable, scalable, and inexpensive cloud computing services.
Premium
Twilio SendGrid
Twilio SendGrid
Send marketing and transactional email through the Twilio SendGrid platform with the Email API, proprietary mail transfer agent, and infrastructure for scalable delivery.
Amazon SES
Amazon SES
Amazon SES is a cloud-based email service provider that can integrate into any application for high volume email automation
Premium
Klaviyo
Klaviyo
Email Marketing and SMS Marketing Platform
Premium
Zendesk
Zendesk
Zendesk is award-winning customer service software trusted by 200K+ customers. Make customers happy via text, mobile, phone, email, live chat, social media.
Notion
Notion
Notion is a new tool that blends your everyday work apps into one. It's the all-in-one workspace for you and your team.
Slack
Slack
Slack is a channel-based messaging platform. With Slack, people can work together more effectively, connect all their software tools and services, and find the information they need to do their best work — all within a secure, enterprise-grade environment.
Microsoft Teams
Microsoft Teams
Microsoft Teams has communities, events, chats, channels, meetings, storage, tasks, and calendars in one place.
Schedule
Schedule
Trigger workflows on an interval or cron schedule.