Bot do Telegram (Editor Independente)
A API de Bot do Telegram é uma interface baseada em HTTP criada para desenvolvedores interessados em criar bots para o Telegram.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Woong Choi |
| URL | https://www.linkedin.com/in/woongchoi/ |
| woong.choi@rapidcircle.com |
| Metadados do conector | |
|---|---|
| Publicador | Woong Choi |
| Site | https://telegram.org/ |
| Política de privacidade | https://telegram.org/privacy |
| Categorias | Communication |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Enviar Foto |
Use esse método para enviar fotos. |
| Enviar Mensagem |
Use este método para enviar mensagens de texto |
| Obter atualizações |
Use esse método para receber atualizações de entrada usando sondagem longa |
| Obter chat |
Use este método para obter informações atualizadas sobre o chat |
| Obter-me |
Retorna informações básicas sobre o bot na forma de um objeto User. Um método simples para testar o token de autenticação do bot. |
Enviar Foto
Use esse método para enviar fotos.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Bot Token
|
token | True | string |
Token de Bot do Telegram. por exemplo, 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11 |
|
Chat ID
|
chat_id | string |
chat_id |
|
|
Foto
|
photo | string |
Fototo enviar |
Retornos
Esse objeto representa uma mensagem.
- Message
- Message
Enviar Mensagem
Use este método para enviar mensagens de texto
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Bot Token
|
token | True | string |
Token de Bot do Telegram. por exemplo, 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11 |
|
Chat ID
|
chat_id | string |
chat_id |
|
|
Texto
|
text | string |
Texto a ser enviado |
|
|
Modo de Análise
|
parse_mode | string |
Modo para analisar entidades no texto da mensagem. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Ok
|
ok | boolean |
Ok |
|
Message
|
result | Message |
Esse objeto representa uma mensagem. |
Obter atualizações
Use esse método para receber atualizações de entrada usando sondagem longa
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Bot Token
|
token | True | string |
Token de Bot do Telegram. por exemplo, 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11 |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
OKEY
|
ok | boolean |
Solicitação bem-sucedida |
|
resultado
|
result | array of Update |
resultado |
Obter chat
Use este método para obter informações atualizadas sobre o chat
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Bot Token
|
token | True | string |
Token de Bot do Telegram. por exemplo, 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11 |
|
Chat ID
|
chat_id | string |
chat_id |
Retornos
Esse objeto representa uma mensagem.
- Message
- Message
Obter-me
Retorna informações básicas sobre o bot na forma de um objeto User. Um método simples para testar o token de autenticação do bot.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Bot Token
|
token | True | string |
Token de Bot do Telegram. por exemplo, 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11 |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
OKEY
|
ok | boolean |
Solicitação bem-sucedida |
|
Utilizador
|
result | User |
Esse objeto representa um usuário ou bot do Telegram |
Definições
Chat
Esse objeto representa um chat
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Chat ID
|
id | integer |
Identificador exclusivo para este chat |
|
Primeiro Nome
|
first_name | string |
Nome da outra parte em um chat privado |
|
Apelido
|
last_name | string |
Sobrenome da outra parte em um chat privado |
|
Nome do usuário
|
username | string |
Nome de usuário, para chats privados, supergrupos e canais, se disponível |
|
Chat
|
type | string |
Tipo de chat, pode ser "privado", "grupo", "supergrupo" ou "canal" |
Update
Esse objeto representa uma atualização de entrada.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID da atualização
|
update_id | integer |
O identificador exclusivo da atualização. |
|
Message
|
message | Message |
Esse objeto representa uma mensagem. |
Message
Esse objeto representa uma mensagem.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID da mensagem
|
message_id | integer |
Identificador de mensagem exclusivo dentro deste chat |
|
Utilizador
|
from | User |
Esse objeto representa um usuário ou bot do Telegram |
|
Chat
|
chat | Chat |
Esse objeto representa um chat |
|
Date
|
date | integer |
Data em que a mensagem foi enviada na hora do Unix |
|
Texto
|
text | string |
Para mensagens de texto, o texto UTF-8 real da mensagem, 0-4096 caracteres |
Utilizador
Esse objeto representa um usuário ou bot do Telegram
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | integer |
Identificador exclusivo para este usuário ou bot |
|
É Bot
|
is_bot | boolean |
True, se esse usuário for um bot |
|
Primeiro Nome
|
first_name | string |
Nome do usuário ou bot |
|
Apelido
|
last_name | string |
Sobrenome do usuário ou bot |
|
Nome do usuário
|
username | string |
Nome de usuário do usuário ou bot |
|
Código de idioma
|
language_code | string |
Marca de idioma IETF do idioma do usuário |
|
Pode unir grupos
|
can_join_groups | boolean |
True, se o bot puder ser convidado para grupos. |
|
Pode ler todas as mensagens de grupo
|
can_read_all_group_messages | boolean |
True, se o modo de privacidade estiver desabilitado para o bot. |
|
Dá suporte a consultas embutidas
|
supports_inline_queries | boolean |
True, se o bot for compatível com consultas embutidas. |