Akuvox Action URL — Trigger a ControlByWeb Relay
An Akuvox door phone can send an HTTP request whenever its relay fires. Point that request at a ControlByWeb board and the intercom will switch a second, completely separate relay — over the network, with no extra wiring run back to the door.
Set the Action URL on the Akuvox
Log in to the door phone
Browse to the device's IP address (find it with the Akuvox IP Scanner). The default login is
admin / admin.
Go to Device Management → Setting → Action URL, and tick Enabled
Nothing on this page is sent until Enabled is checked. Leave UserName and Password blank unless the receiving server asks for digest authentication — for ControlByWeb you will put the credentials in the URL instead (see below).
Paste the URL into RelayA Triggered / RelayB Triggered, then Submit
RelayA Triggered fires the moment relay A closes; RelayB Triggered does the same for relay B. Use the matching Closed field only if you also need to signal the relay releasing. Click Submit — the setting is not saved until you do.
The ControlByWeb URL
ControlByWeb boards are driven by a plain HTTP GET to state.xml. The parameter name
depends on which generation of board you have — check the manual for your exact model if the first
form does nothing.
| ControlByWeb model | Turn on | Turn off | Pulse |
|---|---|---|---|
| Current X-series (X-301, X-310, X-410, WebRelay 441 / 444) |
state.xml?relay1=1 |
state.xml?relay1=0 |
state.xml?relay1=2 |
| Original WebRelay (single relay, X-WR-1R12) |
state.xml?relayState=1 |
state.xml?relayState=0 |
state.xml?relayState=2 |
| WebRelay-Quad (older 4-relay) |
state.xml?relay1State=1 |
state.xml?relay1State=0 |
state.xml?relay1State=2 |
So the value you actually type into RelayA Triggered looks like this —
192.168.1.2 being the ControlByWeb board's IP address:
http://192.168.1.2/state.xml?relay1=2
=2 (pulse). The board closes for the Pulse Duration set on its own relay page and then
releases on its own. =1 latches the relay on and nothing will ever turn it back off.
To override the board's configured pulse length, add
pulseTime. On current firmware it must
come before the relay parameter —
http://192.168.1.2/state.xml?pulseTime1=5&relay1=2 — while the original WebRelay
takes it after: http://192.168.1.2/state.xml?relayState=2&pulseTime=5.
If the board has a password
ControlByWeb uses HTTP Basic authentication, which the Akuvox Action URL field cannot send as a header. Put the credentials in the URL instead — Akuvox's own documentation notes that credentials inside the URL take precedence over the UserName / Password boxes:
http://user:password@192.168.1.2/state.xml?relay1=2
&noReply=1 to stop the board returning its XML status page.
The intercom ignores the response either way, so this just saves a little traffic:
http://192.168.1.2/state.xml?relay1=2&noReply=1
$mac, $ip, $relay1status and similar to an Action URL so a logging
server can record which device fired. ControlByWeb is not a logging server — it expects only its own
parameters, and unrecognised ones will make the command fail. Send the bare
state.xml?relay1=2 and nothing else.
Akuvox procedure per the Akuvox knowledge base, “Set up Action URL” (updated 25 September 2025). ControlByWeb command syntax per Xytronix Research & Design's Integration & Communication Protocols Manual and the WebRelay User's Manual.