> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/actions/playbooks/integrations.md).

# Integrations

Playbooks can use AirOps integrations to read context, notify teams, prepare content for publishing, and coordinate work across your stack.

## Grids

Grids and Playbooks compose for batch work. Add a Playbooks column to a Grid to run a published Playbook for each row.

To add a Playbooks column:

1. Open the Grid.
2. Click **+ Add Column**.
3. Select the **Playbooks** tab.
4. Choose the Playbook.
5. Map Grid columns, static values, or Brand Kits to Playbook Inputs.

If the workspace has no published Playbooks, the Playbooks tab does not have a Playbook to add.

## Slack

Slack supports two separate Playbook use cases:

* Add the native **Slack** Tool when the Playbook needs to read or act on Slack content.
* Connect Slack notifications when people should be notified about triggered runs or Human Review.

### Add the Slack Tool

1. Open the Playbook editor.
2. Open the **Tools** panel and add **Slack**.
3. Select an existing Slack workspace authentication. If the workspace does not have one, connect Slack when prompted.
4. Add Slack to the Playbook, then reference it in the Section that should use it.

The Slack Tool can read channel history and threads, look up users, retrieve files and canvases, and search messages. It can also send channel messages and thread replies, send direct messages, add reactions, and perform supported channel and canvas actions.

State the target channel, thread, user, file, or canvas in the Playbook instructions. For searches, include a query and time range. If a person should approve an outbound message or another Slack change, place a Human Review block before that action.

### Connect Slack notifications

To receive AirOps notifications when a Playbook is triggered or when Human Review is required:

1. Integrate Slack in your AirOps workspace settings.
2. Install the AirOps app in your Slack workspace.

{% hint style="info" %}
Slack notifications do not give a Playbook access to Slack content. Add the native Slack Tool when a Playbook needs to read or act on workspace content.
{% endhint %}

## CMS publishing

Best practice is to keep content creation and CMS publishing as separate steps. Use Playbooks to create, refresh, and review content, then publish from a Grid column, a separate publishing Playbook, or a CMS MCP.

Native CMS publishing options include:

* **Webflow:** Native export. The export pushes the full rich-text field, so custom embeds or tables in that field can be replaced.
* **WordPress:** Direct publishing.
* **Contentful:** Field-level content push.
* **Sanity:** Structured content push.
* **Ghost:** Article publishing.

If you use a CMS MCP or another custom publishing path, call the AirOps MCP `track_aeo_page_content_update` tool after the page is published or refreshed. Pass the page URL and update type. This records the content update in AirOps Insights so you can connect future AI visibility, citation, mention, and traffic changes to the publish event.

{% hint style="info" %}
Images created with the Image Generation tool are hosted. Other images generated or attached during a Session can be local to the Session. For CMS publishing that requires hosted images, use the Image Generation tool, stock image URLs, or add a manual image upload step to your process.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.airops.com/actions/playbooks/integrations.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
