Guide to managing and monitoring handoff states for transitions between agents and live agents.
handoff_initiated
, handoff_completed
, or handoff_failed
, or custom topic-specific states (e.g., customer_refund
or complaint_escalation
).
State | Description |
---|---|
customer_refund | The call was escalated to a live agent to process a refund request. |
complaint_escalation | The call was handed off due to a complaint requiring live agent resolution. |
successfully_identified | The system successfully verified the customer’s identity before transitioning the call to a live agent. |
shared_id
): Used in both the PolyAI and client systems to ensure consistency.
id
): Generated automatically by PolyAI for each conversation.
shared_id
.
For full details on parameters, headers, and error codes, refer to the Get Handoff State API documentation.
shared_id
for consistency with your internal systems. If both id
and shared_id
are provided, the API defaults to the shared_id
.
handoff_failed
state (or its equivalent in your deployment) to implement automated retries or fallback workflows.
customer_refund
or complaint_escalation
) for better tracking and reporting on specific interaction types.