هوية معرف مستخدم واتساب

/v1/contacts/{users-whatsapp-id}/identity

يمكن تلقي إشعارات من واتساب عندما يكون المستخدم الذي تتواصل معه قد تغير. استخدم عنصر الربط /v1/contacts هذا لإدارة هويات المستخدمين. لمزيد من المعلومات، يمكنك الرجوع إلى التعرف على تغيير الهوية في واتساب للأعمال.

لمزيد من المعلومات حول إشعار النظام الذي يتم إرساله من واتساب، يمكنك الرجوع إلى رسائل النظام الواردة — مثال: احتمالية تغيير المستخدم. يتولى نشاطك التجاري إدارة الاستجابة لإشعار النظام.

القراءة

يعمل استدعاء GET لنقطة النهاية هذه على استعادة تجزئة الهوية الأحدث للمستخدم.

مثال

الطلب:

GET /v1/contacts/users-whatsapp-id/identity

في حالة نجاح الأمر، يقوم طلبك بإرجاع القيمة 200 OK ونص رسالة يحتوي على كائن contacts. على سبيل المثال، يمكن أن تبدو الاستجابة الكاملة كما يلي، بما في ذلك الكائن contacts:

{
    "contacts":
    {
        "hash": "UKD6Y/5SqDU=",
        "created_timestamp": 1600132094000,
        "acknowledged": true 
    }
}
  

الحقول التي يتم إرجاعها

يحتوي كائن الاستجابة في contacts على المعلومات التالية المتعلقة بهوية المستخدم.

الإنشاء

استخدم استدعاءات PUT لنقطة النهاية هذه لاعتماد إشعار النظام user_identity_changed الأحدث.

حتى يتم إجراء استدعاء API identity ناجح بعد تلقي إشعار user_identity_changed، سيتم حظر جميع الرسائل الصادرة إلى هذا المستخدم في حالة تمكين الإعدادات show_security_notifications في إعدادات التطبيق.

مثال

الطلب:

PUT /v1/contacts/users-whatsapp-id/identity
  {
    “hash”: “Rc/eg9RQ0JA=”
  }

الاستجابة الناجحة هي 200 OK وتتضمن نص رسالة بالقيمة null أو {}.

المعلمات