phone-calling_skill

This skill helps you place international calls securely and affordably using Ringez, with balance checks and direct or bridge modes.

Python

2.6k

GitHub Stars

7

Bundled Files

2 months ago

Catalog Refreshed

4 months ago

First Indexed

Readme & install

Copy the install command, review bundled files from the catalogue, and read any extended description pulled from the listing source.

Installation

Preview and clipboard use veilstrat where the catalogue uses aiagentskills.

npx veilstrat add skill openclaw/skills --skill phone-calling

_meta.json635 B
CHANGELOG.md1.8 KB
openapi.json12.9 KB
ringez-api-spec.md21.0 KB
ringez-implementation-guide.md22.3 KB
ringez-quickstart-guide.md17.6 KB
SKILL.md8.7 KB

Overview

This skill lets you make affordable international phone calls to 200+ countries with simple API calls and low per-minute rates. New users get 5 free minutes to test the service, and payments are supported via PayPal (USD) or UPI (INR). It supports both bridge (calls your phone first) and direct (calls destination directly) modes for personal or automated usage.

How this skill works

You authenticate with an email/OTP flow or email+password and receive a session_id used for all requests. Check your balance, initiate calls with an idempotency_key to avoid duplicates, monitor or end active calls, and send DTMF tones during calls. Calls are billed per minute (rounded up) and credits must be added through the web wallet — the skill cannot process payments directly.

When to use it

Call family or friends abroad quickly without a subscription
Let an AI agent place automated calls or reservations using direct mode
Make short business calls at predictable, low per-minute rates
Test voice flows or IVR interactions using free trial minutes
Place calls when you need to press DTMF tones (menus, banking)

Best practices

Store and reuse session_id securely for API calls; refresh via login/OTP when expired
Always generate a unique idempotency_key per user action to prevent duplicate calls
Check balance before initiating calls to avoid interruptions mid-call
Use bridge mode for personal calls and direct mode for automated agents or when you don’t want your phone to ring
Round expected cost up to nearest minute when planning longer calls

Example use cases

User requests: “Call my mom in India” → check balance, initiate bridge call, connect when user answers
AI agent books a restaurant using direct mode; phone does not ring for the user
Customer support bot navigates IVR menus by sending DTMF digits programmatically
Business user checks call history and costs to reconcile international calling expenses
Developer testing: use free 5-minute credit to validate call initiation and DTMF behavior

FAQ

Add credits at the web wallet; PayPal for USD or UPI for INR. The skill cannot process payments directly.

What is an idempotency key and why use it?

A unique identifier for each call attempt; reuse within 5 minutes returns the original call to prevent duplicates.

What’s the difference between bridge and direct mode?

Bridge rings your phone first and then connects you to the destination; direct mode calls the destination directly and is ideal for automated agents.

Are calls billed per second or per minute?

Calls are billed per minute, rounded up to the next whole minute.