واجهة REST وwebhooks

اربط واتساب بنظام إدارة العملاء أو الصندوق أو برنامجك

واجهة REST بسيطة بصيغة JSON لإرسال الرسائل والنماذج الموافق عليها، وإنشاء جهات الاتصال، والرد داخل محادثة، وإطلاق حملة أو إضافة موعد؛ مع webhooks موقّعة لاستقبال كل حدث لديك.

الواجهة البرمجية والـwebhooks جزء من عرض الوكالة. أما Google Sheets والمتاجر فتُربط دون برمجة في كل العروض.

ابدأ في ثلاث خطوات

  1. 1

    أنشئ مفتاحًا

    في automatesend، التكاملات ← الواجهة البرمجية: يظهر المفتاح «as_live_…» مرة واحدة فقط. احتفظ به على الخادم.

  2. 2

    استدعِ الواجهة

    عبر HTTPS وبصيغة JSON مع ترويسة Authorization: Bearer. تُقبل الأرقام المغربية كما تُكتب (0661234567).

  3. 3

    استقبل الأحداث

    أضف عنوان خادمك واختر الأحداث: الرسائل، الطلبات، المواعيد، الحملات…

أمثلة

تستعمل كل الطلبات الترويسة Authorization: Bearer as_live_... وصيغة JSON.

إرسال نموذج معتمد

curl -X POST https://automatesend.com/api/v1/messages \
  -H "Authorization: Bearer as_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "to": "0661234567", "template": "confirmation_commande",
        "language": "fr", "variables": ["Salma", "#1024", "539 DH"] }'

الرد بنص حر (عميل كتب قبل أقل من 24 ساعة)

curl -X POST https://automatesend.com/api/v1/messages \
  -H "Authorization: Bearer as_live_..." -H "Content-Type: application/json" \
  -d '{ "to": "0661234567", "text": "Votre colis part demain." }'

إنشاء جهة اتصال أو تحديثها

curl -X POST https://automatesend.com/api/v1/contacts \
  -H "Authorization: Bearer as_live_..." -H "Content-Type: application/json" \
  -d '{ "phone": "0661234567", "first_name": "Salma", "tags": ["VIP"] }'

نقاط الوصول

https://automatesend.com/api/v1

  • POST/messagesإرسال نموذج معتمد
  • GET/messages/IDحالة رسالة (sent، delivered، read، failed)
  • POST/contactsإنشاء جهة اتصال أو تحديثها
  • GET/contacts?phone=0661234567البحث عن جهة اتصال (الترقيم limit، cursor)
  • GET/conversations?status=openعرض المحادثات (مرشحات status وneeds_human وphone)
  • GET/conversations/ID/messagesرسائل محادثة، الأحدث أولًا
  • POST/conversations/ID/messagesالرد بنص حر في المحادثة (خلال 24 ساعة)
  • POST/conversations/ID/templateإرسال نموذج معتمد في المحادثة
  • GET/campaignsعرض الحملات مع أرقامها
  • POST/campaigns/ID/launchإطلاق حملة مبرمجة فورًا، أو استئناف حملة متوقفة
  • GET/analytics/overview?from=…&to=…نظرة عامة: الرسائل، نسبة القراءة، المحادثات، الطلبات، تكلفة Meta
  • GET · POST/appointmentsعرض المواعيد أو إضافتها (يتلقى العميل التذكير)

Webhooks

يرسل automatesend طلب POST بصيغة JSON إلى عنوانك عند كل حدث اخترته.

  • message.receivedرسالة واردة من عميل
  • message.sentرسالة مُرسلة (الفريق، المساعد، الأتمتة، الواجهة البرمجية)
  • message.statusحالة رسالة مرسلة (وصلت، قُرئت، فشلت)
  • contact.createdجهة اتصال جديدة
  • contact.unsubscribedجهة اتصال ألغت اشتراكها
  • conversation.openedمحادثة مفتوحة (جديدة أو أُعيد فتحها)
  • conversation.closedمحادثة أغلقها الفريق
  • conversation.handoffمحادثة حوّلها المساعد إلى الفريق
  • campaign.launchedتم إطلاق حملة
  • campaign.completedانتهت حملة (مع أرقامها)
  • order.createdطلب مستلم
  • order.confirmedطلب أكّده العميل
  • order.cancelledطلب ألغاه العميل
  • order.reviewedرأي العميل بعد التوصيل
  • link.clickedنقرة على رابط متتبَّع
  • appointment.bookedتم حجز موعد
  • appointment.rescheduledتم تغيير موعد
  • appointment.confirmedأكّد العميل الموعد
  • appointment.cancelledتم إلغاء موعد
  • form.submittedتم ملء استمارة واتساب

يحتوي كل webhook على الترويسة X-Automatesend-Signature: sha256=…: وهي HMAC-SHA256 للمحتوى الخام بسر الـ webhook. قارنها قبل معالجة الحدث. عند الخطأ (رد غير 2xx)، تُعاد المحاولة 3 مرات.

الأخطاء والحدود

كل خطأ يُرجع رمز HTTP وكائن { error: { code, message } }. 300 استدعاء في الدقيقة لكل مفتاح.

401
مفتاح غائب أو غير صالح أو ملغى.
404
جهة اتصال أو محادثة أو نموذج أو رسالة غير موجودة في مساحتك.
409
الإجراء غير ممكن الآن: نافذة الـ24 ساعة مغلقة (استعمل نموذجًا)، جهة اتصال ألغت اشتراكها، موعد محجوز…
429
استدعاءات كثيرة: أعد المحاولة بعد دقيقة.

دون كتابة أي برمجة

  • أدوات المساعد الذكييستدعي المساعد واجهتك بنفسه للاطلاع على سعر أو مخزون أو حالة، ويحضّر إجراءات يوافق عليها فريقك.
  • Google Sheetsسطر لكل جهة اتصال أو طلب أو موعد في جدولك، مع سكريبت جاهز للصق.
  • المتاجر وشركات النقلShopify وWooCommerce وYouCan وSendit وOlivraison وOzon: ربط عبر webhook دون تطوير.

مستعد لربط واتساب بأدواتك؟

أنشئ حسابك، جرّب الواجهة البرمجية بالمحاكي، ثم اربط رقمك.