Udostępnij przez

Bot Telegram (niezależny wydawca)

Interfejs API bota Usługi Telegram to oparty na protokole HTTP interfejs utworzony dla deweloperów, którzy chcą tworzyć boty dla usługi Telegram.

Ten łącznik jest dostępny w następujących produktach i regionach:

Usługa Class Regions
Copilot Studio Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Logic Apps Standard Wszystkie regiony usługi Logic Apps z wyjątkiem następujących:
     — Regiony platformy Azure Government
     — Regiony platformy Azure (Chiny)
     - Departament Obrony USA (DoD)
Power Apps Premium Wszystkie regiony usługi Power Apps z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Power Automate Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Kontakt
Name Woong Choi
adres URL https://www.linkedin.com/in/woongchoi/
Email woong.choi@rapidcircle.com
Metadane łącznika
Publisher Woong Choi
Witryna internetowa https://telegram.org/
Zasady ochrony prywatności https://telegram.org/privacy
Kategorie Communication

Limity ograniczania

Nazwa Wywołania Okres odnowienia
Wywołania interfejsu API na połączenie 100 60 sekund

Akcje

Pobieranie aktualizacji

Ta metoda służy do odbierania aktualizacji przychodzących przy użyciu długiego sondowania
Pobierz mnie

Zwraca podstawowe informacje o botze w postaci obiektu Użytkownik. Prosta metoda testowania tokenu uwierzytelniania bota.
Uzyskiwanie czatu

Użyj tej metody, aby uzyskać aktualne informacje o czacie
Wyślij wiadomość

Użyj tej metody do wysyłania wiadomości tekstowych
Wyślij zdjęcie

Użyj tej metody do wysyłania zdjęć.

Pobieranie aktualizacji

Identyfikator operacji:
GetUpdates

Ta metoda służy do odbierania aktualizacji przychodzących przy użyciu długiego sondowania

Parametry

Nazwa Klucz Wymagane Typ Opis
Token bota
 token True string

Token bota telegramu. np. 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

Zwraca

Nazwa Ścieżka Typ Opis
OK
 ok boolean

Żądanie powiodło się
wynik
 result array of Update

wynik

Pobierz mnie

Identyfikator operacji:
GetMe

Zwraca podstawowe informacje o botze w postaci obiektu Użytkownik. Prosta metoda testowania tokenu uwierzytelniania bota.

Parametry

Nazwa Klucz Wymagane Typ Opis
Token bota
 token True string

Token bota telegramu. np. 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

Zwraca

Nazwa Ścieżka Typ Opis
OK
 ok boolean

Żądanie powiodło się
User
 result User

Ten obiekt reprezentuje użytkownika lub bota usługi Telegram

Uzyskiwanie czatu

Identyfikator operacji:
GetChat

Użyj tej metody, aby uzyskać aktualne informacje o czacie

Parametry

Nazwa Klucz Wymagane Typ Opis
Token bota
 token True string

Token bota telegramu. np. 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
Identyfikator czatu
 chat_id string

chat_id

Zwraca

Ten obiekt reprezentuje komunikat.

Message
Message

Wyślij wiadomość

Identyfikator operacji:
SendMessage

Użyj tej metody do wysyłania wiadomości tekstowych

Parametry

Nazwa Klucz Wymagane Typ Opis
Token bota
 token True string

Token bota telegramu. np. 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
Identyfikator czatu
 chat_id string

chat_id
Tekst
 text string

Tekst do wysłania
Tryb analizowania
 parse_mode string

Tryb analizowania jednostek w tekście wiadomości.

Zwraca

Nazwa Ścieżka Typ Opis
Ok
 ok boolean

Ok
Message
 result Message

Ten obiekt reprezentuje komunikat.

Wyślij zdjęcie

Identyfikator operacji:
SendPhoto

Użyj tej metody do wysyłania zdjęć.

Parametry

Nazwa Klucz Wymagane Typ Opis
Token bota
 token True string

Token bota telegramu. np. 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
Identyfikator czatu
 chat_id string

chat_id
Fotka
 photo string

Zdjęcie do wysłania

Zwraca

Ten obiekt reprezentuje komunikat.

Message
Message

Definicje

Chat

Ten obiekt reprezentuje czat

Nazwa Ścieżka Typ Opis
Identyfikator czatu
 id integer

Unikatowy identyfikator tego czatu
Imię
 first_name string

Imię drugiej strony w prywatnym czacie
Nazwisko
 last_name string

Nazwisko innej strony w prywatnym czacie
Nazwa użytkownika
 username string

Nazwa użytkownika, w przypadku czatów prywatnych, supergrup i kanałów, jeśli są dostępne
Chat
 type string

Typ czatu może być "prywatny", "grupa", "supergrupa" lub "kanał"

Update

Ten obiekt reprezentuje aktualizację przychodzącą.

Nazwa Ścieżka Typ Opis
Identyfikator aktualizacji
 update_id integer

Unikatowy identyfikator aktualizacji.
Message
 message Message

Ten obiekt reprezentuje komunikat.

Message

Ten obiekt reprezentuje komunikat.

Nazwa Ścieżka Typ Opis
Identyfikator komunikatu
 message_id integer

Unikatowy identyfikator wiadomości wewnątrz tego czatu
User
 from User

Ten obiekt reprezentuje użytkownika lub bota usługi Telegram
Chat
 chat Chat

Ten obiekt reprezentuje czat
Date
 date integer

Data wysłania wiadomości w czasie systemu Unix
Tekst
 text string

W przypadku wiadomości tekstowych rzeczywisty tekst UTF-8 wiadomości, 0–4096 znaków

User

Ten obiekt reprezentuje użytkownika lub bota usługi Telegram

Nazwa Ścieżka Typ Opis
identyfikator
 id integer

Unikatowy identyfikator tego użytkownika lub bota
Jest botem
 is_bot boolean

Prawda, jeśli ten użytkownik jest botem
Imię
 first_name string

Imię użytkownika lub bota
Nazwisko
 last_name string

Nazwisko użytkownika lub bota
Nazwa użytkownika
 username string

Nazwa użytkownika lub bota
Kod języka
 language_code string

Tag języka IETF języka użytkownika
Może dołączać do grup
 can_join_groups boolean

Prawda, jeśli bot może zostać zaproszony do grup.
Może odczytywać wszystkie komunikaty grupowe
 can_read_all_group_messages boolean

Prawda, jeśli tryb prywatności jest wyłączony dla bota.
Obsługuje zapytania wbudowane
 supports_inline_queries boolean

Prawda, jeśli bot obsługuje zapytania wbudowane.