P

phone calling

phone-calling

🌐 English

Make international phone calls to any country. Low per-minute rates. Pay with PayPal or UPI.

数据来源：ClawHub。在 ClawSkills 查看

1.7k下载量

3收藏数

2浏览量

安装

选择你使用的 Agent

方法一：命令行安装（推荐）

关于 phone calling

--- name: phone-calling description: Make international phone calls to any country. Low per-minute rates. Pay with PayPal or UPI. version: 1.0.7 author: Ringez tags: [phone, call, calling, international, voice, communication, family, friends] api_base: https://ringez-api.vercel.app/api/v1 openapi: openapi.json ---

Ringez Phone Calling API

Make affordable international phone calls from anywhere. No hidden fees, no subscriptions — just pay for the minutes you use.

What is Ringez?

Ringez is a simple, privacy-focused international calling service that lets you make phone calls to 200+ countries without complicated setups or expensive plans.

Perfect for:

Calling family abroad
Business calls to international clients
AI agents making reservations or appointments
Quick calls without buying a calling plan

---

Quick Start Guide

1. Create an Account

First, check if your email is already registered:

POST https://ringez-api.vercel.app/api/v1/auth/check-email
Content-Type: application/json

{"email": "[email protected]"}

Response:

new_user → Continue to OTP verification
existing_user → Login with password

For New Users: Verify with OTP

Step 1: Request OTP

POST https://ringez-api.vercel.app/api/v1/auth/send-otp
Content-Type: application/json

{"email": "[email protected]"}

Step 2: Verify OTP

POST https://ringez-api.vercel.app/api/v1/auth/verify-otp
Content-Type: application/json

{
  "email": "[email protected]",
  "otp": "123456"
}

Response:

{
  "session_id": "sess_abc123xyz",
  "user": {
    "email": "[email protected]",
    "balance_minutes": 5
  }
}

Save the session_id — you will need it for all API calls.

For Existing Users: Login

POST https://ringez-api.vercel.app/api/v1/auth/login
Content-Type: application/json

{
  "email": "[email protected]",
  "password": "your-password"
}

---

2. Check Your Balance

See how many minutes you have before making a call:

GET https://ringez-api.vercel.app/api/v1/auth/me
X-Session-ID: sess_abc123xyz

Response:

{
  "balance_minutes": 5,
  "balance_usd": 0,
  "email": "[email protected]"
}

---

3. Make a Phone Call

Use the idempotency_key to prevent accidental duplicate calls:

POST https://ringez-api.vercel.app/api/v1/calls/initiate
X-Session-ID: sess_abc123xyz
Content-Type: application/json

{
  "to_number": "+919876543210",
  "idempotency_key": "sess_abc123xyz_1700000000000_xyz789"
}

Response (Success):

{
  "call_id": "call_xyz789",
  "status": "initiated",
  "mode": "bridge",
  "to_number": "+919876543210",
  "from_number": "+17623713590",
  "twilio_call_sid": "CAxxxxx"
}

Response (Duplicate Call):

{
  "alreadyInitiated": true,
  "callSid": "CAxxxxx"
}

---

Call Modes Explained

Ringez supports two ways to make calls:

Bridge Mode (Default)

How it works: Calls your phone first, then connects you to the destination
Best for: Personal calls where you want to talk
Your phone: Will ring first

Direct Mode

How it works: Calls the destination directly
Best for: AI agents, automated calls, or when you do not want your phone to ring
Your phone: Does not ring

Force Direct Mode:

POST /api/v1/calls/initiate
X-Session-ID: sess_abc123xyz
Content-Type: application/json

{
  "to_number": "+919876543210",
  "mode": "direct"
}

---

Preventing Duplicate Calls

When making calls through an API, network delays or retries can accidentally create multiple calls. Use an idempotency key to prevent this.

What is an Idempotency Key?

A unique identifier for each call attempt. If you use the same key within 5 minutes, the API returns the original call instead of creating a new one.

How to Use It

Generate a unique key for each user action:

const idempotencyKey = `${sessionId}_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
// Example: sess_abc123_1700000000000_xyz789abc

Important Notes

5-minute window: Same key within 5 minutes returns the existing call
After 5 minutes: Same key creates a new call
Generate fresh keys: Create a new key for each button click, not for API retries
Response: If duplicate detected, you get {alreadyInitiated: true, callSid: "..."}

---

Pricing

Pay only for what you use. No monthly fees, no subscriptions.

USD Plans

| Plan | Price | Minutes | Rate per Minute | |------|-------|---------|-----------------| | Starter | $5 | 30 | $0.17 | | Popular | $15 | 120 | $0.13 | | Best Value | $30 | 300 | $0.10 |

INR Plans

| Plan | Price | Minutes | Rate per Minute | |------|-------|---------|-----------------| | Starter | ₹99 | 7 | ₹14/min | | Popular | ₹199 | 19 | ₹10/min | | Value | ₹499 | 60 | ₹8/min | | Power | ₹999 | 143 | ₹7/min |

Billing: Rounded up to the nearest minute. A 2-minute 30-second call = 3 minutes charged.

---

Managing Active Calls

Check Call Status

See if your call is still ringing, connected, or completed:

GET https://ringez-api.vercel.app/api/v1/calls/call_xyz789
X-Session-ID: sess_abc123xyz

Response:

{
  "call_id": "call_xyz789",
  "status": "in-progress",
  "duration": 120,
  "estimated_cost": {
    "minutes": 2,
    "amount": 0.25,
    "currency": "USD"
  }
}

End a Call Early

Hang up a call before it finishes:

DELETE https://ringez-api.vercel.app/api/v1/calls/call_xyz789
X-Session-ID: sess_abc123xyz

Navigate Phone Menus (DTMF)

Press numbers during a call (useful for bank menus, customer support):

POST https://ringez-api.vercel.app/api/v1/calls/call_xyz789/actions
X-Session-ID: sess_abc123xyz
Content-Type: application/json

{
  "action": "dtmf",
  "parameters": {
    "digits": "1"
  }
}

Common DTMF uses:

{"digits": "1"} — Press 1 for English
{"digits": "1234"} — Enter PIN
{"digits": "w"} — Wait 0.5 seconds

---

Call History

See your past calls:

GET https://ringez-api.vercel.app/api/v1/calls?limit=10&offset=0
X-Session-ID: sess_abc123xyz

Response:

{
  "calls": [
    {
      "call_id": "call_abc123",
      "to_number": "+919876543210",
      "status": "completed",
      "duration": 300,
      "cost": 0.375,
      "started_at": "2026-02-09T10:00:00Z"
    }
  ],
  "pagination": {
    "total": 25,
    "has_more": true
  }
}

---

Use Cases

Personal Call to Family

User: Call my mom in India
AI: I will help you call India. First, let me check your balance...
      You have 15 minutes available.
      Calling +91 98765 43210 now...
      
AI: Your phone is ringing. Pick up and I will connect you.

AI Agent Making a Reservation

User: Book a table at Taj Restaurant for 7 PM
AI: I will call Taj Restaurant for you.
      
      [AI uses direct mode — your phone does not ring]
      
AI: Calling +91 12345 67890...
      
AI: Hello, I would like to make a reservation for 2 people at 7 PM today.
      
AI: ✅ Reservation confirmed! Table for 2 at 7 PM under your name.

---

Important Information

Free Minutes

New accounts get 5 free minutes to test the service. These are for testing only — please add credits for regular use.

Adding Credits

This skill cannot add credits. To add minutes:

Visit: https://ringez.com/wallet
Pay with PayPal (USD) or UPI (INR)
Credits appear instantly

Why? Payment processing requires secure browser redirects and PCI compliance that APIs cannot handle.

Low Balance Handling

If someone tries to call with insufficient balance:

...

Prompt 示例

安装 phone calling 后，可以对 AI 说这些话来触发它

U

Help me get started with phone calling

A

Explains what phone calling does, walks through the setup, and runs a quick demo based on your current project

U

Use phone calling to make international phone calls to any country

A

Invokes phone calling with the right parameters and returns the result directly in the conversation

U

What can I do with phone calling in my general tools workflow?

A

Lists the top use cases for phone calling, with example commands for each scenario

常见问题

如何安装 phone calling？▾

将技能文件夹放到 ~/.claude/skills/phone-calling/ 目录（个人级，所有项目可用），或 .claude/skills/phone-calling/（项目级）。重启 AI 客户端后，用 /phone-calling 主动调用，或让 AI 根据上下文自动发现并使用。

phone calling 支持哪些 AI 平台？▾

phone calling 支持 Claude、Cursor、OpenClaw，可与这些 AI 平台无缝集成，扩展其能力。

phone calling 是免费的吗？▾

phone calling 可免费安装使用。请查阅仓库了解许可证信息。

phone calling 有什么功能？▾

Make international phone calls to any country. Low per-minute rates. Pay with PayPal or UPI.

phone calling 属于哪个分类？▾

phone calling 属于「General Tools」分类，该分类的技能帮助 AI 智能体在此领域执行专业任务。

使用场景

Getting Started with phone calling→Automate General Tools Workflows with phone calling→Team Collaboration with phone calling→

phone calling

安装

关于 phone calling

Ringez Phone Calling API

What is Ringez?

Quick Start Guide

1. Create an Account

For New Users: Verify with OTP

For Existing Users: Login

2. Check Your Balance

3. Make a Phone Call

Call Modes Explained

Bridge Mode (Default)

Direct Mode

Preventing Duplicate Calls

What is an Idempotency Key?

How to Use It

Important Notes

Pricing

USD Plans

INR Plans

Managing Active Calls

Check Call Status

End a Call Early

Navigate Phone Menus (DTMF)

Call History

Use Cases

Personal Call to Family

AI Agent Making a Reservation

Important Information

Free Minutes

Adding Credits

Low Balance Handling

Prompt 示例

常见问题

使用场景

同类技能推荐

Sonoscli

SkillScan

Gemini

description: 将用户讲稿一键生成乔布斯风极简科技感竖屏HTML演示稿。当用户需要生成PPT、演示文稿、Slides、幻灯片，或要求科技风/极简风/乔布斯风格的演示时触发此技能。输出为单个可直接运行的HTML文件。