When the WEBFORM button does nothing: tracing it in the URL Log

An agent clicks the WEBFORM button, a window should pop open with the customer's record loaded, and nothing happens. Before you start blaming the browser, you can prove exactly what the agent screen tried to do. VICIdial records every WEBFORM button click in the URL Log Report, including the full URL it built, so you can see whether the request fired at all and where the chain actually broke.

What the WEBFORM button actually does

The WEBFORM button is a Web form launcher configured per Campaign. When the agent clicks it, the agent screen takes the WEBFORM URL you set, substitutes the live call fields into it, and opens the result. That substitution is the part that breaks most often: tokens like the Lead ID, phone number, or any Custom field get swapped into the URL, and a typo or a missing field can produce a broken link or a blank window.

The URL Log Report records each requested URL (in VICIdial) the system builds, including agent-screen WEBFORM clicks, for the date and time range you pick. So if the agent insists they clicked and nothing opened, the log tells you whether the click ever turned into a request.

Step one: check the campaign WEBFORM URL field

Open the campaign and look at the WEBFORM URL setting. Common problems here:

• The field is empty, so the button has nothing to open.
• A substitution token is misspelled, so the field never gets filled and you end up with a malformed URL.
• The URL points at a host that is down or that the agent's network can't reach.

Step two: confirm the request fired in the URL Log

Now have the agent click WEBFORM again and pull up the URL Log Report for that minute. If you see a row with the fully substituted URL, the agent screen did its job — the request was built and sent. If you see no row at all, the click never reached the server, which points at the browser or a frozen agent screen rather than your settings.

flowchart TD
  A[Agent clicks WEBFORM] --> B{Row in URL Log Report?}
  B -->|No row| C[Click never fired]
  C --> D[Popup blocker or frozen agent screen]
  B -->|Row with full URL| E[Request fired]
  E --> F{URL looks correct?}
  F -->|Token unsubstituted| G[Fix campaign WEBFORM URL field]
  F -->|Looks right| H[Target host down or unreachable]

Step three: rule out popup blockers and field gaps

If the URL Log shows a clean, correct URL but the agent still sees nothing, copy that exact URL out of the log and paste it into the agent's browser by hand. If it opens that way, a popup blocker or browser extension is eating the WEBFORM window — whitelist your dialer's hostname. If the pasted URL also fails, the problem is on the target side, not in VICIdial. And if the logged URL contains an empty value where the Lead data should be, fix the substitution token in the campaign field and test again.

For a wider tour of how this report behaves and every field it can show, read how to read the URL Log Report. When a broken WEBFORM is one symptom of a wider agent-screen problem, work through the VICIdial troubleshooting playbook to triage in order.

Half of these failures come down to a flaky web tier you don't control. VICIfast runs a hardened, managed VICIdial box that is live in under 40 seconds, so the agent screen and your WEBFORM targets sit on infrastructure you can actually trust. See our plans and pricing.