Voxtelesys Integration for ERPNext Helpdesk

Minimal Frappe app that receives an HTTP webhook from 3CX when an inbound call arrives (via a Voxtelesys SIP trunk) and automatically creates an HD Ticket in Frappe Helpdesk.

Architecture

Voxtelesys SIP trunk → 3CX PBX → CF_URLFetch (Call Flow) → ERPNext webhook → HD Ticket

Installation

cd ~/frappe-bench
bench get-app https://forge.wilddragon.net/zgaetano/voxtelesys_integration.git
bench --site erp.broadcastmgmt.cloud install-app voxtelesys_integration
bench --site erp.broadcastmgmt.cloud migrate
bench restart

Webhook Endpoint

POST https://erp.broadcastmgmt.cloud/api/method/voxtelesys_integration.api.inbound_call

Parameters (POST body or query string)

Parameter	Required	Description
`caller_id`	Yes	Inbound caller number e.g. `+12025551234`
`called_did`	No	DID that was dialled
`call_id`	No	3CX internal call ID (for deduplication)

Response

{ "ok": true, "ticket": "HD-TICKET-00001" }

3CX Call Flow Setup

Open 3CX Management Console → Call Flow Designer
Create a new Call Flow (or edit your inbound DID's flow)
Add a CF_URLFetch block with these settings:
- URL: https://erp.broadcastmgmt.cloud/api/method/voxtelesys_integration.api.inbound_call
- Method: POST
- Parameters:
  - caller_id = [caller_id] (3CX variable for inbound caller number)
  - called_did = [called_did] (optional)
  - call_id = [call_id] (optional, enables deduplication)
Connect the block in your call flow — it can run in parallel with ringing, no need to wait for the response

Optional: Webhook Secret

To prevent unauthorized calls to the endpoint, add this to your site config:

bench --site erp.broadcastmgmt.cloud set-config voxtelesys_webhook_secret "yourtoken"

Then append ?secret=yourtoken to the 3CX webhook URL.

Optional: Custom Field for Deduplication

To prevent duplicate tickets if 3CX retries the webhook, add a custom field to HD Ticket:

DocType: HD Ticket
Field Name: custom_3cx_call_id
Field Type: Data

This can be done via ERPNext → Customize Form → HD Ticket.

License

MIT

2.3 KiB Raw Blame History