Freshdesk - Atako

Let your agents handle customer support in Freshdesk — create and update tickets, reply to customers, add notes, and manage contacts.

Connection

Authentication: API key.
Required settings:
- Subdomain — yourcompany in yourcompany.freshdesk.com

Log in to your Freshdesk portal → click your profile picture (top right) → Profile settings → find “Your API key” in the right sidebar (complete the captcha if asked) and copy it. The key inherits the permissions of your agent role — a role with ticket and contact access is enough.See Freshdesk’s documentation.

Read actions (13)

Action	Description
`get_agent`	Fetch an agent by id.
`get_company`	Fetch a company by id.
`get_contact`	Fetch a contact by id.
`get_current_agent`	Fetch the agent whose API key is used (identity check).
`get_ticket`	Fetch a ticket by id, optionally embedding conversations, requester, company or stats.
`list_agents`	List support agents, filterable by email or availability state.
`list_companies`	List companies in the helpdesk.
`list_contacts`	List contacts, filterable by email, phone, company or state.
`list_groups`	List agent groups.
`list_ticket_conversations`	List all replies and notes on a ticket.
`list_tickets`	List tickets, filterable by view, requester, company or last-update time.
`search_contacts`	Search contacts with a Freshdesk query string, e.g. email:jane@acme.com.
`search_tickets`	Search tickets with a Freshdesk query string, e.g. status:2 AND priority:4 (quotes added automatically).

Write actions (7)

Action	Description
`create_contact`	Create a contact (requires a name plus at least an email, phone or mobile).
`create_ticket`	Create a support ticket (requester identified by email, phone or requester_id).
`create_ticket_note`	Add a note to a ticket (private to agents by default).
`create_ticket_reply`	Send a public reply on a ticket (emailed to the requester).
`delete_ticket`	Delete a ticket (moved to trash, recoverable by an admin for 30 days).
`update_contact`	Update a contact (name, email, phone, company…).
`update_ticket`	Update a ticket (status, priority, assignee, subject, tags…).

Permissions

Every action above must be explicitly granted to an agent before it can be used. See Permissions for the grant model and Security for how credentials are protected.