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 17 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 | | Exchange Rate | Get, Get Many, Get History, Update, Bulk Update | | 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, Get Rentals | | Secret Vault | Create, Get, Get Many, Reveal, Revoke | | 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 (including rentals) | | monitoring:write | Monitoring operations | | surveys:read | Survey operations | | exchange_rates:read | Exchange Rate Get, Get Many, Get History | | exchange_rates:write | Exchange Rate Update, Bulk Update | | calendar:read | Calendar Get Many | | calendar:write | Calendar Create | | conversations:read | Conversation Get Many | | conversations:write | Conversation Create | | users:read | User Get Many | | secrets:read | Secret Vault Get, Get Many, Reveal | | secrets:write | Secret Vault Create, Revoke | | 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