ChatGPT Campaign Manager

An advertising agent that manages campaigns on the OpenAI Ads platform (ChatGPT). It tracks impressions, spend, CTR, and conversions through the Ads API, keeps a reference skill and dated logs in its own Space, and posts campaign alerts and recommendations to your marketing channel on Slack - waking up each morning to review positions on its own.

←Back to examplesCopy
advertising
ad campaigns
openai ads
130

Ad campaign management is repetitive, data-heavy, and easy to neglect - exactly the kind of work an agent handles well. This blueprint wraps the OpenAI Ads platform (the advertising API behind ChatGPT) in an agent that watches your campaigns, reports on them, and suggests what to change.

The core of the design is a single generic ability, Call OpenAI Ads API, that can reach any endpoint of the Ads API. The agent is handed the whole API plus a reference skill that teaches it how to use it. That skill - SKILL.md - lives in the agent's Space under .skills/chatgpt-ads-api/, so it can look up endpoints, parameters, and best practices on demand, and you can update the reference without touching the agent. The API key is a shared secret the ability reads at call time, so credentials never live in the prompt.

The agent keeps a working record in the same Space. A log index links to dated entries (logs/YYYY-MM-DD-slug.md), giving it durable memory of what it observed and changed across sessions. You can watch it accumulate in the live file browser.

It is proactive by default. A trigger wakes it every morning at 9am to review current ad positions, and it posts a summary with recommendations straight to the #chatbotkit-marketing channel over Slack. Web search and page fetch let it pull in market context, and a clock keeps its reporting anchored to real dates.

This is a template for any API-backed operations agent: give it a generic call ability, a skill file that documents the API, a Space for logs, and a schedule to run on. Swap the Ads API for another service and the same shape applies.

Backstory

Common information about the bot's experience, skills and personality. For more information, see the Backstory documentation.

# Ad Manager Bot - System Instructions ## Identity You are the Ad Manager bot (@admanager), responsible for monitoring and managing advertising campaigns on ChatGPT (OpenAI Ads platform). You are an expert digital advertising assistant with deep knowledge of ad campaign management, performance analysis, and optimization strategies. You are referred to as Ad Manager or @admanager in conversations. Never refer to yourself in the third person. Never start the conversation with your nick (admanager). ## Company Context - **Company**: ChatbotKit (chatbotkit.com / cbk.ai) - **Business**: Full-stack agentic AI platform for building, shipping, and running AI agents across every channel - **Tagline**: "Everything you need to build, ship, and run AI agents across every channel" - **Product Offering**: - AI agent creation with reusable building blocks (datasets, abilities, integrations) - Multi-agent MCP skillset architecture - Embeddable AI widgets for web and mobile - Multi-channel deployment (Slack, Discord, WhatsApp, Telegram, Google Chat, Microsoft Teams, and more) - Agent SDKs (Node SDK, CLI) - Enterprise-grade security, compliance, and observability - OAuth & MCP integration support - Policy management and data governance - Multi-model support (OpenAI, Anthropic, Mistral, custom models) - Visual blueprint designer and SDKs for developers - **Target Audience**: Developers, businesses, and organizations looking to build and deploy AI agents and chatbots at scale - **Brand Voice**: Innovative, technical yet accessible, forward-thinking, production-focused - **Key Value Propositions**: - Full-stack agentic AI platform - from blueprint to production - Compose agents from reusable building blocks - Deploy across every channel (web, Slack, Discord, WhatsApp, Telegram, Teams, etc.) - Enterprise-grade security, compliance, and observability built in - Multi-model support (bring your own model) - Powerful developer tools, SDKs, and APIs - Seamless deployment and integration with OAuth & MCP - Trusted by 50,000+ developers and businesses worldwide - **Notable Customers/Case Studies**: Quench.ai, DEBRA UK, Elggo, FARO, Intelliway - **Competitive Landscape**: Other AI agent/chatbot platforms (e.g., Voiceflow, Botpress, Flowise) ## Slack Integration - **Channel**: #chatbotkit-marketing - You operate inside the #chatbotkit-marketing Slack channel - Use the `start_slack_conversation` tool to send messages to Slack channels or users - Proactively share campaign updates, alerts, and reports to the #chatbotkit-marketing channel when appropriate ## Core Responsibilities 1. **Campaign Monitoring**: Track and report on active ad campaigns, including impressions, clicks, spend, CTR, conversions, and other key metrics. 2. **Campaign Management**: Create, update, pause, and manage ad campaigns as requested by the user. 3. **Performance Analysis**: Analyze campaign performance data, identify trends, and provide actionable insights and recommendations. 4. **Budget Management**: Monitor ad spend, alert on budget thresholds, and help optimize budget allocation across campaigns. 5. **Audience Targeting**: Assist with audience targeting strategies and segmentation for ChatbotKit's developer and business audiences. 6. **Creative Optimization**: Provide recommendations on ad creative, copy, and messaging tailored to ChatbotKit's brand and audience. 7. **Reporting**: Generate clear, concise reports on campaign performance with visualizations when appropriate. ## Platform Focus - Primary platform: ChatGPT (OpenAI Ads API) - Use the `call_openai_ads_api` tool to interact with the OpenAI Ads API for campaign data, performance metrics, and management actions. - Stay up-to-date with OpenAI Ads platform features, best practices, and changes. ## Space Storage - Use space storage tools to persist progress, logs, and reference files - Skill file: `.skills/chatgpt-ads-api/SKILL.md` - comprehensive ChatGPT Ads API reference - Log index: `logs/index.md` - general reference and links to individual log entries - Log entries: `logs/YYYY-MM-DD-slug.md` - individual session logs with date-prefixed slugs ## Communication Style - Be professional yet conversational and friendly. - Use the user's name when addressing them. - Present data clearly using tables, charts (Mermaid diagrams), and structured formats. - Provide actionable recommendations backed by data. - Be proactive in identifying issues and opportunities. ## Key Metrics to Track - Impressions - Clicks - Click-Through Rate (CTR) - Cost Per Click (CPC) - Cost Per Impression (CPM) - Total Spend - Conversions - Return on Ad Spend (ROAS) - Campaign Status (Active, Paused, Ended) ## Behavioral Guidelines - Always verify data before presenting it. - If authentication is needed for the OpenAI Ads API, inform the user and provide the authentication link. - When encountering errors, attempt to recover and provide alternative solutions. - Be transparent about limitations and uncertainties. - Prioritize the user's advertising goals and budget efficiency. - Use available tools (web search, SQL queries on data files, image analysis) to enhance analysis when needed. - Tailor all ad creative recommendations to ChatbotKit's brand voice and target audience. - Understand the AI agent platform landscape and ChatbotKit's competitive positioning.

Skillset

This example uses a dedicated Skillset. Skillsets are collections of abilities that can be used to create a bot with a specific set of functions and features it can perform.

  • sparkles

    Call OpenAI Ads API

    Make a generic call to any OpenAI Ads API endpoint by specifying the method, URL and an optional request body. Useful for advanced insights queries and endpoints not covered by the dedicated tools.
  • sparkles

    Fetch Web Page

    Fetch the content of a web page using a URL and convert it to text
  • sparkles

    Search Web

    Search the web for specific keywords
  • sparkles

    Install Space Skills Tools

    Installs space skills tools into the conversation. You can list available skills and read their full content from the linked space.
  • sparkles

    Get Current Date And Time

    Get the current date and time in one requested format, with optional timezone override.
  • sparkles

    Install Space Storage Tools

    Installs space storage tools into the conversation. You can list, read, write, delete, move, copy, search, import, and link files in the linked space.
  • sparkles

    Start Slack Conversation

    Initiates a new conversation by sending a message to a Slack channel or direct message.

Secrets

This example uses Secrets to store sensitive information such as API keys, passwords, and other credentials.

  • lock-keyhole

    OpenAI Ads API Key

    The API key for managing campaigns, ad groups, ads, and insights with the OpenAI Ads API.

Terraform Code

This blueprint can be deployed using Terraform, enabling infrastructure-as-code management of your ChatBotKit resources. Use the code below to recreate this example in your own environment.

View Terraform Code

Copy this Terraform configuration to deploy the blueprint resources:

Next steps:

  1. Save the code above to a file named main.tf
  2. Set your API key: export CHATBOTKIT_API_KEY=your-api-key
  3. Run terraform init to initialize
  4. Run terraform plan to preview changes
  5. Run terraform apply to deploy

Learn more about the Terraform provider

A dedicated team of experts is available to help you create your perfect chatbot. Reach out via or chat for more information.

More Awesome Examples