Passthru Applet



The Passthru Applet sends call and streaming metadata from Voice Applet flows to your server, especially useful when executing:

Passthru sends additional stream-specific parameters as query parameters, enriching standard passthru behaviour.

Refer to the standard passthru documentation here: Working with Passthru Applet

This guide is an extended version with additional parameters for streaming flows.

Passthru makes an HTTP GET request to your URL, passing URL-encoded call and stream metadata.

Example:

Your backend must parse:

Sometimes, all parameters are sent in a single JSON string under the Stream key:

Passthru requests can be handled synchronously or asynchronously:

Note: The above fields are added on top of standard passthru parameters.

Concurrency limit breaches trigger:

Implement retry or fallback strategies accordingly.

Below are the most common failure and disconnection scenarios captured in the passthru payload:

Test 1: Call hung up during greeting

Expected: Capture who disconnected and status

Test 2: Invalid WebSocket URL

Expected: Failure metadata including error, stream URL, and disconnector

Test 3: Call cancelled after delay in streaming setup

Expected: Accurate cancellation reason and disconnection origin

Test 4: Call disconnected by bot after successful conversation

Expected: Final stream status and session metadata

These structured outputs ensure consistent understanding of streaming lifecycle and failure context.

Note: DisconnectedBy values are standardized to: user, bot, NA.

Passthru logs enriched with detailed Error messages improve debugging and recovery mechanisms.