Send a Large Message (3000+ characters) with Slack API on New Customer from LiveAgent API

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

Trigger workflow on

New Customer from the LiveAgent API

Next, do this

Send a Large Message (3000+ characters) with the Slack 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 LiveAgent trigger and Slack 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 trigger
1. Connect your LiveAgent account
2. Configure timer
Configure the Send a Large Message (3000+ characters) action
1. Connect your Slack account
2. Select a Channel
3. Configure Text
4. Optional- Configure Send text as Slack mrkdwn
5. Optional- Configure Send as User
6. Optional- Configure Schedule message
7. Optional- Configure Include link to workflow
8. Optional- Configure Customize Bot Settings
9. Optional- Configure Bot Username
10. Optional- Select a Icon (emoji)
11. Optional- Configure Icon (image URL)
12. Optional- Configure Reply to Thread
13. Optional- Configure Message Timestamp
14. Optional- Configure Send Channel Message
15. Optional- Configure Add Message Metadata
16. Optional- Configure Metadata Event Type
17. Optional- Configure Metadata Event Payload
18. Optional- Configure Configure Unfurl Settings
19. Optional- Configure Unfurl Links
20. Optional- Configure Unfurl Media
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 on LiveAgent

Description:Emit new event on each new customer.

Version:0.0.2

Key:liveagent-new-customer

View on GitHub

LiveAgent Overview#

The LiveAgent API provides access to a feature-rich helpdesk platform, allowing you to automate customer support tasks, synchronize data with other services, and streamline communication channels. With Pipedream, you can tap into the LiveAgent API to create custom workflows that enhance support operations, trigger actions based on customer interactions, and connect with a myriad of other apps to enrich the support ecosystem. Pipedream's serverless platform makes it simple to set up these automations with minimal coding, using pre-built actions or scripting your own.

Trigger Code#

import liveagent from "../../liveagent.app.mjs";
import { DEFAULT_POLLING_SOURCE_TIMER_INTERVAL } from "@pipedream/platform";

export default {
  name: "New Customer",
  version: "0.0.2",
  key: "liveagent-new-customer",
  description: "Emit new event on each new customer.",
  type: "source",
  dedupe: "unique",
  props: {
    liveagent,
    db: "$.service.db",
    timer: {
      type: "$.interface.timer",
      static: {
        intervalSeconds: DEFAULT_POLLING_SOURCE_TIMER_INTERVAL,
      },
    },
  },
  methods: {
    emitEvent(data) {
      this.$emit(data, {
        id: data.id,
        summary: `New customer with id ${data.id}`,
        ts: Date.parse(data.date_created),
      });
    },
    _setLastTimestamp(timestamp) {
      this.db.set("lastTimestamp", timestamp);
    },
    _getLastTimestamp() {
      return this.db.get("lastTimestamp");
    },
  },
  hooks: {
    async deploy() {
      const customers = await this.liveagent.getCustomers({
        params: {
          _perPage: 20,
          _sortDir: "DESC",
          _sortField: "date_created",
        },
      });

      if (customers.length) {
        this._setLastTimestamp(Date.parse(customers[0].date_created));
      }

      customers.reverse().forEach(this.emitEvent);
    },
  },
  async run() {
    const lastTimestamp = this._getLastTimestamp();
    this._setLastTimestamp(new Date().getTime());

    let page = 1;

    while (true) {
      const customers = await this.liveagent.getCustomers({
        params: {
          _page: page,
          _perPage: 100,
          _sortDir: "DESC",
          _sortField: "date_created",
        },
      });

      customers.reverse().forEach(this.emitEvent);

      if (customers.length < 100 || Date.parse(customers[0].date_created) < +lastTimestamp) {
        return;
      }

      if (customers.length) {
        this._setLastTimestamp(Date.parse(customers[0].date_created));
      }

      page++;
    }

  },
};

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
LiveAgent	`liveagent`	`app`	This component uses the LiveAgent app.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
	`timer`	`$.interface.timer`

Trigger Authentication#

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

You can find your API Key in Configuration > System > API in your LiveAgent account.
Your domain is 12345678 if your Live Agent URL is https://12345678.ladesk.com/

About LiveAgent#

LiveAgent is a web-based live chat and helpdesk software. It covers all support channels: Email, Live Chat, Call Center, Contact forms, Feedback Forms, Knowledge Base, Social networks(Twitter and Facebook) and integrates them into one enviroment.

Action#

Send a Large Message (3000+ characters) on Slack

Description:Send a large message (more than 3000 characters) to a channel, group or user. See [postMessage](https://api.slack.com/methods/chat.postMessage) or [scheduleMessage](https://api.slack.com/methods/chat.scheduleMessage) docs here

Version:0.0.20

Key:slack-send-large-message

View on GitHub

Slack Overview#

The Pipedream Slack app enables you to build event-driven workflows that interact with the Slack API. Once you authorize the Pipedream app's access to your workspace, you can use Pipedream workflows to perform common Slack actions or write your own code against the Slack API.

The Pipedream Slack app is not a typical app. You don't interact with it directly as a bot, and it doesn't add custom functionality to your workspace out of the box. It makes it easier to automate anything you'd typically use the Slack API for, using Pipedream workflows.

Automate posting updates to your team channels
Create a bot to answer common questions
Integrate with your existing tools and services
And much more!

Action Code#

import common from "../common/send-message.mjs";

export default {
  ...common,
  key: "slack-send-large-message",
  name: "Send a Large Message (3000+ characters)",
  description: "Send a large message (more than 3000 characters) to a channel, group or user. See [postMessage](https://api.slack.com/methods/chat.postMessage) or [scheduleMessage](https://api.slack.com/methods/chat.scheduleMessage) docs here",
  version: "0.0.20",
  type: "action",
  props: {
    slack: common.props.slack,
    conversation: {
      propDefinition: [
        common.props.slack,
        "conversation",
      ],
    },
    text: {
      propDefinition: [
        common.props.slack,
        "text",
      ],
    },
    mrkdwn: {
      propDefinition: [
        common.props.slack,
        "mrkdwn",
      ],
    },
    ...common.props,
  },
  async run({ $ }) {
    if (this.include_sent_via_pipedream_flag) {
      const sentViaPipedreamText = this._makeSentViaPipedreamBlock();
      this.text += `\n\n\n${sentViaPipedreamText.elements[0].text}`;
    }

    let metadataEventPayload;

    if (this.metadata_event_type) {
      if (typeof this.metadata_event_payload === "string") {
        try {
          metadataEventPayload = JSON.parse(this.metadata_event_payload);
        } catch (error) {
          throw new Error(`Invalid JSON in metadata_event_payload: ${error.message}`);
        }
      }

      this.metadata = {
        event_type: this.metadata_event_type,
        event_payload: metadataEventPayload,
      };
    }

    const obj = {
      text: this.text,
      channel: this.conversation,
      as_user: this.as_user,
      username: this.username,
      icon_emoji: this.icon_emoji,
      icon_url: this.icon_url,
      mrkdwn: this.mrkdwn,
      metadata: this.metadata || null,
      reply_broadcast: this.thread_broadcast,
      thread_ts: this.thread_ts,
      unfurl_links: this.unfurl_links,
      unfurl_media: this.unfurl_media,
    };

    let response;
    if (this.post_at) {
      obj.post_at = this.post_at;
      response = await this.slack.sdk().chat.scheduleMessage(obj);
    }

    response = await this.slack.sdk().chat.postMessage(obj);
    const { channel } = await this.slack.conversationsInfo({
      channel: response.channel,
    });
    let channelName = `#${channel?.name}`;
    if (channel.is_im) {
      const usernames = await this.slack.userNames();
      channelName = `@${usernames[channel.user]}`;
    } else if (channel.is_mpim) {
      channelName = `@${channel.purpose.value}`;
    }
    $.export("$summary", `Successfully sent a message to ${channelName}`);
    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
Slack	`slack`	`app`	This component uses the Slack app.
Channel	`conversation`	`string`	Select a value from the drop down menu.
Text	`text`	`string`	Text of the message to send (see Slack's formatting docs). This field is usually necessary, unless you're providing only attachments instead.
Send text as Slack mrkdwn	`mrkdwn`	`boolean`	`TRUE` by default. Pass `FALSE` to disable Slack markup parsing. See docs here
Send as User	`as_user`	`boolean`	Optionally pass `TRUE` to post the message as the authenticated user, instead of as a bot. Defaults to `FALSE`.
Schedule message	`post_at`	`string`	Messages can only be scheduled up to 120 days in advance, and cannot be scheduled for the past. The datetime should be in ISO 8601 format. (Example: `2014-01-01T00:00:00Z`)
Include link to workflow	`include_sent_via_pipedream_flag`	`boolean`	Defaults to `true`, includes a link to the workflow at the end of your Slack message.
Customize Bot Settings	`customizeBotSettings`	`boolean`	Customize the username and/or icon of the Bot
Reply to Thread	`replyToThread`	`boolean`	Reply to an existing thread
Add Message Metadata	`addMessageMetadata`	`boolean`	Set the metadata event type and payload
Configure Unfurl Settings	`configureUnfurlSettings`	`boolean`	Configure settings for unfurling links and media

Action Authentication#

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

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

channels:historychannels:readchannels:writeemoji:readgroups:historygroups:readgroups:writeim:historyim:readim:writelinks:readlinks:writempim:historympim:readmpim:writereactions:readreactions:writereminders:readreminders:writestars:readteam:readusergroups:readusergroups:writeusers:readusers:read.emailusers:writechat:write:botchat:write:userfiles:write:usercommandsusers.profile:writeusers.profile:read

About 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.

More Ways to Connect Slack + LiveAgent#

Other Popular Integrations#

Create Customer with LiveAgent API on New Star Added To Message (Instant) from Slack API

Slack + LiveAgent

Send a Large Message (3000+ characters) with Slack API on New Customer from LiveAgent API

Pipedream makes it easy to connect APIs for Slack, LiveAgent 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