Canonical Definition
{
"category": "channel-auth",
"description": {
"en": "Binds a Telegram user to a Vetra workspace identity so authenticated context can be used.",
"es": "Vincula un usuario de Telegram a una identidad de workspace de Vetra para habilitar contexto autenticado."
},
"function": {
"description": "Bind a Telegram sender to a Vetra workspace identity so Imaginclaw can fetch authenticated onboarding context for that user.",
"name": "bind_telegram_workspace",
"parameters": {
"properties": {
"bot_name": {
"description": "Bot display name, usually `Vetra`.",
"type": "string"
},
"locale": {
"default": "es",
"description": "Preferred locale for this Telegram binding.",
"type": "string"
},
"sender_id": {
"description": "Telegram sender ID to bind.",
"type": "string"
},
"sender_name": {
"description": "Human-readable Telegram sender name.",
"type": "string"
},
"workspace_company": {
"description": "Workspace company name to scope onboarding/KYB context.",
"type": "string"
},
"workspace_user": {
"description": "Workspace user identity or email to act as inside Vetra.",
"type": "string"
}
},
"required": [
"sender_id",
"workspace_user",
"workspace_company"
],
"type": "object"
}
},
"id": "bind_telegram_workspace",
"label": {
"en": "Bind Telegram to workspace",
"es": "Vincular Telegram al workspace"
},
"metadata": {
"artifact_type": "vetra-telegram-binding-tool",
"consumers": [
"Vetra-rust",
"Imaginclaw"
],
"owner_app": "Vetra-rust",
"promotion_reason": "Telegram workspace binding must be reusable across Vetra channel surfaces.",
"scope": "app-scoped",
"version": "0.1.0"
},
"requires_workspace": true,
"response": {
"data": {
"binding_status": "linked",
"channel": "telegram"
},
"summary": {
"en": "Telegram binding prepared for `{{workspace_user}}`.",
"es": "Vinculación de Telegram preparada para `{{workspace_user}}`."
}
},
"suggested_actions": [
"onboarding_help",
"search_provider"
],
"triggers": [
"telegram",
"bind",
"workspace",
"login",
"link"
],
"type": "function"
}