<aside> 📞

X-Tone Click-to-Call Integration This page documents the API commands for authenticating and initiating calls through the Vaspian X-Tone web interface. Use these commands to programmatically trigger calls between extensions and external numbers. The examples use curl, but you can use any HTTP method to call the URL.

</aside>

Overview

The X-Tone system provides a web-based API for click-to-call functionality. The workflow requires two steps: authenticate to receive a session cookie, then use that cookie to initiate calls.

System: X-Tone (xtone.buf.vaspian.net)

Authentication: Extension + Password

Protocol: HTTP POST with session cookies

Step 1: Authentication

Before initiating calls, you must authenticate and store the session cookie.

curl -c cookie.txt -L -v -X POST '<https://xtone.buf.vaspian.net/webadmin/en/user/jsp/ProcessLogin.jsp?tenantWebName=/sandbox&UserID=100&Password=****>'

Parameters explained:

• -c cookie.txt — Saves session cookies to a file for subsequent requests
• -L — Follows HTTP redirects automatically
• -v — Verbose output showing request/response headers (useful for debugging)
• -X POST — HTTP POST method

URL Parameters:

• tenantWebName=/sandbox — Specifies the tenant identifier
• UserID=100 — Extension number for authentication
• Password=*** — Password for the specified extension

<aside> ✅

On success, this command stores authentication cookies in cookie.txt for use in subsequent API calls.

</aside>