--- updatedAt: 2026-10-08T09:12:22.000Z agentTools: siteIndex: https://documentation.bloomreach.com/llms.txt projectIndex: https://documentation.bloomreach.com/engagement/llms.txt --- # Sinch Mobile Messaging Integrate [WhatsApp](https://documentation.bloomreach.com/engagement/docs/whatsapp) and [RCS](https://documentation.bloomreach.com/engagement/docs/rcs) mobile messaging channels using Sinch's cross-channel solution to send and receive messages and engage in [two-way conversations](https://documentation.bloomreach.com/engagement/docs/two-way-sms-messaging-and-keyword-auto-responses). ## Set up the integration To set up your **Sinch Mobile Messaging** provider integration: 1. Go to **Data & Assets **>** Integrations **>** Add new integration**. 2. Search for **"Sinch Mobile Messaging"** and click **Add integration**. [block:image]{"images":[{"image":["https://files.readme.io/773fcba6eb126881c0dcc5fda6404d8d4e9c3f58c3b956725e407e5b49462589-add-sinch-mm-integration.png","",""],"align":"center"}]}[/block] 3. The integration settings page appears. Populate the fields shown using the account details your CSM or CS team provided. 1. **Project ID:** The unique ID associated with your Sinch account. 2. **App ID:** Represents the ID of the application that initiates the message. 3. **Access Key:** Your unique Sinch Access Key ID. You can find it on the Sinch Access Keys page. 4. **Access Secret:** Your unique Sinch Access Key Secret. It is only displayed once when you create a new key. 5. **Endpoint region:** Choose your region based on your domain location and data protection requirements. Options are **EU** and **US**. 4. Click **Save integration** button to complete your integration. [block:image]{"images":[{"image":["https://files.readme.io/4dd5897105d8a878298693d102bd26f0e29f9bfd8390ec156902cafcff77a1c4-set-up-sinch-mm-integration.png","",""],"align":"center","border":true}]}[/block] 5. Copy the callback URL in the **Two-way mobile messaging** field. This URL must be set up in your Sinch account to receive incoming messages.![](https://files.readme.io/3d0b9e003dc9000d171b0fd0c3d108ad19c92d0397f82109723a20ffcfe42263-sinch-mm-callback-url.png) 6. Provide the callback URL to your CSM. They will help set this up on the Sinch side. 7. Start using mobile messaging integration and configure any project settings. ## Sender profile To use the integration, set it up as a sender profile. For details, read the [SMS](https://documentation.bloomreach.com/engagement/docs/sms-campaigns#set-up-sender-profiles) or [MMS](https://documentation.bloomreach.com/engagement/docs/mms-campaigns#set-up-sender-profiles) campaign documentation. The process is the same for MMS and SMS. Your user role must have admin rights to set default provider integrations. ### RCS RCS shares some settings with MMS and SMS. To set the provider, go to **Project Settings** > **Channels** > **SMS / MMS / RCS**. ### WhatsApp Set the default WhatsApp integration by going to **Project Settings** > **Channels** > **Mobile messaging > WhatsApp messaging integration**. This default provider will be preselected in any new WhatsApp nodes you create. ## Event tracking and reports By default, event tracking for mobile messaging is mapped to the `campaign` event with the `action_type` specifying the channel (`whatsapp` or `rcs`). You can optionally map events to a different event name in **Project settings > Campaigns > Mapping > Campaign events**. ### Mobile message event properties | Event property | Value | Description | | :-------------- | :--------------------------------------- | :--------------------------------------------------------------------------- | | message\_type | "campaign" | n/a | | action\_type | "whatsapp" or "rcs" | n/a | | campaign\_id | for example: "123546" | Generated `campaign_id` for the mobile message | | recipient | for example: "004211111111111" | Phone number of destination recipient | | sender | for example: "123456" | Sender ID or number used to send the mobile message | | sent\_timestamp | for example: "1723484965.922874" | Timestamp of when the mobile message was sent | | status | for example: "delivered" | Message delivery statuses reported in real-time | | error | for example: "RECIPIENT\_NOT\_REACHABLE" | Error explanations in cases of messages with statuses of rejected or failed. | Refer to [Two-way messaging and keywords auto responses - Event tracking](two-way-sms-messaging-and-keyword-auto-responses#event-tracking) for more details on event tracking for two-way messaging. ### Delivery and read reports For each mobile message you send, the integration provides real-time **Delivery reports** and **Read/seen reports**. These reports help you track when messages are sent, delivered, and seen, offering clarity on message delivery and customer reactions for campaign evaluation. * **Delivery reports:** In case of a failure, you will receive a delivery failure status event immediately and an error explanation indicating the reason behind it. * **Read/seen reports:** In case the message was delivered successfully, this report will additionally inform you whether the recipient has seen the message. To receive read reports, you must enable receiving read receipts in your **WhatsApp** > **Settings** > **Privacy section**. When disabled, both personal and business accounts have read indicators disabled. In cases of messages returning `rejected` or `failed` statuses, the integration provides error explanations in the `error` property of the `campaign` event. For more information on error explanations, see the list of [Sinch Error Codes](https://developers.sinch.com/docs/conversation/callbacks/#error-codes). ### Message statuses Mobile message statuses are as follows: | Status value | Description | | :---------------- | :-------------------------------------------------------------------------------------------- | | enqueued | Enqueued the message to the service provider | | enqueued\_failed | Could not enqueue the message to the service provider | | delivered | The message was successfully delivered to the customer's device | | sent | The message was submitted to the service provider for delivery | | failed | The message was not delivered, typically due to a failure or temporary problem | | rejected | The service provider rejected message delivery | | incoming\_message | Inbound message or reply from a campaign recipient (requires two-way messaging to be enabled) | | read | The customer read or saw the message | ## Terms and conditions If Bloomreach provides Sinch services to the customer, the customer hereby agrees to accept and comply with the following terms and conditions relating to the use of services: * [General terms and conditions](https://sinch.com/legal/terms-and-conditions/other-sinch-terms-conditions/general-terms-and-conditions/) * [Messaging supplemental terms and conditions](https://sinch.com/legal/terms-and-conditions/other-sinch-terms-conditions/messaging-supplemental-terms-and-conditions/)