GetNextCampaignContact returns the next contact available for dialing.

GET 
/api/v1/voice/campaigns/next-contact

Global endpoint — not tied to a specific campaign. The system finds active campaigns assigned to the agent's queue(s) and returns the next contact across all of them.

Flow

1. Agent polls this endpoint
2. System checks agent availability, finds active campaigns for their queues
3. Returns next contact with full campaign context
4. Agent reviews, calls DialCampaignContact or SkipCampaignContact

Reasons for available=false

• agent_not_found: No agent linked to user
• agent_not_available: Agent is offline, busy, or on break
• no_active_campaigns: No active campaigns for agent's queues
• no_contacts_available: All contacts in all campaigns have been processed

Responses

200

A successful response.

default

An unexpected error response.