خصوصية العملاء المحتملين والتحقّق من البريد الإلكتروني

ما الذي يمكنك فعله

عندما يلتقط كتيّب العملاء المحتملين، يمكنك تشكيل جزأين من تلك التجربة عبر الـ API:

• الخصوصية / الموافقة — اضبط نص الخصوصية/الموافقة وخيارات التقاط العملاء المحتملين (مثل مربّع موافقة GDPR)، بما في ذلك رابط سياسة الخصوصية الخاصة بك.
• التحقّق من البريد الإلكتروني — فعّل التحقّق من بريد العملاء المحتملين أو ألغِه، بحيث يُطلَب من المشاهدين تأكيد بريدهم قبل الوصول.

قبل أن تبدأ

ستحتاج إلى:

• مفتاح API — يُرسَل مع كل طلب إمّا في ترويسة X-Api-Key أو ضمن Authorization: Bearer YOUR_API_KEY.
• الـ {flipbookId} — المُعرّف الرقمي للكتيّب/المستند. يُعيده create-by-file / create-by-url (بوصفه ID) أو تُعيده list. وتأخذه نقطتا النهاية كلتاهما بوصفه معطى مسار.
• تذهب جميع الطلبات إلى الرابط الأساسي https://go.fliplink.me.

جسم الطلب لنقطتَي النهاية كلتيهما يكون بصيغة form-urlencoded (لا JSON).

اضبط الخصوصية والموافقة

يضبط PUT /api/set-lead-privacy/{flipbookId} نص الخصوصية/الموافقة وخيارات التقاط العملاء المحتملين (مثل مربّع موافقة GDPR).

curl -X PUT 'https://go.fliplink.me/api/set-lead-privacy/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsLeadPrivacyPolicy=false' \
  --data-urlencode 'PrivacyPolicyURL=' \
  --data-urlencode 'PrivacyPolicyText='

الاستجابة:

{
  "Result": "OK",
  "Message": "Updated successfully"
}

اضبط التحقّق من البريد الإلكتروني

يفعّل PUT /api/set-lead-verification/{flipbookId} التحقّق من بريد العملاء المحتملين أو يلغيه، بحيث يُطلَب من المشاهدين تأكيد بريدهم قبل الوصول.

curl -X PUT 'https://go.fliplink.me/api/set-lead-verification/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsVerifyEmail=false' \
  --data-urlencode 'IsVerifyMobile=false' \
  --data-urlencode 'TwillioAPIKey=' \
  --data-urlencode 'EmailVerifyTitleText=' \
  --data-urlencode 'EmailVerifyButtonText='

الاستجابة:

{
  "Result": "OK",
  "Message": "Updated successfully"
}

الأخطاء المحتملة

• مفتاح API مفقود أو غير صالح ← HTTP 401. تُعيد هذه الحالة صفحة HTML عادية لعدم التصريح — دون أي جسم JSON. تحقّق من وجود ترويسة X-Api-Key وصحّتها.
• مُعرّف العنصر غير موجود أو غير مملوك لمفتاحك ← HTTP 200 مع Message بالقيمة Item not found.
• حقل مجهول أو مكتوب خطأً في الجسم ← HTTP 200 مع Message بالقيمة Unknown field(s) '…'. Expected: ….

ملاحظات

• يحتفظ الحقل TwillioAPIKey بالتهجئة الأصلية Twillio — فأرسِله بهذا الاسم بالضبط.