get_http_callback

Name: LifeBots
Rating: 4.8 (150 reviews)

List the bot's webhooks, or look one up

Usage

curl -X POST "https://api.lifebots.cloud/api/bot.html" \
  -H "Content-Type: application/json" \
  -d '{
  "action": "get_http_callback",
  "apikey": "YOUR_API_KEY",
  "botname": "Joe Resident",
  "secret": "bot-secret-123",
  "dataType": "json"
}'

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

Parameters

Name	Required	Description
`id` string	no	Webhook id to look up.
`url` string	no	Webhook URL to look up (used when id is not given).

Returns

Field	Type	Description
`callbacks`	array	Without id/url: every webhook, {id, url, events}.
`lastSuccessAt`	date	With id/url: when the last delivery succeeded. The id, url and events fields are returned too.

Example response

{
  "success": true,
  "callbacks": [
    {
      "id": "cb_8f2a",
      "url": "https://yourapp.com/hooks/YOUR_SECRET",
      "events": [
        "instant_message",
        "group_invite"
      ]
    }
  ]
}

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

Good to know

The list form answers with success:true and no result field (result is added as OK by the API).