track_avatars

Starts watching up to a list of avatars. Changes (movement, sitting, arriving, leaving) are sent as avatar_tracker_update webhook events.

Usage

1
2
3
4
5
6
7
8
9
10

curl -X POST "https://api.lifebots.cloud/api/bot.html" \
  -H "Content-Type: application/json" \
  -d '{
  "action": "track_avatars",
  "apikey": "YOUR_API_KEY",
  "botname": "Joe Resident",
  "secret": "bot-secret-123",
  "avatars": "a2e76fcd-9360-4f6d-a924-000000000000",
  "dataType": "json"
}'

Every request also needs apikey, botname and secret — see Authentication.

Parameters

Example response

1
2
3
4

{
  "result": "OK",
  "tracking": 1
}

With dataType=json. A failure has result: "FAIL" and the reason in resulttext — see Responses & errors.

Good to know

• Each call replaces the whole list.
• Events are sent only when something changes, checked twice a second. Register a webhook with events=all to receive them.