Skip to main content
Integration · Freshdesk

Answer from your Freshdesk during a chat

Half the tickets in your Freshdesk are the same five questions, asked again and again, by customers who would have been just as happy with an instant answer at midnight on a Sunday. NebulaHex deflects the routine ones in chat and can read a ticket’s status, its thread and your help articles out of Freshdesk while the customer waits. Escalations go to your team in the NebulaHex inbox; they do not open Freshdesk tickets today.

Two-field API-key setup · 4 live lookups · no Freshdesk tickets opened today

your-company.freshdesk.com/TicketsToday · All groups
Open ticketsHighlighted: the ticket a customer asked about in chat
#3847Where is my refund for order 1182?
maria.lopez@example.com·2m ago
#3846Cannot sign in after password reset
dev.patel@example.com·8m ago
#3845Shipping address change request
sam.okafor@example.com·14m ago
#3844Invoice for tax filing — VAT receipt needed
finance@globex.io·32m ago
The bot reads tickets; it writes none here4 open
Jump to section

01

The shape of your backlog

Your support team has a backlog problem, and it isn’t because they’re slow. It’s because half of the tickets in Freshdesk are the same five questions, asked again and again, by customers who would have been just as happy with an instant answer at midnight on a Sunday. “Where is my order?” “How do I reset my password?” “Is the integration with X supported?” “What’s your refund policy?” “Can I change the email on my account?”

Your agents could answer these in their sleep, and that’s the problem — they’re handling them when they should be working on the messy, high-judgment tickets that genuinely need a human. Connecting NebulaHex to Freshdesk fixes the shape of that backlog. An AI bot lives on your website, your WhatsApp number, and your social DMs, fielding the routine questions in real time using your own knowledge base. When a conversation on your website hits something the bot can’t answer alone, the visitor can tap Talk to a human in the widget, on a bot with live chat handoff switched on (it is off by default), and the conversation goes to your team in the NebulaHex inbox; WhatsApp and social DM conversations stay with the bot. Freshdesk does not open a ticket for it today: the Freshdesk connection subscribes to no events. What the connection adds is the read side: the bot can answer “what’s happening with my ticket?” from the ticket itself.

02

What the integration does

Once Freshdesk is connected, the Configure Tools panel lists ten tools, which this page groups three ways. Four run during conversations today, all of them reads, and like every integration tool they run only when your agent answers with a Claude model. The others are locked off, or, for the write actions, refused even when switched on.

READ5 tools

The bot queries Freshdesk during a chat to answer with real, current data. Four lookups run today; the ticket and contact lookups ask the visitor to confirm a detail on the record first.

fdesk_lookup_ticket

Live: fetch a ticket by ID and read its status to the customer

fdesk_list_tickets

Not available yet: list a requester’s tickets. Needs visitor verification.

fdesk_get_ticket_thread

Live: read a ticket’s conversation for context

fdesk_search_solutions

Live: search your Freshdesk Solutions (help-center articles)

fdesk_lookup_contact

Live: find a contact by email

INTROSPECT2 tools

Two lists that only the ticket-creation action reads. Both stay locked off while it does not run.

fdesk_get_groups

Not available yet: list your support groups. Only the ticket-creation action reads it.

fdesk_get_ticket_fields

Not available yet: read your ticket fields. Only the ticket-creation action reads it.

WRITE3 tools

The bot’s write actions do not run yet: they are refused on every surface, even when switched on, so the bot writes nothing into Freshdesk.

fdesk_create_ticket

Does not run yet: open a ticket from the chat

fdesk_add_reply

Does not run yet: post a reply on an existing ticket

fdesk_create_contact

Does not run yet: create a contact

The Introspect lists exist to feed one write action, ticket creation: the groups a new ticket could go to, and the fields it would need. Because that action does not run yet, both lists stay locked off, and the bot does not read your groups or ticket fields.

The bot reads Freshdesk; it does not write to it yet. When a customer gives your widget the number of an existing ticket, the bot can look the ticket up and read its status and conversation back to them, once they confirm the email address on it. Posting a reply onto the ticket from the chat, opening a ticket, or creating a contact does not run yet; those write actions wait on visitor verification.

03

Two-step API-key setup

Most helpdesk integrations require an OAuth handshake — a redirect to the provider, a consent screen, scopes to negotiate, sometimes a vendor review process. Freshdesk’s integration is simpler. Connection is API-key based, which means setup is a two-field form and you’re connected.

1

Grab your API key from Freshdesk

Freshdesk · Profile Settings

Your API key

fdsk_8f4a2c91b73e6d0f5

Best practice: create a service user (e.g. Acme Bot) in Freshdesk and use that user’s API key. The bot’s lookups then run as that user.

Open Freshdesk, click your avatar, go to Profile Settings. Your personal API key is shown on the right side of the page.

2

Paste subdomain and key into NebulaHex

Freshdesk · Integrations

Subdomain

your-company.freshdesk.com

API key

fdsk_8f4a2c91b73e6d0f5

Open your bot’s Integrations tab, find the Freshdesk card, paste the two values, click Connect. The key is encrypted before it touches our database.

Best practice: create a service user. The bot acts in Freshdesk as the user whose API key was used. If you generate the key from a dedicated bot user — create a service user, give it the helpdesk permissions you want the bot to have, generate that user’s key — every call the bot makes is made as that user, with that user’s permissions. Today those calls only read.

The key is encrypted before it’s stored. It never sits in plain text inside our database, and it never appears in audit logs. If you ever suspect the key has been compromised, rotate it inside Freshdesk and re-paste the new value into NebulaHex without touching anything else. Disconnect from the same card removes the credentials immediately.

04

What the bot writes into Freshdesk

Today the bot writes nothing into Freshdesk, and that is worth saying plainly because it changes what you will see there. The Freshdesk connection subscribes to no events, so an escalation does not open a Freshdesk ticket and a captured lead does not create a Freshdesk contact. The write actions — opening a ticket, replying on one, creating a contact — are refused even when switched on. Escalations go to your team in the NebulaHex inbox, and leads stay on your NebulaHex Leads page.

What runs is the read side. During a chat the bot can find a ticket by its ID and read its status and conversation, once the visitor confirms the requester email on it; search your Freshdesk Solutions articles; and find a contact by email, once the visitor confirms the phone number on file. Every ticket in your queue is still one your customers or your team opened.

Your audit trail is the NebulaHex inbox, where every escalation lands with its whole conversation. When an escalation shows the bot got something wrong, that’s a signal to update the knowledge base. The next customer who asks the same question doesn’t escalate at all. The loop closes; the bot gets better; the backlog shrinks.

05

Real use cases

🖥️

IT support for a 200-person company

Tickets come in from employees who can’t print, can’t sign in, can’t connect to the VPN, can’t remember whether the Wi-Fi password rotated last week. Most have been answered before. Putting NebulaHex on a Freshdesk-connected portal means the bot answers from existing sources first, and an employee who needs hands-on help taps Talk to a human in the website widget, on a bot with live chat handoff switched on (it is off by default), to reach your team in the NebulaHex inbox. A hardware swap is worth that tap; "how do I reset my Slack password" isn’t.

Agents stop being a status-update service
🛒

E-commerce and consumer SaaS

The Freshdesk integration carries most of the routine support load off your agents’ plates. Pre-purchase questions from product pages, post-purchase from shipping policies, account from your help center — all handled in chat, no ticket. When a customer needs a human (missing package, defective item, stuck refund), they tap Talk to a human in your website widget, on a bot with live chat handoff switched on (it is off by default), and the conversation goes to your team in the NebulaHex inbox; it does not open a Freshdesk ticket today. Wire in Shopify alongside Freshdesk and the bot can also answer where-is-my-order with the actual tracking number.

Two integrations covering the support surface
📈

Mid-market SaaS scaling support

Support volume scales with customers, but support quality has to scale with revenue, not agent count. You can’t grow the team 3x in a quarter just because the customer base did. NebulaHex with Freshdesk wired in absorbs volume without dilution. The bot handles configuration questions, integration troubleshooting, "where do I find this setting". The questions that reach your team are the ones a visitor taps Talk to a human for, on a bot with live chat handoff switched on (it is off by default) — usually the genuinely hard ones: bugs, contractual questions, edge cases.

Agents become specialists, not triagers
🤝

Agency or managed-services model

If you’re a digital agency, managed-IT provider, or fractional support partner, you might run multiple Freshdesk accounts for multiple clients. NebulaHex bots are per-bot — stand up a separate bot for each client, each with its own knowledge base, brand, widget, and connect each bot to that client’s Freshdesk. Data stays segregated; experience stays branded.

Per-client isolation, per-agency scale

06

Where Freshdesk fits

Freshdesk is a customer-support helpdesk built and operated by Freshworks. It started as a more-affordable, faster-to-deploy alternative to legacy enterprise helpdesks and grew into one of the most-used helpdesk platforms for small and mid-sized support organizations. The product centers on a shared inbox that consolidates email, chat, social, and phone into a single ticket stream, with categorization, automation rules, SLA policies, and analytics layered on top.

Freshdesk is often selected as a Zendesk alternative for businesses that want similar capability at a friendlier price point. The free tier covers basic ticketing, a knowledge base, and a small number of agents — enough for many startups to run their entire support function without paying anything. Paid plans add automation, custom fields, multi-channel routing, AI assistance, advanced reporting, and team collaboration features.

The platform’s API is comprehensive: tickets, contacts, agents, groups, companies, and Solutions are all exposed for read and write. That depth is what makes a meaningful integration possible. NebulaHex doesn’t read your helpdesk through a screen-scrape or a fragile email gateway — the bot makes real API calls against the same surfaces your Freshdesk admins use to build their own automations.

07

Why NebulaHex over building it yourself

You can write directly against Freshdesk’s API. The API is well documented; the auth model (API key in a Basic header) is simple; if you have an engineering team with bandwidth, you can have ticket lookups and help-article search working in a sprint.

The work that’s harder to estimate is everything around the integration: an AI layer that grounds replies in your actual content; a knowledge base your team can edit without redeploying; an inbox where humans can take over the chats a visitor has escalated; analytics that tell you whether deflection is actually working; rate-limit handling, a time limit on every call, and a check that the visitor is who they say before a lookup reveals anything.

NebulaHex is that whole stack. You connect Freshdesk by pasting two values into a form. You build the bot by uploading knowledge sources — URLs, files, plain Q&A. You watch the bot work from a unified inbox that covers your widget, WhatsApp, Instagram, Messenger, and Telegram alongside Freshdesk. The case for buying instead of building isn’t that any one piece is hard — it’s that the system around the pieces is hard, and you’d rather spend the months on selling and supporting than on rebuilding what already works.

08

Trust & security

Your Freshdesk API key is encrypted at rest the moment it’s submitted, and every outbound call to Freshdesk happens over an encrypted connection. The key never appears in logs, never displays in plain text inside the dashboard after you’ve saved it, and is the only credential we need from your account — we do not ask for, store, or process your Freshdesk password.

Access to your bots and integrations is governed by role-based permissions inside NebulaHex. Owners and Admins can connect or disconnect Freshdesk; Members work the shared inbox; Viewers have read-only access. Disconnecting Freshdesk from the integration card removes the stored credentials immediately and stops the bot from reaching the helpdesk. Anything the integration already created — contacts, tickets — stays in Freshdesk, where it belongs to you.

Your conversation data isn’t used to train AI models. The knowledge sources you upload power your bot’s answers, not anyone else’s. If you want even more control, the Bring Your Own Key option lets you provide your own model API key so prompts and responses pass through the AI provider you choose, on the terms of your account with that provider. See our privacy policy and terms for the full posture.

09

Connect Freshdesk to your bot in minutes

If you already have a Freshdesk account, you’re a few minutes away from your first AI-deflected ticket. Open your bot’s Integrations tab, find the Freshdesk card, click Connect, paste your subdomain and API key. The four lookups are on from the start. The ticket and contact lookups ask the visitor to verify first, which never happens in your bot’s preview, so try them in your live widget, then point your real customers at it.

The cheapest ticket is the one never opened

The bot answers the routine questions in chat and reads ticket status out of Freshdesk. When a visitor taps Talk to a human, on a bot with live chat handoff switched on (it is off by default), the conversation reaches your team in the NebulaHex inbox. Your agents work only the conversations visitors hand them.