Freshdesk

Freshdesk helpdesk — manage tickets, contacts, companies, and agents via REST API

Security Scan

This skill is a small Freshdesk CLI that is internally consistent with its stated purpose (it only needs your Freshdesk API key and domain); the main issue to note is it will try to read a local .env file as a fallback for environment variables, so check where you store secrets before installing.

Purpose & Capability

Name/description request the Freshdesk API and the skill only requires FRESHDESK_API_KEY and FRESHDESK_DOMAIN, which is proportionate for a Freshdesk REST API client. The provided CLI commands map to Freshdesk resources.

Instruction Scope

SKILL.md instructs running the included Python CLI and only declares two env vars. The implementation will also attempt to read a .env file from the workspace fallback (~/.openclaw/workspace/.env or $WORKSPACE/.env) when an env var is not set. This implicit file access is not called out in the docs and can expose secrets stored in that .env file.

Install Mechanism

No install spec; instruction-only with a single Python stdlib script included. Nothing is downloaded or written to disk by an installer.

Credentials

Only two environment variables are required (FRESHDESK_API_KEY and FRESHDESK_DOMAIN) and the primary credential is the API key — appropriate for a Freshdesk integration. Note: the fallback .env lookup means the skill may read other variables present in that file if used as a source.

Persistence & Privilege

The skill does not request always:true or any elevated platform privileges. It does not modify other skills or system-wide settings.

Assessment

This skill appears coherent for accessing Freshdesk. Before installing: (1) Be aware the script will read a .env file at $WORKSPACE/.env or ~/.openclaw/workspace/.env as a fallback — remove or avoid storing unrelated secrets there. (2) Prefer to set FRESHDESK_API_KEY and FRESHDESK_DOMAIN in your runtime environment rather than relying on a shared .env. (3) Review the included scripts/freshdesk.py yourself; it uses Basic auth (base64 of key:domain) and standard HTTP calls — test with a limited-scope or rotation-friendly API key. (4) If you need stricter controls, consider forking the script to remove the .env fallback or to change authentication behavior.

Freshdesk helpdesk — manage tickets, contacts, companies, and agents via REST API

Requirements

Variable	Required	Description
FRESHDESK_API_KEY	✅	API key
FRESHDESK_DOMAIN	✅	Domain (yourcompany.freshdesk.com)

Quick Start

# List tickets
python3 {{baseDir}}/scripts/freshdesk.py tickets --filter <value> --email <value>

# Get ticket
python3 {{baseDir}}/scripts/freshdesk.py ticket-get id <value>

# Create ticket
python3 {{baseDir}}/scripts/freshdesk.py ticket-create --subject <value> --description <value> --email <value> --priority <value> --status <value>

# Update ticket
python3 {{baseDir}}/scripts/freshdesk.py ticket-update id <value> --status <value> --priority <value>

# Delete ticket
python3 {{baseDir}}/scripts/freshdesk.py ticket-delete id <value>

# Reply to ticket
python3 {{baseDir}}/scripts/freshdesk.py ticket-reply id <value> --body <value>

# Add note
python3 {{baseDir}}/scripts/freshdesk.py ticket-note id <value> --body <value>

# List conversations
python3 {{baseDir}}/scripts/freshdesk.py conversations id <value>

All Commands

Command	Description
tickets	List tickets
ticket-get	Get ticket
ticket-create	Create ticket
ticket-update	Update ticket
ticket-delete	Delete ticket
ticket-reply	Reply to ticket
ticket-note	Add note
conversations	List conversations
contacts	List contacts
contact-get	Get contact
contact-create	Create contact
companies	List companies
agents	List agents
groups	List groups
roles	List roles
products	List products
satisfaction-ratings	List CSAT
time-entries	Ticket time entries

Output Format

All commands output JSON by default. Add --human for readable formatted output.

python3 {{baseDir}}/scripts/freshdesk.py <command> --human

Script Reference

Script	Description
{{baseDir}}/scripts/freshdesk.py	Main CLI — all commands in one tool

Credits

Built by M. Abidi | agxntsix.ai YouTube | GitHub Part of the AgxntSix Skill Suite for OpenClaw agents.

📅 Need help setting up OpenClaw for your business? Book a free consultation