n8n-nodes-yourang
An n8n community node to integrate yourang.ai into your workflows. Automate call handling, contact management, appointment scheduling, and AI agent configuration directly from n8n.
yourang.ai is a 24/7 AI phone assistant that handles inbound and outbound calls, schedules appointments, collects customer data, and manages interactions automatically.
Installation
Follow the n8n community nodes installation guide:
- Open Settings > Community Nodes in your n8n instance
- Enter
n8n-nodes-yourang
- Click Install
Credentials
- Create an account at app.yourang.ai
- Generate an API key from your dashboard
- In n8n, add new Yourang API credentials with your API key
The default API base URL is https://api.yourang.ai/v1. See the full API documentation for details.
Operations
Call History
| Operation |
Description |
| Get Call |
Retrieve details of a specific call |
| Get Many |
List calls with filters (type, status, direction, phone, contact) |
| Get Transcript |
Get the transcript for a specific call |
| Get Summary |
Get AI-generated summary for a call |
Contact
| Operation |
Description |
| Create |
Add a new contact (name, phone, email, address) |
| Get |
Retrieve a contact by ID |
| Get by Phone |
Retrieve a contact by phone number |
| Get Many |
List contacts with search and sort filters |
| Update |
Update a contact by ID |
| Update by Phone |
Update a contact by phone number |
| Delete |
Remove a contact by ID |
| Delete by Phone |
Remove a contact by phone number |
Event
| Operation |
Description |
| Get |
Get details of a specific event |
| Get by Date |
Get events for a specific date |
| Get Many |
Get events grouped by date range |
| Update |
Update an existing event |
| Update Status |
Approve or reject an event |
| Delete |
Delete an event |
Agent
| Operation |
Description |
| Get |
Get details of a specific AI agent |
| Get Many |
List agents for your organization |
Agent Tool
| Operation |
Description |
| Get |
Get configuration for a specific agent tool |
| Get Many |
List tools available for a specific agent |
| Update |
Update configuration for an agent tool |
Workflow
| Operation |
Description |
| Get |
Get workflow details |
| Get Many |
List workflows |
| Execute |
Execute a workflow |
| Get Executions |
List workflow executions |
| Get Execution Details |
Get details of a specific execution |
Campaign
| Operation |
Description |
| Get |
Get campaign details |
| Get Many |
List campaigns with status/search filters |
| Get Stats |
Get campaign statistics |
| Pause |
Pause a running campaign |
| Resume |
Resume a paused campaign |
| Start |
Start a campaign |
| Stop |
Stop a campaign |
Catalogue
| Operation |
Description |
| Create |
Create a catalogue, optionally with initial items |
| Delete |
Delete a catalogue (optionally preserving its items as standalone) |
| Get |
Get catalogue details |
| Get Many |
List catalogues with search/sort filters |
| Update |
Update catalogue name or description |
Catalogue Item
| Operation |
Description |
| Assign |
Assign items to a catalogue, or unassign them (standalone) |
| Create |
Create a catalogue item or standalone item |
| Delete |
Delete an item |
| Get |
Get item details |
| Get Many |
List items with catalogue/search/sort/standalone filters |
| Update |
Update item fields (name, price, quantity, ...) |
Contact List
| Operation |
Description |
| Add Contacts |
Add contacts to a list by ID or phone number (optionally auto-creating missing contacts) |
| Get |
Get contact list details |
| Get Contacts |
List contacts in a contact list |
| Get Many |
List contact lists |
| Remove Contacts |
Remove contacts from a list by ID or phone number |
Order
| Operation |
Description |
| Get |
Get order details |
| Get Many |
List orders with status/date/sort filters |
| Update |
Update order status, notes, or refusal reason |
Wallet
| Operation |
Description |
| Get |
Get the wallet snapshot (balance) |
| Get Many Transactions |
List wallet transactions with type/date filters |
Trigger
The Yourang Trigger node starts a workflow when yourang emits an event, replacing the
manual Webhook + Code parsing pattern. Select one or more events and the node receives a
typed, signed payload.
| Event |
Fires when |
| Call Ended |
A call finished and its record was persisted |
| Call Summary Ready |
The async summary of a call is ready |
| Appointment Booked |
An appointment/event was created (CONFIRMED) |
| Appointment Updated |
An appointment was rescheduled/approved/rejected |
| Appointment Cancelled |
An appointment was cancelled |
| Contact Created |
A new contact (lead) was created |
| Call Transcript Ready |
The transcript of a call is available |
| Order Created |
A new order was created |
| Order Status Changed |
An order changed status (confirmed/completed/cancelled/refused) |
| Dialer Contact Completed |
A campaign contact reached a terminal outcome |
| Dialer Campaign Completed |
A dialer campaign finished processing all contacts |
On activation the node registers a subscription on yourang
(POST {baseUrl}/webhooks, e.g. https://api.yourang.ai/v1/webhooks) with the workflow's
webhook URL; the platform returns a one-time signing secret that the node stores. On
deactivation it removes the subscription. Incoming requests are verified against the
X-Webhook-Signature (HMAC-SHA256) header and deduplicated by event_id.
Payload envelope
{
"event": "call.ended",
"event_id": "uuid",
"occurred_at": "ISO-8601",
"organization_id": "uuid",
"data": { }
}
Requires the platform outbound-webhook API. Until it ships, turn off Auto-Register
Subscription in the node options to test by POSTing the envelope to the webhook URL
directly.
Example Use Cases
- CRM Sync -- Push call history and contact data to your CRM after each call
- Appointment Automation -- Create, update, and manage events from external calendars
- Call Analytics -- Collect transcripts and AI summaries for reporting dashboards
- Agent Configuration -- Manage AI agent tools and workflows programmatically
Compatibility
- Minimum n8n version: 1.0.0
- Node.js: >= 20.15
Resources
License
MIT
