ai-actions-platform

AI Actions Platform 3.0 - Complete Reference

SELF-CONTAINED: This skill has everything needed for AI Actions app development. No other skill required.

AI Actions App Structure

AI Actions apps are serverless-only - NO frontend, NO locations, NO product events:

app-root/
├── actions.json              # Action definitions (display_name, parameters, response)
├── manifest.json             # Platform 3.0 manifest
├── server/
│   ├── server.js            # SMI function implementations
│   └── test_data/
│       └── actionName.json  # Test payload per action
├── config/
│   ├── requests.json        # Request templates for external APIs
│   ├── iparams.json         # Installation parameters
│   └── oauth_config.json    # Optional: for OAuth-based APIs
└── README.md

CRITICAL: Function names in actions.json MUST match server.js exactly (case-sensitive).

---

Manifest Structure (Platform 3.0)

{
  "platform-version": "3.0",
  "modules": {
    "common": {
      "requests": {
        "requestTemplateName": {}
      },
      "functions": {
        "actionFunctionName": { "timeout": 20 }
      }
    },
    "support_ticket": {},
    "chat_conversation": {}
  },
  "engines": {
    "node": "24.11.0",
    "fdk": "10.0.0"
  }
}

Rules:

• ✅ platform-version MUST be "3.0"
• ✅ At least ONE product module required (support_ticket, chat_conversation, service_ticket, deal, etc.) - can be empty {}
• ✅ All request templates declared in modules.common.requests
• ✅ All action functions declared in modules.common.functions with timeout (recommended: 20)
• ✅ engines block required with node and fdk versions
• ❌ NO product block (use modules)
• ❌ NO whitelisted-domains
• ❌ NO locations, NO events (AI Actions are serverless-only)

Product Module Mapping

Target Product	Include Module
Freshdesk	support_ticket
Freshchat	chat_conversation
Freshservice	service_ticket
Freshsales/CRM	deal, contact
Multi-product	support_ticket, chat_conversation