Pre-requisites
- WhatsApp Business number connected — see Connect WhatsApp.
- Salesforce Live Messaging credentials saved — see Live Messaging setup.
How conversations land in Salesforce
Setting up
Confirm WhatsApp is connected
Open Channels → WhatsApp in the OpenCX dashboard. Your WhatsApp Business number should be listed and active.
Confirm Live Messaging is connected
In Settings → Integrations, open Salesforce → MIAW. All six fields should be filled and saved.
Trigger a test handoff
Send a WhatsApp message to your connected number and ask to speak to a human. The AI should hand off.
What the rep sees
- A messaging thread in the Salesforce console routed through Omni-Channel.
- The contact’s WhatsApp profile (name, phone number) in the conversation.
- Full transcript of the AI-to-customer exchange so far.
OpencxSessionIdrouting attribute — the trace key to the full OpenCX session.- Replies land on the customer’s WhatsApp within a couple of seconds.
Channel-specific details
24-hour messaging window
24-hour messaging window
WhatsApp’s policy lets reps send free-form messages within 24 hours of the customer’s last message. Outside that window, replies must use an approved . Your rep will need to use templates from the WhatsApp side if the window has closed.
Contact matching by phone number
Contact matching by phone number
OpenCX matches contacts primarily on phone number. If the customer has previously shared an email, that link is preserved. No duplicate contact records.
Media messages
Media messages
Images, audio, and documents the customer sends on WhatsApp appear as attachments on the messaging thread in the Salesforce console. Size limits follow WhatsApp’s per-media-type limits.
Proactive outbound
Proactive outbound
Sending a WhatsApp template-message campaign from OpenCX is independent of the Salesforce integration — see the WhatsApp channel docs. Replies to a template land as a messaging thread in the Salesforce console once the customer engages.
Related Documentation
AI WhatsApp Support
The channel itself — connect, messaging rules, templates.
Live Messaging setup
JWT credentials, routing attributes, and connection.
Salesforce overview
What Salesforce lights up across every channel.
Troubleshooting
Conversations not appearing, replies not reaching WhatsApp.