Co skonfigurujesz
- Bota Telegram utworzonego przez BotFather - token należy do Ciebie, Elido przechowuje go w postaci zaszyfrowanej.
- Twój numeryczny chat ID, czy to czat prywatny, czy grupa (w tym supergrupy z prefiksem
-100). - Konfigurację dla poszczególnych zdarzeń dla alertów o linkach, domenach i limitach użycia.
Elido wysyła powiadomienia Telegram przez bota, którego tworzysz. Bot wysyła wiadomości na konkretny czat - prywatny z samym sobą lub do grupy. Token bota należy do Ciebie; Elido przechowuje go wyłącznie w postaci zaszyfrowanej.
Krok 1 - Utwórz bota w BotFather
- Otwórz Telegram i wyszukaj
@BotFatherlub otwórzhttps://t.me/BotFather. - Wyślij
/newbot. - Postępuj zgodnie z instrukcjami: wybierz nazwę wyświetlaną, a potem nazwę użytkownika (musi kończyć się na
bot, np.AcmeElidoBot). - BotFather odpowie Twoim tokenem API. Wygląda on tak:
123456789:AABBccDD.... Skopiuj go od razu - możesz go później odzyskać z/mybots, ale szybciej jest skopiować go teraz.
Krok 2 - Znajdź swój chat ID
Potrzebujesz numerycznego chat ID miejsca, do którego mają trafiać wiadomości.
Dla czatu prywatnego (tylko Ty):
-
Wyślij dowolną wiadomość do swojego nowego bota.
-
Otwórz ten adres w przeglądarce, zastępując
TOKENswoim tokenem:https://api.telegram.org/botTOKEN/getUpdates -
Znajdź w odpowiedzi
"chat":{"id":...}. Ta liczba to Twój chat ID. W czatach osobistych jest to zwykle dodatnia liczba całkowita o 9 cyfrach.
Dla grupy:
- Dodaj bota do grupy.
- Wyślij w grupie wiadomość z oznaczeniem bota przez @ (np.
@AcmeElidoBot hello). - Otwórz ten sam adres
getUpdates. Identyfikatory czatów grupowych są liczbami ujemnymi (np.-1001234567890).
Krok 3 - Skonfiguruj Elido
- Przejdź do Settings → Notifications → Telegram → Add channel.
- Wklej token bota i chat ID.
- Kliknij Save. Elido wyśle wiadomość testową. Spodziewaj się jej w Telegramie w ciągu 2 sekund.
Wybierz zdarzenia
Po połączeniu kliknij Configure events, aby wybrać, które zdarzenia wywołują wiadomość:
link.broken- zalecany punkt wyjścia: monitor uszkodzonych linków znalazł adres docelowy, który już nie działa.usage.threshold_80iusage.threshold_100- workspace wykorzystał 80% lub 100% limitu planu.link.expiredilink.cap_reached- link wygasł lub osiągnął limit kliknięć.link.created- przydatne we współdzielonych workspace'ach, w których chcesz widzieć nowe linki.domain.verifiedidomain.ssl_failed- status własnej domeny.
Pełna lista typów zdarzeń znajduje się w przewodniku po webhookach.
Usuń integrację
Przejdź do Settings → Notifications → Telegram → Remove. Usuwa to token bota z bazy danych Elido. Opcjonalnie unieważnij samego bota w BotFather poleceniem /revoke.
Rozwiązywanie problemów
„Unauthorized” w logu dostarczeń - Token jest błędny. Sprawdź to, wklejając do przeglądarki ten adres:
https://api.telegram.org/botTOKEN/getMe
Jeśli zwraca {"ok":false,...}, token jest nieprawidłowy.
„Chat not found” - Chat ID jest błędny lub bot nigdy nie został dodany do grupy. W przypadku grup upewnij się, że bot jest członkiem, i wyślij wiadomość z jego oznaczeniem, zanim wywołasz getUpdates.
Brak wiadomości po kliknięciu Test - Sprawdź getUpdates, aby potwierdzić, że bot otrzymał jakąkolwiek interakcję. Jeśli odpowiedź jest pusta, Telegram nie zarejestrował jeszcze żadnego kontaktu między użytkownikiem/grupą a botem.
Wiadomości w grupie są niewidoczne - Niektóre grupy Telegram mają „tryb powolny” lub pozwalają pisać tylko administratorom. Nadaj botowi rolę administratora z uprawnieniem „Post messages”.