Metadata-Version: 2.0
Name: lambdagram
Version: 0.9.2
Summary: telegram bot wrapper with webhook for aws lambda
Home-page: https://github.com/jwkcp/lambdagram
Author: Jaewoong
Author-email: jaewoong.go@gmail.com
License: UNKNOWN
Download-URL: https://pypi.org/project/lambdagram/#files
Description-Content-Type: UNKNOWN
Keywords: telegram,aws,lambda
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Requires-Python: >=3
Requires-Dist: requests

# lambdagram

lambdagram is the library to help who want to create telegram bot with [official telegram bot api](https://core.telegram.org/bots/api) using webhook on AWS lambda.

## Introduction

Main target of this library is who want to create telegram bot using webhook simply and easily. Especially for AWS lambda platform. Because AWS lambda do not allow to use polling mechanism for infinite loops. Just sending and receiving message through webhook. Not a big deal. But I believe this pretty helpful for someone who telegram and AWS lambda newbies.

## Installing

~~~
pip install lamdbgram
~~~  

## Telegram API support

- getMe
- setWebhook
- getWebhookInfo
- deleteWebhook

## Key function the lambdagram support

- send_message(self, event, msg) - Efficient way, but you must set webhook before use this method using web browser.
  (https://api.telegram.org/bot{TOKEN}/setWebhook?url={WEBHOOKURL}, remove '{' and '}')
- send_message(self, event, msg, webhook_url) - Inefficient way, but it's useful for beginners.

## How to use

~~~
from lambdagram.bot import Bot


WEBHOOK = "https://YOUR-WEBHOOK-URL"
TOKEN = "THE TOKEN YOU GOT FROM @BotFather"

def lambda_handler(event, context): # Basic function signature on AWS lambda 

    bot = Bot(TOKEN)
    bot.send_message(event, "THE MESSAGE YOU WANT TO SEND")
~~~

or

~~~
from lambdagram.bot import Bot


WEBHOOK = "https://YOUR-WEBHOOK-URL"
TOKEN = "THE TOKEN YOU GOT FROM @BotFather"

def lambda_handler(event, context): # Basic function signature on AWS lambda 

    bot = Bot(TOKEN)
    bot.send_message(event, "THE MESSAGE YOU WANT TO SEND", WEBHOOK)
~~~



