Merge pull request #1882 from oracle-devrel/matsliwins-patch-2

WhatsApp AI Agent

Author: anshoracle

ai/gen-ai-agents/WhatsApp AI Agent/README.md

@@ -0,0 +1,45 @@
+# WhatsApp GenAI Agent on OCI
+
+This repo helps you set up a WhatsApp Generative AI Agent on Oracle Cloud Infrastructure (OCI) using WhatsApp Cloud API. For full step by step refer to the pdf instruction.
+
+## Features
+- WhatsApp Cloud API integration
+- OCI Generative AI Agent for intelligent messaging
+- Simple OCI compute setup
+
+## Requirements
+- OCI account
+- Meta for Developers account
+- Python ≥ 3.12
+
+## Quick Setup
+1. Create a WhatsApp Business App in [Meta for Developers](https://developers.facebook.com).
+2. Configure `.env`:
+```env
+ACCESS_TOKEN="<token>"
+APP_ID="<app id>"
+APP_SECRET="<app secret>"
+RECIPIENT_WAID="<phone number>"
+VERSION="v22.0"
+PHONE_NUMBER_ID="<phone number ID>"
+VERIFY_TOKEN="<verify token>"
+ENDPOINT="<OCI endpoint>"
+COMPARTMENT_ID="<OCI compartment ID>"
+AGENT_ENDPOINT_OCID="<OCI agent endpoint>"
+```
+3. Deploy webhook using OCI Starter and OCI Cloud Shell.
+4. Run your app:
+```bash
+pip3 install -r requirements.txt
+python3 run.py
+```
+
+## Testing
+Use Meta’s WhatsApp sandbox for testing, then switch to verified business numbers for production.
+
+## Troubleshooting
+- Confirm Python ≥ 3.12
+- Check `.env` configurations
+
+Refer to full guide for detailed instructions.
+

ai/gen-ai-agents/WhatsApp AI Agent/WhatsApp Documentation v1.3.pdf

@@ -0,0 +1,16 @@
+from flask import Flask
+from app.config import load_configurations, configure_logging
+from .views import webhook_blueprint
+
+
+def create_app():
+    app = Flask(__name__)
+
+    # Load configurations and logging settings
+    load_configurations(app)
+    configure_logging()
+
+    # Import and register blueprints, if any
+    app.register_blueprint(webhook_blueprint)
+
+    return app

ai/gen-ai-agents/WhatsApp AI Agent/code/app/__init__.py

@@ -0,0 +1,26 @@
+import sys
+import os
+from dotenv import load_dotenv
+import logging
+
+def load_configurations(app):
+    load_dotenv()
+    
+    app.config["ACCESS_TOKEN"] = os.getenv("ACCESS_TOKEN")
+    app.config["APP_ID"] = os.getenv("APP_ID")
+    app.config["APP_SECRET"] = os.getenv("APP_SECRET")
+    app.config["RECIPIENT_WAID"] = os.getenv("RECIPIENT_WAID")
+    app.config["VERSION"] = os.getenv("VERSION")
+    app.config["PHONE_NUMBER_ID"] = os.getenv("PHONE_NUMBER_ID")
+    app.config["VERIFY_TOKEN"] = os.getenv("VERIFY_TOKEN")
+    app.config["ENDPOINT"] = os.getenv("ENDPOINT")
+    app.config["EMBEDDING_MODEL"] = os.getenv("EMBEDDING_MODEL")
+    app.config["GENERATE_MODEL"] = os.getenv("GENERATE_MODEL")
+    app.config["COMPARTMENT_ID"] = os.getenv("COMPARTMENT_ID")
+
+def configure_logging():
+    logging.basicConfig(
+        level=logging.INFO,
+        format="%(asctime)s - %(name)s - %(levelname)s - %(message)s",
+        stream=sys.stdout,
+    )

ai/gen-ai-agents/WhatsApp AI Agent/code/app/__pycache__/__init__.cpython-313.pyc

@@ -0,0 +1,38 @@
+from functools import wraps
+from flask import current_app, jsonify, request
+import logging
+import hashlib
+import hmac
+
+
+def validate_signature(payload, signature):
+    """
+    Validate the incoming payload's signature against our expected signature
+    """
+    # Use the App Secret to hash the payload
+    expected_signature = hmac.new(
+        bytes(current_app.config["APP_SECRET"], "latin-1"),
+        msg=payload.encode("utf-8"),
+        digestmod=hashlib.sha256,
+    ).hexdigest()
+
+    # Check if the signature matches
+    return hmac.compare_digest(expected_signature, signature)
+
+
+def signature_required(f):
+    """
+    Decorator to ensure that the incoming requests to our webhook are valid and signed with the correct signature.
+    """
+
+    @wraps(f)
+    def decorated_function(*args, **kwargs):
+        signature = request.headers.get("X-Hub-Signature-256", "")[
+            7:
+        ]  # Removing 'sha256='
+        if not validate_signature(request.data.decode("utf-8"), signature):
+            logging.info("Signature verification failed!")
+            return jsonify({"status": "error", "message": "Invalid signature"}), 403
+        return f(*args, **kwargs)
+
+    return decorated_function