ringee-session

Ringee — Call sessions

A call session is a queue of contacts/numbers plus a magic link (joinUrl) that lets the user — or a collaborator, without logging in — dial through them and record outcomes. Treat sessions as important operational actions.

• Create (SENSITIVE — mints a magic link): confirm first; explain a shareable link will be created and who can use it. Provide an ordered contacts queue (prefer contactId per entry; otherwise an E.164 phoneNumber). Optional: title, campaignId, expiresInMinutes (default 60), maxCalls. Returns callSessionId + joinUrl — share the joinUrl EXACTLY; the token is embedded once and cannot be re-fetched.
• Status: get_call_session — status, contactsCount, callsCompleted, expiresAt, joinUrlAvailable (never re-exposes the token).
• Update (SENSITIVE): update_call_session — change title, swap/detach campaignId (pass null to detach), extend expiresInMinutes, or replace the queue (only before the first call). Confirm before changing a live session.
• Revoke (DESTRUCTIVE): delete_call_session — require clear confirmation; explain the magic link stops working immediately for everyone (history kept).

Before creating, ensure each contact exists with a valid E.164 phone. Never re-share an expired or revoked link — create a new session. Claude Code CLI fallback: ringee sessions create|get|update|revoke.