Create Tweet with X (Twitter) API on New Customer Created from HotspotSystem API

Pipedream makes it easy to connect APIs for X (Twitter), HotspotSystem and 2,400+ other apps remarkably fast.

Trigger workflow on

New Customer Created from the HotspotSystem API

Next, do this

Create Tweet with the X (Twitter) 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 HotspotSystem trigger and X (Twitter) action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New Customer Created trigger
1. Connect your HotspotSystem account
2. Configure Polling schedule
3. Select a Location ID
Configure the Create Tweet action
1. Connect your X (Twitter) account
2. Optional- Configure Text
3. Optional- Configure In Reply To Tweet (ID)
4. Optional- Configure Exclude Reply User IDs
5. Optional- Configure Media IDs
6. Optional- Configure Tagged User IDs
7. Optional- Configure Place ID
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 Customer Created on HotspotSystem

Description:Emit new event when a new customer in a location is created. [See the docs](http://www.hotspotsystem.com/apidocs/api/reference/#operation-getcustomersbylocationid).

Version:0.0.1

Key:hotspotsystem-new-customer-created

View on GitHub

HotspotSystem Overview#

The HotspotSystem API enables automation of hotspot management tasks, such as creating and managing user accounts, adjusting access packages, and retrieving usage statistics. Leveraging Pipedream's capabilities, you can build powerful workflows to interact with this API, automating tasks that otherwise would take considerable manual effort. Use Pipedream to integrate HotspotSystem with a myriad of services for notifications, data analysis, customer management, and more, all in real-time.

Trigger Code#

import common from "../common/polling.mjs";
import constants from "../../common/constants.mjs";

export default {
  ...common,
  key: "hotspotsystem-new-customer-created",
  name: "New Customer Created",
  description: "Emit new event when a new customer in a location is created. [See the docs](http://www.hotspotsystem.com/apidocs/api/reference/#operation-getcustomersbylocationid).",
  type: "source",
  version: "0.0.1",
  dedupe: "unique",
  methods: {
    ...common.methods,
    listLocationCustomers({
      locationId, ...args
    }) {
      return this.app.makeRequest({
        path: `/locations/${locationId}/customers`,
        ...args,
      });
    },
    getResourcesFn() {
      return this.listLocationCustomers;
    },
    getResourcesFnArgs() {
      return {
        locationId: this.locationId,
        params: {
          limit: constants.DEFAULT_LIMIT,
          sort: `-${constants.FIELDS.REGISTERED_AT}`,
        },
      };
    },
    generateMeta(resource) {
      return {
        id: resource.id,
        summary: `New Customer ${resource.id}`,
        ts: Date.parse(resource.registered_at),
      };
    },
  },
};

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
HotspotSystem	`app`	`app`	This component uses the HotspotSystem app.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
Polling schedule	`timer`	`$.interface.timer`	How often to poll the Hotspot System API
Location ID	`locationId`	`string`	Select a value from the drop down menu.

Trigger Authentication#

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

Your API key can be generated from the Control Center > Tools & Settings > API Keys menu.

About HotspotSystem#

Hotspotsystem.com reseller program is designed for ISP and WISP companies, Multi-site, Hotels, Campgrounds, Retail Chains, Wireless Hotspot Installers, Network System Integrators.

Action#

Create Tweet on X (Twitter)

Description:Create a new tweet. [See the documentation](https://developer.twitter.com/en/docs/twitter-api/tweets/manage-tweets/api-reference/post-tweets)

Version:2.1.6

Key:twitter-create-tweet

View on GitHub

X (Twitter) Overview#

The Twitter API on Pipedream enables you to automate interactions with Twitter, from posting tweets to analyzing social media trends. Pipedream's serverless platform provides the tools to create workflows that trigger on specific Twitter activities, process data, and connect with countless other apps for extensive automation scenarios. With Pipedream's integration, you can listen for events such as new tweets, mentions, or followers, and execute actions like tweeting, retweeting, or even leveraging sentiment analysis to gauge public perception.

Action Code#

import app from "../../app/twitter.app.mjs";
import { ACTION_ERROR_MESSAGE } from "../../common/errorMessage.mjs";
import { defineAction } from "@pipedream/types";
const DOCS_LINK = "https://developer.twitter.com/en/docs/twitter-api/tweets/manage-tweets/api-reference/post-tweets";
export default defineAction({
    key: "twitter-create-tweet",
    name: "Create Tweet",
    description: `Create a new tweet. [See the documentation](${DOCS_LINK})`,
    version: "2.1.6",
    type: "action",
    props: {
        app,
        text: {
            type: "string",
            label: "Text",
            description: "Text of the Tweet being created. Required if `Media IDs` is not set.",
            optional: true,
        },
        inReplyToTweetId: {
            type: "string",
            label: "In Reply To Tweet (ID)",
            description: "Tweet ID of the Tweet being replied to. Please note that this prop needs to be set if `Exclude Reply User IDs` is also set.",
            optional: true,
        },
        excludeReplyUserIds: {
            type: "string[]",
            label: "Exclude Reply User IDs",
            description: "A list of User IDs to be excluded from the reply Tweet thus removing a user from a thread.",
            optional: true,
        },
        mediaIds: {
            type: "string[]",
            label: "Media IDs",
            description: "A list of Media IDs being attached to the Tweet. This is only required if `Tagged User IDs` is set.",
            optional: true,
        },
        taggedUserIds: {
            type: "string[]",
            label: "Tagged User IDs",
            description: "A list of User IDs being tagged in the Tweet with Media. If the user you're tagging doesn't have photo-tagging enabled, their names won't show up in the list of tagged users even though the Tweet is successfully created.",
            optional: true,
        },
        placeId: {
            type: "string",
            label: "Place ID",
            description: "Place ID being attached to the Tweet for geo location.",
            optional: true,
        },
    },
    async run({ $ }) {
        const { text, inReplyToTweetId, excludeReplyUserIds, mediaIds, placeId, taggedUserIds, } = this;
        const params = {
            $,
            data: {
                text,
                ...((inReplyToTweetId || excludeReplyUserIds) && {
                    reply: {
                        exclude_reply_user_ids: excludeReplyUserIds,
                        in_reply_to_tweet_id: inReplyToTweetId,
                    },
                }),
                ...((mediaIds || taggedUserIds) && {
                    media: {
                        media_ids: mediaIds,
                        tagged_user_ids: taggedUserIds,
                    },
                }),
                ...(placeId && {
                    geo: {
                        place_id: placeId,
                    },
                }),
            },
            fallbackError: ACTION_ERROR_MESSAGE,
        };
        const response = await this.app.createTweet(params);
        $.export("$summary", `Successfully posted tweet (ID ${response.data?.id})`);
        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
X (Twitter)	`app`	`app`	This component uses the X (Twitter) app.
Text	`text`	`string`	Text of the Tweet being created. Required if `Media IDs` is not set.
In Reply To Tweet (ID)	`inReplyToTweetId`	`string`	Tweet ID of the Tweet being replied to. Please note that this prop needs to be set if `Exclude Reply User IDs` is also set.
Exclude Reply User IDs	`excludeReplyUserIds`	`string[]`	A list of User IDs to be excluded from the reply Tweet thus removing a user from a thread.
Media IDs	`mediaIds`	`string[]`	A list of Media IDs being attached to the Tweet. This is only required if `Tagged User IDs` is set.
Tagged User IDs	`taggedUserIds`	`string[]`	A list of User IDs being tagged in the Tweet with Media. If the user you're tagging doesn't have photo-tagging enabled, their names won't show up in the list of tagged users even though the Tweet is successfully created.
Place ID	`placeId`	`string`	Place ID being attached to the Tweet for geo location.

Action Authentication#

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

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

Create Tweet with X (Twitter) API on New Customer Created from HotspotSystem API

Pipedream makes it easy to connect APIs for X (Twitter), HotspotSystem and 2,400+ other apps remarkably fast.

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

Developers ♥ Pipedream

1-24of2,400+apps by most popular

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