<action application="curl" data="https://pdf-api.company.com/generate?caller=$caller_id_number&duration=$duration POST"/> On FreeSWITCH 18, enforce wss:// (WebSockets Secure) for hot desking login over the web. Edit sip_profiles/internal.xml :
<extension name="hotdesk_login"> <condition field="destination_number" expression="^\\*10(\\d+)$"> <action application="set" data="hotdesk_user=$1"/> <action application="playback" data="ivr/8000/please_enter_your_pin.wav"/> <!-- Wait for PIN --> <action application="set" data="pin=$wait_for_dtmf(4)"/> <action application="hash" data="insert/$domain_name/hotdesk/$sip_from_user/$hotdesk_user"/> <action application="playback" data="ivr/8000/login_successful.wav"/> <action application="sofia" data="register $hotdesk_user@$domain_name $pin"/> </condition> </extension> Modify the Lua script to pull the active hotdesk user:
-- Write temp HTML local html_file = "/tmp/cdr_" .. uuid .. ".html" local pdf_file = "/tmp/cdr_" .. uuid .. ".pdf" local f = io.open(html_file, "w") f:write(html_template) f:close()
<include> <user id="101" mailbox="101"> <params> <param name="password" value="1234"/> </params> <variables> <variable name="user_context" value="hotdesk"/> <variable name="effective_caller_id_name" value="Alice Sales"/> <variable name="email_pdf" value="alice@company.com"/> </variables> </user> </include> In dialplan/hotdesk.xml :
This article dives deep into how you can leverage FreeSWITCH 1.10 (the "18-era" stack), integrate dynamic PDF reporting, and implement hot desking to build a state-of-the-art telephony system. First, a clarification: The official version number remains 1.10.x. However, the community shorthand "FreeSWITCH 18" refers to the software running optimally on Debian 11 (Bullseye) or Ubuntu 22.04 LTS – environments using OpenSSL 3.0 and newer kernel modules. These OS versions, released around late 2021 to 2022, introduced breaking changes for older FreeSWITCH builds.
With the release of version 1.10 (often colloquially referred to in the community as "FreeSWITCH 18" due to its compatibility with modern dependency stacks like Debian 11/12 and specific library versions), a new wave of features has emerged. Among the most requested capabilities are for call detail records (CDRs) and "Hot Desking" – a feature allowing users to log into any physical phone on the network and make it their own.
-- Execute conversion (hot generation) os.execute("wkhtmltopdf " .. html_file .. " " .. pdf_file)
-- Hot PDF script - triggered via dialplan api = freeswitch.API() uuid = argv[1]; -- Call UUID caller_id = api:execute("getvar", "caller_id_number") dest_number = api:execute("getvar", "destination_number") start_epoch = api:execute("getvar", "start_epoch") -- Build HTML template html_template = [[ <html> <head><title>Call Receipt - FreeSWITCH 18</title></head> <body> <h1>Communication Log</h1> <p>Caller: ]] .. caller_id .. [[</p> <p>Destination: ]] .. dest_number .. [[</p> <p>Timestamp: ]] .. os.date("%Y-%m-%d %H:%M:%S", tonumber(start_epoch)) .. [[</p> <p>Status: HOT Transfer</p> </body> </html> ]]
