يمكن لنموذج على موقعك الإلكتروني أنت — تنزيل ورقة بيضاء، أو طلب عرض توضيحي، أو صفحة اتصال — أن ينشئ عملاء محتملين في AB Sales مباشرة، وكذلك يستطيع نظامك الخلفي أو أداة أتمتة. وكلاهما يستعمل مفتاح استلام واحداً من إعدادات AB Sales. ولا يحتاج شيء على موقعك إلى تسجيل الدخول، ولا يحتاج نموذج HTML البسيط إلى JavaScript أصلاً.
أين المفتاح
افتح مساحة عملك ← الإعدادات ← بطاقة نموذج الموقع وواجهة API. وفي أول مرة يفتحها Owner أو Admin (مالك أو مسؤول) يُنشأ مفتاح؛ ويرى الأعضاء المفتاح نفسه للقراءة فقط. وتعرض البطاقة المفتاح مع زرّ نسخ، ومقتطف نموذج HTML جاهزاً للّصق، ومثالاً لـAPI، وزرّ إعادة إنشاء المفتاح.
طريقتان للوصول
نموذج HTML بسيط
يرسل نموذجك الحالي مباشرة إلى AB Sales ويحوّل الزائر إلى صفحة الشكر لديك. الخيار الأفضل لنموذج تنزيل أو اتصال على موقع لا مطوّر في متناوله.
واجهة JSON API
يرسل نظامك الخلفي، أو Zapier، أو Power Automate، أو أي أداة تستطيع إرسال طلب ويب، الحقول نفسها بصيغة JSON (صيغة نصية بسيطة للبيانات المهيكلة) مع المفتاح كرمز حامل (bearer token).
1. وجّه نموذج HTML إلى AB Sales
- انسخ المقتطف. في بطاقة نموذج الموقع وواجهة API، انقر نسخ بجوار نموذج HTML. وهو يحمل مفتاحك سلفاً.
- غيّر رابط صفحة الشكر. الحقل المخفي
redirectهو حيث يهبط زائرك بعد الإرسال — صفحة التنزيل أو الشكر لديك، بعنوانhttps://كامل. - أبقِ الحقول المخفية وأضف حقولك. يقوم
keyوredirectبالعمل؛ أماab_hpفمصيدة (honeypot): حقل لا يراه الناس أبداً، فالروبوت الذي يملأ كل حقل يجده يكشف نفسه ويُسقَط إرساله. أضفcompanyأوphoneأوwebsiteأوmessageكمدخلات إضافية بهذه الأسماء تحديداً. - أرسل مرة بنفسك. يظهر العميل المحتمل في العملاء المحتملون خلال لحظة، بالمصدر Website.
<form method="post" action="https://blz.actionbridge.io/api/crm/leads/form">
<input type="hidden" name="key" value="lk_…your key…">
<input type="hidden" name="redirect" value="https://www.example.com/thank-you">
<input type="text" name="ab_hp" value="" tabindex="-1" autocomplete="off" style="display:none">
<input name="name" placeholder="Your name">
<input name="company" placeholder="Company">
<input name="email" type="email" required placeholder="Work email">
<button type="submit">Download</button>
</form>message مخفي مثل Downloaded: Pricing guide يهبط في ملاحظات العميل المحتمل، فيعرف من يتناوله لماذا جاء هذا الشخص — والبحث بالذكاء الاصطناعي يقرأ الملاحظات أيضاً.الحقول
البريد الإلكتروني وحده مطلوب — فبه يُعرَف الإرسال المتكرر، وبه يُتواصل مع العميل المحتمل. وكل ما عداه اختياري.
| حقل النموذج | حقل API | يصبح |
|---|---|---|
email مطلوب | email | البريد الإلكتروني |
name | name | اسم جهة الاتصال — أو اسم العميل المحتمل حين لا تُعطى شركة |
company | company | الاسم. وحين يوجد، يصبح name الشخص المسؤول عن الاتصال، كما يفعل روبوت Teams |
phone, website, industry | نفسها | الهاتف، والموقع الإلكتروني، والقطاع |
source | source | المصدر. افتراضياً Website؛ وقائمة العملاء المحتملين تصفّي عليه، فاقتصر على قيم قليلة |
message | message | الملاحظات، حتى 4,000 حرف |
country, language, timezone | countryCode, preferredLanguage, timeZone | البلد (JP)، واللغة المفضلة (ja-JP)، والمنطقة الزمنية (Asia/Tokyo). والقيمة التي ليست رمزاً صالحاً تُرفض، فلا يحمل العميل المحتمل أبداً قيمة لا يستطيع شيء بعده قراءتها |
الحقول النصية محدودة بـ200 حرف. وإذا رُفض إرسال، سمّى الجواب الحقل.
2. واجهة JSON API
الحقول نفسها، بتسمية camelCase، مع المفتاح كرمز حامل (bearer token) يُرسل في ترويسة Authorization. وللأداة التي لا تستطيع ضبط تلك الترويسة، تحمل ترويسة X-AB-Key المفتاح بدلاً منها.
curl -X POST https://blz.actionbridge.io/api/crm/leads \
-H "Authorization: Bearer lk_…your key…" \
-H "Content-Type: application/json" \
-d '{"name":"Aoi Sato","company":"Contoso","email":"aoi@contoso.com","message":"Downloaded the pricing guide"}'| الحالة | المعنى |
|---|---|
| 201 | عميل محتمل جديد. ويحمل المتن leadId الخاص به. |
200 existing: true | تكرار: أُضيفت ملاحظة إلى ذلك العميل المحتمل بدلاً من ذلك (أدناه). |
| 400 | حقل خاطئ. ويقول الخطأ أيّ حقل. |
| 401 | مفتاح غير معروف — كُتب خطأً، أو أُعيد إنشاؤه منذ ذلك. |
| 429 | مساحة العمل تجاوزت حصة العملاء المحتملين، أو عنوان واحد يرسل أكثر من 60 طلباً في الدقيقة. |
الإرسال المتكرر لا يصنع نسخاً مكررة
الإرسال الثاني من بريد إلكتروني يعود أصلاً إلى عميل محتمل حيّ في مساحة العمل لا ينشئ عميلاً محتملاً آخر. بل تُضاف ملاحظة إلى الموجود — “Submitted again through the website form.” (أُرسل مرة أخرى عبر نموذج الموقع) مع ما كتبوه — فيرى الفريق الاهتمام المتجدد حيث يعمل أصلاً، ولا تُصرف الحصة مرتين على شخص واحد. والمطابقة تتجاهل حالة الأحرف؛ والعميل المحتمل المؤرشف لا يُحتسب، فمن يعود بعد أرشفته يبدأ من جديد.
ما الذي يراه زائرك
مع redirect، صفحة الشكر لديك دائماً — حتى حين كان الإرسال تكراراً، أو روبوتاً، أو كانت مساحة العمل فوق حصة العملاء المحتملين. فحدّ خطتك شأنك أنت، لا شأن زائرك. وبلا إعادة توجيه (نموذج أُرسل بـJavaScript)، تجيب نقطة النهاية بالـJSON الوارد في الجدول أعلاه.
إذا أُسيء استعمال المفتاح
لا يكلفك سوء الاستعمال سوى عملاء محتملين مزعجين (spam) وشيئاً من الحصة، لا غير. انقر إعادة إنشاء المفتاح في البطاقة، وأكّد، فيتوقف المفتاح القديم عن العمل فوراً — ثم الصق المفتاح الجديد في كل نموذج وتكامل كان يستعمله. والطلبات محدودة المعدّل أيضاً لكل عنوان مُرسل، فيصطدم الكاشط (scraper) بحائط لا تصطدم به صفحة حقيقية أبداً.
نموذج موقعك الإلكتروني ليس إلا طريقاً آخر يصل منه عميل محتمل: العميل المحتمل نفسه، والقمع نفسه، والحصة نفسها — ولم يذهب إلا الكتابة اليدوية.