Tôi có thể làm gì với Telegram CRM API?
+
Liệt kê và tìm kiếm chat Telegram, đọc lịch sử tin nhắn, quản lý danh bạ và trường tùy chỉnh, tạo và cập nhật ticket kèm mức ưu tiên và người được giao, kích hoạt broadcast tới các phân khúc đã gắn thẻ, thêm và gỡ thẻ, và cập nhật giá trị trường tùy chỉnh. Mọi endpoint đều có phạm vi theo không gian làm việc và được ghi nhật ký kiểm toán.
Có những phạm vi quyền nào?
+
workspace.read · members.read · accounts.read · contacts.read · chats.read · chats.write · custom_fields.read · custom_fields.write. Chọn mức tối thiểu mà tích hợp của bạn cần: quyền tối thiểu giới hạn phạm vi thiệt hại nếu một khóa bị lộ. Cùng các phạm vi này áp dụng cho API, máy chủ MCP và tích hợp Make.com.
Ví dụ cụ thể: các đội thực tế xây dựng gì?
+
Một đội giao dịch đồng bộ mọi cuộc chat Telegram vào BigQuery mỗi giờ để chuyên viên phân tích kết hợp với dữ liệu on-chain. Một đội hỗ trợ SaaS dùng cron job kéo các ticket chưa xử lý của hôm qua và đẩy vào bản tóm tắt trên Slack. Một đội tăng trưởng gửi broadcast Telegram từ webhook mỗi khi có sự kiện nâng cấp trên Stripe. Một đội vận hành dựng bảng điều khiển Retool hiển thị thời gian phản hồi theo từng nhân viên, lưu lượng ticket và phân bố stage trong pipeline. Tất cả đều chạy trên API của Entergram.
Làm sao để tạo và quản lý khóa API?
+
Vào tab Developers trong không gian làm việc Entergram. Nhấp 'Create key', chọn các phạm vi bạn cần, tùy chọn đặt TTL ngắn hơn và danh sách IP được phép, rồi sao chép khóa. Khóa gốc chỉ hiển thị một lần, nên hãy lưu nó an toàn. Khóa được băm một chiều khi lưu trữ. Thu hồi bất kỳ khóa nào ngay lập tức từ cùng tab đó.
Làm sao để xoay vòng một khóa bị lộ?
+
Tab Developers → tìm khóa theo tiền tố → Revoke (có hiệu lực ngay). Sau đó tạo khóa mới với cùng phạm vi và danh sách IP được phép, triển khai vào tích hợp của bạn, và kiểm tra thông tin lần dùng cuối của khóa cũ để xác nhận không còn lưu lượng nào.
API có thấy được dữ liệu của không gian làm việc khác không?
+
Không. Mọi lệnh gọi API đều bị giới hạn trong không gian làm việc đã cấp khóa. Khóa từ không gian làm việc A hoàn toàn không đọc được không gian làm việc B, vì phạm vi được thực thi ở phía máy chủ trên mọi truy vấn.
Tôi có thể gặp những lỗi HTTP nào?
+
401 = khóa đã hết hạn, đã bị thu hồi hoặc không đúng với không gian làm việc. 403 = khóa thiếu phạm vi cần thiết, hoặc request đến từ một IP nằm ngoài danh sách được phép. 429 = bạn đã chạm giới hạn tốc độ; hãy chờ rồi thử lại theo header Retry-After.
API và máy chủ MCP khác nhau thế nào?
+
Cả hai truy cập cùng dữ liệu không gian làm việc với cùng các phạm vi. API dành cho code của bạn: cron job, webhook, công cụ nội bộ, luồng đồng bộ. Máy chủ MCP dành cho tác tử AI (Claude, ChatGPT, Cursor) tự khám phá và gọi công cụ qua Model Context Protocol. Dùng API khi bên sử dụng là code; dùng máy chủ MCP khi bên sử dụng là AI.
API có hỗ trợ webhook không?
+
Webhook gửi đi đang nằm trong lộ trình phát triển. Hiện nay, cách làm là kéo dữ liệu: gọi API theo lịch hoặc để phản hồi sự kiện của chính bạn. Nếu cần tự động hóa kiểu đẩy, ứng dụng Make.com cũng có trigger cho các sự kiện trong workspace; hãy xem danh sách trong Make trước khi thiết kế kịch bản dựa trên một trigger nào đó.
