المقدمة

واجهة K-Message تخلي برنامجك يسوي اللي يسويه فريقك من لوحة التحكم: يرسل رسائل واتساب، يقرأ المحادثات، يحدّث جهات الاتصال، ويشغّل إرسال جماعي.

هي واجهة REST. الطلبات عبر HTTPS، والمحتوى JSON، والتوثيق ترويسة وحدة. ما فيه مكتبة تنصّبها ولا خدمة تشغّلها جنب تطبيقك.

العنوان الأساسي

https://k-message.kerneltics.com/v1

كل شيء في هذي الوثائق نسبةً لهذا العنوان. إذا كنت مشغّل K-Message على سيرفرك، استخدم عنوانك أنت مع نفس المسار /v1.

/v1 وعد. ممكن تنضاف نقاط نهاية جديدة وحقول جديدة في الردود، لكن اللي موجود ما يتغيّر شكله وما ينحذف. لوحة التحكم تستخدم واجهة خاصة ثانية تتغيّر مع الواجهة نفسها؛ تلك ما هي موثّقة هنا وما ينفع تناديها.

أربع أفكار تستاهل تعرفها

المفتاح يحمل صلاحيات، مو شخص. لما تنشئ مفتاح تختار بالضبط وش يقدر يسوي. ويحتفظ بهذي الصلاحيات مهما صار لحساب اللي أنشأه، عشان موظف يتغيّر دوره ما يوقّف تكامل شغّال. راجع التوثيق.

الإرسال يُقبل، ما يكتمل. الطلب POST /v1/messages يرجّع 201 وحالة pending أول ما تُحفظ الرسالة. وصولها من عدمه يجيك بعدين، إما على ويب هوك أو لما تقرأ الرسالة مرة ثانية. إبقاء الاتصال مفتوح لين طرف ثالث يأكّد التسليم أبطأ وما هو أصدق.

نافذة الـ ٢٤ ساعة تحكم وش تقدر ترسل. واتساب يسمح للمنشأة ترد بحرية خلال ٢٤ ساعة من آخر رسالة أرسلها العميل. خارج هذي النافذة ما يمر إلا قالب معتمد. المحادثات ترجّع window_open_until عشان ما تحسبها بنفسك. هذا أكثر سبب لرفض الإرسال.

إعادة المحاولة مسؤوليتك، ونحن نخليها آمنة. الشبكات تنقطع بعد ما يخلص الشغل فعليًا. أرسل Idempotency-Key وإعادة المحاولة ترجّع النتيجة الأولى بدل ما ترسل رسالة ثانية. راجع منع التكرار.

وش ما هو موجود بعد

• إنشاء القوالب. إرسال قالب للاعتماد يبدأ مراجعة من ميتا تاخذ ساعات، عشان كذا تنعمل من لوحة التحكم اللي تبيّن حالتها. تقدر تقرأ القوالب ومتغيراتها من الواجهة.
• مفاتيح تجريبية. ما فيه وضع اختبار يوقف الإرسال الفعلي. أي شيء ترسله يوصل جوال حقيقي، فاستخدم رقم تملكه وأنت تطوّر.
• مكتبات جاهزة. كل الأمثلة هنا HTTP عادي في curl وجافاسكربت وPHP وبايثون.