خمس دقائق.
أول نداء،
أنشئ مفتاحًا، اعرض المحادثات، أرسل ردًا، سجّل ويبهوك. بلا تثبيت SDK. الـ SDK سكّر.
01
أنشئ مفتاح API
افتح الإعدادات → API Keys، انقر مفتاح جديد، أعطه تسمية، اختر النطاقات. انسخ مرّة واحدة. المفاتيح التي تبدأ بـ ir_live_ ترسل رسائل حقيقية. المفاتيح التي تبدأ بـ ir_test_ لا تفعل أبدًا.
# .env
IR_API_KEY=ir_live_3f2a...02
اعرض محادثاتك
كل endpoint قائمة يستخدم cursor pagination. مرّر ?cursor= للصفحة التالية. 100 كحدّ أقصى لكل نداء.
curl https://instantreply.up.railway.app/v1/conversations \
-H "Authorization: Bearer $IR_API_KEY"03
أرسل ردًا
POST رسالة إلى محادثة. مع مفتاح test يُرجع النداء 201 وهميًا ولا يلمس Meta أبدًا. مع مفتاح live تتعامل المنصّة مع التسليم وإعادة المحاولات والامتثال.
curl -X POST https://instantreply.up.railway.app/v1/conversations/$ID/messages \
-H "Authorization: Bearer $IR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "content": "Thanks for reaching out." }'04
سجّل ويبهوك
يتضمّن الردّ سرّ توقيع (whsec_...). تحقّق من هيدر X-IR-Signature على كل payload وارد. تُعاد محاولة التسليم الفاشل بتأخير أُسّي لمدة 30 يومًا.
curl -X POST https://instantreply.up.railway.app/v1/webhooks \
-H "Authorization: Bearer $IR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://yourapp.com/webhooks/ir",
"events": ["message.received", "conversation.closed"]
}'