# Slack Reference

## `slack.channel`

**Using YAML actions:** `slack.channel`

**Using Pilot JavaScript:** `$slack.channel(...)`

Send a Slack message to a channel.

### Inputs

This action action expects an object argument with the following properties:

* `text` (`string`)
  * The text of the message.

    If `blocks` is provided, then this becomes the text for the Slack notification.
* `blocks` (`Array<{ [key: string]: any }> | null`)
  * The blocks of the message.

    See <https://api.slack.com/block-kit/building> for more information.
* `hook_url` (`string | null`)
  * The webhook to send the Slack message to.

    If not provided, the message will be sent to the default configured channel for the Aviator account.

    See <https://api.slack.com/messaging/webhooks> for more information.

## `slack.direct`

**Using YAML actions:** `slack.direct`

**Using Pilot JavaScript:** `$slack.direct(...)`

Send a Slack direct message to a user or group of users.

### Inputs

This action action expects an object argument with the following properties:

* `text` (`string`)
  * The text of the message.

    If `blocks` is provided, then this becomes the text for the Slack notification.
* `blocks` (`Array<{ [key: string]: any }> | null`)
  * The blocks of the message.

    See <https://api.slack.com/block-kit/building> for more information.
* `github_users` (`Array<{login: string} > | null`)
  * The GitHub logins for users that will be messaged.

    These users must connect both their GitHub and Slack accounts to Aviator in order to receive the message.
* `github_group` (`string | null`)
  * GitHub group whose members will be messaged.

    The group must be a GitHub team in the form `@org/team`.

    The members of the group must connect both their GitHub and Slack accounts to Aviator in order to receive the message.
* `labels` (`Array<string> | null`)
  * Labels associated with this Slack message.

    Users can opt-in or opt-out of certain labels to personalize their Aviator Slack messages.
* `opt_in` (`boolean | null`)
  * Whether users must opt-in to receive the Slack message.

    If true, then users must explicitly opt-in to receive the message. Otherwise, all users will receive the message unless they have opted-out.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.aviator.co/pilot-automated-actions/reference/slack.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.