I’m trying to poll the current state of an interaction. I know /api/v2/conversations/{id} gives me the live session data. But the docs for /api/v2/analytics/conversations/details/summary mention disposition and wrapup.
Is the analytics endpoint updated in real-time? Or is there a delay? I tried hitting the analytics endpoint immediately after a transfer and got empty data. Should I stick to the conversations endpoint for immediate checks?
analytics has a delay. usually 15-30 seconds. don’t use it for real-time logic.
stick to /api/v2/conversations/voice/{conversationId}. if you need the final disposition, wait for the conversation.update event or poll the conversation endpoint until state is closed.
// check state directly
const conv = await platformClient.ConversationsApi.getConversationVoice(conversationId);
console.log(conv.state); // "connected", "closed", etc.
// analytics is for reporting, not control flow
// /api/v2/analytics/conversations/details/summary
if you’re building a flow that depends on the wrap-up code being set, listen for the event. polling the analytics endpoint will just waste tokens.