getchat action

README.md

@@ -59,6 +59,7 @@ TelegramBot
 * [TelegramBot](#TelegramBot)
     * [new TelegramBot(token, [options])](#new_TelegramBot_new)
     * [.getMe()](#TelegramBot+getMe) ⇒ <code>Promise</code>
+    * [.getChat()](#TelegramBot+getChat) ⇒ <code>Promise</code>
     * [.setWebHook(url, [cert])](#TelegramBot+setWebHook)
     * [.getUpdates([timeout], [limit], [offset])](#TelegramBot+getUpdates) ⇒ <code>Promise</code>
     * [.sendMessage(chatId, text, [options])](#TelegramBot+sendMessage) ⇒ <code>Promise</code>
@@ -111,6 +112,15 @@ Returns basic information about the bot in form of a `User` object.
 
 **Kind**: instance method of <code>[TelegramBot](#TelegramBot)</code>  
 **See**: https://core.telegram.org/bots/api#getme  
+<a name="TelegramBot+getChat"></a>
+
+### telegramBot.getChat() ⇒ <code>Promise</code>
+Use this method to get up to date information about the chat
+(current name of the user for one-on-one conversations, current
+username of a user, group or channel, etc.).
+
+**Kind**: instance method of <code>[TelegramBot](#TelegramBot)</code>  
+**See**: https://core.telegram.org/bots/api#getchat  
 <a name="TelegramBot+setWebHook"></a>
 
 ### telegramBot.setWebHook(url, [cert])
@@ -362,7 +372,7 @@ Note that you must provide one of chat_id, message_id, or
 inline_message_id in your request.
 
 **Kind**: instance method of <code>[TelegramBot](#TelegramBot)</code>  
-**See**: https://core.telegram.org/bots/api#editmessagetext  
+**See**: https://core.telegram.org/bots/api#editmessagecaption  
 
 | Param | Type | Description |
 | --- | --- | --- |

src/telegram.js

@@ -186,6 +186,21 @@ class TelegramBot extends EventEmitter {
     return this._request(_path);
   }
 
+  /**
+   * Use this method to get up to date information about the chat
+   * (current name of the user for one-on-one conversations, current
+   * username of a user, group or channel, etc.).
+   * @return {Promise}
+   * @see https://core.telegram.org/bots/api#getchat
+   */
+  getChat(chatId) {
+    const form = {
+      chat_id: chatId
+    };
+
+    return this._request('getChat', {form: form});
+  }
+
   /**
    * Specify an url to receive incoming updates via an outgoing webHook.
    * @param {String} url URL where Telegram will make HTTP Post. Leave empty to

test/index.js

@@ -131,6 +131,15 @@ describe('Telegram', function telegramSuite() {
     });
   });
 
+  describe('#getChat', function getMeSuite() {
+    it('should return an User object', function test() {
+      const bot = new Telegram(TOKEN);
+      return bot.getChat(USERID).then(resp => {
+        assert.ok(is.object(resp));
+      });
+    });
+  });
+
   describe('#getUpdates', function getUpdatesSuite() {
     it('should return an Array', function test() {
       const bot = new Telegram(TOKEN);