By Sagar Shankaran, Founder of CallSphere
Zendesk's Sunshine Conversations API unifies 14+ messaging channels behind one REST surface. Here is how a CallSphere voice agent uses Switchboard to escalate and Side Conversations to coordinate.
Key takeaways
Sunshine Conversations is the most under-discussed Zendesk asset for voice teams. One REST API gives you WhatsApp, Messenger, Instagram, SMS, and Web Messenger — and Switchboard lets your voice agent pass control to a human or another bot without dropping context.
flowchart LR
Repo[GitHub repo] --> CI[GitHub Actions]
CI --> Eval[Agent eval suite · PromptFoo]
Eval -->|pass| Deploy[Deploy]
Eval -->|fail| Block[Block PR]
Deploy --> Prod[Production agent]
Prod --> Trace[(LangSmith trace)]
Trace --> EvalA CallSphere voice agent finishes triaging a support call. The customer needs a human escalation but they prefer text. Voice agent says "I will text you the details so we have a paper trail" — and behind the scenes Sunshine Conversations opens a WhatsApp thread, posts the call summary, attaches the recording, and Switchboards control to the next available Zendesk Support agent. From the customer's perspective it is one conversation. From Zendesk's perspective it is a Ticket with full context.
The base URL is https://api.smooch.io/v2. Key resources: POST /apps/{appId}/conversations to start a conversation, POST /apps/{appId}/conversations/{conversationId}/messages to post into it, POST /apps/{appId}/conversations/{conversationId}/passControl to invoke Switchboard and hand the conversation to another integration (Zendesk Agent Workspace, a third-party bot, or back to the customer-only state). POST /apps/{appId}/users to create or upsert the messaging user, and POST /apps/{appId}/users/{userId}/identities to link the WhatsApp/SMS identity.
Hear it before you finish reading
Talk to a live CallSphere AI voice agent in your browser — 60 seconds, no signup.
Auth: server-to-server uses Basic auth with a Sunshine Conversations API key, or JWT for short-lived sessions. Sunshine Conversations is included only on Zendesk Suite Professional, Enterprise, and Enterprise Plus.
CallSphere runs 37 specialist agents across 6 verticals with 90+ tools. Healthcare's 14 tools (lookup_patient, create_new_patient, get_available_slots, schedule_appointment, send_intake_link...) routinely escalate to a clinic's Zendesk Support workspace via Sunshine. Real Estate OneRoof's 10 specialist agents post property cards into a WhatsApp thread mid-call so the buyer has the listings on their phone the second they hang up. The Salon GlamBook integration uses SMS Sunshine threads for booking confirmations and same-day reschedule prompts.
Pricing: $149/$499/$1499. 14-day trial. 22% affiliate.
callsphere (your voice agent integration) and zd-agentWorkspace (Zendesk's native Agent Workspace).POST /users with the customer's E.164 phone. Then POST /conversations with that user.POST /messages with the structured summary (call topic, attempted resolutions, disposition).passControl with target zd-agentWorkspace so the next Zendesk human picks it up. Sunshine fires a switchboard:passControl webhook back to CallSphere if you need to know.message:appUser webhooks so a later customer reply re-engages CallSphere if the human marks the ticket back to bot-handled.// Hand off from CallSphere voice to Zendesk Agent Workspace via Switchboard
await fetch(
`https://api.smooch.io/v2/apps/${appId}/conversations/${conversationId}/passControl`,
{
method: "POST",
headers: {
Authorization: `Basic ${btoa(`${keyId}:${secret}`)}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
switchboardIntegration: "zd-agentWorkspace",
metadata: {
callSphereCallId: turn.callId,
callSummary: turn.summary,
recordingUrl: recording.s3Url,
},
}),
}
);
What is the difference between Side Conversations and Sunshine? Side Conversations are internal Zendesk threads used for vendor or coworker coordination on a Ticket. Sunshine is the customer-facing messaging fabric. CallSphere uses both — Side Convos for "ping the supervisor," Sunshine for the multichannel customer thread.
Still reading? Stop comparing — try CallSphere live.
CallSphere ships complete AI voice agents per industry — 14 tools for healthcare, 10 agents for real estate, 4 specialists for salons. See how it actually handles a call before you book a demo.
Does Switchboard work with our existing Zendesk routing? Yes. Switchboard wraps Zendesk's Agent Workspace as one participant. Routing, SLAs, and views all behave normally once a human picks the conversation up.
Will the customer see "bot to human" handoff messages? Only if you publish them as messages. passControl itself is silent. Most teams send a one-line "Connecting you with a teammate" before the handoff.
How does Sunshine pricing work? It is bundled with Suite Professional and above. Per-conversation MAUs apply on Enterprise. Plan accordingly.
How do I get started? Start a CallSphere trial and visit our demo page to schedule a walkthrough of the Zendesk Switchboard pattern.
Written by
Sagar Shankaran· Founder, CallSphere
Sagar Shankaran is the founder of CallSphere, where he builds production AI voice and chat agents deployed across healthcare, hospitality, real estate, and home services. He writes about agentic AI, LLM engineering, and shipping voice agents that handle real calls in production.
See how AI voice agents work for your industry. Live demo available -- no signup required.
Graphiti is the open-source temporal knowledge graph for AI agents in 2026. Learn how bi-temporal memory beats vector RAG for voice agents and long-running LLMs.
Self-correction is now a property of the model, not the framework. What that means for production agent reliability, voice/chat fallbacks, and CallSphere.
How to design a multi-agent system using MCP for tools and A2A for cross-vendor coordination, with a CallSphere voice agent as a participating node.
Offline evals catch regressions before deploy on a fixed dataset. Online evals catch real-world drift on live traffic. You need both — here is how we run them.
The full metric set for evaluating production voice agents — STT word error rate, end-to-end latency budgets, RAG grounding, prosody, and the metrics that actually correlate with retention.
Build a working voice agent with the OpenAI Realtime API + Agents SDK, then bolt on an eval pipeline that catches barge-in failures, hallucinated grounding, and latency regressions.
© 2026 CallSphere LLC. All rights reserved.