WebhookLib

The WebhookLib has one method named getUrl() that returns a webhook URL based on the provided parameters. Only $Bot and some $Libs functions work on webhook command

Usage

Here is the usage documentation for the getUrl() method:

<?php
$Libs->WebhookLib->getUrl($command, $user_id, $options, $redirect_to);

$command: The name of the webhook command to execute.
$user_id: The ID of the user who triggered the webhook.
$options (optional): An array of additional options to pass to the webhook.
$redirect_to (optional): A URL to redirect the user to after the webhook is executed.

Example 1:

Get webhook url for the current user without $options and $redirect_to parameters

<?php
$webhook = $Libs->WebhookLib->getUrl("/onWebhook", $user_id);
$User->sendMessage($webhook);

Example 2:

Full usage example of this webhook lib

<?php
// set command and user_id
$command = "/onWebhook";
$user_id = $user_id; // for current user or replace it with the another user telegram id

// build URL with options and redirect_to parameters
$options = array('category' => 'tech');
$redirect_to = "https://www.google.com/search";

$webhook = $Libs->WebhookLib->getUrl($command, $user_id, $options, $redirect_to);
$User->sendMessage($webhook);

On command /onWebhook we can get posted $data from the webhook

<?php
// user's webhook

// for get method webhook request
$Bot->sendMessage([
    "chat_id" => $user_id,
    "text" => "Hello from webhook"
]);

// for post method webhook request
if ($data) {
    $Bot->sendMessage([
        "chat_id" => $user_id,
        "text" => $data
    ]);
}

// to get options values use
$category = $options["category"];

Example 3:

Global bot webhook lib usage example

<?php
// set command and user_id
$command = "/onWebhook";
$user_id = 0000000000; // add `0000000000` for global webhook

$webhook = $Libs->WebhookLib->getUrl($command, $user_id);
$User->sendMessage("This is global webhook url: $webhook");

On global command /onWebhook we can get posted $data from the webhook.

---

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

<?php
if ($data) {
    // get user_id, order_id and amount from the webhook
    $user_id = $data->user_id;
    $order_id = $data->order_id;
    $amount = $data->amount;

    $Bot->sendMessage([
        "chat_id" => $user_id,
        "text" => "Your deposit of $amount USD for order Id $order_id was successful"
    ]);
}

Webhooks can be with GET and POST methods only. All passed data contains on $data variable