From a97aa009c2b41a3411623d2f1eb168b640411307 Mon Sep 17 00:00:00 2001 From: Yago Date: Mon, 29 Jun 2015 00:51:10 +0200 Subject: [PATCH] Create README.md --- README.md | 98 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 98 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..7c46d3d --- /dev/null +++ b/README.md @@ -0,0 +1,98 @@ +* * * + +## Class: TelegramBot +NodeJS class for Telegram Bot API. + +Support for WebHooks and long polling. Emits `message` when message arrives. + +### TelegramBot.getMe() + +Returns basic information about the bot in form of a `User` object. + +**Returns**: `Promise` + +### TelegramBot.setWebHook(url) + +Specify a url to receive incoming updates via an outgoing webHook. + +**Parameters** + +**url**: `String`, URL + + +### TelegramBot.getUpdates(timeout, limit, offset) + +Use this method to receive incoming updates using long polling + +**Parameters** + +**timeout**: `Number | String`, Timeout in seconds for long polling. + +**limit**: `Number | String`, Limits the number of updates to be retrieved. + +**offset**: `Number | String`, Identifier of the first update to be returned. + +**Returns**: `Promise`, Updates + +### TelegramBot.sendMessage(chatId, text, options) + +Send text message. + +**Parameters** + +**chatId**: `Number | String`, Unique identifier for the message recipient + +**text**: `Sting`, Text of the message to be sent + +**options**: `Object`, Additional Telegram query options + +**Returns**: `Promise` + +### TelegramBot.forwardMessage(chatId, fromChatId, messageId) + +Forward messages of any kind. + +**Parameters** + +**chatId**: `Number | String`, Unique identifier for the message recipient + +**fromChatId**: `Number | String`, Unique identifier for the chat where the +original message was sent + +**messageId**: `Number | String`, Unique message identifier + +**Returns**: `Promise` + +### TelegramBot.sendPhoto(chatId, photo, options) + +Send photo + +**Parameters** + +**chatId**: `Number | String`, Unique identifier for the message recipient + +**photo**: `String | stream.Stream`, A file path or a Stream. Can +also be a `file_id` previously uploaded + +**options**: `Object`, Additional Telegram query options + +**Returns**: `Promise` + +### TelegramBot.sendAudio(chatId, audio, options) + +Send audio + +**Parameters** + +**chatId**: `Number | String`, Unique identifier for the message recipient + +**audio**: `String | stream.Stream`, A file path or a Stream. Can +also be a `file_id` previously uploaded. + +**options**: `Object`, Additional Telegram query options + +**Returns**: `Promise` + + + +* * *