DEV

Bluesky

Bluesky Connection

Put Bluesky to Work with @Human Automations and @Human Agents

The Bluesky Connection documents all Triggers, Actions and Query Operations available for creating automations via the Bluesky API.

What can you do with the Bluesky Connection?

  • Connect to the Bluesky API in a few clicks

  • Use the related Bluesky Operations (see below) in @Human Automations or @Human Agents

Action Operations

Action: Like Post

Action: Repost Post

Action: Create Post

Query Operations

Query: Find Thread

Example link

Obtaining Access Credentials

To obtain a Personal Access Token (PAT) for Bluesky, follow these steps:

  1. Log in to your Bluesky account at https://bsky.app (ensure you're using the correct account if managing multiple).

  2. Navigate to Settings:

    • Click your profile icon (top-right).

    • Select "Settings" from the dropdown.

  3. Go to App Passwords:

    • In the left sidebar, select "App Passwords" (under "Advanced").

  4. Generate a new token:

    • Click "Generate New Password".

    • Enter a descriptive name (e.g., "API Access").

    • Click "Create".

  5. Copy the token:

    • The token will appear once—copy it immediately.


Token Scope: This PAT grants full account access. Use securely.

Configuring Webhooks

  1. Identify a Relay Endpoint: Select a public Jetstream relay (e.g., wss://jetstream2.us-east.bsky.network/subscribe).

  2. Define Subscription Filters: Specify the wantedCollections (e.g., app.bsky.feed.post) using query parameters in the connection URL.

  3. Establish a Persistent Connection: Open a WebSocket connection to the relay to receive a real-time JSON stream of network activity.

  4. Implement an Event Listener: Create a consumer service to parse the incoming stream and filter for relevant events.

  5. Forward to a Webhook URL: Configure your service to execute an HTTP POST request to your target endpoint for each matching event.

Code (Apache v2.0): Service Connectivity and Metadata

Code (Apache v2.0): List of External Resources and Internal Mapping

Last updated