Skip to main content

​
n8n Integration

n8n is a powerful workflow automation tool that lets you connect Ringyo AI with hundreds of other apps and services. This guide shows you how to integrate Ringyo AI with n8n using HTTP Request nodes.
No custom node installation required — n8n’s built-in HTTP Request node works perfectly with Ringyo AI’s REST API.

​
Prerequisites

  • A Ringyo AI account with Pro or Agency plan
  • An API key (from Dashboard → Developers)
  • n8n installed (self-hosted or cloud)

​
Setting Up Authentication

First, create a reusable credential in n8n for Ringyo AI:
1

Open Credentials

In n8n, go to Settings → Credentials → Add Credential.
2

Select Header Auth

Choose Header Auth as the credential type.
3

Configure the Header

  • Name: Authorization
  • Value: Bearer vb_live_YOUR_API_KEY
4

Save

Name it “Ringyo AI” and save.

​
Basic Workflow: Make a Call

Here’s a simple workflow that makes an outbound call when triggered:

​
1. Add an HTTP Request Node

{
  "name": "Make Ringyo Call",
  "type": "n8n-nodes-base.httpRequest",
  "parameters": {
    "method": "POST",
    "url": "https://api.ringyo.ai/v1/calls",
    "authentication": "predefinedCredentialType",
    "nodeCredentialType": "httpHeaderAuth",
    "sendHeaders": true,
    "headerParameters": {
      "parameters": [
        {
          "name": "Content-Type",
          "value": "application/json"
        }
      ]
    },
    "sendBody": true,
    "bodyParameters": {
      "parameters": [
        {
          "name": "to",
          "value": "={{ $json.phone }}"
        },
        {
          "name": "agent_id",
          "value": "your_agent_id"
        },
        {
          "name": "context",
          "value": "={{ JSON.stringify({ customer_name: $json.name }) }}"
        }
      ]
    }
  }
}

​
Visual Setup

  1. Add an HTTP Request node
  2. Set Method to POST
  3. Set URL to https://api.ringyo.ai/v1/calls
  4. Under Authentication, select your Ringyo AI credential
  5. Enable Send Body and add:
    • to: The phone number to call
    • agent_id: Your voice agent ID
    • context: Any context data for the agent

​
Example Workflows

​
Lead Qualification from Google Forms

Trigger an AI call when someone submits a form: 
[Google Forms Trigger] → [HTTP Request: Make Call] → [Set Status in Sheet]
Flow:
  1. Google Forms Trigger — Watches for new submissions
  2. HTTP Request — Calls the lead using Ringyo AI
  3. Google Sheets — Updates submission status

​
Appointment Reminder Calls

Send reminder calls 24 hours before appointments: 
[Schedule Trigger] → [Get Tomorrow's Appointments] → [Loop] → [Make Reminder Call]
Flow:
  1. Schedule Trigger — Runs daily at 9 AM
  2. HTTP Request — Fetches appointments from your calendar/CRM
  3. Loop — Iterates through appointments
  4. HTTP Request — Makes reminder calls via Ringyo AI

​
Call Results to CRM

Update your CRM when calls complete: 
[Webhook Trigger] → [IF Call Completed] → [Update HubSpot Contact]
Flow:
  1. Webhook — Receives Ringyo AI webhook events
  2. IF — Checks if event is call.completed
  3. HubSpot — Updates contact with call outcome

​
Receiving Webhooks

To receive webhook events from Ringyo AI in n8n:
1

Create a Webhook Node

Add a Webhook node to your workflow and set it to POST.
2

Copy the Webhook URL

n8n will generate a URL like https://your-n8n.com/webhook/abc123.
3

Register in Ringyo AI

Use the API or Dashboard to create a webhook pointing to your n8n URL:
curl https://api.ringyo.ai/v1/webhooks \
  -X POST \
  -H "Authorization: Bearer vb_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-n8n.com/webhook/abc123",
    "events": ["call.completed", "call.failed", "appointment.created"]
  }'

​
Webhook Payload Example

When a call completes, your n8n workflow receives: 
{
  "event": "call.completed",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "call_id": "call_abc123",
    "agent_id": "agent_xyz",
    "phone_number": "+1234567890",
    "duration_seconds": 145,
    "outcome": "appointment_booked",
    "transcript": "Agent: Hello! Thanks for calling...",
    "extracted_data": {
      "appointment_date": "2024-01-20",
      "appointment_time": "14:00",
      "customer_name": "John Smith"
    }
  }
}

​
Workflow Templates

Download ready-to-import n8n workflow templates:

Lead Qualifier

Automatically qualify leads with AI calls.

Appointment Reminder

Send reminder calls before appointments.

Follow-up Sequence

Multi-touch follow-up automation.

CRM Sync

Sync call results to your CRM.

​
Tips & Best Practices

Add delays between API calls if processing many items:
[Loop] → [HTTP Request] → [Wait 200ms] → [Next]
Always add error handling nodes after HTTP requests to catch and log failures.
Store your agent_id in n8n variables for easy reuse across workflows.
Use Ringyo AI’s test mode (prepend calls with test_) during development.

​
Need Help?