Skip to main content

Overview

The Atera plugin connects ArgentOS to your Atera RMM/PSA platform. Your agent can query tickets, manage devices, monitor alerts, and run reports — all through natural conversation. Built for MSPs and IT teams that use Atera as their primary helpdesk and remote management tool.

Quick Start

1

Add your Atera API key

In Dashboard > Settings > API Keys (variable: ATERA_API_KEY)
2

Enable the plugin

Add "atera" to plugins.allow in ~/.argentos/argent.json
3

Set your technician name

Set technicianName in plugins.entries.atera.config
4

Restart the gateway

5

Run setup

Ask the agent to run setup — she’ll link your technician ID automatically

Tools

ToolDescription
atera_ticketsList and search tickets by status, customer, or assignee
atera_ticketGet ticket detail or create new tickets
atera_devicesList devices, filter by customer or online status
atera_customersList and search customers
atera_alertsView active monitoring alerts by severity
atera_reportRun reports: my tickets, open tickets, customer summary, device health
atera_setupSelf-service technician identity linking

What You Can Ask

  • “Show me my open tickets”
  • “Any critical alerts right now?”
  • “List offline devices for Acme Corp”
  • “Create a high priority ticket for the printer issue at Smith & Co”
  • “Give me a customer summary report”
  • “How’s our device health looking?”

Agent Context

The plugin injects a live summary into the agent’s context before every conversation — your open ticket count and overall queue status. The agent always knows your current workload without you having to ask.

Requirements

  • Atera account with API access
  • API key from Atera Admin > API

Configuration

KeyDescription
technicianNameYour display name in Atera
technicianIdAuto-detected by atera_setup
excludedCustomerIdsCustomer IDs to hide (e.g., system accounts)

Source

~/.argentos/extensions/atera/
  argent.plugin.json
  index.ts
  README.md
See Building Plugins for how this extension was built.