製品の説明

製品の概要

Basic Concepts

ユースケース

機能概要

アカウントシステム

ユーザープロフィールとリレーションシップチェーン

メッセージ管理

グループシステム

Official Account

Audio/Video Call

使用制限

購入ガイド

課金概要

価格説明

Purchase Instructions

Renewal Guide

支払い延滞説明

Refund Policy

ダウンロードセンター

SDK & Demo ソースコード

更新ログ

シナリオプラン

Live Streaming Setup Guide

AI Chatbot

極めて大規模なエンターテインメントコラボレーションコミュニティ

Discord実装ガイド

ゲーム内IM統合ガイド

WhatsApp Channel-style Official Account Integration Solution

Send Red Packet

Firewall Restrictions

クライアントAPIs

SDK API（Web）

Android

iOS & macOS

Swift

Flutter

SDK API（Electron）

SDK APIs (Unity)

SDK API（React Native）

C APIs

C++

サービス側 APIs

UserSigの生成

RESTful APIs

Webhooks

コンソールガイド

New Console Introduction

アプリケーションの作成とアップグレード

基本設定

機能設定

アカウント管理

グループ管理

Official Channel Management

コールバック設定

監視ダッシュボード

Viewing Guide for Resource Packages

Real-Time Monitor

補助ツールの開発

アクセス管理

Advanced Features

よくあるご質問

uni-app FAQs

購入に関する質問

SDKに関する質問

アカウント認証に関する質問

ユーザープロファイルとリレーションシップチェーンに関する質問

メッセージに関する質問

グループに関する質問

ライブ配信グループに関する質問

ニックネームプロフィール画像に関連した問題

一般的なリファレンス

Service Level Agreement

セキュリティコンプライアンス認証

IM ポリシー

プライバシーポリシー

データプライバシーとセキュリティ契約

エラーコード

お問い合わせ

Callback After Reminding a Chatbot in a Group

PDF

フォーカスモード

フォントサイズ

最終更新日: 2025-07-24 17:02:48

Feature Description
After the "chatbot event callback" is enabled in the console, the App backend will receive the callback of a reminder message when a user reminds a chatbot in a group.
Must-Knows
To enable this callback, you need to configure the callback URL and turn on the switch corresponding to this callback. For the configuration method, see Webhook Configuration.
The direction of the callback is that the Chat backend sends HTTP POST requests to the App backend.
After receiving a callback request, the App backend needs to verify whether the value of the SDKAppID parameter in the request URL is its own SDKAppID.
For other security-related matters, see Security Considerations in Webhook Overview.
Callback Triggering Scenarios
A user reminds a chatbot in a group. (The callback is not triggered if all group members are reminded.)
Callback Triggering Timing
The callback is triggered after a user reminds a chatbot in a group.
API Description
Sample Request URL
In the following example, the callback URL configured for the App is https://www.example.com.
Example:
https://www.example.com?SdkAppid=$SDKAppID&CallbackCommand=$CallbackCommand&contenttype=json&ClientIP=$ClientIP&OptPlatform=$OptPlatform
Request Parameters
Parameter
Description
https
The request protocol is HTTPS, and the request method is POST.
www.example.com
Callback URL.
SdkAppid
SDKAppID assigned to an application when the application is created in the Chat console.
CallbackCommand
The value is fixed as Bot.OnGroupMessage.
contenttype
The value is fixed as json.
ClientIP
Client IP address. For example, 127.0.0.1.
OptPlatform
Client platform. For the valid values, see the description of the OptPlatform parameter in Webhook Protocol in Webhook Overview.
Sample Request Packet
{
    "CallbackCommand": "Bot.OnGroupMessage", // Callback command.
    "GroupId": "@TGS#2J4SZEAEL", // Group ID.
    "Type": "Public", // Group type.
    "From_Account": "jared", // Sender.
    "Operator_Account":"admin", // Initiator of the request.
    "Random": 123456, // Random number.
    "MsgSeq": 123, // Message serial number.
    "MsgTime": 1490686222, // Message sending timestamp.
    "OnlineOnlyFlag": 1, // Online message. 1: yes; 0: no. For live streaming groups, this attribute is ignored, and the default value 0 is used.
    "MsgBody": [ // Message body. See the message object TIMMessage.
        {
            "MsgType": "TIMTextElem", // Text.
            "MsgContent": {
                "Text": "@@RBT#001 hello"
            }
        }
    ],
    "AtRobots_Account": [ "@RBT#001" ], // List of reminded chatbots. Users can remind more than one chatbot if multiple chatbots exist in the group.
    "CloudCustomData": "your cloud custom data",
    "EventTime": 1670574414123// Event trigger timestamp, in milliseconds.        
}
Request Packet Fields
Field
Type
Description
CallbackCommand
String
Callback command.
GroupId
String
ID of the group with the group message.
Type
String
Type of the group with the group message. For example, Public. See Group Types in Group System for details.
From_Account
String
User ID of the message sender.
Operator_Account
String
User ID of the request initiator, which can be used to determine whether the request is initiated by the administrator.
Random
Integer
32-bit random number in the message request.
MsgSeq
Integer
Message serial number, which uniquely identifies a message. 
Group messages are sorted by MsgSeq. A message is sent more recently if its MsgSeq value is larger.
MsgTime
Integer
Message sending timestamp, corresponding to the backend server time.
OnlineOnlyFlag
Integer
Online message. 1: yes; 0: no. For live streaming groups, this attribute is ignored, and the default value 0 is used.
MsgBody
Array
Message body. See Message Formats for details.
AtRobots_Account
Array
List of reminded chatbots. Users can remind more than one chatbot if multiple chatbots exist in the group.
CloudCustomData
String
Custom message data. (It is saved on the cloud and will be sent to the recipient. It can still be obtained after Chat is uninstalled and then reinstalled.)
TopicId
String
Topic ID. If this parameter is used, messages are related to the topic. This parameter applies only to community groups that support topics.
EventTime
Integer
Event trigger timestamp, in milliseconds.
Sample Response Packet
The response packet is returned after the App backend synchronizes the data.
{
    "ActionStatus": "OK",
    "ErrorInfo": "",
    "ErrorCode": 0 // Ignore the callback result.
}
Response Packet Fields
Field
Type
Required
Description
ActionStatus
String
Required
Request processing result. OK: processing successful; FAIL: processing failed.
ErrorCode
Integer
Required
Error code. The value 0 indicates that the callback result is ignored.
ErrorInfo
String
Required
Error message.
References
﻿Webhook Overview﻿
REST API: Sending Ordinary Messages in a Group﻿
﻿

ヘルプとサポート

この記事はお役に立ちましたか？

営業担当者にお問い合わせいただくかチケットを提出してサポートを求めることができます。

フィードバック

Parameter	Description
https	The request protocol is HTTPS, and the request method is POST.
www.example.com	Callback URL.
SdkAppid	SDKAppID assigned to an application when the application is created in the Chat console.
CallbackCommand	The value is fixed as Bot.OnGroupMessage.
contenttype	The value is fixed as json.
ClientIP	Client IP address. For example, 127.0.0.1.
OptPlatform	Client platform. For the valid values, see the description of the OptPlatform parameter in Webhook Protocol in Webhook Overview.

Field	Type	Description
CallbackCommand	String	Callback command.
GroupId	String	ID of the group with the group message.
Type	String	Type of the group with the group message. For example, Public. See Group Types in Group System for details.
From_Account	String	User ID of the message sender.
Operator_Account	String	User ID of the request initiator, which can be used to determine whether the request is initiated by the administrator.
Random	Integer	32-bit random number in the message request.
MsgSeq	Integer	Message serial number, which uniquely identifies a message. Group messages are sorted by MsgSeq. A message is sent more recently if its MsgSeq value is larger.
MsgTime	Integer	Message sending timestamp, corresponding to the backend server time.
OnlineOnlyFlag	Integer	Online message. 1: yes; 0: no. For live streaming groups, this attribute is ignored, and the default value 0 is used.
MsgBody	Array	Message body. See Message Formats for details.
AtRobots_Account	Array	List of reminded chatbots. Users can remind more than one chatbot if multiple chatbots exist in the group.
CloudCustomData	String	Custom message data. (It is saved on the cloud and will be sent to the recipient. It can still be obtained after Chat is uninstalled and then reinstalled.)
TopicId	String	Topic ID. If this parameter is used, messages are related to the topic. This parameter applies only to community groups that support topics.
EventTime	Integer	Event trigger timestamp, in milliseconds.

Field	Type	Required	Description
ActionStatus	String	Required	Request processing result. OK: processing successful; FAIL: processing failed.
ErrorCode	Integer	Required	Error code. The value 0 indicates that the callback result is ignored.
ErrorInfo	String	Required	Error message.

tencent cloud

Chat

Callback After Reminding a Chatbot in a Group

Feature Description

Must-Knows

Callback Triggering Scenarios

Callback Triggering Timing

API Description

Sample Request URL

Request Parameters

Sample Request Packet

Request Packet Fields

Sample Response Packet

Response Packet Fields

References

ヘルプとサポート