Monitoring and results

Consumption sits outside the numbered route. Everything on this page works from the first completed call onward and stays available for the life of the integration. It has a page of its own because the audience usually differs: your analytics or CRM people, rather than the engineers who did phase 2.

Two directions

• You pull. Your system polls or queries for outcomes, history and recordings. Nothing new to operate on your side.
• Voicebot pushes. Each finished call goes to the webhook targets configured on the agent that ran it. Voicebot persists a delivery before attempting it, so you can inspect and replay a failed one.

Pull

The outcome of one call. Each accepted call produces exactly one outcome.

GET/v1/communication/{id}

Everything that happened during it. The step-by-step execution history: which bricks ran, what was recognised, where the call branched.

GET/v1/communication/{id}/history

Audio. The call recording, and the speech-recognition recordings the history points at.

GET/v1/communication/{id}/recording
GET/v1/communication/{id}/speech-recording

Bulk. List with filters, sorting and paging for reporting jobs.

GET/v1/communication

Every list answers the same envelope

Every list endpoint here returns the same shape: items, total, the paging that was applied, and has_more. Read has_more rather than computing the end yourself.

Push

You configure the targets on the agent, through PATCH/v1/agent/{id}. The operations below act on the deliveries once they exist.

GET/v1/communication-result
GET/v1/communication-result/{id}
POST/v1/communication-result/{id}/resend

Design for redelivery

Voicebot does not guarantee exactly-once delivery — the same result may arrive more than once. Key your handler on the communication sid and make it idempotent.

Reading a status correctly

Lifecycle status and call outcome are two independent axes. Both carry a failed value, and the two meanings differ, so a report that sums them counts two unrelated events as one. The glossary defines both axes.