logo
In-app Chat
On this page

Callback on room entered


Overview

With this callback, you can receive the callback on the room entered by the user in real time, and view the information of the room entered 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

Common 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
room_idStringRoom ID.
operator_accountStringThe user ID of the room enter.
new_user_idsArrayThe user IDs of the new room members.
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" : "room_enter",
    "room_id" : "1",
    "nonce": "350176",
    "signature": "signature",
    "operator_account" : "userA",
    "new_user_ids" : ["Tony","Jenny"],
    "timestamp" : 1499676978
}
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 created

Next

Room left