Webhooks lib

Search…
Webhooks lib
Integration with external services can be possible with webhooks notifications. This lib generate url for webhooks.
Example bot
See example bot​
From wikipedia: a webhook is a method of augmenting or altering the behavior of bot, with custom callbacks.
These callbacks may be maintained, modified, and managed by third-party users and developers who may not necessarily be affiliated with the originating website or application.
 The term "webhook" was coined by Jeff Lindsay in 2007 from the computer programming term hook.
Webhooks is more simple way for integration. Other libs also use webhooks notifications already: CoinPayments, FreeKassa.
Get Webhook Url
1
// user's webhook
2
let webhookUrl = Libs.Webhooks.getUrlFor({
3
  // this command will be runned on webhook
4
  command: "/onWebhook",
5
  // this text will be passed to command
6
  content: "Did you see the cat?",
7
  // execute for this (current) user
8
  user_id: user.id,
9
  // redirect to page with cat after calling webhook
10
  // you need remove this for external service
11
  redirect_to: "https://cataas.com/cat"
12
})
13
​
14
Bot.inspect(webhookUrl);
Copied!
This code will generate Webhook url. 
After loading page via this url:
web page with cat will be loaded (Thank for cat to https://cataas.com)
command /onWebhook will be execute on Bot for user with user.id
content "Did you see the cat?" will be passed for command /onWebhook
 More useful for external services
As a rule, the webhook URL must be set from the admin panel on the external service. So we can not set it for just one user: 
1
// global bot webhook
2
let webhookUrl = Libs.Webhooks.getUrlFor({
3
  // this command will be runned on webhook
4
  command: "/onWebhook"
5
})
Copied!
Webhooks can be with GET and POST methods only. All passed data contains on content variable
On command /onWebhook we can get posted content from external service
1
// for user's webhook
2
Bot.sendMessage(inspect(content))
3
// also you can read data with Bot.getProperty - you need store it before
Copied!
As a rule, external service must pass useful data on webhook. For example info about payments: order_id, user_id. Use it!
On command /onWebhook for bot's webhook we do not have user:
1
// for bot's webhook
2
​
3
// this is not worked - because no current user on bot's webhook
4
// Bot.sendMessage(inspect(content))
5
​
6
// make any not specific user code
7
// ...
8
​
9
// We can pass user_id in content (it is depend from external service)
10
Bot.run({ command: "/userCommand", user_id: JSON.parse(content).user_id })
11
​
12
// in /userCommand we can now use Bot.sendMessage function
13
​
Copied!
​
Last modified 1yr ago
Copy link
Contents
Example bot
Get Webhook Url
More useful for external services