What the Dispo Email URL field does

Dispo Email URL is the bookend to the field that fires when an email starts. This one fires when the email ends, the moment an agent applies a Disposition and closes the message. Like its sibling, it is completely silent: VICIdial sends a web request to the address you set, and the agent sees nothing.

Leave it blank, which is the default, and nothing happens. Populate it, and every statused email pings your URL. That makes it the natural place to tell an outside system that a piece of work is finished.

The two variables that make it useful

The string accepts the same variables as web form fields and scripts, so you can pass lead_id, user, and the rest of the record. On top of those, Dispo Email URL gives you two extras that only make sense at the end of an email:

• dispo, the disposition the agent chose to close the email.
• talk_time, the actual time spent working the email, in seconds.

With those two you can do real reporting from outside VICIdial: push the outcome and handle time into your own analytics, or trigger different follow-ups depending on how the email was statused.

Where it fires in the email's life

The request sits at the closing edge of the work, after the agent decides what happened:

flowchart TD
  A["Email delivered to agent"] --> B["Agent reads and replies"]
  B --> C["Agent picks a disposition"]
  C --> D{"Dispo Email URL set"}
  D -->|no| E["Email closed, nothing fires"]
  D -->|yes| F["Send request with dispo and talk_time"]
  F --> G["Your system records the outcome"]
  G --> E

Start versus dispo

It helps to keep the pair straight. The start field fires when an email reaches an Agent and is good for opening a record. The dispo field fires when the email is closed and is good for recording what happened and how long it took. Many teams set both, one to open work in their CRM and one to close it.

One more thing worth knowing: leads statused a certain way can also be moved to another Lead list using a related script, which is handy for sending sales to a follow-up queue. That is a separate mechanism from this URL, so it is covered on its own.

Setting Dispo Email URL up takes a minute. Open the email group, paste your full web address into the field, and append the variables you want, including dispo and talk_time. Save, and from then on every statused email fires the request. Clear the field and it stops. Since the agent never sees any of this, you can change the endpoint without retraining anyone or interrupting their work.

A practical note on talk_time: it reports the actual seconds the agent spent working the email, not how long the message sat in the queue beforehand. That makes it a clean measure of real effort per email. Feed it into your reporting and you can compare handle time across agents or across email groups, then use what you learn to balance the queues better.

For the field that fires at the other end of the work, read the Start Email URL field. The bigger setup, parsers and queues included, lives in the inbound email and chat guide. If wiring webhooks and parsers by hand is not how you want to spend your week, our pricing page covers managed VICIdial hosting with the box live in under 40 seconds.