Pre-requisites
- SMS number connected and verified — see Connect SMS and, for US numbers, SMS compliance.
- Zendesk Sunshine credentials saved — see Sunshine Conversations.
How conversations land in Zendesk
Setting up
Confirm SMS is connected
Open Channels → SMS in the OpenCX dashboard. Your SMS number should be listed and active.
Confirm Sunshine is connected
In Settings → Integrations, open Zendesk → Messaging. The status should show Active.
Trigger a test handoff
Text your connected number and ask to speak to a human. The AI should hand off.
What the rep sees
- A live chat in the Agent Workspace tagged
opencx_channel_sms. - Contact phone number attached via the Sunshine user.
- Full transcript of the AI-to-customer exchange.
opencx_session_idon the conversation — the trace key to the full OpenCX session.- Replies deliver as SMS within a couple of seconds, carrier willing.
Channel-specific details
US number compliance
US number compliance
US SMS numbers require or before they can reliably deliver outbound messages. Complete this on the OpenCX side — see SMS compliance. The Zendesk integration doesn’t change the requirement.
User merge by phone number
User merge by phone number
OpenCX matches Sunshine messaging contacts to existing Zendesk support users. SMS merges primarily on phone number; email is used only when the customer has shared one on another channel first.
Message length and segmentation
Message length and segmentation
SMS messages are split into 160-character segments by carriers. Reps in the Agent Workspace don’t see the split — the full reply is sent as one logical message and the customer sees it as one thread. Keep replies tight; carrier costs scale per segment.
MMS
MMS
Media sent by the customer (MMS) appears as attachments on the Sunshine conversation when the carrier supports it. Outbound MMS support depends on your SMS provider’s capabilities.
Related Documentation
AI SMS Support
The channel itself — connect, routing, compliance.
Sunshine Conversations setup
Credentials, webhook, and user merge.
Zendesk overview
What else Zendesk lights up across every channel.
Troubleshooting
Replies not reaching SMS, duplicate contacts.