ayudala

n8n community node for Ayudala helpdesk & service management platform

Package Information

Downloads: 375 weekly / 375 monthly
Latest Version: 0.2.1
Author: Ayudala

Available Nodes

Ayudala icon
Ayudala
Interact with the Ayudala helpdesk & service management platform
Ayudala Trigger icon
Ayudala Trigger
Starts the workflow when an Ayudala event occurs

Documentation

n8n-nodes-ayudala

Community node for n8n that integrates with Ayudala — a helpdesk and service management platform.

Installation

Community Nodes (recommended)

  1. Go to Settings > Community Nodes.
  2. Select Install.
  3. Enter n8n-nodes-ayudala and confirm.

Manual

cd ~/.n8n/nodes
npm install n8n-nodes-ayudala

Restart n8n after installation.

Credentials

Field Description
Base URL Your Ayudala instance URL (e.g. https://app.ayuda.la)
API Key Generated from Integrations > API Keys in Ayudala

The credential test calls GET /api/ext/verify to validate the key.

Nodes

Ayudala

Regular node with 15 resources:

Resource Operations
Ticket Create, Get, Get Many, Update, Change Status, Assign
Comment Create, Get Many
Work Log Create, Get Many
Wish Create, Get Many, Approve, Reject
Company Get, Get Many
Contract Get, Get Many, Get Hours
Invoice Get, Get Many, Add Line, Record Payment
SLA Get Policies, Get Ticket SLA
KB Article Get, Get Many, Search
Resource Get, Get Many, Get Expiring
Monitoring Send Alert, Resolve Alert
Survey Get, Get Many, Get Responses
Calendar Event Get Many, Create
Conversation Get Many, Create
User Get Many

Ayudala Trigger

Webhook-based trigger that receives events from Ayudala:

  • ticket.created — New ticket created
  • ticket.updated — Ticket fields changed
  • ticket.resolved — Ticket marked resolved
  • ticket.closed — Ticket closed
  • comment.added — Comment added to ticket
  • sla.breached — SLA breach detected
  • invoice.created — New invoice created
  • invoice.paid — Invoice payment recorded

The trigger automatically registers and deregisters webhooks in Ayudala when the workflow is activated/deactivated. Payloads are verified with HMAC-SHA256.

API Scopes

The API key needs the following scopes depending on which resources you use:

Scope Required for
tickets:read Ticket / Work Log Get operations
tickets:write Ticket / Wish Create/Update/Status
comments:read Comment Get Many
comments:write Comment Create
worklogs:write Work Log Create
companies:read Company operations
contracts:read Contract operations
invoices:read Invoice operations
sla:read SLA operations
knowledge:read KB Article operations
resources:read Resource operations
monitoring:write Monitoring operations
surveys:read Survey operations
calendar:read Calendar Get Many
calendar:write Calendar Create
conversations:read Conversation Get Many
conversations:write Conversation Create
users:read User Get Many
webhooks:write Trigger node (auto-registration)
* Full access (all scopes)

Development

cd n8n-node
npm install
npm run build

To test locally with n8n:

# Link the node
npm link
cd ~/.n8n/nodes
npm link n8n-nodes-ayudala

# Restart n8n
n8n start

License

MIT

Discussion