Python SDK

1. ثبّت الـ SDK

محتاج Python 3.10 أو أحدث. اسم الـ package wayo-agent. استخدم التحميل لحد ما ينزل على الـ registry.

# Extract wayo-agent-python.zip first
python -m pip install ./wayo-agent-python

python -m pip install wayo-agent

2. حط الـ signing secret بتاعك

من الإعدادات ← المطوّرين، انسخ الـ signing secret بتاعك. الـ SDK محتاجه، سواء Chat أو Webhook أو REST.

$env:WAYO_SECRET="whsec_REPLACE_WITH_YOUR_REAL_SECRET"

export WAYO_SECRET="whsec_REPLACE_WITH_YOUR_REAL_SECRET"

3. رجّع أول رد

ابدأ بالمثال الكامل ده على جهازك. بيرجّع رد تجربة التوصيل.

from wayo_agent import Wayo
wayo = Wayo.from_env()
wayo.on_message(lambda message: "Wayo is connected.")

if __name__ == "__main__":
    wayo.serve(port=8080)

python standalone.py

رجّع نص عادي أو object فيه reply مش فاضي. بدّل رد التجربة بالبحث في المخزون أو المحل بتاعك. سجّل handler واحد بس.

from fastapi import Request
from fastapi.responses import JSONResponse

# Register your wayo.on_message handler first.
@app.post("/wayo")
async def wayo_route(request: Request):
    status, data = await wayo.handle(
        body=await request.body(), headers=request.headers
    )
    return JSONResponse(data, status_code=status)

# In app.py, after registering your answer function:
app = wayo.app()

# Install and run from your terminal:
# python -m pip install uvicorn
# python -m uvicorn app:app --port 8080

4. وصّل في وايو

اعمل deploy ورا عنوان عام بـ HTTPS، أو افتح السيرفر اللي على جهازك من خلال HTTPS tunnel. الـ localhost ماينفعش يبقى endpoint لوايو.

https://your-business.example/

اختار Chat API، ودخّل الـ endpoint النهائي، ودوس جرّب التوصيل. المفروض يظهرلك “Wayo is connected.” وبعدين بدّل رد التجربة ببيانات حقيقية وجرّب تاني قبل ما تحفظ.

نفس الـ handler بياخد Webhook POST و REST GET. شوف الطلبات والردود عشان أشكالهم. أمثلة السيرفر المستقل للتطوير؛ استخدم الاستضافة العادية بتاعتك للـ production والزباين الحقيقيين.