====
WABC
====
A modern, easy to use, feature-rich ready API wrapper for `WhatsApp Business Cloud (WABC)`_ written in Python.
* Documentation: https://leandcesar.github.io/wabc/
* GitHub: https://github.com/leandcesar/wabc/
* PyPI: https://pypi.org/project/wabc/
* Free and open source software: MIT license
Features
--------
* Full `Send Messages`_ Support (text, audio, contacts, documents, images, interactive, location, sticker, and videos)
* Full `Webhook Notification`_ Parsing Support
Installing
----------
Stable release
~~~~~~~~~~~~~~
To install wabc, run this command in your terminal:
.. code-block:: console
$ pip install wabc
This is the preferred method to install wabc, as it will always install the most recent stable release.
If you don't have `pip`_ installed, this `Python installation guide`_ can guide
you through the process.
From sources
~~~~~~~~~~~~
The sources for wabc can be downloaded from the `Github repo`_.
You can either clone the public repository:
.. code-block:: console
$ git clone git://github.com/leandcesar/wabc
Or download the `tarball`_:
.. code-block:: console
$ curl -OJL https://github.com/leandcesar/wabc/tarball/master
Once you have a copy of the source, you can install it with:
.. code-block:: console
$ python setup.py install
Quick Example
-------------
Mirror Bot
~~~~~~~~~~
.. code:: py
from wabc import Bot, Ctx
class MirrorBot(Bot):
def before_event_message(self, ctx: Ctx):
ctx.read()
def on_event_message_audio(self, ctx: Ctx):
ctx.send_audio(ctx.message.audio.id)
def on_event_message_document(self, ctx: Ctx):
ctx.send_document(
ctx.message.document.id,
caption=ctx.message.document.caption,
)
def on_event_message_image(self, ctx: Ctx):
ctx.send_image(
ctx.message.image.id,
caption=ctx.message.image.caption,
)
def on_event_message_location(self, ctx: Ctx):
ctx.send_location(
latitude=ctx.message.location.latitude,
longitude=ctx.message.location.longitude,
address=ctx.message.location.address,
name=ctx.message.location.name,
)
def on_event_message_sticker(self, ctx: Ctx):
ctx.send_sticker(ctx.message.sticker.id)
def on_event_message_text(self, ctx: Ctx):
ctx.send_text(ctx.message.text.body)
def on_event_message_video(self, ctx: Ctx):
ctx.send_video(
ctx.message.video.id,
caption=ctx.message.video.caption,
)
Run using Flask
~~~~~~~~~~~~~~~
.. code:: py
from flask import Flask, request
from wabc import Bot
app = Flask(__name__)
bot = Bot()
bot.start(phone_id="PHONE_ID", token="ACCESS_TOKEN")
@app.get("/")
async def ping():
if request.args.get("hub.verify_token") == "VERIFY_TOKEN":
return request.args.get("hub.challenge")
return "Invalid verify token"
@app.post("/")
def root():
data = request.get_json()
bot.handle(data)
return "Success"
Run using Fast API
~~~~~~~~~~~~~~~~~~
.. code:: py
from fastapi import FastAPI, Request
from wabc import Bot
app = FastAPI()
bot = Bot()
bot.start(phone_id="PHONE_ID", token="ACCESS_TOKEN")
@app.get("/")
async def ping(
token: str = Query(alias="hub.verify_token"),
challenge: str = Query(alias="hub.challenge"),
):
if token == VERIFY_TOKEN:
return challenge
return "Invalid verify token"
@app.post("/")
async def root(request: Request):
data = await request.json()
bot.handle(data)
return "Success"
Useful Links
------------
* `Get Started with the WhatsApp Business Cloud API`_
Credits
-------
This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.
.. _`WhatsApp Business Cloud (WABC)`: https://developers.facebook.com/docs/whatsapp/cloud-api
.. _`Send Messages`: https://developers.facebook.com/docs/whatsapp/cloud-api/reference/messages
.. _`Webhook Notification`: https://developers.facebook.com/docs/whatsapp/cloud-api/webhooks/components
.. _`pip`: https://pip.pypa.io
.. _`Python installation guide`: http://docs.python-guide.org/en/latest/starting/installation/
.. _`Github repo`: https://github.com/leandcesar/wabc
.. _`tarball`: https://github.com/leandcesar/wabc/tarball/master
.. _`Get Started with the WhatsApp Business Cloud API`: https://developers.facebook.com/docs/whatsapp/cloud-api/get-started
.. _`Cookiecutter`: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage
=======
History
=======
0.3.0 (2022-12-25)
------------------
* Implement methods for each message type.
* Implement `Routine`.
0.2.0 (2022-12-24)
------------------
* Rename project to wabc.
0.1.0 (2022-12-19)
------------------
* First release on PyPI.
Raw data
{
"_id": null,
"home_page": "https://github.com/leandcesar/wabc",
"name": "wabc",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "whatsapp",
"author": "Leandro C\u00e9sar Cassimiro",
"author_email": "ccleandroc@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/b5/db/ebf67f82a68944fefa7c10ddc42f5e69c052bfe813dcdb89affbcad9a426/wabc-0.3.0.tar.gz",
"platform": null,
"description": "====\nWABC\n====\n\nA modern, easy to use, feature-rich ready API wrapper for `WhatsApp Business Cloud (WABC)`_ written in Python.\n\n\n* Documentation: https://leandcesar.github.io/wabc/\n* GitHub: https://github.com/leandcesar/wabc/\n* PyPI: https://pypi.org/project/wabc/\n* Free and open source software: MIT license\n\n\nFeatures\n--------\n\n* Full `Send Messages`_ Support (text, audio, contacts, documents, images, interactive, location, sticker, and videos)\n* Full `Webhook Notification`_ Parsing Support\n\nInstalling\n----------\n\nStable release\n~~~~~~~~~~~~~~\n\nTo install wabc, run this command in your terminal:\n\n.. code-block:: console\n\n $ pip install wabc\n\nThis is the preferred method to install wabc, as it will always install the most recent stable release.\n\nIf you don't have `pip`_ installed, this `Python installation guide`_ can guide\nyou through the process.\n\nFrom sources\n~~~~~~~~~~~~\n\nThe sources for wabc can be downloaded from the `Github repo`_.\n\nYou can either clone the public repository:\n\n.. code-block:: console\n\n $ git clone git://github.com/leandcesar/wabc\n\nOr download the `tarball`_:\n\n.. code-block:: console\n\n $ curl -OJL https://github.com/leandcesar/wabc/tarball/master\n\nOnce you have a copy of the source, you can install it with:\n\n.. code-block:: console\n\n $ python setup.py install\n\nQuick Example\n-------------\n\nMirror Bot\n~~~~~~~~~~\n\n.. code:: py\n\n from wabc import Bot, Ctx\n\n class MirrorBot(Bot):\n def before_event_message(self, ctx: Ctx):\n ctx.read()\n\n def on_event_message_audio(self, ctx: Ctx):\n ctx.send_audio(ctx.message.audio.id)\n\n def on_event_message_document(self, ctx: Ctx):\n ctx.send_document(\n ctx.message.document.id,\n caption=ctx.message.document.caption,\n )\n\n def on_event_message_image(self, ctx: Ctx):\n ctx.send_image(\n ctx.message.image.id,\n caption=ctx.message.image.caption,\n )\n\n def on_event_message_location(self, ctx: Ctx):\n ctx.send_location(\n latitude=ctx.message.location.latitude,\n longitude=ctx.message.location.longitude,\n address=ctx.message.location.address,\n name=ctx.message.location.name,\n )\n\n def on_event_message_sticker(self, ctx: Ctx):\n ctx.send_sticker(ctx.message.sticker.id)\n\n def on_event_message_text(self, ctx: Ctx):\n ctx.send_text(ctx.message.text.body)\n\n def on_event_message_video(self, ctx: Ctx):\n ctx.send_video(\n ctx.message.video.id,\n caption=ctx.message.video.caption,\n )\n\nRun using Flask\n~~~~~~~~~~~~~~~\n\n.. code:: py\n\n from flask import Flask, request\n from wabc import Bot\n\n app = Flask(__name__)\n bot = Bot()\n bot.start(phone_id=\"PHONE_ID\", token=\"ACCESS_TOKEN\")\n\n @app.get(\"/\")\n async def ping():\n if request.args.get(\"hub.verify_token\") == \"VERIFY_TOKEN\":\n return request.args.get(\"hub.challenge\")\n return \"Invalid verify token\"\n\n @app.post(\"/\")\n def root():\n data = request.get_json()\n bot.handle(data)\n return \"Success\"\n\nRun using Fast API\n~~~~~~~~~~~~~~~~~~\n\n.. code:: py\n\n from fastapi import FastAPI, Request\n from wabc import Bot\n\n app = FastAPI()\n bot = Bot()\n bot.start(phone_id=\"PHONE_ID\", token=\"ACCESS_TOKEN\")\n\n @app.get(\"/\")\n async def ping(\n token: str = Query(alias=\"hub.verify_token\"),\n challenge: str = Query(alias=\"hub.challenge\"),\n ):\n if token == VERIFY_TOKEN:\n return challenge\n return \"Invalid verify token\"\n\n @app.post(\"/\")\n async def root(request: Request):\n data = await request.json()\n bot.handle(data)\n return \"Success\"\n\nUseful Links\n------------\n\n* `Get Started with the WhatsApp Business Cloud API`_\n\nCredits\n-------\n\nThis package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.\n\n\n.. _`WhatsApp Business Cloud (WABC)`: https://developers.facebook.com/docs/whatsapp/cloud-api\n.. _`Send Messages`: https://developers.facebook.com/docs/whatsapp/cloud-api/reference/messages\n.. _`Webhook Notification`: https://developers.facebook.com/docs/whatsapp/cloud-api/webhooks/components\n.. _`pip`: https://pip.pypa.io\n.. _`Python installation guide`: http://docs.python-guide.org/en/latest/starting/installation/\n.. _`Github repo`: https://github.com/leandcesar/wabc\n.. _`tarball`: https://github.com/leandcesar/wabc/tarball/master\n.. _`Get Started with the WhatsApp Business Cloud API`: https://developers.facebook.com/docs/whatsapp/cloud-api/get-started\n.. _`Cookiecutter`: https://github.com/audreyr/cookiecutter\n.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage\n\n\n=======\nHistory\n=======\n\n0.3.0 (2022-12-25)\n------------------\n\n* Implement methods for each message type.\n* Implement `Routine`.\n\n0.2.0 (2022-12-24)\n------------------\n\n* Rename project to wabc.\n\n0.1.0 (2022-12-19)\n------------------\n\n* First release on PyPI.\n\n\n",
"bugtrack_url": null,
"license": "MIT license",
"summary": "A modern, easy to use, feature-rich ready API wrapper for WhatsApp Business Cloud written in Python",
"version": "0.3.0",
"split_keywords": [
"whatsapp"
],
"urls": [
{
"comment_text": "",
"digests": {
"md5": "7ec3aca70e75b1a22b9fb3b80fe3ad70",
"sha256": "579d2371ccecf294acdb10f70637f0a243b8ae210a972785d246074c5cfdde58"
},
"downloads": -1,
"filename": "wabc-0.3.0-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "7ec3aca70e75b1a22b9fb3b80fe3ad70",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=3.6",
"size": 26465,
"upload_time": "2022-12-25T22:29:44",
"upload_time_iso_8601": "2022-12-25T22:29:44.013247Z",
"url": "https://files.pythonhosted.org/packages/10/e3/81cd8855cdc3e6b0adc4713c0ad76b8fbb5d174fda25d0567ab583ae8d39/wabc-0.3.0-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"md5": "6ec44917f2bee520bb2068151dabb4aa",
"sha256": "bbe5b6c475b5effd0225df5fb5e1bc200cae6b8ee8abecffb7c681a6b44db6d1"
},
"downloads": -1,
"filename": "wabc-0.3.0.tar.gz",
"has_sig": false,
"md5_digest": "6ec44917f2bee520bb2068151dabb4aa",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 88998,
"upload_time": "2022-12-25T22:29:46",
"upload_time_iso_8601": "2022-12-25T22:29:46.202630Z",
"url": "https://files.pythonhosted.org/packages/b5/db/ebf67f82a68944fefa7c10ddc42f5e69c052bfe813dcdb89affbcad9a426/wabc-0.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-12-25 22:29:46",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "leandcesar",
"github_project": "wabc",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"tox": true,
"lcname": "wabc"
}
JSON
