تتيح الواجهة البرمجية لـ CRM لمطوريك أو نظام ERP أو موقعك قراءة سجلات CRM وتحديثها. وترسل الـ Webhooks التغيير إلى نظامك لحظة حدوثه، فلا تحتاج إلى الاستعلام المتكرر. وكلاهما في صفحة الواجهة البرمجية والـ Webhooks ضمن إعدادات CRM.
المصادقة
- أنشئ مفتاح API لمساحة العمل وفعّل صلاحية crm. المفاتيح التي لا تحملها لا تصل إلى CRM، فلا تتأثر المفاتيح الحالية.
- أرسل المفتاح في الترويسة X-Zapier-Api-Key.
- يعمل المفتاح باسم مساحة العمل كلها: يرى كل سجلات CRM مهما كانت صلاحيات الفريق. احفظه على خادمك، ولا تضعه أبدًا في متصفح أو تطبيق.
ما الذي يمكنك فعله
| المورد | النقاط تحت /api/v1/crm |
|---|---|
| جهات الاتصال | العرض، والبحث، والمخطط، والإنشاء، والقراءة، والتحديث، وإضافة ملاحظة |
| الشركات | العرض، والبحث، والمخطط، والإنشاء، والقراءة، والتحديث، والحذف، وربط جهات الاتصال، وإضافة ملاحظة |
| الصفقات | المسارات، وأسباب الخسارة، والعرض، والبحث، والإنشاء، والقراءة، والتحديث، والحذف، ونقل المرحلة، والتسجيل رابحة أو خاسرة، وإضافة ملاحظة |
| المهام | العرض، والإنشاء، والقراءة، والتحديث، والحذف، والإكمال |
| الأنشطة | العرض، والإنشاء، والقراءة |
| عروض الأسعار والمنتجات | العرض، والمخطط، والإنشاء، والقراءة، والتحديث، والحذف |
تعرض الصفحة عنوان الأساس الخاص بمساحة عملك ورابطًا إلى المرجع الكامل للواجهة البرمجية.
الـ Webhooks
- مالك مساحة العمل وحده يضيف الـ Webhooks. اختر إضافة Webhook.
- أدخل عنوان HTTPS على الإنترنت العام، مثل https://example.com/letsbot/webhooks.
- اختر الأحداث: إنشاء جهة اتصال أو شركة أو صفقة أو تحديثها أو حذفها، وتغيّر مرحلة الصفقة أو ربحها أو خسارتها، وإنشاء مهمة أو إكمالها، وإنشاء تذكرة، وإرسال عرض سعر أو مشاهدته أو قبوله.
- انسخ سر التوقيع — فهو يظهر مرة واحدة فقط.
- استخدم إرسال حدث تجريبي وراجع سجل الإرسال.
تحقق من التوقيع
يحمل كل طلب الترويسة X-LetsBot-Signature: t=<ثوانٍ يونكس>,v1=<hex>. احسب HMAC-SHA256 للنص <t>.<المتن الخام> بالسر، وقارنه بقيمة v1، وارفض الطلبات التي مضى على t فيها أكثر من 5 دقائق. وتحمل الترويسة X-LetsBot-Event اسم الحدث.
إعادة المحاولة
إن فشل عنوانك يعيد لتس بوت المحاولة بعد نحو دقيقة، ثم 5 دقائق، ثم 30 دقيقة، ثم ساعتين، ثم 6 ساعات. والـ Webhook الذي يستمر فشله، أو يرد بالحالة HTTP 410، يُوقف؛ أصلح العنوان ثم أعد تشغيله. ويمكنك أيضًا إعادة إرسال أي عملية من السجل.