1. iWay Integration Tools
  2. Chapter 1. iWay Components
  3. 1.3. Concept: iWay Connectors
  4. Slack Connector
  5. Slack - post message

Slack - post message

Description - Post a text message and optional attachments to a group or im
 
Runtime Class - com.ibi.agents.XDXSlackChatPostMessage

 

Configuration

This action requires a Generics Configuration as well as the following required parameters.
 

Parameter Groups

  Parameter Type Description
* Channel: string Channel, private group, or IM channel to send message to. Can be an encoded ID, or a name.
* - denotes required
  Parameter Type Description
* Text: string Text of a message to send. Provide no more than 40,000 characters or risk truncation.
* - denotes required
  Parameter Type Description
  JSON Descriptor: string A JSON-based array of structured attachments, presented as a URL-encoded string.
* - denotes required
  Parameter Type Description
  As User: boolean true to post the message as the authed user, instead of as a bot. Defaults to false.
  Icon Emoji: string Used as the icon for the message. Overrides Icon Url. Must be used in conjunction with as_user set to false, otherwise ignored.
  Icon URL: string URL for an image to use as the icon for the message. Must be used in conjunction with as_user set to false, otherwise ignored.
  Link Names: boolean Find and link channel names and user names. Default is true.
  mrkdwn: boolean Disable Slack markup parsing by setting to false. Default is true.
  Parse Texts: string Change how Slack message texts are treated. Default is none.

Select from one of the following options:
  • none - do not parse
  • full - perform Slack formatting
  Broadcast Reply: boolean Used in conjunction with Thread Timestamp and indicates whether a reply should be made visible to everyone in the channel or conversation. Default is false.
  Unfurl Links: boolean If true, enables unfurling of primarily text-based content.
  Unfurl Media: boolean If false, disables unfurling of media content.
  User Name: string Sets your request's user name. Usually used in conjunction with As User set to false, otherwise ignored.
  Reply to message id: string To reply to another message provide the other message's Timestamp value . void using a reply's Timestamp value; use its parent instead.
* - denotes required
  Parameter Type Description
* Namespace: string Name of the special registers namespace to prepend to any created register or variable returned by the object.
* - denotes required
  Parameter Type Description
  On Success: string If operation was successful, the object will return the following document type.

Select from one of the following options:
  • Status Document {status} - output status
  • Results Document {results} - output response in JSON format
  • Input Document {inputDocument} - output the input document in JSON format
  On Failure: string If operation in unsuccessful, should the agent return the standard error document, or should it return its input?

Select from one of the following options:
  • Status Document {status} - The status document of execution.
  • Results Document {results} - The JSON results document of execution.
  • Input Document {inputDocument} - The original document passed into the object.
  • Error Document {errorDocument} - The error document produced by the object.
* - denotes required

 

Output Events

 

Name Description
onAccountInactive Authentication token is for a deleted user or workspace.
onActionProhibited the team associated with your request has some kind of restriction
onComplianceExportsPreventDeletion Compliance exports are on, messages can not be deleted.
onFatalError The server could not complete your operation(s) without encountering a catastrophic error. It's possible some aspect of the operation succeeded before the error was raised.
onInvalidAuth Some aspect of authentication cannot be validated. Either the provided token is invalid or the request originates from an IP address disallowed from making the request.
onIsArchived Channel has been archived.
onMissingScope Authorization prived does not have the required scope for the request. See Slack results JSON key "needed".
OnMessageTooLong Message text is too long
onNoPermission The workspace token used in this request does not have the permissions necessary to complete the request. Make sure your app is a member of the conversation it's attempting to post a message to.
onNotAuthorized No authentication token provided.
onLoginRequired The workspace is undergoing an enterprise migration and will not be available until migration is complete.
onRateLimited Application has posted too many messages, read 'https://api.slack.com/docs/rate-limits' documentation for more information
onRequestTimeout The method was called via a POST request, but the POST data was either missing or truncated.
onRestrictedAction Workspace preference prevents the authenticated user from posting.
onRollupError rolluop_error
onTeamAddedToOrg The workspace associated with your request is currently undergoing migration to an Enterprise Organization. Web API and other platform operations will be intermittently unavailable until the transition is complete.
onTokenRevoked Authentication token is for a deleted user or workspace or the app has been removed.
onTooManyAttachments Too many attachments were provided with this message. A maximum of 100 attachments are allowed on a message.
onUserNotFound the user used in your request does not actually exist.
onFailInitialization XDXSlack agent initialization error occurred.
onFailConnect Could not connect to the external system.
onFailNhttpErrorOccurred fail_nhttp_error_occurred
onFailSlackRequestProcessing An error occurred while processing the Slack request.
onFailSlackResponseProcessing An error occurred while processing the Slack response.
onAsUserNotSupported The as_user parameter does not function with workspace apps.
onChannelIsArchived the channel has been archived and doesn't accept further messages
onChannelNotFound Channel value passed was invalid.