# Chat management: Install chat > Connect with customers over chat using our web and mobile SDKs. Source: https://kustomer.kustomer.help/en_us/chat-sdk-SyRjnij0P Last updated: 2026-06-15T13:42:58.307Z Connect with customers over chat using our web and mobile SDKs. You can generate a custom chat code snippet to embed your chat widget on your website and create keysets to turn on push notifications for Android and iOS devices. Learn more about the [Kustomer Chat SDKs](http://developer.kustomer.com/chat-sdk/) for web and mobile in Chat SDK developer documentation. **Who can access this feature?** **User types** Admins can access the Chat page. ### In this article * [Generate the Web SDK code](#generate-code) * [Embed the Web SDK code on your site](#embed-site) * [Embed the Web SDK code to your Knowledge Base](#embed-knowledgebase) * [Turn on mobile SDK push notifications](#mobile-sdk) * [Customize your push notifications content](#customize-notifications) To access the Chat SDK settings for a brand in Kustomer, go to **Apps**![](https://cdn.kustomerhostedcontent.com/media/570fad9d9001bc1000163b28/e01df58f27d25ed0c11568be35b45d5b.png)**\>**  **Chat**. Select the desired brand from the Chat Management page and then go to the **Install Chat** tab. ### Generate the Web SDK code The Web SDK setting automatically generates the standard chat widget code for your brand customized with your brand ID and API key with the correct role to use with the Web SDK. Otherwise, you can manually create and enter an API Key with the  `org.tracking` role. To create an [API key](https://support.kustomer.com/en_us/api-keys-SJs5YTIWX) go to **Settings![](https://cdn.kustomerhostedcontent.com/media/570fad9d9001bc1000163b28/d03668f66574711b594367ed653c6cbb.png)** **\> Security > API Keys**. ![](https://cdn.kustomerhostedcontent.com/media/570fad9d9001bc1000163b28/9d116e0b2cb5c42b3204f2615c5a2a46.png) The following two values are generated: * `data-kustomer-api-key` is the unique API key tied to your Kustomer organization.  * `brandId` is the unique brand ID of the chat widget brand. To learn more, see [Find your brand ID](https://kustomer.kustomer.help/create-and-manage-multiple-brands-ryc8HBZnD#find-brand-id). **Note:** If you don't include a specific brand ID in your Chat SDK, Kustomer automatically assigns the [default brand ID](https://help.kustomer.com/create-and-manage-multiple-brands-ryc8HBZnD#customize). To learn more, see [Multi-brand Chat](https://help.kustomer.com/multi-brand-chat-SkItrr3w#set-brand-id). ### Embed the Web SDK code on your site Copy and paste the generated chat widget code to embed the chat widget on your site. **To embed the code:** 1. Select **Copy Code** to copy the code snippet. Make sure that you have selected the correct brand and that there is an API key in the code. 2. Locate the closing body tag in your HTML file for the website. ![Chat Management: SDK settings, closing body tag in HTML sample, for Kustomer Chat 2.0.](https://cdn.kustomerhostedcontent.com/media/570fad9d9001bc1000163b28/e34c0bfad46d85b508e7e0f0a47afa62.png) 3. Paste the code **before** the closing body tag and save your HTML file. ![Chat Management: SDK settings, sample HTML file with Web SDK code with API key and brand ID, for Kustomer Chat 2.0.](https://cdn.kustomerhostedcontent.com/media/570fad9d9001bc1000163b28/ba816b74e38724b7dd2b19cc6661cd3b.png) Once you save the HTML file with the Web SDK code, you can chat and track visitors with chat on the site. ### Embed the Web SDK code to your knowledge base To learn how to add chat to your knowledge base, see [Add chat to your knowledge base](https://developer.kustomer.com/chat-sdk/v2.0-Web/docs/add-chat-to-knowledge-base) in the Chat SDK developer documentation. ### Turn on mobile SDK push notifications The chat mobile SDKs support push notifications for your mobile apps on Android and iOS. You can create keysets within your Kustomer chat settings to turn on push notifications for Android and iOS devices. For iOS only, you can test push notifications on a simulator before turning them on. **Android** * Before creating a keyset, ask your mobile developer for the Firebase Cloud Messaging Private Key file * For more information, see [Push notifications with FCM](https://developer.kustomer.com/chat-sdk/v2-Android/docs/push-notificatons-with-fcm) in our developer docs. **iOS** * Before creating a keyset, ask your mobile developer for the following information: * Apple Developer account-wide push key as a p8 file * Apple Developer Account Team ID * [Apple Push Notifications service (APNs) Key](https://developer.kustomer.com/chat-sdk/v2-iOS/docs/push-certificates#step-1-create-and-download-your-push-key) * Bundle IDs for each app you want to use with push notifications. * Include bundle IDs for both your Kustomer sandbox and Kustomer production environments. * See [Push Keys and Certificates](https://developer.kustomer.com/chat-sdk/v2-iOS/docs/push-certificates) in our developer docs for more information. See [Push notifications](https://developer.kustomer.com/chat-sdk/v2-iOS/docs/push-notifications) to learn more about implementing and testing push notifications in iOS. ### Customize your push notifications content By default, push notifications show a preview of the chat message content. To prevent sensitive information from appearing in the push notification preview, you can use this setting to redact it. For example, you can use this setting to replace the preview with a message that reads "You received a secure message". ![](https://cdn.kustomerhostedcontent.com/media/570fad9d9001bc1000163b28/f1bb13149fafed2344b11764ee80fc01.gif) You can customize your push notifications by adding an emoji, personalizing the notification with contextual data (such as a customer's name) with dynamic text, or using a snippet for multi-lingual support. For notifications to display properly, we recommend a maximum length of 45 characters for the title and 128 for the body. **Note:** Selecting **Reset to Default** removes any custom overrides. Notifications will show the message preview instead. ### **Troubleshoot "blocked-content" errors on chat messages** If chat messages fail with a `400 blocked-content` or `ISP block` error, this typically indicates an outdated mobile SDK version. Although the error message references ISP blocking (which is normally associated with email), it appears on chat messages when the SDK version is no longer compatible. To resolve this: 1. Check your current SDK version against the latest release: * ****Android:**** Current version 4.5.0 * ****iOS:**** Current version 7.2.0 2. Update your mobile SDK to the latest version. 3. Rebuild and redeploy your app. ### Troubleshoot chat widget not loading If the Kustomer chat widget does not appear on your website, follow these steps to identify the cause. ### **Verify the script is loaded** 1. Open your browser developer tools (press F12 or right-click and select ****Inspect****). 2. In the ****Console**** tab, type `Kustomer` and press ENTER. If the Kustomer object is defined, the script loaded successfully. If it returns `undefined`, the script did not load. ### **Check script placement** The Kustomer chat snippet must be placed directly in your site's HTML. If you load the snippet through a tag manager (such as Google Tag Manager), the script may fail to attach properly. * Place the Kustomer snippet directly in your site theme or page template, inside the `` tag. * If you use Shopify, add the snippet to your Shopify theme files rather than through a tag manager. ### **Verify Kustomer.start() is called correctly** The `Kustomer.open()` method only works after `Kustomer.start()` completes. Use the callback to confirm initialization: ` ` `Kustomer.start({}, function() {`   `console.log('Kustomer chat initialized');` `});` ### **Check additional settings** * ****Authorized domains:**** From the left navigation, click ****Settings****, then select ****Chat**** and review ****Authorized Domains****. Your website domain must be listed. * ****Business hours:**** If the ****Hide Chat**** setting is enabled outside of business hours, the widget will not appear during off-hours. * ****Browser console errors:**** Check for JavaScript errors in the browser console that may indicate conflicts with other scripts on the page. * ****Ad blockers:**** Some browser extensions block third-party chat scripts. Test in an incognito window with extensions disabled.