> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wisepilot.app/llms.txt
> Use this file to discover all available pages before exploring further.

# ChatGPT Integration

> Set up a ChatGPT project with full access to WisePilot — read data, create content, publish to platforms, and generate reports through natural conversation.

Connect ChatGPT to WisePilot for a natural-language marketing operations interface. Each client gets their own ChatGPT project with brand context pre-loaded and full API access.

## What You Can Do

With the ChatGPT integration, your team can:

* **Query any data** — GSC, GA4, Google Ads, Meta Ads, GBP performance, conversations, appointments
* **Create content** — Blog posts, landing pages, CTAs, ad creatives, social posts, nurture sequences
* **Publish to platforms** — WordPress, Google Ads, Meta Ads, GHL, Elementor, Pinterest, Slack
* **Manage workflows** — Lifecycle tracking, work item triage, content opportunity management
* **Generate reports** — PPTX slide decks with brand theming, performance snapshots
* **Run SEO research** — Keyword ideas, SERP analysis, competitor gaps via Ahrefs

<Note>
  **Tool surface.** ChatGPT discovers WisePilot's full surface area through **8 explore/query domain pairs** (`{domain}_explore` + `{domain}_query`) plus 4 atomic orchestration tools (`dispatch_lifecycle`, `promote_learning`, `request_wp_engineer_work`, `get_image_brief`). The agent calls `_explore` to see what's available, then `_query` to execute. See the **[MCP Tool Reference](/integrations/mcp-reference)** for the full catalog and patterns.
</Note>

## Prerequisites

1. **WisePilot account** with Editor role or higher
2. **API key** — created in WisePilot Settings > API Keys
3. **ChatGPT Plus, Team, or Enterprise** plan
4. **Brand data configured** in WisePilot (brand position, ICPs, guidelines)

## Setup Guide

### Step 1: Create an API Key

1. Go to **Settings > API Keys** in WisePilot
2. Click **Create Key** and scope it to the client's website
3. Copy the `cr_...` key (shown only once)

### Step 2: Export the Knowledge Pack

Download the brand context file:

```bash theme={null}
curl -H "Authorization: Bearer cr_YOUR_KEY" \
  "https://ai.wisepilot.app/api/v1/export/knowledge-pack?website_id=YOUR_WEBSITE_ID" \
  -o knowledge-pack.md
```

This file contains brand position, ICPs, messaging library, confirmed learnings, and visual identity.

### Step 3: Create a ChatGPT Project

1. Open ChatGPT > **Projects** > **New Project**
2. Name it after the client (e.g., "Fully Booked Venue")

### Step 4: Configure the API Action

1. In the project, go to **Actions** > **Create Action**
2. Import the OpenAPI spec: `https://ai.wisepilot.app/docs/openapi.yaml`
3. Set authentication:
   * Type: **API Key**
   * Header: `Authorization`
   * Value: `Bearer cr_YOUR_KEY`

### Step 5: Add the System Prompt

Copy the system prompt from your WisePilot admin or use the template provided by your agency. This teaches ChatGPT how to use every API endpoint.

### Step 6: Upload Knowledge Pack

Upload the `knowledge-pack.md` file as a project file. This gives ChatGPT persistent access to brand context without burning API calls.

### Step 7: Test

Ask ChatGPT: *"What are our top performing blog posts this month?"*

It should call the GSC and GA4 endpoints and answer with real numbers.

## Refreshing Data

* **Knowledge pack** — Re-export when brand data changes (new ICPs, new learnings, rebranding). Not needed weekly.
* **Live data** — Metrics, work items, and content are always fetched live via API. If data looks stale, ask ChatGPT to *"sync the latest GSC data"*.

## Available Skills

ChatGPT comes with 23 workflow playbooks:

| Category         | Skills                                                                        |
| ---------------- | ----------------------------------------------------------------------------- |
| **Content**      | Blog creation, blog editing, landing page creation, content calendar planning |
| **SEO**          | SEO audit, competitor analysis, content performance deep dive                 |
| **Ads**          | Ad creative production, ad campaign operations, Google Ads optimization       |
| **Intelligence** | Work item triage, experiment management, CTA optimization                     |
| **Local**        | GBP review management, agent prompt optimization                              |
| **Setup**        | New client onboarding, entity library building, integration health check      |
| **Reporting**    | Client snapshot, deck creation                                                |
| **Other**        | Social content creation, nurture sequence building, image generation          |

## Security

* API keys are scoped to specific websites — ChatGPT can only access data for the assigned client
* Write operations use risk gating — high-risk actions (publishing, ad changes) create approval work items instead of executing directly
* Rate limit: 1,000 requests per hour per key
* Keys can be revoked at any time from Settings > API Keys

## Troubleshooting

| Issue                            | Fix                                                                                                |
| -------------------------------- | -------------------------------------------------------------------------------------------------- |
| "Unauthorized" errors            | Check that the API key is correct and hasn't been revoked                                          |
| ChatGPT doesn't call the API     | Verify the Action is configured with the correct OpenAPI spec URL                                  |
| Empty data responses             | The integration may not be connected — ask ChatGPT to check integration health                     |
| "Lifecycle checklist incomplete" | The content needs to complete lifecycle steps before publishing — ask ChatGPT what's blocking      |
| HIGH risk action gated           | Expected behavior — approve the work item in WisePilot or ask ChatGPT to check the approval status |