fb-gapi 0.1.1

A lightweight Python SDK for sending messages via Facebook Messenger

Facebook Messenger Graph API Python SDK

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

🚀 Usage

1. Import the client

from facebook_messenger import MessengerClient

2. Initialize with your Page Access Token

client = MessengerClient(access_token="YOUR_PAGE_ACCESS_TOKEN")

---

✉️ Sending a Text Message

response = client.send_text(recipient_id="USER_PSID", message_text="Hello, user!")
print(response)

---

🖼️ Sending an Image Attachment

image_url = "https://example.com/image.jpg"
response = client.send_attachment(recipient_id="USER_PSID", image_url=image_url)
print(response)

---

⚠️ Error Handling

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

Example:

from facebook_messenger import MessengerAPIError

try:
    client.send_text("invalid_user_id", "Hi!")
except MessengerAPIError as e:
    print(f"Facebook API Error: {e}")

Error Output Example:

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

---

📄 Requirements

• Python 3.6+
• requests

Install requirements using:

pip install -r requirements.txt

---

🛠️ TODO

• Add support for more attachment types (video, audio, file)
• Support for templates, quick replies, and buttons
• Webhook integration

---

📃 License

MIT License. Use freely and contribute!