tencent cloud

This document describes how to quickly integrate the Tencent Cloud IM SDK into your web or Mini Program project.

• You can integrate the IM SDK into your web project by using npm (recommended) or script.
• You can integrate the IM SDK into your Mini Program project by using npm.
• You can integrate the SDK upload plugin for faster and safer upload of rich text message resources. For more information, see SDK Upload Plugin Integration (Web & Mini Program).

Preparations

• You have already created an IM app and obtained the SDKAppID.
• You have obtained the key information.

Relevant Documents

• Running the IM SDK (Mini Program) TUIKit
• Running the IM SDK (Web) Demo
• SDK Upload Plugin Integration (Web & Mini Program)

Integrating SDK

Integrating via npm (recommended)

Use npm to install appropriate IM SDK dependencies in your project.

Web project

// IM Web SDK
// SDK v2.11.2 and later versions support WebSocket, and you are advised to integrate such SDK versions. SDK v2.10.2 and earlier versions use HTTP.
npm install tim-js-sdk --save
// The Tencent Cloud IM upload plugin is required to send messages such as images and files.
npm install tim-upload-plugin --save

Note：

If a problem occurs during dependency synchronization, change the npm source and try again.

>// Change cnpm source
>npm config set registry http://r.cnpmjs.org/
>

Import the module into the project script.

// SDK v2.11.2 and later versions support WebSocket, and you are advised to integrate such SDK versions. SDK v2.10.2 and earlier versions use HTTP.
import TIM from 'tim-js-sdk';
import TIMUploadPlugin from 'tim-upload-plugin';
let options = {
 SDKAppID: 0 // Replace `0` with the `SDKAppID` of your IM app during access.
};
// Create an SDK instance. The `TIM.create()` method returns the same instance for the same `SDKAppID`.
let tim = TIM.create(options); // The SDK instance is usually represented by `tim`.
// Set the SDK log level for output. For more information on each level, see <a href="https://web.sdk.qcloud.com/im/doc/en//SDK.html#setLogLevel">setLogLevel API Description</a>.
tim.setLogLevel(0); // Common level. You are advised to use this level during connection as it covers more logs.
// tim.setLogLevel(1); // Release level, at which the SDK outputs important information. You are advised to use this log level in a production environment.
// Register the Tencent Cloud IM upload plugin.
tim.registerPlugin({'tim-upload-plugin': TIMUploadPlugin});

Mini Program project

// IM Mini Program SDK
// SDK v2.11.2 and later versions support WebSocket, and you are advised to integrate such SDK versions. SDK v2.10.2 and earlier versions use HTTP.
npm install tim-wx-sdk --save
// The Tencent Cloud IM upload plugin is required to send messages such as images and files.
npm install tim-upload-plugin --save

Note：

If a problem occurs during dependency synchronization, change the npm source and try again.

>// Change cnpm source
>npm config set registry http://r.cnpmjs.org/
>

Import modules to the project script and initialize the modules.

// SDK v2.11.2 and later versions support WebSocket, and you are advised to integrate such SDK versions. SDK v2.10.2 and earlier versions use HTTP.
import TIM from 'tim-wx-sdk';
import TIMUploadPlugin from 'tim-upload-plugin';
let options = {
 SDKAppID: 0 // Replace `0` with the `SDKAppID` of your IM app during access.
};
// Create an SDK instance. The `TIM.create()` method returns the same instance for the same `SDKAppID`.
let tim = TIM.create(options); // The SDK instance is usually represented by `tim`.
// Set the SDK log level for output. For more information on each level, see <a href="https://web.sdk.qcloud.com/im/doc/en//SDK.html#setLogLevel">setLogLevel API Description</a>.
tim.setLogLevel(0); // Common level. You are advised to use this level during connection as it covers more logs.
// tim.setLogLevel(1); // Release level, at which the SDK outputs important information. You are advised to use this log level in a production environment.
// Register the Tencent Cloud IM upload plugin.
tim.registerPlugin({'tim-upload-plugin': TIMUploadPlugin});

For more information on how to initialize the SDK and use APIs, see SDK Initialization.

Integrating via script

Import the SDK to your project by using the script tag and initialize the SDK.

<!-- `tim-js.js` and `tim-upload-plugin.js` can be obtained at https://github.com/tencentyun/TIMSDK/tree/master/Web/Demo/sdk. -->
<script src="./tim-js.js"></script>
<script src="./tim-upload-plugin.js"></script>
<script>
var options = {
SDKAppID: 0 // Replace `0` with the `SDKAppID` of your IM app during access.
};
// Create an SDK instance. The `TIM.create()` method returns the same instance for the same `SDKAppID`.
var tim = TIM.create(options);
// Set the SDK log output level. For details on each level, see **setLogLevel API description**.
tim.setLogLevel(0); // Common level. You are advised to use this level during connection as it covers more logs.
// tim.setLogLevel(1); // Release level, at which the SDK outputs important information. You are advised to use this log level in a production environment.
// Register the Tencent Cloud IM upload plugin.
tim.registerPlugin({'tim-upload-plugin': TIMUploadPlugin});
// Next, you can use `tim` to bind events and build IM apps.
</script>

Note：

Set the SDK log output level. For more information on each level, see setLogLevel API Description.

For more information on how to initialize the SDK and use APIs, see SDK Initialization.

Relevant resources

• SDK Update Log
• SDK API Documentation
• FAQs
• IM Web Demo
• Download URL of Tencent Cloud IM Upload Plugin

FAQs

1. What should I do if I want to launch a Mini Program and deploy a production environment?
Configure domain names by navigating to WeChat Official Accounts Platform -> Development -> Development Settings -> Server Domain Name:

Add the following domain names to request valid domain names:

SDK v2.11.2 and later versions support WebSocket, and the following domain names must be added for them:

Domain Name	Description	Required
wss://wss.im.qcloud.com	Web IM service domain	Yes
wss://wss.tim.qq.com	Web IM service domain	Yes
https://web.sdk.qcloud.com	Web IM service domain	Yes
https://webim.tim.qq.com	Web IM service domain	Yes

SDK v2.10.2 and earlier versions use HTTP, and the following domain names must be added for them:

Domain Name	Description	Required
https://webim.tim.qq.com	Web IM service domain	Yes
https://yun.tim.qq.com	Web IM service domain	Yes
https://events.tim.qq.com	Web IM service domain	Yes
https://grouptalk.c2c.qq.com	Web IM service domain	Yes
https://pingtas.qq.com	Web IM statistical domain	Yes

Add the following domain name to the uploadFile valid domain name:

Domain Name	Description	Required
https://cos.ap-shanghai.myqcloud.com	File upload domain	Yes

Add the following domain name to downloadFile valid domain name:

Domain Name	Description	Required
https://cos.ap-shanghai.myqcloud.com	File download domain	Yes