Skip to content

Block Catalog

Blocks are the building units of AiSpinner. Place them on the canvas and connect with edges (routes) to compose your workflow. The system handles routing, state, and execution — you handle intent.

Conventions

  • Type ID — internal identifier (e.g. trading.bybit). Used in the API and graph JSON.
  • Plan badgepro means paid plan only; absent = free.
  • server-only — block runs exclusively in the Server execution mode (Browser mode disabled).

Edge = Connection

Drawing an edge between two blocks is the only configuration most blocks need. Delete the edge and they're disconnected — no manual config required.


Telephony — ElevenLabs

BlockType IDDescription
Phone Numberai.phone_numberSIP trunk or Twilio — inbound & outbound voice
AI Agentai.agentElevenLabs conversational voice agent (prompt, voice, model)
PBXai.pbxVirtual PBX — campaign auto-dialer, parallel calls, operator routing
Journalai.journalStandalone call history viewer — transcripts, audio playback, CSV export

Telephony — Custom Voice pro

Build your own voice pipeline with cheaper providers (Deepgram + DeepSeek/OpenAI + Cartesia) and dial through your own Asterisk SIP trunk.

BlockType IDDescription
Custom Agentvoice.custom_agentOwn STT/LLM/TTS pipeline — alternative to ElevenLabs
Call Guardai.call_guardAI call monitor — voicemail / silence / rudeness detection
Voice Translatorvoice.translatorReal-time bidirectional speech translation between two callers
SIP / ARI Trunktelephony.trunkAsterisk SIP trunk configuration
PBX (ARI)ais.pbxVirtual PBX dialing through Custom Agent + Asterisk

AI Agents

BlockType IDSubgroupDescription
ChatGPTai.llm_agentOpenAIOpenAI GPT models — tasks, prompts, automation
Claude Agentai.claude_agentAnthropicAnthropic Claude — vision, reasoning, automation
Grok Agentai.grok_agentxAIxAI Grok — X/Twitter data, reasoning
DeepSeekai.deepseek_agentDeepSeekDeepSeek V3 + R1 reasoning, cost-efficient
Groqai.groq_agentGroqUltra-fast Llama, Mixtral, Gemma inference

All AI Agent blocks share a hub-style configuration — they accept connections from messengers, trading, data, files, and more, exposing those capabilities as tools.


Automation

BlockType IDDescription
Workercode.workerProgrammable Python worker — runs in browser sandbox or on the server
Schedulerautomation.schedulerTrigger connected blocks on an interval (cron-style)
Logic Gateautomation.logic_gateConditional routing — IF/THEN/ELSE for events

Trading

10 exchanges, covering crypto and traditional markets. Trading blocks expose a unified API to Worker code via ctx.{exchange}.

Crypto

BlockType IDPlanNotes
Bybittrading.bybitfreeSpot + derivatives
Binancetrading.binancefreeSpot + futures (31 methods, WebSocket-cached)
Coinbasetrading.coinbasepro · server-onlyAdvanced Trade API
OKXtrading.okxpro · server-onlySpot, swaps, futures
Krakentrading.krakenpro · server-onlyBalance, orders, trading
Deribittrading.deribitpro · server-onlyCrypto options, futures, perpetuals (33 methods)
Hyperliquidtrading.hyperliquidproOn-chain perpetuals DEX (EIP-712 wallet signing)
Bitgettrading.bitgetproSpot + USDT-FUTURES, copy-trading

Traditional

BlockType IDPlanNotes
IG Marketstrading.igpro · server-onlyCFDs, forex, indices, commodities (Lightstreamer)
Interactive Brokerstrading.ibkrfreeStocks, options, futures, forex (Gateway / TWS mode)

Prediction Markets

BlockType IDPlanDescription
Polymarket Monitorprediction.polymarket_monitorfreePublic events, probabilities, trends
Polymarket Traderprediction.polymarket_traderproOrders, positions, P&L

Data Feeds

BlockType IDDescription
CoinGeckodata.coingeckoCrypto market data — prices, volumes, trends, categories
Twelve Datadata.twelve_dataStocks, forex, indices, commodities — quotes and history
Apifydata.apifyUniversal web scraping — Amazon, Instagram, Google Maps, 3000+ actors

Messengers

BlockType IDSubgroupDescription
Telegrammessenger.telegramTelegramBot API — send messages, alerts
Telegram Bot (AI)ai.telegram_botTelegramInteractive bot that responds via connected LLM
Telegram Channelmessenger.telegram_channelTelegramAuto-publish content to channels
Telegram Readermessenger.telegram_readerTelegramParse public channels via Telethon (user-account)
Discordmessenger.discordDiscordBot messages, notifications, commands
WhatsAppmessenger.whatsappWhatsAppWhatsApp Business — Meta Cloud API
Matrix Messengermessenger.matrixMatrixVoIP calls + chat over Matrix protocol

Storage

BlockType IDDescription
File Explorerstorage.file_explorerSandboxed file manager — CSV, JSON, TXT (100 MB / workspace)

UI / Monitoring

Display blocks render data pushed from connected Workers, PBX runs, or Matrix sessions. They can also be pinned to your Dashboard.

BlockType IDDescription
Worker Monitorui.monitorUniversal display — renders metrics, status, tables, progress, log widgets from ctx.monitor
PBX Monitorui.pbx_monitorLive call journal, stats, active calls for PBX blocks
Matrix Monitorui.matrix_monitorReal-time call/chat monitor for Matrix blocks

How Blocks Connect

Blocks connect through edges (routes) drawn on the canvas:

  1. Click Route in the toolbar
  2. Drag from one block to another
  3. The connection is established automatically — no manual config

A single Worker block can connect to multiple blocks simultaneously. For example, one Worker connected to Bybit + CoinGecko + Telegram + Claude Agent + Monitor becomes a complete AI trading bot with alerts and a live dashboard.

Connection examples

FromToWhat happens
WorkerBybitctx.bybit becomes available in worker code
WorkerMonitorctx.monitor renders widgets to the Monitor block
WorkerTelegramctx.telegram sends messages via the bot
WorkerClaude Agentctx.llm.claude(...) queries Claude
WorkerFile Explorerctx.files provides read/write/list/delete
AI AgentPhone NumberThe agent handles inbound calls on that number
SchedulerWorkerScheduler triggers the worker on its schedule
PBXJournalJournal block displays call history for that PBX
Voice TranslatorPhone Number ×2Translator bridges two callers and translates each side

See the Worker API Reference for the full list of ctx.* adapters available when blocks are connected.

AiSpinner Documentation