logo
In-app Chat
On this page

Callback on group created


Overview

With this callback, you can receive the callback on the group created by the user in real time, and view the information of the group created by the user.

Callback description

  • Request method: POST.
    Note

    The callback data format is JSON, and you need to perform UrlDecode decoding on it.

  • Request URL: The corresponding callback endpoint set in the ZEGOCLOUD Admin Console
  • Protocol: HTTPS/HTTP. HTTPS is recommended.

Callback parameters

ParameterTypeDescription
appidStringThe unique identifier of the App.
eventStringThe callback event. The return value of this callback is group_create.
timestampIntThe server time in Unix timestamp when the group is created.
nonceStringA random number, used to calculate the signature.
signatureStringThe verification string. For details, see Authenticating server-to-server callbacks
ParametersTypeDescription
group_idStringThe group ID.
operator_accountStringThe user ID of the group creator.
owner_accountStringThe user ID of the group owner.
group_nameStringThe group name.
attributesArray of ObjectThe attributes set when the group is created.
└ keyStringThe attribute Key.
└ valueStringThe attribute Value.
user_idsArrayThe user IDs of all group members when the group is created.
Note

We recommend that you convert some parameters to Int for logical processing. The relevant fields include appid and nonce.

Sample code

Untitled
{
    "appid" : "1",
    "event" : "group_create",
    "group_id" : "1",
    "nonce": "350176",
    "signature": "signature",
    "operator_account" : "userA",
    "owner_account" : "operator_account",
    "group_name" : "group_name",
    "attributes" : [
        {
            "key" : "UserSet1",
            "value" : "UserGet1"
        }
        {
            "key" : "UserSet2",
            "value" : "UserGet2"
        }
    ],
    "timestamp" : 1499676978,
    "user_ids" : ["Tony","Jenny"]
}
1
Copied!

Return codes

A status code of 2XX (such as 200) indicates success, and other responses indicate failure.

Callback retry policy

If the ZEGOCLOUD server does not receive a response, or the HTTP status code received by the ZEGOCLOUD server is not 2xx (such as 200), it will retry with intervals of 2s, 4s, 8s, 16s, and 32s respectively. If the retry still fails after an interval of 32s, it will no longer retry.

Previous

Room destroyed

Next

Group joined