ابرووا
شروع رایگان
☰ فهرست مستندات · Telegram

یکپارچگی Telegram

هشدارهای خطای ابرووا تریس را فوراً با یک ربات Telegram بگیرید. ربات را با BotFather بسازید، Chat ID را پیدا کنید و دریافت اعلان‌ها را شروع کنید.

به‌روزرسانی: ۵ آبان ۱۴۰۵

هشدارهای خطا را فوراً با ربات Telegram بگیرید. یک ربات بسازید، chat ID خود را پیدا کنید و در چند دقیقه دریافت اعلان‌ها را شروع کنید.

دسترسی به Telegram از ایران.

Telegram سرویسی بیرون از ایران است و ممکن است از برخی شبکه‌های داخل ایران در دسترس نباشد. برای راه‌اندازی و خواندن هشدارها به اتصالی نیاز دارید که به Telegram برسد، و پیام‌ها فقط وقتی می‌رسند که api.telegram.org پاسخ دهد؛ ارسال‌های ناموفق در لاگ ارسال یکپارچگی نمایش داده می‌شوند. اگر این برای تیم شما مشکل است، به‌جای آن یا در کنارش از یکپارچگی ایمیل یا Webhook استفاده کنید.

این‌که پروژه‌ی شما از کدام کانال‌ها می‌تواند استفاده کند، در صفحه‌ی ابرووا تریس ← یکپارچه‌سازی‌ها در کنسول ابرووا نمایش داده می‌شود.

ساختن ربات Telegram#

  1. Telegram را باز کنید و @BotFather را جست‌وجو کنید
  2. دستور /newbot را بفرستید
  3. یک نام برای ربات وارد کنید (مثلاً «AbrovaTrace Alerts»)
  4. یک نام کاربری وارد کنید (باید با «bot» تمام شود، مثلاً «MyAbrovaTrace_bot»)
  5. Bot Token را که BotFather می‌دهد کپی کنید

قالب توکن: 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz123456789

نکته‌ی امنیتی. توکن ربات را محرمانه نگه دارید. هر کسی توکن را داشته باشد می‌تواند ربات شما را کنترل کند.

پیدا کردن Chat ID#

گزینه‌ی الف: گفت‌وگوی شخصی

  1. با ربات خود گفت‌وگو را شروع کنید (با نام کاربری جست‌وجویش کنید)
  2. هر پیامی به ربات بفرستید
  3. این URL را در مرورگر باز کنید:
text
https://api.telegram.org/bot{YOUR_BOT_TOKEN}/getUpdates

Chat ID را در پاسخ JSON زیر message.chat.id پیدا کنید.

گزینه‌ی ب: گروه

  1. یک گروه جدید بسازید یا از گروهی موجود استفاده کنید
  2. ربات را به گروه اضافه کنید
  3. در گروه یک پیام بفرستید
  4. از همان URL مربوط به getUpdates در بالا استفاده کنید

Chat ID گروه‌ها عدد منفی است (مثلاً -1001234567890).

پیکربندی در ابرووا تریس#

  1. در کنسول ابرووا، ابرووا تریس ← یکپارچه‌سازی‌ها را باز کنید (یکپارچگی‌ها متعلق به پروژه‌ی انتخاب‌شده‌اند)
  2. روی «افزودن یکپارچه‌سازی» کلیک کنید و Telegram را انتخاب کنید (یا روی کارت Telegram «اتصال» را بزنید)
  3. یک نام، Bot token و Chat ID را وارد کنید
  4. روی «ذخیره و ارسال تست» کلیک کنید تا ذخیره و بررسی شود (یا «ذخیرهٔ کانال»)
گزینهنوعاجباریتوضیح
Namestringبلهنامی آشنا (مثلاً Ops chat)
Bot tokenstringبلهتوکنی که BotFather داده است (1234567890:ABC...)
Chat IDstringبلهChat ID شخصی یا گروه (یک عدد، مثلاً -1001234567890) یا @channelname

بعد از ذخیره

مدیریت یکپارچگی‌ها (افزودن، ویرایش، روشن و خاموش کردن، حذف، تست) نقش admin یا owner می‌خواهد؛ همه‌ی نقش‌ها می‌توانند آن‌ها و لاگ ارسالشان را ببینند. نقش‌ها و دسترسی‌ها را ببینید.

توکن ربات بعد از ذخیره دیگر هرگز نمایش داده نمی‌شود: فرم آن را «تنظیم‌شده» نشان می‌دهد. دست نزنید تا توکن ذخیره‌شده بماند، یا جایگزینی را بزنید تا توکن تازه‌ای وارد کنید.

اگر Chat ID را تغییر دهید، توکن ربات را هم دوباره وارد کنید؛ توکن ذخیره‌شده هرگز خودبه‌خود برای گفت‌وگوی دیگری استفاده نمی‌شود.

قالب اعلان#

پیام‌های Telegram از ابرووا تریس شامل این‌هاست:

  • سرتیتر 🚨 New Error Detected
  • پیام خطا در یک بلوک monospace
  • پروژه، محیط، تعداد رخدادها و زمان اولین دیده شدن
  • ۵۰۰ کاراکتر اول stack trace
  • لینک View in Dashboard

عیب‌یابی#

ربات پیام نمی‌فرستد؟
  • اول باید با ربات گفت‌وگو را شروع کرده باشید
  • مطمئن شوید Bot Token درست است
  • مطمئن شوید Chat ID دقیق است
  • در گروه‌ها، مطمئن شوید ربات عضو گروه است
  • لاگ ارسال یکپارچگی را ببینید: timeout یا خطای اتصال یعنی Telegram در دسترس نبوده است
Chat ID در getUpdates دیده نمی‌شود؟
  • بعد از ساختن ربات به آن پیام بفرستید
  • چند ثانیه صبر کنید و URL را دوباره بارگذاری کنید
  • در گروه‌ها، بعد از اضافه کردن ربات پیام بفرستید
خطای «Unauthorized»؟
  • ممکن است Bot Token نامعتبر یا باطل شده باشد
  • با دستور /revoke در BotFather توکن تازه بسازید
  • یکپارچگی را در ابرووا تریس ← یکپارچه‌سازی‌ها ویرایش کنید و روی توکن ربات «جایگزینی» را بزنید
قبلی
وب‌هوک دلخواهبعدی
Discord
این صفحه مفید بود؟
گزارش مشکل