الصفحات المسموح بها
/pagesالصلاحية المطلوبة:pages:read
زامن جهات الاتصال، وأجب عن الرسائل والتعليقات، واقرأ إحصاءات التدفقات الحالية. إنشاء التدفقات وتعديلها غير متاحين عبر هذا API.
أنشئ تكاملًا بالصفحات والصلاحيات المطلوبة في لوحة التحكم. أرسل المفتاح بصيغة Bearer في ترويسة Authorization. تنتهي صلاحيته بعد سنة ويمكن تغييره أو إلغاؤه من اللوحة.
أرسل الطلبات من خادم تطبيقك. لا تضع الرمز في كود المتصفح أو المستودعات العامة. لا تحتاج طلبات Bearer إلى ملفات تعريف الارتباط أو تهيئة CSRF. تتاح فقط الصفحات التي تملكها وتختارها للاتصال؛ لا يمكن تفويض صفحات الفريق المشتركة. الرسائل والتعليقات مدعومة حالياً لإنستغرام فقط.
عنوان API الأساسي
https://highfollower.com/api/v1curl 'https://highfollower.com/api/v1/pages' \
-H 'Authorization: Bearer YOUR_API_TOKEN' \
-H 'Accept: application/json'/pagesالصلاحية المطلوبة:pages:read
{
"status": "ok",
"message": "",
"data": [],
"meta": {
"per_page": 50,
"next_cursor": null,
"has_more": false
}
}المعامل page هو المعرّف الداخلي للصفحة ويختلف عن page_id في إنستغرام. احصل على conversation_key من قائمة المحادثات ورمّزه عند وضعه في URL.
تستخدم القوائم باستثناء /pages و/tags ترقيم المؤشر. اضبط per_page بين 1 و100 (الافتراضي 50)، ثم أرسل meta.next_cursor كقيمة cursor مع المرشحات الأصلية حتى تصبح meta.has_more مساوية لـ false. لا تعدّل المؤشرات. تُرتّب جهات الاتصال تصاعدياً حسب updated_at ثم id والرسائل من الأحدث. استخدم فترات updated_since متداخلة وحدّث جهات الاتصال حسب المعرّف. تقبل التواريخ ISO 8601 وتُحوّل إلى UTC.
done وupdated_since؛ التعليقات تقبل media_id وparent_id. تقبل الإحصاءات period=7
يتطلب مسارا الرد هيدر Idempotency-Key بقيمة UUID ونص message غير فارغ حتى 1000 حرف. أنشئ UUID جديداً لكل رد جديد. تكرار المفتاح مع الصفحة والوجهة والنص نفسها يعيد النتيجة المسجلة؛ تغيير المحتوى يعيد 409. استجابة 503 مع status=uncertain تعني أن الإرسال جارٍ أو أن نتيجته غير معروفة: تحقق من صندوق الوارد قبل الإرسال مجدداً ولا تُعد المحاولة تلقائياً بمفتاح جديد.
curl -X POST 'https://highfollower.com/api/v1/pages/12/conversations/CONVERSATION_KEY/replies' \
-H 'Authorization: Bearer YOUR_API_TOKEN' \
-H 'Accept: application/json' \
-H 'Idempotency-Key: 7d598e78-eaf7-4eb4-9c48-7e57ef887902' \
-H 'Content-Type: application/json' \
-d '{"message":"Hello! How can we help?"}'لتغيير حالة المحادثة أرسل status بقيمة open أو done. لاستبدال وسوم جهة الاتصال أرسل مصفوفة tag_ids؛ المصفوفة الفارغة تزيل جميع الوسوم.
اضبط العنوان والأحداث وأرسل حدثًا تجريبيًا. تتضمن الحمولة id وtype وapi_version وoccurred_at وplatform_page_id وplatform وdata. أحداث الرسائل والتعليقات تشمل الوارد والصادر. يشير حدث synced إلى ضرورة تحديث القائمة من API.
استخدم نطاق HTTPS عاماً على المنفذ 443 يُحل إلى IPv4 عام، دون بيانات دخول أو جزء fragment في العنوان. لا تُتبع عمليات إعادة التوجيه. فعّل كل حدث وصلاحية القراءة المرتبطة به. أعد 2xx بعد حفظ الحدث بشكل دائم. قد تتكرر الأحداث أو تصل بترتيب مختلف؛ طابق بياناتك دورياً عبر API.
message.createdconversations:readmessage.deletedconversations:readconversation.updatedconversations:readdirects.syncedconversations:readcomment.createdcomments:readcomment.deletedcomments:readcomment.updatedcomments:readcomments.syncedcomments:readcontact.updatedcontacts:readlead.createdleads:readwebhook.test—{
"id": "f5e0c74f-364c-44ae-bc5b-486a2afba3b5",
"type": "message.created",
"api_version": "v1",
"occurred_at": "2026-10-02T10:00:00.000000Z",
"platform_page_id": 12,
"platform": "instagram",
"data": {
"id": "provider-message-id",
"message_id": "provider-message-id",
"conversation_key": "existing-conversation-key",
"sender": {
"id": "provider-user-id"
},
"message": {
"text": "Hello"
}
}
}X-HighFollower-Event-Id: f5e0c74f-364c-44ae-bc5b-486a2afba3b5
X-HighFollower-Timestamp: <Unix seconds>
X-HighFollower-Signature: sha256=<hex HMAC-SHA256>يُرسل lead.created بعد تأكيد حفظ سجل جديد من بيانات التدفق ويتطلب leads:read. كل حقل محفوظ سجل مستقل؛ تعديل سجل قائم أو تكرار عملية الحفظ نفسها لا ينشئ حدثاً جديداً. تشمل البيانات معرّفات السجل والصفحة والتدفق والتنفيذ، ومعرّف المرسل واسم الحقل وقيمته والمصدر ووقت الإنشاء. الحدث مستقل عن contact.updated ولا يتطلب حفظ القيمة في ملف جهة الاتصال.
{
"id": "591396d6-5561-52a5-9506-14e23f4e5c25",
"type": "lead.created",
"api_version": "v1",
"occurred_at": "2026-10-31T10:00:00.000000Z",
"platform_page_id": 12,
"platform": "instagram",
"data": {
"id": 42,
"platform_page_id": 12,
"automation_flow_id": 7,
"execution_id": 103,
"flow_node_id": "collect-phone",
"sender_id": "provider-user-id",
"field_name": "phone",
"value": "+989120000000",
"source_type": "direct",
"source_id": "provider-message-id",
"created_at": "2026-10-31T10:00:00.000000Z"
}
}تحقق من HMAC-SHA256(secret, timestamp + "." + raw_body) قبل تحليل JSON. تبدأ X-HighFollower-Signature بـsha256=. تحقق من X-HighFollower-Timestamp ضمن خمس دقائق واحفظ id لمنع معالجة الحدث مرتين.
import hashlib, hmac, json, time
def verify_webhook(raw_body, headers, secret):
timestamp = headers["X-HighFollower-Timestamp"]
if abs(time.time() - int(timestamp)) > 300:
raise ValueError("Expired webhook")
digest = hmac.new(
secret.encode(), timestamp.encode() + b"." + raw_body,
hashlib.sha256,
).hexdigest()
if not hmac.compare_digest(
"sha256=" + digest, headers["X-HighFollower-Signature"]
):
raise ValueError("Invalid signature")
return json.loads(raw_body)
# Deduplicate the verified payload["id"] in your database.
# Return 2xx after durably accepting the event.الاستجابة 2xx تؤكد الاستلام. تُعاد أخطاء الشبكة و408 و425 و429 و5xx حتى ثماني محاولات؛ تفشل الاستجابات الأخرى بما فيها إعادة التوجيه. فترات الانتظار 1 و5 و15 و60 و180 و360 و720 دقيقة إضافة إلى تأخير الطابور. يبقى معرّف الحدث ثابتًا. يُحفظ السجل 30 يومًا. تغيير العنوان أو مفتاح التوقيع يلغي عمليات التسليم القديمة المعلّقة.
يتطلب API وWebhooks اشتراك Pro مدفوعاً وفعالاً (10 اتصالات فعالة افتراضياً؛ راجع حد اشتراكك). لا تشمل التجارب هذه الميزة. الحد 120 طلباً في الدقيقة لكل اتصال و240 لكل عنوان IP مصدر. عند 429 انتظر عدد الثواني في Retry-After. تتطلب الردود صفحة نشطة وبيانات اتصال صالحة ورصيداً كافياً. انتهاء الاشتراك يوقف الطلبات وWebhooks مع الاحتفاظ بالمفاتيح.
401: رمز غير صالح أو ملغى أو منتهي. 403: صلاحية غير كافية أو صفحة غير نشطة للإرسال. 404: مورد مفقود أو خارج الصلاحيات. 409: إعادة استخدام Idempotency-Key لمحتوى مختلف. 422: إدخال غير صالح أو plan_limit_reached. 429: تجاوز حد الطلبات. 503 مع status=uncertain: الإرسال جارٍ أو نتيجته غير معروفة؛ تحقق من صندوق الوارد قبل إرسال آخر.