How does the Chainalysis Sanctions integration work in B3OS?

B3OS uses the Chainalysis Sanctions Screening API to cross-reference blockchain addresses against global sanctions lists. You can authenticate using a dedicated connector or via the CHAINALYSIS_SANCTIONS_API_KEY environment variable for seamless fallback.

Can I use my own Telegram bot for these notifications?

Yes. While you can choose the B3OS Bot for rapid deployment, you can also bring your own bot by creating one through @BotFather and connecting it to your B3OS workflow.

What sanctions lists are covered by the Chainalysis integration?

The integration screens addresses against major global regulatory lists, including OFAC, the EU, the UN, and other critical international sanctions datasets.

What happens if I don't configure a specific Chainalysis connector?

If no specific connector is attached to the workflow action, B3OS automatically falls back to the CHAINALYSIS_SANCTIONS_API_KEY environment variable to ensure your automation remains uninterrupted.

Chainalysis Sanctions + Telegram Bot Integration

Overview

Automate real-time compliance monitoring by integrating Chainalysis Sanctions with Telegram. Create instant automated alerts that notify your team via Telegram whenever a blockchain address triggers a match against OFAC, EU, or UN sanctions lists.

Popular ways to use the Chainalysis Sanctions + Telegram Bot integration onchain

View all templates ›

Compliance: Sanctions + Illicit Finance Monitoring

This workflow monitors contracts events and screens addresses interacting with that contract to flag santions/OFAC and high risk accounts. The data and flagged accounts are auto-logged into a Gsheet and a notification is sent. This allows teams to make sure they remain compliant and block any bad actors from interacting with their platform. ### Quick Setup: 1. Connect your Gsheets account 2. Input the contract address you want monitored 3. Input the chain the contract address is deployed on 4. Drop in the Gsheet Spreadsheet URL where you want the data to be logged 5. Specify the tab you want the data to be logged in the Spreadsheet (input 0 if first tab) 6. Test and Publish!

Daily Portfolio Sentiment Recap

This workflow monitors the assets in your wallet, identified the top-performing tokens and then scans Twitter for any breaking/interesting news regarding those tokens. A recap is then sent to you via Telegram. This allows you to monitor you portfolio and be notified if a specific asset you hold has any pertinent news come out on Twitter for you to be aware of without having to monitor and scan Twitter yourself ### Quick Setup: 1. Select the wallet you want monitored 2. Select how often/when and what time you want a recap set to you 3. Select the Telegram channel you want the recap sent to 4. Test and Publish!

Morpho: LTV Alerts + Repay

Watches every Morpho Blue borrow position you have on the chosen chain. When any position crosses 80% of its LLTV, you get a Telegram alert with a one-tap Repay button per position. Tap it and the workflow repays down to 50% of LLTV using fresh on-chain prices. Runs every 5 minutes. Silent if you don't tap within an hour. ### Quick Setup: 1. Import your wallet or use your B3OS Treasury Wallet 2. Pick the Telegram chat for LTV alerts 3. Pick the chain - where your Morpho positions live (default: Base) 4. Set Danger Threshold - % of LLTV that triggers an alert (default: 80) 5. Set Safe Target - % of LLTV to repay back down to when you tap (default: 50) 6. Set Poll Schedule - how often to scan positions (default: every 5 minutes) 7. Test and publish!

Telegram: Wallet Control

This workflow allows you to control your organization Treasury Wallet via Telegram on Base. You're able to quickly send money into or out of the Treasury Org wallet anywhere by just prompting commands in TG. This allows you quickly top up the Treasury Wallet should you be running out of funds or be able to move all your funds to a new wallet without being logged into B3OS. ### Quick Setup: 1. Select the Organization Wallet to control 2. Select the TG account to use 3. In TG, use controls like /balance to get your balance or /send to send funds to any Ox... address.

Supported triggers and actions

Send Telegram Message

Action

Send a text message to a Telegram chat using a bot token. Supports Markdown formatting (bold, italic, code, links). Uses the same bot token configured for receiving Telegram messages. Ideal for: chat replies, alerts, notifications, automated responses to Telegram triggers.

Screen Address for Sanctions

Action

Check whether a blockchain address is on any sanctions list tracked by Chainalysis (OFAC SDN, EU, UN, etc.). Returns a boolean sanctioned flag, unique categories, and the full identifications list with source URLs. Chain-agnostic (EVM, BTC, Solana). Ideal for: compliance workflows, pre-transaction screening, counterparty risk checks, AML monitoring, audit trails.

Telegram Chat Message

Trigger

Triggers when a new message is posted in a Telegram chat or group. Connect your Telegram bot, then add the bot to your chat.

Telegram: Button Click / Interaction