--- sourceDocument: Australia Customer Service Management sourceDocumentLink: https://www.servicenow.com/docs/r/customer-service-management Release : - australia ft:locale : - en-US ft:publication_title : - Australia Customer Service Management ft:clusterId : - csm bundleId : - csm workflow : - Customer and Industry --- # Integrating WhatsApp with Customer Service Management using the WhatsApp Cloud API # Integrating WhatsApp with Customer Service Management using the WhatsApp Cloud API {#ariaid-title1} * Release version: Australia * * Updated July 16, 2026 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes to read Use WhatsApp messaging with Customer Service Management to enable direct communication with customers through WhatsApp using the WhatsApp Cloud API. This WhatsApp direct integration connects to Meta's WhatsApp business platform and enables agents to provide real‑time customer support with rich media, interactive controls, and full CSM workflow integration. The WhatsApp channel supports both automated conversations through Virtual Agent and live agent interactions through Agent Workspace, providing a complete customer service experience. ## WhatsApp messaging capabilities {#messg-integrating-whatsapp-with-csm-whatsapp-cloud__section_dbh_plh_jnb} WhatsApp messaging capabilities in Customer Service Management enable rich, interactive customer conversations beyond basic text messaging. Agents can exchange media files, send structured interactive controls, request customer inputs, and deliver formatted messages that improve clarity and reduce friction. ## Rich and interactive messaging features {#messg-integrating-whatsapp-with-csm-whatsapp-cloud__section_s1l_x4g_shc} WhatsApp supports the following messaging features and rich interactive controls: {#messg-integrating-whatsapp-with-csm-whatsapp-cloud__table_vlk_ykh_shc__entry__2} | Rich controls | Description | |-|-| | Rich media | Agents and customers can exchange images, videos, and documents directly within the conversation thread.The media can be uploaded from the device only. | | Typing indicators | Real-time visual feedback shows when agents or customers are composing messages, keeping both parties informed about conversation activity. Agent-side capabilities: * Automatically displayed to customer when agent types in Agent Workspace * Appears as "typing..." status in customer's WhatsApp * Provides immediate feedback that agent is responding {#messg-integrating-whatsapp-with-csm-whatsapp-cloud__ul_mmx_3lh_shc} | | Message status indicators | WhatsApp automatically handles message delivery and read status indicators according to WhatsApp's standard behavior. The application displays these statuses in the interaction timeline. Status indicators (for users): * Sent: Single gray checkmark (message sent to WhatsApp server) * Delivered: Double gray checkmarks (message delivered to agent's device) * Read: Double blue checkmarks (agent viewed message) {#messg-integrating-whatsapp-with-csm-whatsapp-cloud__ul_uwl_klh_shc} Status indicator (for agent): Sent: Single gray checkmark (message sent to user's device) | | Link previews | URLs in messages automatically generate rich previews with images, titles, and descriptions. | | Opt-in and consent | The integration captures and records customer opt-in and opt-out messages to track communication consent. | | Audio messages | When a customer sends an audio message through WhatsApp, the system renders it as an inline audio player in the conversation thread instead of a downloadable link. The audio player supports play, pause, seek, and volume controls, and displays the total duration and current playback position. You can enable audio rendering using the supports_audio_rich_control custom adapter system property. For details, see [WhatsApp Cloud API provider properties](https://www.servicenow.com/docs/access?context=whatsapp-cloud-api-provider-properties&version=australia&pubname=australia-conversational-interfaces&ft:locale=en-US). | | Customer-initiated conversations | These conversations begin when the customer sends the first message to your business. WhatsApp applies specific rules for messages sent within this interaction window. Messaging window: * Opens when customer sends first message * Remains open for 24 hours from last customer message * Resets to 24 hours with each new customer message * Agent can respond within this window {#messg-integrating-whatsapp-with-csm-whatsapp-cloud__ul_cxf_wlh_shc} Characteristics: * No restrictions on message content * Supports all message types and interactive features * Most common conversation type for customer serviceOpens when customer sends first message {#messg-integrating-whatsapp-with-csm-whatsapp-cloud__ul_dxf_wlh_shc} | | Agent-initiated conversations | These conversations begin when the agent proactively messages the customer. WhatsApp enables outbound initiation only under certain conditions. Requirements: * Customer must have active channel user profile in the application * Customer must have opted in to receive messages * Customer's phone number must be valid and registered on WhatsApp * Must be within 24 hours of customer's last message {#messg-integrating-whatsapp-with-csm-whatsapp-cloud__ul_z55_1mh_shc} | | System-initiated conversations | These conversations begin when an automated workflow sends a WhatsApp message to the customer. Requirements: * Customer must have opted in * Must be within 24 hours of customer's last message {#messg-integrating-whatsapp-with-csm-whatsapp-cloud__ul_zvm_zlh_shc} | [ ] {#messg-integrating-whatsapp-with-csm-whatsapp-cloud__table_vlk_ykh_shc} ## End users and roles {#messg-integrating-whatsapp-with-csm-whatsapp-cloud__section_qjq_cpg_shc} The users with the roles listed in the following table can use the Conversational Integration with WhatsApp (WhatsApp Cloud API) application. {#messg-integrating-whatsapp-with-csm-whatsapp-cloud__table_iwr_2pg_shc__entry__2} | Role | Tasks | |-|-| | admin | Configure and manage the WhatsApp Cloud API integration, including connection settings, routing rules, system properties, and security configurations. | | agent_workspace_user | Accept an ongoing WhatsApp chat conversation with a customer through the WhatsApp service channel in Advanced Work Assignment. | | sn_customerservice_manager | View details of a WhatsApp chat conversation by using interaction records of type Messaging and subtype WhatsApp. | | sn_customerservice.consumer, sn_customerservice.customer | Initiate WhatsApp chat conversations with a Virtual Agent or live agent so that you can search for articles in Communities and Knowledge Management, access service catalogs, and create a customer service case. | [Table 1. Roles required for Conversational Integration with WhatsApp (WhatsApp Cloud API)] {#messg-integrating-whatsapp-with-csm-whatsapp-cloud__table_iwr_2pg_shc} **Related concepts** * [System properties for configuring WhatsApp (WhatsApp Cloud API)](https://www.servicenow.com/docs/2ckDZbhPOLHtKrv7ZHCzHQ "You can configure the system properties for your Conversational Integration with WhatsApp (WhatsApp Cloud API) application so that you can enable secure and authenticated communication.") **Related topics** * [WhatsApp Cloud API provider properties](https://www.servicenow.com/docs/access?context=whatsapp-cloud-api-provider-properties&version=australia&pubname=australia-conversational-interfaces&ft:locale=en-US) * [Configure Conversational Integration with WhatsApp (WhatsApp Cloud API)](https://www.servicenow.com/docs/access?context=messg-direct-whatsapp-configure&version=australia&pubname=australia-conversational-interfaces&ft:locale=en-US) * [Using Conversational Integration with WhatsApp (WhatsApp Cloud API)](https://www.servicenow.com/docs/access?context=messg-direct-whatsapp-using&version=australia&pubname=australia-conversational-interfaces&ft:locale=en-US)