Back to Documentation

AI Agent Integration Guide

Connect ChatGPT, Claude, Gemini, and custom AI agents to your store through zalink.ai

ChatGPT / OpenAI

ACP Protocol

Integrate via OpenAI Actions using the Agentic Commerce Protocol. Register your store as a ChatGPT plugin so users can browse products and checkout conversationally.

  1. 1Register your store at dashboard.zalink.ai
  2. 2Copy your ACP manifest URL: https://api.zalink.ai/acp/stores/{storeId}/.well-known/ai-plugin.json
  3. 3In ChatGPT plugin store, choose "Develop your own plugin" and paste the manifest URL
  4. 4ChatGPT will discover endpoints automatically via the OpenAPI spec
  5. 5Users can now ask ChatGPT to search products, manage carts, and checkout

Claude / Anthropic

MCP Protocol

Integrate via Model Context Protocol for rich, session-based interactions. Claude can use MCP tools to search products, manage carts, and process orders with full conversation context.

  1. 1Obtain your MCP endpoint: https://api.zalink.ai/mcp/{storeId}
  2. 2Configure Claude Desktop or API with the MCP server URL
  3. 3Set your API key as the authorization bearer token
  4. 4Claude automatically discovers available tools and resources
  5. 5Sessions persist context across multi-turn conversations

Gemini / Google

Coming Soon

Google Gemini integration is under development. Your store will be discoverable via the standard endpoint once available. Register interest through your dashboard.

  1. 1Discovery endpoint: https://api.zalink.ai/agents/discover/{storeId}
  2. 2Will support Gemini function calling format
  3. 3Automatic capability mapping from existing ACP endpoints
  4. 4Sign up for early access at dashboard.zalink.ai/settings

Custom AI Agents

REST API

Build your own AI agent integration using the zalink.ai REST API. Full access to products, orders, carts, and customer data with Bearer token authentication.

  1. 1Generate an API key at dashboard.zalink.ai/api-keys
  2. 2Base URL: https://api.zalink.ai
  3. 3Authenticate with Authorization: Bearer YOUR_API_KEY
  4. 4Use ACP endpoints for product search, cart, and checkout
  5. 5Consult the API Reference for full endpoint documentation

Code Examples

Authenticating with the API

import requests

API_KEY = "your_api_key_here"
BASE = "https://api.zalink.ai"
headers = {"Authorization": f"Bearer {API_KEY}"}

Searching Products

resp = requests.get(
  f"{BASE}/acp/stores/{store_id}/products/search",
  headers=headers,
  params={"q": "laptop", "limit": 10}
)
products = resp.json()["products"]

Managing a Cart

# Create cart
cart = requests.post(
  f"{BASE}/acp/stores/{store_id}/cart",
  headers=headers,
  json={"items": [{"productId": "p1", "quantity": 2}]}
).json()

# Update cart
requests.put(
  f"{BASE}/acp/stores/{store_id}/cart/{cart['id']}",
  headers=headers,
  json={"action": "update", "itemId": "p1", "quantity": 3}
)

Processing Checkout

checkout = requests.post(
  f"{BASE}/acp/stores/{store_id}/checkout",
  headers=headers,
  json={
    "cartId": cart["id"],
    "customerInfo": {
      "email": "buyer@example.com",
      "name": "Ahmed"
    }
  }
).json()
print(checkout["checkoutUrl"])

Start Integrating Now

Check out the full MCP Protocol reference or try the API directly.