Direct Call

Use the RingQ API Web Hook to directly call a number from a specific extension without requiring the agent to dial — ideal for click-to-call integrations.

The Direct Call web hook tells RingQ to dial a destination number on behalf of a specific extension. Unlike Make Call, Direct Call places the outbound leg immediately — the agent’s extension rings as if they had dialled the number themselves.

Prerequisites

Before you begin, you need your API Key from the RingQ admin dashboard.

1. Log in to the RingQ admin dashboard.
2. Go to Settings → API.
3. Copy the API Key shown on this page. You will use it in every web hook URL.

API URL Format

https://{your-ringq-domain}/api/v2/{api-key}/directcall/{extension}/{destination}

Parameter	Description
your-ringq-domain	The domain or IP address of your RingQ instance (e.g. pbx.yourdomain.com).
api-key	Your API key from Settings → API.
extension	The extension number that will be used as the caller (the outgoing call is placed from this extension).
destination	The number to dial — an extension, DID, or external phone number.

Example

To place a direct outbound call from extension 205 to [phone]:

https://pbx.yourdomain.com/api/v2/abc123xyz/directcall/205/[phone]

RingQ will immediately initiate an outbound call from extension 205 to the destination number.

Response

A successful request returns HTTP 200 with a JSON body:

{ "result": "success" }

Direct Call is ideal for click-to-call buttons in a CRM. When a user clicks the button, the web hook fires, and their desk phone or softphone rings to connect them to the customer.