helix-engage/docs/next-session.md

Next Session — Outbound Call UI + Remaining Work

Priority 0: Kookoo Dial to SIP Extension

Status: Kookoo IVR endpoint works. When customer answers, Kookoo hits /kookoo/ivr, we respond with <dial>523590</dial>. But Kookoo tries to call 523590 as a PSTN number — status=not_answered.

The Voice URL in Kookoo dashboard has been changed to: https://engage-api.srv1477139.hstgr.cloud/kookoo/ivr

Formats to try in the <dial> tag:

1. 523590 — current, fails (treated as PSTN)
2. 0523590 — with STD prefix
3. sip:523590@blr-pub-rtc4.ozonetel.com — full SIP URI
4. 523590@blr-pub-rtc4.ozonetel.com — SIP without scheme
5. Use <conference> tag instead — put customer in room, have browser SIP join same room

Alternative approach: Instead of <dial>, use <conference> tag:

• Customer answers → put in conference room "call-{sid}"
• Meanwhile, browser SIP joins the same conference room
• Both connected

Files: helix-engage-server/src/ozonetel/kookoo-ivr.controller.ts line where we return <dial>523590</dial>

Priority 1: Outbound Call UI

Problem: When agent clicks Call, a toast appears and the call happens in the background. No call screen shows.

Fix: When agent clicks Call on a lead:

1. Immediately set callState = 'ringing-out' and callerNumber via Jotai atoms
2. Show ActiveCallCard with "Calling {name}..." and End button
3. Show CallPrepCard with AI summary (same as inbound)
4. Context panel auto-loads Lead 360
5. Sidecar calls Kookoo outbound in parallel
6. When SIP bridge arrives (newRTCSession), auto-answer it — don't show Answer/Decline
7. UI transitions to active call with Mute/Hold/End
8. Call ends → Disposition form

Files to change:

• src/components/call-desk/click-to-call-button.tsx — set Jotai atoms on click, not just call API
• src/components/call-desk/active-call-card.tsx — handle 'ringing-out' state
• src/state/sip-manager.ts — auto-answer SIP when outbound call is pending
• src/pages/call-desk.tsx — include 'ringing-out' in isInCall, set selected lead on dial

Key insight: The call card is driven by app state, not SIP events. Set state immediately on click.

Priority 2: Remaining Polish

• Kookoo callback creates call records (already deployed)
• Toast for dial should be replaced with the call card (covered by Priority 1)
• Test full outbound flow end-to-end on staging

Priority 3: Caching

• DataProvider fires 14 queries on mount (7 × StrictMode)
• Add deduplication or sidecar-level cache

Deploy Commands

See memory/helix-engage-session-progress.md for full deploy instructions.