ChatGPT Integration

Create a Custom GPT that searches real product offers, deals, and services via AON.

Prerequisites

• A ChatGPT Plus, Team, or Enterprise account (Custom GPTs require a paid plan)
• An active Agent App token (get one here)

Step 1: Create a Custom GPT

1. Go to ChatGPT
2. Click your profile → My GPTs → Create a GPT
3. Switch to the Configure tab

Step 2: Set Name and Description

• Name: AON Shopping Assistant (or your preferred name)
• Description: Find real product offers, deals, and services powered by Agent Offer Network.

Step 3: Paste Instructions

Copy the following instructions and paste into the Instructions field:

You are a shopping and product recommendation assistant powered by
Agent Offer Network (AON). You help users find real product offers,
deals, and services.
 
Core Rules:
1. MUST call searchOffers for ANY question about products, shopping,
   deals, offers, pricing, recommendations, comparisons, or services.
2. NEVER answer product recommendations from your own knowledge.
   Always call searchOffers first.
3. For non-shopping questions, answer normally without calling any action.
 
How to Call searchOffers:
- Extract the user's product intent into clear English text
- Set intent.content to [{"type": "input_text", "text": "<intent>"}]
- Set pagination.limit to 5 unless user asks for more or fewer
- Always include context.user_profile (even if empty: {})
 
Presenting Results:
- Show product title, price, description, and entity/brand name
- Include a clickable link using action.payload.target
- Add the label "Sponsored" next to each recommendation
- Respond in the user's language
 
Format:
> **Product Title** by Brand — $29.99
> Brief description.
> [View Deal](url) · *Sponsored*

Step 4: Configure the Action

1. Scroll down to Actions → Create new action
2. Paste the following OpenAPI spec into the schema editor:

{
  "openapi": "3.1.0",
  "info": {
    "title": "Agent Offer Network - ChatGPT Action",
    "version": "0.1.0"
  },
  "servers": [
    {
      "url": "https://api.aon.pro",
      "description": "Production public API baseline"
    }
  ],
  "security": [{ "bearerAuth": [] }],
  "paths": {
    "/v1/offers/query": {
      "post": {
        "operationId": "searchOffers",
        "summary": "Search product offers by intent.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["intent"],
                "properties": {
                  "intent": {
                    "type": "object",
                    "properties": {
                      "content": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "type": { "type": "string", "enum": ["input_text"] },
                            "text": { "type": "string" }
                          },
                          "required": ["type", "text"]
                        }
                      }
                    },
                    "required": ["content"]
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

3. Verify the import shows 0 validation errors
4. You should see one action: searchOffers

Step 5: Configure Authentication

1. In the Action configuration, click Authentication
2. Select API Key
3. Set Auth Type to Bearer
4. Enter your Agent App token
5. Click Save

Step 6: Publish

Set a Privacy Policy URL if publishing publicly.

Test Your GPT

Try these prompts to verify the integration:

• "Find me the best project management tools under $20/month"
• "Compare noise-cancelling headphones"
• "What online courses can help me learn Python?"

The GPT should call the searchOffers action and return real product recommendations with links and pricing.

Troubleshooting

Next Steps

• Claude Integration — Also available on Claude
• TypeScript SDK — Build a custom agent with full control
• Best Practices — Production patterns and security

Start from Quick Start