In-group URLs: firing webhooks on inbound call events

If you want your dialer to tell another system something happened, the in-group URL fields are the way. Each one is a web address that gets called automatically at a specific moment in an inbound call. You drop in a link, and at the right instant the system makes a request to it with the call's details. That is a plain Webhook, built right into the in-group.

The events you can hook into

There are several fields, each tied to a different stage:

• Enter In-Group URL fires when a call enters the queue, just before the system looks for an agent. If the call leaves the group early, for things like no-agent or after-hours, it does not fire.
• Start Call URL fires every time a call is actually sent to an agent.
• Dispo Call URL fires when an agent dispositions the call, and it can pass along the disposition, the talk time, and how the call ended.
• No Agent Call URL fires when a call that no agent handled is hung up or transferred away.
• Talk Seconds URLs fire based on how long the agent has been talking, and a Waiting Call on/off pair fires when calls start and stop waiting in the queue.

Passing call data in the URL

These fields use the same variable style as the web form and scripts. You wrap a field name in the marker tokens VICIdial expects and the system swaps in the live value when it makes the request. So you can send the phone number, the lead ID, the Disposition, the talk time, and more to whatever endpoint you point at. The Dispo Call URL in particular gives you dispo, talk_time and term_reason, which is enough to log an outcome anywhere you like.

If one URL is not enough, type ALT into the field and submit. You then get a page where you can define multiple URLs with a rank that controls their order, an active flag, and conditions on disposition status or list. Be careful with rank: if a slow URL is ranked first, the ones after it wait for it to answer.

What people build with these

The common use is keeping an outside CRM in sync without an agent touching anything. Enter In-Group can create a record the moment a call lands; Dispo Call can update that record with the outcome. People also use them for screen pops, for billing systems, and for the original Waiting Call trick of flashing a physical light when the queue backs up. Any URL (in VICIdial) you can call over HTTP is fair game.

These URL fields are one slice of the in-group panel. For the full sequence of how an inbound call is received and routed, see the inbound call handling guide. One specific URL, the one that creates a brand new lead, has its own quirks, so the Add Lead URL guide covers it separately.

Want a dialer where your in-groups can fire webhooks into your own stack from day one? See our plans.