Skip to content

PIA Setup

PIA is a robotic process automation (RPA) platform for MSPs. Once connected, Junto can browse available automations, trigger them with the right inputs, and monitor execution progress — letting technicians kick off automations directly through the AI agent.

Prerequisites

  • A PIA Automate account with API access
  • Your PIA instance URL and API secret

Step 1: Get Your API Credentials

  1. Log in to your PIA Automate instance.
  2. Navigate to your API settings and locate your API Secret.
  3. Note your PIA Instance URL (e.g., https://msp.pia.ai).

Step 2: Configure in Junto

  1. In Junto, go to Settings > Integrations > PIA.
  2. Click Add Configuration and fill in:
    • PIA Instance URL -- The base URL of your PIA instance.
    • API Secret -- Your API key. This is encrypted before storage.
  3. Click Create. Junto validates the credentials before saving.

Step 3: Map Companies (Optional)

If your PIA instance manages multiple clients:

  1. Click Manage Company Mappings after connecting.
  2. Link each Junto company to its corresponding PIA client.
  3. Save mappings. This allows the agent to target the correct PIA client automatically.

What the AI Agent Can Do

Discovery

ToolDescriptionRisk Level
List AutomationsBrowse available RPA automations, optionally filtered by clientLow
Get Automation InputsView the input fields and requirements for a specific automation before triggering itLow

Execution

ToolDescriptionRisk Level
Trigger AutomationExecute an automation with the required inputs and optional ticket contextHigh

Monitoring

ToolDescriptionRisk Level
Get Execution StatusCheck the progress or completion status of a running automationLow
Get Activity LogsView step-by-step logs from a completed or running automationLow

Approval Required

The agent always asks for confirmation before triggering an automation. Discovery and monitoring tools do not require approval.

Troubleshooting

  • Connection fails -- Verify your instance URL and API secret. The URL must include the protocol (e.g., https://).
  • No automations listed -- Confirm automations are published and accessible in your PIA instance.
  • Automation fails to trigger -- Check that all required input fields are provided and that the target PIA client is reachable.
  • Status shows no progress -- The automation may still be queued. Check the PIA console for execution details.