# Telegram Bot

This integration allows you to connect OxaPay with Telegram using Make.&#x20;By combining OxaPay’s payment and invoice system with Telegram bots or chats, you can automate payment notifications, order confirmations, and user interactions in real-time.

<div data-with-frame="true"><figure><img src="https://2150865118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0cdQgWk1yvwE7MR49PSn%2Fuploads%2Fs3KYEHDh62ygPD7d1L3G%2F2.png?alt=media&#x26;token=39b72558-38ee-4cfe-be74-e095b3b8c4a4" alt=""><figcaption></figcaption></figure></div>

### Using OxaPay and Telegram together on Make, you can:

* Send Telegram messages when a payment is completed
* Generate invoices and automatically deliver them to customers through Telegram
* Automatically deliver digital products after successful payment
* Alert users about payment expiration or failure
* Create a Telegram based payment notification system for merchants

> **In short, you can build virtually any payment related automation by combining OxaPay and Telegram on Make.**

### Example Automation Scenarios

{% stepper %}
{% step %}

#### **Scenario 1: Payment Notification Bot**

When a payment status changes to Paid in OxaPay, a Telegram message is sent automatically to a user or group.
{% endstep %}

{% step %}

#### **Scenario 2: Admin Alert System**

Admins are notified in a private Telegram group when a new or high-value transaction is completed.
{% endstep %}

{% step %}

#### **Scenario 3: Invoice Creation & Tracking**

An invoice is created in OxaPay and the payment link is instantly sent to the customer via Telegram.
{% endstep %}
{% endstepper %}

### **Telegram Payment Bot with OxaPay Scenario**&#x20;

This scenario creates a Telegram bot powered by OxaPay that allows merchants to generate payment requests directly inside Telegram. Using this bot, users can create invoice links, white-label addresses, or static addresses, and receive instant Telegram notifications whenever a payment is completed. You can download the scenario blueprint file below:

{% file src="<https://2150865118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0cdQgWk1yvwE7MR49PSn%2Fuploads%2Fr5rOBbuK1vyx3ZZIzkVb%2FOxaPay%20Telegram%20Bot.blueprint.json?alt=media&token=1a83c263-efd2-42a9-a4dd-b9a131d8fa46>" %}

#### Before starting, make sure you have:

* An active OxaPay account with API access
* A Telegram bot token created via BotFather
* A Make account with access to Data Store

#### **How to build and configure this Telegram payment bot using Make?**

1. First, create a new scenario by going to the Make dashboard and clicking the "**Create scenario**" button.

<div data-with-frame="true"><figure><img src="https://2150865118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0cdQgWk1yvwE7MR49PSn%2Fuploads%2F8r5RkJ6Rf49S6YqH75g2%2Fimage.png?alt=media&#x26;token=12c541bb-ca3f-4f30-a247-f53c34d1aa9d" alt=""><figcaption></figcaption></figure></div>

2. In the top-right corner, click the three-dot menu, then choose "**Import blueprint"** and upload the downloaded scenario file.

<div data-with-frame="true"><figure><img src="https://2150865118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0cdQgWk1yvwE7MR49PSn%2Fuploads%2F6UzQm4cgB5O6LqFgbCY4%2FScreenshot%20(160).png?alt=media&#x26;token=4ff19fef-9d50-49b6-8072-43e7dbf23e85" alt=""><figcaption></figcaption></figure></div>

3. Now, click on each **module** one by one and complete the required **connection** and configuration steps.

<div data-with-frame="true"><figure><img src="https://2150865118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0cdQgWk1yvwE7MR49PSn%2Fuploads%2F46CcMfyVVIIGUr623x5d%2FScreenshot%20(164).png?alt=media&#x26;token=2f0d032e-9e72-4e08-b6d1-883efa5898b5" alt=""><figcaption></figcaption></figure></div>

4. In the "**Data Store**" module, you need to connect it to a database with the following structure.

<div data-with-frame="true"><figure><img src="https://2150865118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0cdQgWk1yvwE7MR49PSn%2Fuploads%2FeltFhuINYYjSiRWymrUD%2FScreenshot%20(161).png?alt=media&#x26;token=21b02805-f67c-4a71-9668-6c5a1a56a94b" alt=""><figcaption></figcaption></figure></div>

5. Once all modules are configured, click **Save** to store the scenario.

<div data-with-frame="true"><figure><img src="https://2150865118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0cdQgWk1yvwE7MR49PSn%2Fuploads%2FjJgNeG1usyHBupnlQItL%2FScreenshot%20().png?alt=media&#x26;token=fa9c6f9f-ecaf-4493-91eb-60a5291d05f6" alt=""><figcaption></figcaption></figure></div>

6. Now, go to the scenario page you created and click the **Active** button to activate the scenario.

<div data-with-frame="true"><figure><img src="https://2150865118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0cdQgWk1yvwE7MR49PSn%2Fuploads%2FXv3EjozhNomi62YOfCZx%2FScreenshot%20(165).png?alt=media&#x26;token=a60e9f11-ee7f-4a58-aa02-836684c99ae4" alt=""><figcaption></figcaption></figure></div>

7. For real-time payment status notifications, create a separate scenario and import the blueprint file below into a new scenario.

{% file src="<https://2150865118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0cdQgWk1yvwE7MR49PSn%2Fuploads%2F240n8eRqS1yJy8yB9BUr%2FTelegram%20Payment%20Webhook.blueprint.json?alt=media&token=ddb409b9-c286-405a-80c7-5b4e7ad4a888>" %}

8. In the "**Data Store**" module in this scenario, you need to connect it to a database with the following structure.

<div data-with-frame="true"><figure><img src="https://2150865118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0cdQgWk1yvwE7MR49PSn%2Fuploads%2FGrJ32ByYwQln0I6Slbuz%2FScreenshot%20(167).png?alt=media&#x26;token=c052ffa3-d4e7-4946-a0ef-13a800a2dd02" alt=""><figcaption></figcaption></figure></div>

9. Once all modules are configured, copy the webhook URL from the "**Watch Payment Webhook**" module and add it to the Callback URL of all OxaPay modules that create invoices or payment requests in the previous scenario. Finally, save and activate the scenario.

<div data-with-frame="true"><figure><img src="https://2150865118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0cdQgWk1yvwE7MR49PSn%2Fuploads%2FFnrwwEMJ45cdT62lcdmE%2FScreenshot%20(166).png?alt=media&#x26;token=0e0ac03e-f2dc-4963-a886-a9f01e602e8a" alt=""><figcaption></figcaption></figure></div>

### Conclusion and Next Steps

**With these two Make scenarios configured, you now have a fully functional Telegram payment bot powered by OxaPay:**

* Scenario 1 handles user interaction and payment creation inside Telegram.
* Scenario 2 receives real-time payment status updates via webhook and sends automated Telegram notifications.

**This setup can be extended further by:**

* Delivering digital products or access credentials after successful payment
* Logging transactions in external tools such as Google Sheets or CRM systems
* Adding retry or fallback flows for expired or failed payments

By combining OxaPay, Telegram, and Make, you can build flexible and scalable crypto payment automations without writing custom backend code.
