2chat-calls

name	2chat-calls
description	Use this skill when the user wants to view phone call history, get call details or recordings, or list virtual numbers and caller IDs via the 2Chat API. Trigger phrases include "call history", "call details", "call recording", "list virtual numbers", "caller IDs", "phone calls", "2chat calls".

2Chat — Phone Calls

View call history, details, recordings, and manage virtual numbers and caller IDs via the 2Chat API.

Authentication

All requests require the header:

X-User-API-Key: <api_key>

API keys are generated at app.2chat.io/developers. Base URL: https://api.p.2chat.io/open

---

Call History

Get call history

GET /voip/call-history

Query params: page_number, direction (inbound or outbound).

Returns call detail records (CDRs) with uuid, direction (O=outbound, I=inbound), status, to_number, caller_id_used, duration (seconds), recording_url, start_time, end_time, agent_id, and call_cost (with call_price in USD).

Get call details

GET /voip/call/{call_uuid}

Returns a single CDR with full details including agent info (name, profile pic) and call_cost.

---

Virtual Numbers

List virtual numbers

GET /voip/virtual-numbers

Query params: page_number, results_per_page (default 50).

Returns numbers with uuid, phone_number, iso_country_code, friendly_name, record_inbound, is_toll_free, incoming_price_per_minute, status_text (ACTIVE, AWAITING_REGISTRATION, PENDING_ACTIVATION, PENDING_CANCELLATION, RELEASED).

List caller IDs

GET /voip/caller-ids

Query params: page_number, results_per_page (default 50).

Returns caller IDs with uuid, phone_number, friendly_name, type, verified.

Caller ID types:

Type	Description
VN	Virtual number purchased on 2Chat
WW	Connected WhatsApp number
WA	WhatsApp Business API number
CI	Imported custom caller ID