CRM تلگرام

API تلگرام CRM - گردش‌کار تلگرام خود را خودکار کنید

Telegram CRM API: یک REST API محدود به ورک‌اسپیس برای همگام‌سازی چت‌ها و مخاطبان، ارسال برودکست، ساخت تیکت و ساخت ابزارهای داخلی روی داده‌های خودتان.

شروع رایگان

نمای کلی

نمای کلی: API تلگرام CRM

REST API‌ Entergram به شما دسترسی برنامه‌نویسی به کل ورک‌اسپیس تلگرام CRM می‌دهد. چت‌ها و مخاطبان را به BigQuery، Postgres، HubSpot یا Salesforce همگام کنید. هنگام شکست یک پرداخت Stripe یا بسته شدن یک معامله، برودکست تلگرام بزنید. از هشدارهای مانیتورینگ تیکت بسازید. داشبورد داخلی‌ای را بسازید که تیم‌تان واقعاً می‌خواهد.

هر فراخوانی API محدود به ورک‌اسپیس، دارای لاگ ممیزی و تابع همان مدل دسترسی حداقلی است که در سراسر پلتفرم استفاده می‌شود. کلیدها قابل چرخش، قابل محدودسازی به IP و با یک کلیک قابل ابطال هستند.

برای یکپارچه‌سازی با عامل‌های AI، صفحه همراه سرور MCP تلگرام را ببینید - همان سطح داده را از طریق Model Context Protocol در دسترس قرار می‌دهد تا Claude، ChatGPT و دیگر عامل‌های AI بتوانند مستقیماً با ورک‌اسپیس تلگرام شما تعامل کنند.

کل تلگرام CRM شما، در دسترس کد شما

هر کاری که در داشبورد Entergram انجام می‌دهید، کد شما هم می‌تواند انجام دهد.

این یک REST API ساده است - کلیدهای محدودشده به ورک‌اسپیس، JSON و افعال استاندارد HTTP - پس هر زبانی که بتواند یک درخواست بزند می‌تواند چت‌های تلگرام را فهرست و جستجو کند، تاریخچه پیام را بخواند، مخاطبان و فیلدهای سفارشی را مدیریت کند، تیکت باز و به‌روز کند و برودکست راه بیندازد.

مجوزها را یک‌بار تنظیم کنید: همان اسکوپ‌ها روی API، سرور MCP و یکپارچه‌سازی Make. com اعمال می‌شوند.

مستندات API را بخوانید

حساب‌های تلگرام شما

ابزارهای شما

فروش اروپا @lumen_sales_eu
فروش آمریکا @lumen_sales_us
پشتیبانی @lumen_support
شرکا @lumen_partners

Entergram

HubSpot
Zendesk
Slack
Notion
Make.com
API شما

تلگرام را به انبار داده خود همگام کنید
چت‌ها، مخاطبان و مقادیر فیلدهای سفارشی را به‌صورت زمان‌بندی‌شده از Entergram بیرون بکشید. آن‌ها را به BigQuery، Postgres، HubSpot یا Salesforce بریزید تا بقیه کسب‌وکار بتواند داده تلگرام را با هر کانال دیگری ترکیب کند. یک کرون‌جاب شبانه و چند فراخوانی API تنها چیزی است که لازم است.
از رویدادهای بیرونی برودکست تلگرام بزنید
وقتی یک پرداخت در Stripe شکست می‌خورد، وقتی یک معامله در CRM شما بسته می‌شود، وقتی یک هشدار مانیتورینگ فعال می‌شود - به Entergram یک POST بزنید و یک برودکست تلگرام با قالب مناسب به سگمنت تگ‌شده درست ارسال می‌شود. پیام‌رسانی رویدادمحور بدون ترک پشته فعلی شما.
ساخت برنامه‌نویسی تیکت
فرم‌ها، ابزارهای مانیتورینگ، خطوط لوله ایمیل پشتیبانی - هرجا یک رویداد ساختاریافته رخ می‌دهد - آن را به‌عنوان تیکتی که به چت تلگرام درست با اولویت و SLA درست لینک شده POST کنید. حلقه بین تلگرام و هر کانال دیگری که تیم شما استفاده می‌کند را می‌بندد.
ابزارها و داشبوردهای داخلی
داشبورد مدیریتی‌ای را بسازید که تیم‌تان واقعاً می‌خواهد - پایپ‌لاین بر اساس مرحله، زمان پاسخ هر نماینده، گذردهی تیکت - با پشتیبانی API‌ Entergram. محدود بودن به ورک‌اسپیس یعنی فقط می‌تواند داده شما را ببیند. آن را با Retool، Appsmith یا یک فرانت‌اند سفارشی React جفت کنید.

مشخصات

API تلگرام CRM به تفصیل

مشخصات

بیشتر بدانید

تگ‌گذاری خودکار چت‌ها از محرک‌های بیرونیمشتری به یک نقطه عطف در محصول شما می‌رسد ← فراخوانی API تگ VIP را اضافه می‌کند و ستون Stage را ارتقا می‌دهد. دفعه بعد که چت تلگرام را باز کنید، زمینه CRM از قبل آنجاست. با هر وب‌هوک یا سیستم رویدادی کار می‌کند.
امنیت و چرخه عمر کلید APIکلیدها محدود به ورک‌اسپیس، در حالت ذخیره یک‌طرفه هش‌شده و فقط یک‌بار هنگام ساخت نمایش داده می‌شوند. TTL را پیکربندی کنید (پیش‌فرض ۹۰ روز، کوتاه‌تر اگر ترجیح می‌دهید)، فهرست مجاز IP اختیاری (بازه‌های CIDR) و هر کلید را فوراً از تب توسعه‌دهندگان ابطال کنید. هر فراخوانی با پیشوند کلید، IP و user agent لاگ ممیزی می‌شود.
مدل اسکوپworkspace.read · members.read · accounts.read · contacts.read · chats.read · chats.write · custom_fields.read · custom_fields.write. همین اسکوپ‌ها روی API، سرور MCP و یکپارچه‌سازی Make.com اعمال می‌شوند. حداقلی را که یکپارچه‌سازی شما نیاز دارد انتخاب کنید - دسترسی حداقلی شعاع آسیب را در صورت نشت کلید محدود می‌کند.
یکپارچه‌سازی Make.com (کم‌کد)نمی‌خواهید کد بنویسید؟ یکپارچه‌سازی Make.com از همان مدل اسکوپ استفاده می‌کند. Entergram را با سناریوهای بصری به صدها اپ متصل کنید. اکشن‌های این اپ تگ‌ها را به‌روزرسانی می‌کنند، جزئیات مخاطب را به‌روزرسانی می‌کنند و چت را خوانده‌شده علامت می‌زنند؛ برای مثال پرداخت Stripe ← به‌روزرسانی تگ CRM، یا ارسال فرم Typeform ← جزئیات مخاطب.
همراه: سرور MCP تلگراماگر می‌خواهید عامل‌های AI (Claude، ChatGPT، Cursor) با ورک‌اسپیس تلگرام شما تعامل کنند، سرور MCP تلگرام را ببینید - همان سطح API را از طریق Model Context Protocol در دسترس قرار می‌دهد تا عامل‌های AI بتوانند ابزارها را به‌صورت خودکار کشف و فراخوانی کنند، بدون اینکه شما کد کلاینت API بنویسید.

قابلیت	جزئیات
پیش‌نیاز پلن	Pro (و صندلی‌های ورک‌اسپیس Pro)
پروتکل	REST (JSON روی HTTPS)
اندپوینت‌ها	chats · messages · contacts · custom_fields · tickets · broadcasts · workspace · members · accounts
احراز هویت	کلید API محدود به ورک‌اسپیس (توکن Bearer)
TTL پیش‌فرض کلید	۹۰ روز (قابل تنظیم کوتاه‌تر)
فهرست مجاز IP	بازه‌های CIDR اختیاری
ابطال	فوری
ممیزی	هر فراخوانی پیشوند کلید، IP و user agent را لاگ می‌کند
محدودیت نرخ	به‌ازای کلید، به‌ازای اندپوینت - ۴۲۹ با هدر Retry-After

سؤالات متداول

با API تلگرام CRM چه کاری می‌توانم انجام دهم؟

چت‌های تلگرام را فهرست و جستجو کنید، تاریخچه پیام را بخوانید، مخاطبان و فیلدهای سفارشی را مدیریت کنید، تیکت بسازید و با اولویت و مسئول به‌روزرسانی کنید، به سگمنت‌های تگ‌شده برودکست راه بیندازید، تگ اضافه و حذف کنید و مقادیر فیلد سفارشی را به‌روزرسانی کنید. هر اندپوینت محدود به ورک‌اسپیس و دارای لاگ ممیزی است.

چه اسکوپ‌هایی در دسترس هستند؟

workspace.read · members.read · accounts.read · contacts.read · chats.read · chats.write · custom_fields.read · custom_fields.write. حداقلی را که یکپارچه‌سازی شما نیاز دارد انتخاب کنید - دسترسی حداقلی شعاع آسیب را در صورت نشت کلید محدود می‌کند. همین اسکوپ‌ها روی API، سرور MCP و یکپارچه‌سازی Make.com اعمال می‌شوند.

نمونه‌های واقعی - تیم‌های واقعی چه می‌سازند؟

یک تیم ترید هر چت تلگرام را هر ساعت به BigQuery همگام می‌کند تا تحلیلگران بتوانند آن را با داده on-chain ترکیب کنند. یک تیم پشتیبانی SaaS یک کرون‌جاب دارد که تیکت‌های حل‌نشده دیروز را بیرون می‌کشد و آن‌ها را به یک خلاصه Slack می‌فرستد. یک تیم رشد از یک وب‌هوک برودکست تلگرام راه می‌اندازد هرگاه یک رویداد ارتقای Stripe رخ دهد. یک تیم عملیات یک داشبورد Retool ساخته که زمان پاسخ هر نماینده، گذردهی تیکت و توزیع مرحله پایپ‌لاین را نمایش می‌دهد - همه با API‌ Entergram.

چگونه کلیدهای API بسازم و مدیریت کنم؟

به تب توسعه‌دهندگان در ورک‌اسپیس Entergram خود بروید. روی «ساخت کلید» کلیک کنید، اسکوپ‌های موردنیاز را انتخاب کنید، به‌صورت اختیاری TTL کوتاه‌تر و فهرست مجاز IP تنظیم کنید و کلید را کپی کنید. کلید خام فقط یک‌بار نمایش داده می‌شود - آن را امن ذخیره کنید. کلیدها در حالت ذخیره یک‌طرفه هش می‌شوند. هر کلید را فوراً از همان تب ابطال کنید.

چگونه یک کلید نشت‌شده را بچرخانم؟

تب توسعه‌دهندگان ← کلید را با پیشوندش بیابید ← ابطال (فوری). سپس یک کلید جدید با همان اسکوپ‌ها و فهرست مجاز IP بسازید، آن را در یکپارچه‌سازی خود مستقر کنید و اطلاعات آخرین استفاده کلید قدیمی را بررسی کنید تا مطمئن شوید ترافیک دیگری نیست.

آیا API می‌تواند داده ورک‌اسپیس دیگری را ببیند؟

خیر. هر فراخوانی API محدود به ورک‌اسپیسی است که کلید را صادر کرده. کلیدی از ورک‌اسپیس A به‌معنای واقعی نمی‌تواند ورک‌اسپیس B را بخواند - محدودسازی در هر کوئری سمت سرور اعمال می‌شود.

چه خطاهای HTTP ممکن است ببینم؟

۴۰۱ = کلید منقضی، ابطال‌شده یا برای ورک‌اسپیس اشتباه است. ۴۰۳ = کلید فاقد اسکوپ موردنیاز است، یا درخواست از یک IP خارج از فهرست مجاز آمده. ۴۲۹ = به محدودیت نرخ رسیده‌اید؛ عقب بکشید و با هدر Retry-After دوباره تلاش کنید.

تفاوت API و سرور MCP چیست؟

هر دو به همان داده ورک‌اسپیس با همان اسکوپ‌ها دسترسی دارند. API برای کد شماست - کرون‌جاب‌ها، وب‌هوک‌ها، ابزارهای داخلی، خطوط لوله همگام‌سازی. سرور MCP برای عامل‌های AI است - Claude، ChatGPT، Cursor - که ابزارها را به‌صورت خودکار از طریق Model Context Protocol کشف و فراخوانی می‌کنند. وقتی کد مصرف‌کننده است از API استفاده کنید؛ وقتی AI است از سرور MCP.

آیا API از وب‌هوک پشتیبانی می‌کند؟

وب‌هوک‌های خروجی در نقشه راه هستند. امروز الگو مبتنی بر کشش است: API را به‌صورت زمان‌بندی‌شده یا در پاسخ به رویدادهای خودتان فراخوانی کنید. اپ Make.com همچنین تریگرهایی برای رویدادهای فضای کاری دارد؛ پیش از آنکه سناریویی را بر پایه یکی از آن‌ها طراحی کنید، فهرستش را داخل Make بررسی کنید.