An RTMClient allows programs to communicate with the Slack Platform’s RTM API. This object uses the EventEmitter pattern to dispatch incoming events and has several methods for sending outgoing messages.
Constructs a new instance of the RTMClient
class
Parameters:
Name | Type | Required | Description | |
---|---|---|---|---|
token | string |
✓ | ||
opts | RTMClientOptions |
✗ | ||
webClient | WebClient |
✗ | An optional parameter to provide a customized WebClient. Any desired options for the custom client must be set in this parameter (webClient ) as they will take precedence over other arguments passed into RTMClient . |
Options:
Name | Type | |
---|---|---|
agent | Agent |
|
autoReconnect | boolean |
|
clientPingTimeout | number |
|
logger | Logger |
|
logLevel | LogLevel |
|
replyAckOnReconnectTimeout | number |
|
retryConfig | RetryOptions |
|
serverPongTimeout | number |
|
slackApiUrl | string |
|
tls | TLSOptions |
|
useRtmConnect | boolean |
Name | Type | Description |
---|---|---|
activeTeamId | string |
The team ID for the workspace the client is connected to. |
activeUserId | string |
The user ID for the connected client. |
authenticated | boolean |
Whether or not the client has authenticated to the RTM API. This occurs when the connect method completes, and a WebSocket URL is available for the client's connection. |
connected | boolean |
Whether or not the client is currently connected to the RTM API |
Generic method for sending an outgoing message of an arbitrary type. This method guards the higher-level methods from concern of which state the client is in, because it places all messages into a queue. The tasks on the queue will buffer until the client is in a state where they can be sent.
If the awaitReply parameter is set to true, then the returned Promise is resolved with the platform’s acknowledgement response. Not all message types will result in an acknowledgement response, so use this carefully. This promise may be rejected with an error containing code=RTMNoReplyReceivedError if the client disconnects or reconnects before receiving the acknowledgement response.
If the awaitReply parameter is set to false, then the returned Promise is resolved as soon as the message is sent from the websocket.
Parameters:
Name | Type | Required | Description |
---|---|---|---|
awaitReply | true |
✓ | whether to wait for an acknowledgement response from the platform before resolving the returned Promise. |
type | string |
✓ | the message type |
body | object |
✗ | the message body |
Returns Promise<RTMCallResult>
Parameters:
Name | Type | Required | |
---|---|---|---|
awaitReply | false |
✓ | |
type | string |
✓ | |
body | object |
✗ |
Returns Promise<void>
End an RTM session. After this method is called no messages will be sent or received unless you call start() again later.
Returns Promise<void>
Generic method for sending an outgoing message of an arbitrary type. The main difference between this method and addOutgoingEvent() is that this method does not use a queue so it can only be used while the client is ready to send messages (in the ‘ready’ substate of the ‘connected’ state). It returns a Promise for the message ID of the sent message. This is an internal ID and generally shouldn’t be used as an identifier for messages (for that, there is ts
on messages once the server acknowledges it).
Parameters:
Name | Type | Required | Description |
---|---|---|---|
type | string |
✓ | the message type |
body | object |
✗ | the message body |
Returns Promise<number>
Send a simple message to a public channel, private channel, DM, or MPDM.
Parameters:
Name | Type | Required | Description |
---|---|---|---|
text | string |
✓ | The message text. |
conversationId | string |
✓ | A conversation ID for the destination of this message. |
Returns Promise<RTMCallResult>
Sends a typing indicator to indicate that the user with activeUserId
is typing.
Parameters:
Name | Type | Required | Description |
---|---|---|---|
conversationId | string |
✓ | The destination for where the typing indicator should be shown. |
Returns Promise<void>
Begin an RTM session using the provided options. This method must be called before any messages can be sent or received.
Parameters:
Name | Type | Required | |
---|---|---|---|
options | RTMStartOptions |
✗ |
Returns Promise<WebAPICallResult>
Subscribes this client to presence changes for only the given userIds
.
Parameters:
Name | Type | Required | Description |
---|---|---|---|
userIds | string[] |
✓ | An array of user IDs whose presence you are interested in. This list will replace the list from any previous calls to this method. |
Returns Promise<void>
A dictionary of codes for errors produced by this package
All errors produced by this package adhere to this interface
Name | Type | |
---|---|---|
code | ErrorCode |
Name | Type | |
---|---|---|
error | object |
|
reply_to | number |
|
ts | string |
Name | Type | |
---|---|---|
agent | Agent |
|
autoReconnect | boolean |
|
clientPingTimeout | number |
|
logger | Logger |
|
logLevel | LogLevel |
|
replyAckOnReconnectTimeout | number |
|
retryConfig | RetryOptions |
|
serverPongTimeout | number |
|
slackApiUrl | string |
|
tls | TLSOptions |
|
useRtmConnect | boolean |
Name | Type | |
---|---|---|
code | ErrorCode.NoReplyReceivedError |
Name | Type | |
---|---|---|
code | ErrorCode.SendMessagePlatformError |
|
data | RTMCallResult |
Name | Type | |
---|---|---|
code | ErrorCode.SendWhileDisconnectedError |
Name | Type | |
---|---|---|
code | ErrorCode.SendWhileNotReadyError |
Name | Type | |
---|---|---|
code | ErrorCode.WebsocketError |
|
original | Error |
RTMWebsocketError | RTMNoReplyReceivedError | RTMSendWhileDisconnectedError | RTMSendWhileNotReadyError
One of:
RTMStartArguments
One of:
RTMStartArguments