Objective
We’ll configure a Kwala workflow that continuously monitors the SOL price oracle on-chain. When the SOL price falls below $195, it automatically triggers a Telegram alert. This use case highlights how simple YAML configurations can connect on-chain oracle data with real-world notification systems.Prerequisites
Before you begin, ensure you have:- Access to the Kwala Dashboard to create and deploy workflows.
- A Telegram bot created using @BotFather
- Retrieve your bot token and verify it using API testing tools like Reqbin or Postman with a POST request.
- Once verified, your bot is ready to send automated notifications.
This use case does not require deploying any Solidity smart contracts.
Workflow setup on Kwala
Follow the steps below to create and deploy the workflow on Kwala.Step 1: Create a new workflow
- Navigate to your Kwala Dashboard.
- Select Create Workflow.
- Enter a workflow name, for example:
sol_pricedrop1.
Step 2: Configure the trigger
This workflow is price-based, meaning it activates when a specified oracle price condition is met. Trigger configuration parameters:- Execute After: oracle price (Activates when the SOL price reaches $195)
- Repeat Every: oracle price (Re-triggers when the SOL price condition is met again)
- Expires In: timestamp for expiry, for example
17-09-2025 16:00IST - Trigger Source Contract:
0xD31a59c85aE9D8edEFeC411D448f90841571b89c
This is the smart contract address for the SOL price oracle, which Kwala automatically fetches and monitors.
- Trigger Source Configuration:
- Target price:
$195 - Target token:
Solana (SOL)
- Target price:
- Recurring Source Configuration:
- Target price:
$195 - Target token:
Solana (SOL)
- Target price:
- Trigger Chain ID:
1(Ethereum Mainnet) - Trigger Price:
$195 - Action Status Notification POST URL: Add the workflow’s URL (already available in the placeholder)
Step 3: Configure the action
When the price condition is met, Kwala automatically sends a Telegram notification using your bot. Action parameters:- Action Name:
telegram_notifier1 - Action Type:
POST API CALL - API Endpoint:
https://api.telegram.org/bot7754368882:AAHS4KbbOkl5rEHoBBIR8eljgwq2PARYLyY/sendMessage - API Payload (JSON):
- Retries Until Success:
5 - Execution Mode:
Sequential(actions run one after another)
Step 4: Add the YAML configuration
After setting up the trigger and action, define your workflow using the YAML below.Step 5: Save and deploy the workflow
- Review all parameters carefully.
- Select Save and Compile to validate the YAML.
- Once compilation succeeds, select Deploy.
- Wait for the workflow status to change to Claimed in the dashboard.
Output
When the SOL price reaches or drops below $195, your Telegram bot will automatically send:Sol price has dropped to $195!This confirms that the workflow executed successfully and the automation is working as expected.
