← Back to Skills Marketplace
aiwithabidi

Freshdesk

by aiwithabidi · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
461
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install freshdesk
Description
Freshdesk helpdesk — manage tickets, contacts, companies, and agents via REST API
README (SKILL.md)

🆘 Freshdesk

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 \x3Cvalue> --email \x3Cvalue>

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

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

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

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

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

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

# List conversations
python3 {{baseDir}}/scripts/freshdesk.py conversations id \x3Cvalue>

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 \x3Ccommand> --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

Usage Guidance
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.
Capability Analysis
Type: OpenClaw Skill Name: freshdesk Version: 1.0.0 The skill is classified as suspicious due to a minor vulnerability in `scripts/freshdesk.py`. The `get_headers` function constructs the Basic Authentication header by encoding `FRESHDESK_API_KEY:FRESHDESK_DOMAIN` instead of the standard `FRESHDESK_API_KEY:`, which is an unintentional information leak of the domain in the password field of the Basic Auth header. Additionally, the `try_json` function attempts to parse various input arguments as JSON, which, while not a direct RCE, could potentially expose the downstream Freshdesk API to JSON injection if not properly handled by the API itself. No evidence of intentional malicious behavior like data exfiltration to unauthorized endpoints or direct code execution vulnerabilities was found.
Capability Assessment
✓ 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.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install freshdesk
  3. After installation, invoke the skill by name or use /freshdesk
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of the Freshdesk skill. - Manage tickets, contacts, companies, and agents using the Freshdesk REST API. - Provides easy CLI commands for listing, creating, updating, and deleting Freshdesk resources. - No external Python dependencies required (stdlib only). - Outputs JSON by default, with optional human-readable formatting. - Requires FRESHDESK_API_KEY and FRESHDESK_DOMAIN environment variables.
Metadata
Slug freshdesk
Version 1.0.0
License —
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Freshdesk?

Freshdesk helpdesk — manage tickets, contacts, companies, and agents via REST API. It is an AI Agent Skill for Claude Code / OpenClaw, with 461 downloads so far.

How do I install Freshdesk?

Run "/install freshdesk" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Freshdesk free?

Yes, Freshdesk is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Freshdesk support?

Freshdesk is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Freshdesk?

It is built and maintained by aiwithabidi (@aiwithabidi); the current version is v1.0.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments