send_notice

Name: LifeBots
Rating: 4.8 (150 reviews)

Send a group notice

Usage

curl -X POST "https://api.lifebots.cloud/api/bot.html" \
  -H "Content-Type: application/json" \
  -d '{
  "action": "send_notice",
  "apikey": "YOUR_API_KEY",
  "botname": "Joe Resident",
  "secret": "bot-secret-123",
  "groupuuid": "b3f87fed-0470-4a7e-b035-100000000000",
  "subject": "Event tonight",
  "text": "Join us at 8pm SLT!",
  "attachment": "5d2d7a1d-0e8e-4f5d-a678-000000000000",
  "dataType": "json"
}'

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

Parameters

Name	Required	Description
`groupuuid` UUID	yes	Group UUID, or the exact name of a group the bot is in. Also accepted as: `group,` `groupId,` `groupName`
`subject` string	yes	Notice subject.
`text` string	yes	Notice body. Also accepted as: `message`
`attachment` UUID	no	Inventory item to attach. Also accepted as: `attachmentId`

Example response

{
  "result": "OK",
  "groupUUID": "b3f87fed-0470-4a7e-b035-100000000000"
}

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

Good to know

The bot needs the Send Notices power.
An attachment that is not a valid UUID is dropped without an error.