ابنِ على إنجاز

واجهة البوتات

بوت يتكلم مع الناس في المحادثات والمجموعات

البوت حساب خاص بلا رقم هاتف يملكه شخص أو نشاط، ويتكلم عبر رمزه فقط. يجده الناس باسم المستخدم ويضغطون «ابدأ».

• كل أنواع الرسائل: نص وصور وملفات واستطلاعات وموقع وبطاقات منتجات
• أزرار تحت الرسالة، ولوحة ردود جاهزة، وأوامر تظهر عند كتابة /
• استقبال التحديثات بالسحب الطويل getUpdates أو عبر webhook
• تطبيقات مصغّرة: صفحة ويب تُفتح داخل التطبيق ببيانات موقّعة
• بوتات مضمّنة تُستدعى بـ @اسم_البوت في أي محادثة
• «ردود دون برمجة»: قواعد بسيطة تجيب فورًا ولو بلا خادم
• ربط البوت بحساب النشاط ليردّ على العملاء باسمه

# أرسل رسالة بأزرار من بوت
TOKEN='<botId>:<secret>'
curl -s "https://www.engaz.net/bot/$TOKEN/sendMessage" \
  -H 'content-type: application/json' -d '{
  "conversationId": "CONV_ID",
  "text": "اختر الحجم",
  "replyMarkup": {"inlineKeyboard": [[
    {"text": "صغير", "callbackData": "size:s"},
    {"text": "كبير", "callbackData": "size:l"}
  ]]}}'

# الردّ على ضغطة الزر
curl -s "https://www.engaz.net/bot/$TOKEN/answerCallbackQuery" \
  -H 'content-type: application/json' \
  -d '{"callbackQueryId": "CQ_ID", "text": "تم اختيار الكبير"}'

كل إجابة بالشكل { "ok": true, "result": … } أو { "ok": false, "error": "…", "message": "…" }.

Webhooks

يصلك كل حدث لحظة وقوعه

أضف رابط https واختر الأحداث. كل حدث طلب POST موقّع، يُعاد عند الفشل بعد 5 ثوانٍ ثم 30 ثانية ثم دقيقتين ثم 10 ثم 30 دقيقة.

• message.received وmessage.reply وmessage.sent
• button.pressed حين يضغط عميل زرًا في رسالة من الواجهة
• member.joined وmember.left في مجموعات نشاطك
• call.ringing وcall.answered وcall.ended وcall.missed
• زر «حدث تجريبي» في التطبيق لتجربة الربط مع أدوات الأتمتة

// Node.js: تحقّق من التوقيع قبل قبول الحدث
import { createHmac, timingSafeEqual } from 'node:crypto';

const ts = req.headers['x-engaz-timestamp'];
const want = 'sha256=' + createHmac('sha256', SECRET)
  .update(`${ts}.${rawBody}`).digest('hex');
const got = String(req.headers['x-engaz-signature'] ?? '');
const fresh = Math.abs(Date.now() / 1000 - Number(ts)) < 300;
if (!fresh || want.length !== got.length ||
    !timingSafeEqual(Buffer.from(want), Buffer.from(got))) {
  return res.status(401).end();
}
res.status(200).end(); // ردّ بـ 2xx خلال 10 ثوانٍ