Get channel
ReadRead a channel's status and occupancy.
Permissions and limits
Account permissions
- An Ably API key with the channel-metadata capability
Operation limits
- Ably notes this read activates the channel.
Messaging · CONNECTIONAbly + NodeHub
Publish realtime messages and read channel history, presence, channels and usage on Ably.
Explore 7 workflow actions for Ably, including account permissions and operation limits.
6 read actions1 write action
WORKFLOW ACTIONS
What you can configure.
Choose an action in the workflow builder, connect an account, and map its inputs. These actions are available in the catalog; your account access and a successful test determine whether they work for your setup.
Get message history
ReadRead a channel's stored messages in a time window.
Permissions and limits
Account permissions
- An Ably API key with the history capability
Operation limits
- Only messages within the account's retention period, and fully only on channels set to persist messages.
- Returns the first page only; Ably puts later pages in Link headers, so narrow with start, end and limit.
Get presence
ReadRead the members present on a channel now.
Permissions and limits
Account permissions
- An Ably API key with the presence capability
Operation limits
- Returns the first page only; Ably puts later pages in Link headers, so narrow with start, end and limit.
Get presence history
ReadRead enter, leave and update events on a channel in a time window.
Permissions and limits
Account permissions
- An Ably API key with the history capability
Operation limits
- Returns the first page only; Ably puts later pages in Link headers, so narrow with start, end and limit.
Get statistics
ReadRead the app's usage statistics by minute, hour, day or month.
Permissions and limits
Account permissions
- An Ably API key with the statistics capability
Operation limits
- Returns the first page only; Ably puts later pages in Link headers, so narrow with start, end and limit.
List active channels
ReadRead the names of active channels, optionally by prefix.
Permissions and limits
Account permissions
- An Ably API key with the channel-metadata on * capability
Operation limits
- Ably allows one channel listing at a time and may return fewer than the limit.
- Returns the first page only; Ably puts later pages in Link headers, so narrow with start, end and limit.
Publish message
WritePublish a message with an event name and data on a channel.
Permissions and limits
Account permissions
- An Ably API key with the publish capability
Operation limits
- NodeHub sets the message id from the step, so Ably does not deliver a retried publish twice.
- Message size is limited by the account's plan (64 KiB by default).
A repeated request may repeat the external action. Review the previous result before retrying a write.
SETUP
Start with a controlled test.
01Connect the intended account
Use the account and permissions required for your process. Review the connection check before configuring a workflow action.
02Review inputs and access
Select a listed operation and map its required inputs. Use test records and add a human approval before writes that need review.
03Confirm the result
Inspect step outputs and confirm the result in Ably. A saved workflow is not a completed provider action.
EXPLORE YOUR STACK
