---
schema_version: "1"
id: 014b31d5d5b363e4dba351d715d9602cef9549734264c3b848de86c625066c15
title: Configure a Custom Client Deployment for Enhanced Chat
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/service/264-0-0/miaw_deployment_custom.md
canonical_url: https://help.salesforce.com/s/articleView?id=service.miaw_deployment_custom.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 62b39dfa2552f2e8e6105b6778e6c9502a2f50ad1046ae3cd39ede05fdedcc62
description: To enjoy granular control of your web or mobile app messaging experience, create a custom client deployment for Enhanced Chat. While our web or mobile deployments rely on our web client and mobile SDK, a custom client deployment lets you deliver a highly customized UI with the Enhanced Chat REST API.
products:
  - Service Cloud
  - Digital Engagement
release: "264"
---
# Configure a Custom Client Deployment for Enhanced Chat

To enjoy granular control of your web or mobile app messaging experience, create a custom client deployment for Enhanced Chat. While our web or mobile deployments rely on our web client and mobile SDK, a custom client deployment lets you deliver a highly customized UI with the Enhanced Chat REST API.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <tbody>
          <tr class="">
            <td class="slds-cell-wrap" colspan="2" style="vertical-align:top;"><a href="https://help.salesforce.com/s/articleView?id=service.messaging_editions.htm&amp;type=5&amp;language=en_US" target="_blank">View supported editions.</a></td>

          </tr>
          <tr class="">
            <td class="slds-cell-wrap" style="vertical-align:top;">
              <a name="miaw_deployment_custom__d955e335"><!-- --></a><span style="vertical-align:text-bottom;display:inline-block;"><img style="margin-bottom:0;" id="miaw_deployment_custom__d955e335" src="https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-service-support_channels-264-0-0-production-enus/f3c4b3d2-ff86-4f7c-9fe2-3d8b23d35109/resources-global/_corporate/images/checkmark.png" alt="Checkmark"></span>
              <strong>This article applies to:</strong>
            </td>

            <td class="slds-cell-wrap" style="vertical-align:top;">Enhanced In-App Chat and Enhanced Web Chat channels</td>

          </tr>
          <tr class="">
            <td class="slds-cell-wrap" style="vertical-align:top;">
              <span style="vertical-align:text-bottom;display:inline-block;"><img style="margin-bottom:0;" src="https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-service-support_channels-264-0-0-production-enus/f3c4b3d2-ff86-4f7c-9fe2-3d8b23d35109/resources-global/_corporate/images/crossmark.png" alt="X icon"></span>
              <strong>This article doesn’t apply to:</strong>
            </td>

            <td class="slds-cell-wrap" style="vertical-align:top;">Enhanced WhatsApp, Enhanced Facebook Messenger, Standard and Enhanced SMS,
              Enhanced Apple Messages for Business, Enhanced LINE, and Bring Your Own
              Channel</td>

          </tr>
        </tbody>
      </table> <table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d141625e98">User Permissions</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions" class="slds-cell-wrap" style="vertical-align:top;" headers="d141625e98 ">To set up this feature:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d141625e98 ">
              <p>Customize Application </p>
              <p>AND</p>
              <p style="margin-bottom:0;">Modify Metadata Through Metadata API
                Functions</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="User Permissions" class="slds-cell-wrap" style="vertical-align:top;" headers="d141625e98 ">To modify permission sets and profiles:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d141625e98 ">Manage Profiles and Permission Sets</td>

          </tr>
        </tbody>
      </table>

The Enhanced Chat REST API can be used to create conversations that house messaging sessions, generate access tokens, and send messages and files. You can also integrate an external bot solution or partner-supported messaging solutions.

In this stage of Enhanced Chat setup, publish a deployment, customize your deployment, and reference the deployment when invoking public REST API endpoints.

## Publish a Deployment

Create a custom client deployment that can be referenced in public REST API endpoints.

1. Complete the steps in [Prepare a Salesforce Org for Enhanced Chat](https://help.salesforce.com/s/articleView?id=service.miaw_prepare_org_1.htm&release=264.0.0&type=5 "Build a strong foundation for your new messaging channel and deployment."):
    1. Configure Omni-Channel.
    2. Create an Omni-Channel flow to route messages.
    3. Create an Enhanced Chat channel on the Messaging Settings page. This will create an Enhanced Chat deployment automatically, but it’s not a custom client deployment. Ignore the deployment that gets created in this process.
    4. Configure the Service Console to support messaging.
2. From Setup, in the Quick Find box, enter Embedded Service Deployments, and select **Embedded Service Deployments**.
3. Click **New Deployment**.
4. Select **Enhanced Chat**, and then click **Next**.
5. Click **Custom Client**, and then click **Next**.
6. Name your Embedded Service deployment, and customize the API name if desired.
7. Select the Enhanced Chat channel that you created earlier. If you haven’t created one yet, go to the Messaging Settings page and do so.
8. Save your work.
9. Create and publish your new deployment, which takes a few minutes. Don’t navigate away from the page until it’s complete.

## Customize Your Deployment

On the Embedded Service Deployment Settings page shown after your deployment is saved, you can customize your deployment. 

1. Click the **Push Notifications** tile to configure push notifications if it will be used with a mobile app. See [Set Push Notifications for Enhanced In-App Chat](https://help.salesforce.com/s/articleView?id=service.miaw_inapp_push.htm&type=5&language=en_US).
2. Click the **Pre-Chat** tile to prepare a pre-chat form that customers must complete before messaging with a service rep. See [Customize Pre-Chat for Enhanced Chat](https://help.salesforce.com/s/articleView?id=service.miaw_custom_prechat_3.htm&language=en_US).

After you edit a deployment, publish it again by clicking **Publish** on the settings page.

## Reference Your Deployment with the Enhanced Chat REST API

Supply your deployment name when invoking a public endpoint from the [Enhanced Chat REST API](https://developer.salesforce.com/docs/service/messaging-api/overview).