اربط أي متجر بوصّلني

إضافة ووردبريس / ووكومرس

إضافة PHP جاهزة تحوّل كل طلب ووكومرس إلى طلب توصيل في وصّلني — مع تحويل عنوان العميل إلى إحداثيات GPS تلقائيًا، وتتبّع الحالة و«الوصول المتوقع» داخل صفحة الطلب للعميل وللتاجر.

هل يمكن عمل تكامل لأي متجر؟ — نعم

الإضافة مبنية فوق REST API عام + Webhooks موقّعة. أي متجر (Magento، OpenCart، Salla، Zid، نظام مخصّص، أو حتى Google Sheet) يقدر يستفيد بإحدى ثلاث طرق:

مثال: إنشاء توصيلة من أي خادم

curl -X POST https://tawsilah.softwiro.com/api/v1/orders \
  -H "Authorization: Bearer wsl_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Order #1042",
    "payment_mode": "cod",
    "product_value": 350,
    "items": [{"name":"T-shirt","qty":2,"unit_price":175}],
    "locations": [
      {"type":"source","lat":30.0626,"lng":31.2497,"sequence":0},
      {"type":"destination","lat":30.0444,"lng":31.2357,"address":"15 Tahrir St","sequence":1}
    ],
    "contacts": [{"type":"destination","name":"Sara","phone":"01000000000"}]
  }'

استقبال تحديثات الحالة (Webhook)

سجّل رابطك عبر POST /api-keys/{id}/webhooks لتصلك أحداث order.accepted · order.picked_up · order.in_transit · order.delivered · order.location_updated · order.sla_breached. كل طلب موقّع بـ X-Wassalni-Signature: sha256=… = HMAC‑SHA256 للجسم بسرّك.

# Python — التحقق من توقيع الـ Webhook
import hmac, hashlib
def verify(secret, raw_body, header_sig):
    expected = hmac.new(secret.encode(), raw_body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, header_sig.removeprefix("sha256="))

Shopify

وصّلني يوفّر نقطة استقبال webhook لـ Shopify — تسجّل رابطًا واحدًا في Shopify وتُنشأ التوصيلة تلقائيًا عند تنفيذ الطلب، مع التحقق من توقيع X-Shopify-Hmac-Sha256.

التفاصيل الكاملة في وثائق الـ API وملف integrations/README.md في المستودع.