نظرة عامة
أنشئ سجل جهة اتصال واحدة. الحقول الثلاثة في الجسم مطلوبة. يجب أن تتضمن أرقام الهاتف رمز الدولة دون علامة زائد في كثير من التكاملات — تحقق وفق قواعد منطقتك. بعد الإنشاء، استخدم معرف جهة الاتصال في إرسال WhatsApp عبر contact_id.
POST /api/contacts/
استدعِ نقطة النهاية بـ POST ورمز bearer صالح.
curl -X POST 'https://app.buzzbip.com/api/contacts/' \
-H 'Authorization: Bearer ${TOKEN}' \
-H 'Content-Type: application/json' \
-d '{"firstname": "Jane", "lastname": "Doe", "number": "21690123456"}'ملاحظات الاستخدام
أنشئ جهة اتصال. الحقول الثلاثة في الجسم مطلوبة. يجب أن تتضمن الأرقام رمز الدولة — تحقق حسب قواعدك. بعد الإنشاء استخدم id جهة الاتصال في إرسال WhatsApp عبر contact_id.
استخدم الترقيم والفلاتر لتقليل حجم الاستجابة.
ملاحظات التكامل
عند دمج نقطة نهاية Buzzbip هذه، استخدم https://app.buzzbip.com كمضيف إنتاج. احصل على JWT من POST /api/login_check وأرسل Authorization: Bearer في كل طلب. تأكد من تفعيل User.hasApiAccess في إدارة Buzzbip. حلّل استجابات JSend (status وmessage وdata). لإضافات التجارة الإلكترونية، أرسل أيضاً x-api-key وx-platform-type وx-base-uri. احترم الشرطة المائلة النهائية في POST /api/contacts/ وPOST /api/whatsapp/. نفّذ إعادة المحاولة مع backoff عند حدود المعدل. خزّن بيانات الاعتماد على الخادم وأعد المصادقة قبل انتهاء JWT (3600 ثانية).
الأمان
أفضل الممارسات: بيانات الاعتماد على الخادم فقط، TLS إلزامي، مراقبة فشل المصادقة. افصل حسابات التجربة والإنتاج. وثّق القوالب والأتمتة. احذف الأرقام والمحتوى من السجلات المشتركة.
ما التالي؟
صفحات ذات صلة: api/contacts/list-contacts api/whatsapp-messaging/send-whatsapp-message guides/sync-contacts-from-crm