fb-gapi 0.1.17

A lightweight Python Async SDK for sending messages via Facebook Messenger

Facebook Messenger Graph API Python Async SDK ( v22.0 )

A lightweight Python SDK for sending messages (text and image attachments) using the Facebook Graph API along with the Facebook Messenger Send API.

Installation

pip install -U fb_gapi

🚀 Features

• Send Text Messages: Easily send text messages to users.
• Send Remote Attachments: Send remote attachments by URL.
• Send Local Attachments: Send local attachments by file path.
• Get Conversation History: Fetch the latest conversation history.
• Error Handling: The SDK will raise a MessengerAPIError when the Facebook API responds with an error.

🚀 Usage

📦 Import the client

from fb_gapi import MessengerClient

🔒 Initialize with your Page Access Token

client = MessengerClient(access_token="YOUR_PAGE_ACCESS_TOKEN")

✉️ Sending a Text Message

async def send_text():
    response = await client.send_text(
        recipient_id="USER_PSID", message_text="Hello from Python!"
    )
    print(response)

🖼️ Sending an Attachment By URL

async def send_remote_attachment():
    response = await client.send_remote_attachment(
        recipient_id="USER_PSID",
        image_url="https://example.com/image.jpg",
    )
    print(response)

🖼️ Sending a Local Attachment

async def send_local_attachment():
    response = await client.send_local_attachment(
        recipient_id="USER_PSID", file_path="./test.png"
    )
    print(response)

Get User Name

async def get_user_name():
    response = await client.get_user_name(user_id="USER_PSID")
    print(response)

Get Conversation History (Optional Limit)

async def get_chat_history_limited():
    response = await client.get_chat_history(recipient_id="USER_PSID", limit=5)
    print(response)

⚠️ Error Handling

This SDK will raise a MessengerAPIError when the Facebook API responds with an error.

Example:

async def example_error_handling():
    try:
        await client.send_text("invalid_user_id", "Hi!")
    except MessengerAPIError as e:
        print(f"GAPI Error: {e}")

Error Output Example:

MessengerAPIError (HTTP 400): [OAuthException] Invalid OAuth access token. (code 190)

📄 Requirements

• Python 3.6+

🛠️ TODO

• Improve conversation history limit.
• Add support for templates.
• Add support for quick replies.
• Add support for actions.
• Add support for custom buttons.

📃 License

MIT License. Use freely and contribute!