Integration with external services can be possible with webhooks notifications. This lib generate url for webhooks.

Example bot

See example bot​

Webhooks is more simple way for integration. Other libs also use webhooks notifications already: CoinPayments, FreeKassa.

Get Webhook Url

let webhookUrl = Libs.Webhooks.getUrlFor({
  // this command will be runned on webhook
  command: "/onWebhook",
  // this text will be passed to command
  content: "Did you see the cat?",
  // execute for this (current) user
  user_id: user.id,
  // redirect to page with cat after calling webhook
  // you need remove this for external service
  redirect_to: "https://cataas.com/cat"
})
​

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:

let webhookUrl = Libs.Webhooks.getUrlFor({
  // this command will be runned on webhook
  command: "/onWebhook"
})

On command /onWebhook we can get posted content from external service

Bot.sendMessage(inspect(content))
// also you can read data with Bot.getProperty - you need store it before

As a rule, external service must pass useful data on webhook. For example info about payments: order_id, user_id. Use it!