VICIfast
Glossary

system

Asterisk uniqueid

A unique label Asterisk stamps on every channel it creates, so each leg of every call can be tracked, matched to records, and found in logs.

The uniqueid is a label that Asterisk stamps on every channel it creates. A channel is one leg of a call — the caller's leg, the agent's leg, a transfer leg — and each gets its own uniqueid the instant it comes to life. It usually looks like a timestamp with a counter on the end, and no two are ever the same on that server.

Think of it as the receipt number for a piece of a call. When you need to follow exactly what happened to one Channel — when it answered, who it talked to, when it hung up — the uniqueid is the thread you pull. VICIdial stores it alongside its own call records so you can jump from a row in the database straight to the matching events in the Asterisk logs.

It shows up in a lot of useful places. A Call recording file is often named after the uniqueid, which is how the system knows which recording belongs to which call. Tools listening on the AMI (Asterisk Manager Interface) (Asterisk Manager Interface) see the uniqueid in nearly every event, so anything you build to watch calls in real time leans on it heavily.

Keep it straight from the Session ID, which is about an agent's screen for a whole login rather than one call. The uniqueid is the smallest, sharpest handle you have on a single call leg, and it is what you reach for when a customer disputes a Disposition and you need to find the exact recording.

Related terms

Asterisk uniqueid — VICIdial glossary · VICIfast