NAiOS IconNAiOS Logo
Contacto
Volver al catálogo

Ably

ably

Ably is a real-time messaging platform helping developers build live features, including chat and data synchronization, with global scalability and robust reliability for modern applications

Developer ToolsWeb del proveedor
Acciones
11
Triggers
0
Autenticación
—
OAuth gestionado
No
Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (11)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Query Batch PresenceABLY_BATCH_PRESENCEAcción

This tool enables querying the presence states of multiple channels in a single api request. the api retrieves the member presence details of the specified channels in parallel.

Parámetros de entrada

  • channelsstringObligatorio

    Comma-separated list of channel names to query presence for

  • separatorstring

    Character used to separate channel names (default is comma)

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Query Batch Presence HistoryABLY_BATCH_PRESENCE_HISTORYAcción

This tool enables querying presence history for multiple channels in a single api request. it uses the get endpoint at https://rest.ably.io/presence to retrieve the member presence history details of the specified channels in parallel.

Parámetros de entrada

  • endinteger

    End time in milliseconds since epoch

  • limitinteger

    Maximum number of messages to return per channel (default 100, max 1000)

  • startinteger

    Start time in milliseconds since epoch

  • channelsstring[]Obligatorio

    List of channel names to query presence history for

  • directionstring

    Direction of results (backwards or forwards)

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create Ably ChannelABLY_CREATE_CHANNELAcción

Creates a new channel or retrieves an existing channel in ably. this tool allows you to programmatically create and initialize channels for real-time messaging. since ably creates channels implicitly when first used, this action publishes an empty initialization message to create/activate the channel.

Parámetros de entrada

  • channel_idstringObligatorio

    The name of the channel to create/initialize. Must be less than 1024 characters and can contain alphanumeric characters, hyphen, underscore, colon, and period.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete Channel SubscriptionABLY_DELETE_CHANNEL_SUBSCRIPTIONAcción

This tool allows you to unsubscribe devices or clients from push notifications for specific channels. the operation is asynchronous, so immediate requests after deletion may briefly still return the subscription.

Parámetros de entrada

  • channelstring

    The name of the channel to unsubscribe from. If not set, all subscriptions on all channels will be deleted.

  • client_idstring

    Filter to restrict to subscriptions associated with that clientId. Cannot be used with deviceId.

  • device_idstring

    Filter to restrict to subscriptions for that deviceId. Cannot be used with clientId.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Channel DetailsABLY_GET_CHANNEL_DETAILSAcción

This tool retrieves metadata and details for a specific channel in ably. it returns a channeldetails object containing information about the channel's status, occupancy, and other metadata. the endpoint provides visibility into channel activity, including metrics such as connections, presence, publishers, and subscribers, and requires appropriate permissions.

Parámetros de entrada

  • channel_idstringObligatorio

    The ID of the channel to retrieve details for

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Channel HistoryABLY_GET_CHANNEL_HISTORYAcción

This tool retrieves the message history for a specified ably channel. it uses the get /channels/{channelid}/messages endpoint to return a paginated list of messages in chronological order, subject to parameters such as 'channelid', 'limit', 'direction', 'start', and 'end'. the tool is useful for auditing, recovering missed messages, analyzing channel activity, and debugging message flows. authentication is required via basic or token authentication.

Parámetros de entrada

  • endinteger

    The end of the query interval as a time in milliseconds since the epoch

  • limitinteger

    The maximum number of records to return. A limit greater than 1,000 is invalid

  • startinteger

    The start of the query interval as a time in milliseconds since the epoch

  • directionstring

    The direction of this query. The direction determines the order of the returned result array

  • channel_idstringObligatorio

    The ID of the channel to retrieve history for

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Channel Presence HistoryABLY_GET_PRESENCE_HISTORYAcción

This tool retrieves the history of presence messages for a specified channel in ably. it allows you to query presence events on a channel within a given time period.

Parámetros de entrada

  • endinteger

    The end of the query interval as a time in milliseconds since the epoch. Defaults to current time.

  • limitinteger

    The maximum number of records to return. Maximum value is 1000.

  • startinteger

    The start of the query interval as a time in milliseconds since the epoch

  • directionstring

    The direction of results. Can be either 'backwards' or 'forwards'.

  • channel_idstringObligatorio

    The channel name to get presence history for

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Ably Service TimeABLY_GET_SERVICE_TIMEAcción

This tool retrieves the current server time from ably's service in milliseconds since the epoch. it is particularly useful for time synchronization and generating valid tokenrequest timestamps to prevent replay attacks. the endpoint supports multiple content types, handles http errors, network issues, and is a fundamental tool for ensuring accurate timing in ably applications.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Application StatsABLY_GET_STATSAcción

This tool retrieves your application's usage statistics from ably. the stats endpoint returns a paginated list of your application's usage statistics by minute, hour, day, or month. it supports optional parameters such as start, end, direction, limit, and unit to filter and format the returned data. the stats include metrics for: - message counts and data transferred - connection counts - channel usage - api request counts - push notification metrics - token request counts

Parámetros de entrada

  • endinteger

    The end of the query interval as a time in milliseconds since the epoch

  • unitstring

    The unit of aggregation in the returned results

  • limitinteger

    The maximum number of records to return. A limit greater than 1,000 is invalid

  • startinteger

    The start of the query interval as a time in milliseconds since the epoch

  • directionstring

    The direction of this query. The direction determines the order of the returned result array

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List Push Channel SubscriptionsABLY_LIST_PUSH_CHANNEL_SUBSCRIPTIONSAcción

This tool retrieves a list of all push notification channel subscriptions. it allows you to view all active push notification subscriptions for channels in your ably application. allows filtering by channel, deviceid, and clientid, supports pagination with limit parameter, and returns detailed push notification subscription information including channel, deviceid, and clientid.

Parámetros de entrada

  • limitinteger

    The maximum number of records to return. A limit greater than 1,000 is invalid.

  • channelstring

    Filter to restrict to subscriptions associated with that channel

  • client_idstring

    Filter to restrict to subscriptions associated with that clientId

  • device_idstring

    Filter to restrict to subscriptions for that deviceId

  • concat_filtersboolean

    Find all device registrations which match either clientId or deviceId

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Publish Message to ChannelABLY_PUBLISH_MESSAGE_TO_CHANNELAcción

This tool will allow users to publish a message to a specified ably channel using a post request. it covers the essentials like channel name, message data, optional event name/type, and additional metadata for push notifications. it is an independent and fundamental operation within ably's real-time messaging platform.

Parámetros de entrada

  • client_idstring

    Optional client identifier to associate with the message.

  • channel_idstringObligatorio

    The name of the channel to publish the message to.

  • event_namestring

    Optional event name/type for the message.

  • message_idstring

    Optional unique message ID for idempotent publishing.

  • message_datastringObligatorio

    The message payload. Can be a string or a JSON object.

  • push_notificationobject

    Optional push notification configuration.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not