제품 소개

제품 개요

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

Electron

Unity

React Native

C APIs

C++

서버 APIs

Secure authentication with UserSig

RESTful APIs

Webhooks

콘솔 가이드

New Console Introduction

애플리케이션 생성 및 업그레이드

기본 설정

기능 설정

계정 관리

그룹 관리

Official Channel Management

콜백 설정

모니터링 대시보드

Viewing Guide for Resource Packages

Real-Time Monitor

개발 보조 툴

액세스 관리

Advanced Features

FAQ

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

도움말 및 지원