[{"data":1,"prerenderedAt":602},["ShallowReactive",2],{"navigation":3,"/en/cases/inbound-telegram":268,"/en/cases/inbound-telegram-surround":597},[4,150],{"title":5,"path":6,"stem":7,"children":8,"page":61},"EN","/en","en",[9,16,62,70,95,110],{"title":10,"path":11,"stem":12,"children":13,"icon":15},"API","/en/api","en/api/index",[14],{"title":10,"path":11,"stem":12,"icon":15},"i-lucide-code",{"title":17,"path":18,"stem":19,"children":20,"page":61},"Use cases","/en/cases","en/cases",[21,26,31,36,41,46,51,56],{"title":22,"path":23,"stem":24,"icon":25},"Call from your site using the SDK","/en/cases/call-from-site-sdk","en/cases/call-from-site-sdk","i-lucide-phone-call",{"title":27,"path":28,"stem":29,"icon":30},"Connect Voximplant","/en/cases/connect-voximplant","en/cases/connect-voximplant","i-lucide-plug",{"title":32,"path":33,"stem":34,"icon":35},"Embed the widget","/en/cases/embed-widget","en/cases/embed-widget","i-lucide-layout-template",{"title":37,"path":38,"stem":39,"icon":40},"Inbound Call Handling with Telegram Notifications","/en/cases/inbound-telegram","en/cases/inbound-telegram","i-lucide-phone-incoming",{"title":42,"path":43,"stem":44,"icon":45},"Prompting","/en/cases/prompting","en/cases/prompting","i-lucide-pencil-line",{"title":47,"path":48,"stem":49,"icon":50},"Monitor agent quality","/en/cases/quality-monitoring","en/cases/quality-monitoring","i-lucide-activity",{"title":52,"path":53,"stem":54,"icon":55},"Build a sales agent","/en/cases/sales-agent","en/cases/sales-agent","i-lucide-shopping-bag",{"title":57,"path":58,"stem":59,"icon":60},"State, context, secrets","/en/cases/state-context-secrets","en/cases/state-context-secrets","i-lucide-key-round",false,{"title":63,"path":64,"stem":65,"children":66,"icon":69},"Getting Started","/en/getting-started","en/getting-started/index",[67],{"title":68,"path":64,"stem":65,"icon":69},"Getting started","i-lucide-rocket",{"title":71,"path":72,"stem":73,"children":74,"page":61},"Legal","/en/legal","en/legal",[75,80,85,90],{"title":76,"path":77,"stem":78,"icon":79},"Contacts","/en/legal/contacts","en/legal/contacts","i-lucide-mail",{"title":81,"path":82,"stem":83,"icon":84},"Offer","/en/legal/offer","en/legal/offer","i-lucide-file-text",{"title":86,"path":87,"stem":88,"icon":89},"Privacy policy","/en/legal/privacy","en/legal/privacy","i-lucide-lock",{"title":91,"path":92,"stem":93,"icon":94},"Terms of service","/en/legal/terms","en/legal/terms","i-lucide-scale",{"title":96,"path":97,"stem":98,"children":99,"page":61},"Pricing","/en/pricing","en/pricing",[100,105],{"title":101,"path":102,"stem":103,"icon":104},"Model pricing","/en/pricing/model-prices","en/pricing/model-prices","i-lucide-dollar-sign",{"title":106,"path":107,"stem":108,"icon":109},"Plans","/en/pricing/plans","en/pricing/plans","i-lucide-badge-dollar-sign",{"title":111,"path":112,"stem":113,"children":114,"page":61},"Product","/en/product","en/product",[115,120,125,130,135,140,145],{"title":116,"path":117,"stem":118,"icon":119},"Agent","/en/product/agent","en/product/agent","i-lucide-bot",{"title":121,"path":122,"stem":123,"icon":124},"Charts","/en/product/analytics","en/product/analytics","i-lucide-line-chart",{"title":126,"path":127,"stem":128,"icon":129},"Companies","/en/product/companies","en/product/companies","i-lucide-building-2",{"title":131,"path":132,"stem":133,"icon":134},"Procedures","/en/product/procedures","en/product/procedures","i-lucide-list-checks",{"title":136,"path":137,"stem":138,"icon":139},"RBAC","/en/product/rbac","en/product/rbac","i-lucide-shield",{"title":141,"path":142,"stem":143,"icon":144},"Simulations","/en/product/simulations","en/product/simulations","i-lucide-flask-conical",{"title":146,"path":147,"stem":148,"icon":149},"Tools","/en/product/tools","en/product/tools","i-lucide-wrench",{"title":151,"path":152,"stem":153,"children":154,"page":61},"RU","/ru","ru",[155,160,196,202,223,236],{"title":10,"path":156,"stem":157,"children":158,"icon":15},"/ru/api","ru/api/index",[159],{"title":10,"path":156,"stem":157,"icon":15},{"title":161,"path":162,"stem":163,"children":164,"page":61},"Кейсы","/ru/cases","ru/cases",[165,169,173,177,181,185,189,193],{"title":166,"path":167,"stem":168,"icon":25},"Звоним с сайта с помощью SDK","/ru/cases/call-from-site-sdk","ru/cases/call-from-site-sdk",{"title":170,"path":171,"stem":172,"icon":30},"Подключаем Voximplant","/ru/cases/connect-voximplant","ru/cases/connect-voximplant",{"title":174,"path":175,"stem":176,"icon":35},"Встраиваем виджет","/ru/cases/embed-widget","ru/cases/embed-widget",{"title":178,"path":179,"stem":180,"icon":40},"Входящие звонки с уведомлениями в Telegram","/ru/cases/inbound-telegram","ru/cases/inbound-telegram",{"title":182,"path":183,"stem":184,"icon":45},"Пишем успешные промты","/ru/cases/prompting","ru/cases/prompting",{"title":186,"path":187,"stem":188,"icon":50},"Контролируем качество агентов","/ru/cases/quality-monitoring","ru/cases/quality-monitoring",{"title":190,"path":191,"stem":192,"icon":55},"Делаем агента по продажам","/ru/cases/sales-agent","ru/cases/sales-agent",{"title":57,"path":194,"stem":195,"icon":60},"/ru/cases/state-context-secrets","ru/cases/state-context-secrets",{"title":197,"path":198,"stem":199,"children":200,"icon":69},"Начало работы","/ru/getting-started","ru/getting-started/index",[201],{"title":197,"path":198,"stem":199,"icon":69},{"title":203,"path":204,"stem":205,"children":206,"page":61},"Юридические документы","/ru/legal","ru/legal",[207,211,215,219],{"title":208,"path":209,"stem":210,"icon":79},"Контакты","/ru/legal/contacts","ru/legal/contacts",{"title":212,"path":213,"stem":214,"icon":84},"Оферта","/ru/legal/offer","ru/legal/offer",{"title":216,"path":217,"stem":218,"icon":89},"Политика конфиденциальности","/ru/legal/privacy","ru/legal/privacy",{"title":220,"path":221,"stem":222,"icon":94},"Пользовательское соглашение","/ru/legal/terms","ru/legal/terms",{"title":224,"path":225,"stem":226,"children":227,"page":61},"Цены","/ru/pricing","ru/pricing",[228,232],{"title":229,"path":230,"stem":231,"icon":104},"Цены на модели","/ru/pricing/model-prices","ru/pricing/model-prices",{"title":233,"path":234,"stem":235,"icon":109},"Тарифные планы","/ru/pricing/plans","ru/pricing/plans",{"title":237,"path":238,"stem":239,"children":240,"page":61},"Продукт","/ru/product","ru/product",[241,245,249,253,257,260,264],{"title":242,"path":243,"stem":244,"icon":119},"Агент","/ru/product/agent","ru/product/agent",{"title":246,"path":247,"stem":248,"icon":124},"Графики","/ru/product/analytics","ru/product/analytics",{"title":250,"path":251,"stem":252,"icon":129},"Компании","/ru/product/companies","ru/product/companies",{"title":254,"path":255,"stem":256,"icon":134},"Процедуры","/ru/product/procedures","ru/product/procedures",{"title":136,"path":258,"stem":259,"icon":139},"/ru/product/rbac","ru/product/rbac",{"title":261,"path":262,"stem":263,"icon":144},"Симуляции","/ru/product/simulations","ru/product/simulations",{"title":265,"path":266,"stem":267,"icon":149},"Инструменты","/ru/product/tools","ru/product/tools",{"id":269,"title":37,"body":270,"description":590,"extension":591,"links":592,"meta":593,"navigation":594,"path":38,"seo":595,"stem":39,"__hash__":596},"docs/en/cases/inbound-telegram.md",{"type":271,"value":272,"toc":571},"minimark",[273,278,282,285,289,292,305,308,312,328,331,352,356,361,369,373,376,390,393,397,404,407,411,414,418,424,428,431,445,449,452,484,487,491,517,520,524,550],[274,275,277],"h2",{"id":276},"introduction","Introduction",[279,280,281],"p",{},"One of the most common automation patterns is handling inbound phone calls and routing the results to a messenger your team already uses. In this use case, you will set up an AI agent that answers incoming calls, follows a structured conversation plan, and sends a summary to a Telegram chat once the call ends.",[279,283,284],{},"This is useful for teams that want to automate first-line phone support, lead qualification, or appointment scheduling — without building a custom call center.",[274,286,288],{"id":287},"what-you-will-build","What You Will Build",[279,290,291],{},"A fully automated inbound call pipeline:",[293,294,295,299,302],"ul",{},[296,297,298],"li",{},"An AI agent that answers phone calls and follows your conversation plan",[296,300,301],{},"A Telegram integration that receives structured notifications after each call",[296,303,304],{},"A phone number that routes incoming calls to the agent",[279,306,307],{},"Once set up, every incoming call is handled by the agent autonomously. Your team receives a Telegram message with the call outcome — no manual work required.",[274,309,311],{"id":310},"flow-overview","Flow Overview",[313,314,317],"div",{"className":315},[316],"not-prose",[318,319,324],"pre",{"className":320,"code":322,"language":323},[321],"language-text","Incoming call → Phone number → AI Agent → Conversation → Call ends → Telegram notification\n","text",[325,326,322],"code",{"__ignoreMap":327},"",[279,329,330],{},"Step by step:",[332,333,334,337,340,343,346,349],"ol",{},[296,335,336],{},"A caller dials your number",[296,338,339],{},"The call is routed to the AI agent",[296,341,342],{},"The agent follows the conversation plan you defined",[296,344,345],{},"The agent uses tools during the conversation (e.g., collecting data, qualifying a lead)",[296,347,348],{},"When the call ends, the system triggers the Telegram integration",[296,350,351],{},"A notification with call results is delivered to your Telegram chat or group",[274,353,355],{"id":354},"setup-steps","Setup Steps",[357,358,360],"h3",{"id":359},"_1-create-an-agent","1. Create an Agent",[279,362,363,364,368],{},"Go to the ",[365,366,367],"strong",{},"Agents"," section and create a new agent. Give it a clear name that reflects its purpose — for example, \"Inbound Support Agent\" or \"Lead Qualifier\".",[357,370,372],{"id":371},"_2-define-the-conversation-plan","2. Define the Conversation Plan",[279,374,375],{},"Write an instruction for the agent that describes:",[293,377,378,381,384,387],{},[296,379,380],{},"How it should greet the caller",[296,382,383],{},"What information it needs to collect",[296,385,386],{},"How it should handle common questions",[296,388,389],{},"When and how the conversation should end",[279,391,392],{},"Keep the instruction concise and goal-oriented. The agent will follow it as a guide, not a rigid script.",[357,394,396],{"id":395},"_3-create-a-telegram-integration","3. Create a Telegram Integration",[279,398,399,400,403],{},"Go to ",[365,401,402],{},"Integrations"," and create a new Telegram integration. You will need to connect it to a Telegram bot and specify the chat or group where notifications should be sent.",[279,405,406],{},"The integration defines what information is included in the notification — for example, caller intent, collected data, or call outcome.",[357,408,410],{"id":409},"_4-link-the-integration-to-the-agent","4. Link the Integration to the Agent",[279,412,413],{},"Attach the Telegram integration to your agent. This tells the system to trigger a Telegram notification whenever this agent finishes a call.",[357,415,417],{"id":416},"_5-create-a-phone-number","5. Create a Phone Number",[279,419,399,420,423],{},[365,421,422],{},"Phone Numbers"," and create or assign a number to your agent. Once linked, any call to this number will be handled by the agent automatically.",[357,425,427],{"id":426},"_6-test-the-setup","6. Test the Setup",[279,429,430],{},"Call the number from your phone. Verify that:",[293,432,433,436,439,442],{},[296,434,435],{},"The agent picks up and follows the conversation plan",[296,437,438],{},"The agent uses tools correctly during the call",[296,440,441],{},"A Telegram notification arrives after the call ends",[296,443,444],{},"The notification contains the expected information",[274,446,448],{"id":447},"what-happens-behind-the-scenes","What Happens Behind the Scenes",[279,450,451],{},"When an incoming call arrives:",[332,453,454,460,466,472,478],{},[296,455,456,459],{},[365,457,458],{},"Call routing"," — The telephony provider routes the call to the platform. The platform identifies which agent is linked to the dialed number.",[296,461,462,465],{},[365,463,464],{},"Agent activation"," — The agent starts a real-time voice session with the caller. Speech-to-text and text-to-speech run in parallel for low-latency conversation.",[296,467,468,471],{},[365,469,470],{},"Conversation execution"," — The agent follows the conversation plan, asks questions, and invokes tools as needed (e.g., to record data or check information).",[296,473,474,477],{},[365,475,476],{},"Call completion"," — When the call ends (either party hangs up, or the agent concludes the conversation), the system collects the call metadata and tool results.",[296,479,480,483],{},[365,481,482],{},"Notification dispatch"," — The Telegram integration fires, formatting the call data into a message and sending it to the configured chat.",[279,485,486],{},"The entire pipeline runs without human intervention. The only manual step is the initial setup.",[274,488,490],{"id":489},"why-this-matters","Why This Matters",[293,492,493,499,505,511],{},[296,494,495,498],{},[365,496,497],{},"Instant response"," — Every call is answered immediately, 24/7. No missed calls, no hold queues.",[296,500,501,504],{},[365,502,503],{},"Consistent quality"," — The agent follows the same plan every time. No off-script mistakes, no bad days.",[296,506,507,510],{},[365,508,509],{},"Team visibility"," — Telegram notifications keep your team informed in real time without requiring them to monitor a dashboard.",[296,512,513,516],{},[365,514,515],{},"Low overhead"," — No code, no infrastructure. Setup takes minutes, not weeks.",[279,518,519],{},"This pattern scales naturally. Whether you receive 10 calls or 10,000, the system handles them the same way.",[274,521,523],{"id":522},"next-steps","Next Steps",[293,525,526,532,538,544],{},[296,527,528,531],{},[365,529,530],{},"Add a knowledge base"," so the agent can answer product or company questions during the call.",[296,533,534,537],{},[365,535,536],{},"Create additional tools"," for the agent — for example, a tool that checks appointment availability or looks up order status.",[296,539,540,543],{},[365,541,542],{},"Set up multiple agents"," with different conversation plans for different phone numbers (e.g., sales vs. support).",[296,545,546,549],{},[365,547,548],{},"Connect additional integrations"," — send notifications to email, CRM, or a webhook alongside Telegram.",[551,552,556],"callout",{"icon":553,"target":554,"to":555},"i-lucide-message-circle","_blank","https://t.me/+n20MsKSZzzMwNDgy",[279,557,558,559,565,566,570],{},"Need help? Join our ",[560,561,564],"a",{"href":555,"rel":562},[563],"nofollow","community chat"," or contact us at ",[560,567,569],{"href":568},"mailto:sales@aiva.chat","sales@aiva.chat",".",{"title":327,"searchDepth":572,"depth":573,"links":574},1,2,[575,576,577,578,587,588,589],{"id":276,"depth":573,"text":277},{"id":287,"depth":573,"text":288},{"id":310,"depth":573,"text":311},{"id":354,"depth":573,"text":355,"children":579},[580,582,583,584,585,586],{"id":359,"depth":581,"text":360},3,{"id":371,"depth":581,"text":372},{"id":395,"depth":581,"text":396},{"id":409,"depth":581,"text":410},{"id":416,"depth":581,"text":417},{"id":426,"depth":581,"text":427},{"id":447,"depth":573,"text":448},{"id":489,"depth":573,"text":490},{"id":522,"depth":573,"text":523},"Accept incoming calls with an AI agent and send call summaries to Telegram","md",null,{},{"icon":40},{"title":37,"description":590},"GPvH5Z6WE2hx071I2ecrQDDP_YJztwlr74IvwtfDLnI",[598,600],{"title":32,"path":33,"stem":34,"description":599,"icon":35,"children":-1},"Add an agent to your website",{"title":42,"path":43,"stem":44,"description":601,"icon":45,"children":-1},"Prompt engineering basics",1778099772182]