Integrating OpenClaw Support Agent with Freshdesk: A Step‑by‑Step Guide

a. Prerequisites

Before you start, make sure you have the following:

• A Freshdesk account with admin rights.
• OpenClaw API credentials (API key & secret).
• Node.js ≥ 14 installed on your development machine.
• Access to a Git repository or a cloud‑hosted environment (e.g., UBOS platform overview).
• Basic knowledge of REST APIs and webhook concepts.

b. Step‑by‑step configuration

1. Create a Freshdesk API key. Navigate to Admin → API → Your API Key and copy the key. Keep it secure; you’ll need it in the middleware.
2. Set up a Freshdesk webhook. Go to Admin → Automation → Ticket Updates → Webhooks and create a new webhook:
   • Endpoint URL: https://your‑middleware.example.com/openclaw
   • Request type: POST
   • Content type: application/json
   • Payload: {"ticket_id":"{{ticket.id}}","subject":"{{ticket.subject}}","description":"{{ticket.description}}","status":"{{ticket.status}}"}
3. Generate OpenClaw credentials. In the OpenClaw dashboard, go to Integrations → API Tokens and create a new token. Note the client_id and client_secret.
4. Deploy the middleware. Clone the starter repo (or use the Web app editor on UBOS to spin up a Node.js service). Install dependencies:

   npm install express axios body-parser dotenv

5. Configure environment variables. Create a .env file:

   FRESHDESK_API_KEY=your_freshdesk_key
   OPENCLAW_CLIENT_ID=your_openclaw_id
   OPENCLAW_CLIENT_SECRET=your_openclaw_secret
   PORT=3000

6. Run the service. Execute node index.js. The middleware will listen for Freshdesk webhooks, forward ticket data to OpenClaw, and post AI replies back to Freshdesk.

c. Code snippets

The core of the integration lives in index.js. Below is a minimal, production‑ready example:

require('dotenv').config();
const express = require('express');
const bodyParser = require('body-parser');
const axios = require('axios');

const app = express();
app.use(bodyParser.json());

const FRESHDESK_API_KEY = process.env.FRESHDESK_API_KEY;
const OPENCLAW_CLIENT_ID = process.env.OPENCLAW_CLIENT_ID;
const OPENCLAW_CLIENT_SECRET = process.env.OPENCLAW_CLIENT_SECRET;

// Helper: get OpenClaw access token
async function getOpenClawToken() {
  const resp = await axios.post('https://api.openclaw.ai/oauth/token', {
    client_id: OPENCLAW_CLIENT_ID,
    client_secret: OPENCLAW_CLIENT_SECRET,
    grant_type: 'client_credentials'
  });
  return resp.data.access_token;
}

// Endpoint called by Freshdesk webhook
app.post('/openclaw', async (req, res) => {
  const { ticket_id, subject, description, status } = req.body;

  try {
    const token = await getOpenClawToken();

    // Send ticket data to OpenClaw for AI processing
    const aiResp = await axios.post(
      'https://api.openclaw.ai/v1/assist',
      { subject, description },
      { headers: { Authorization: `Bearer ${token}` } }
    );

    const aiReply = aiResp.data.reply;

    // Post AI reply back to Freshdesk as a private note
    await axios.post(
      `https://yourdomain.freshdesk.com/api/v2/tickets/${ticket_id}/notes`,
      { body: aiReply, private: true },
      { auth: { username: FRESHDESK_API_KEY, password: 'X' } }
    );

    // Optionally update ticket status
    if (aiResp.data.resolution === 'resolved') {
      await axios.put(
        `https://yourdomain.freshdesk.com/api/v2/tickets/${ticket_id}`,
        { status: 5 }, // 5 = Closed in Freshdesk
        { auth: { username: FRESHDESK_API_KEY, password: 'X' } }
      );
    }

    res.status(200).send('OK');
  } catch (err) {
    console.error('Integration error:', err);
    res.status(500).send('Integration failed');
  }
});

const PORT = process.env.PORT || 3000;
app.listen(PORT, () => console.log(`OpenClaw‑Freshdesk middleware listening on port ${PORT}`));

This script performs three essential actions:

• Obtains an OAuth token from OpenClaw.
• Sends ticket details for AI analysis.
• Posts the AI‑generated reply back to Freshdesk and optionally closes the ticket.

For production, consider adding retry logic, request validation, and secure storage of secrets (e.g., using UBOS partner program vault services).