واجهة REST وwebhooks
اربط واتساب بنظام إدارة العملاء أو الصندوق أو برنامجك
واجهة REST بسيطة بصيغة JSON لإرسال الرسائل والنماذج الموافق عليها، وإنشاء جهات الاتصال، والرد داخل محادثة، وإطلاق حملة أو إضافة موعد؛ مع webhooks موقّعة لاستقبال كل حدث لديك.
الواجهة البرمجية والـwebhooks جزء من عرض الوكالة. أما Google Sheets والمتاجر فتُربط دون برمجة في كل العروض.
ابدأ في ثلاث خطوات
- 1
أنشئ مفتاحًا
في automatesend، التكاملات ← الواجهة البرمجية: يظهر المفتاح «as_live_…» مرة واحدة فقط. احتفظ به على الخادم.
- 2
استدعِ الواجهة
عبر HTTPS وبصيغة JSON مع ترويسة Authorization: Bearer. تُقبل الأرقام المغربية كما تُكتب (0661234567).
- 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=…نظرة عامة: الرسائل، نسبة القراءة، المحادثات، الطلبات، تكلفة MetaGET · 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 دون تطوير.

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