إرسال رسائل جهات الاتصال والموقع

استخدم العقدة messages لإرسال أنواع الرسائل الأخرى، مثل رسائل جهات الاتصال أو الموقع إلى العملاء.

قبل البدء

ستحتاج إلى ما يلي:

• تلبية كل المتطلبات الأساسية المُدرجة في قسم "قبل البدء" المتوفر في وثائق الرسائل.

رسائل جهات الاتصال

الخطوة الأولى: إجراء طلب POST إلى /messages

POST /v1/messages
{
    "to": "recipient-wa-id",
    "type": "contacts",
    "contacts": [
                {
                    "addresses": [
                        {
                            "city": "Menlo Park",
                            "country": "United States",
                            "country_code": "us",
                            "state": "CA",
                            "street": "1 Hacker Way",
                            "type": "HOME",
                            "zip": "94025"
                        },
                        {
                            "city": "Menlo Park",
                            "country": "United States",
                            "country_code": "us",
                            "state": "CA",
                            "street": "200 Jefferson Dr",
                            "type": "WORK",
                            "zip": "94025"
                        }
                    ],
                    "birthday": "2012-08-18",
                    "emails": [
                        {
                            "email": "test@fb.com",
                            "type": "WORK"
                        },
                        {
                            "email": "test@whatsapp.com",
                            "type": "WORK"
                        }
                    ],
                    "name": {
                        "first_name": "John",
                        "formatted_name": "John Smith",
                        "last_name": "Smith"
                    },
                    "org": {
                        "company": "WhatsApp",
                        "department": "Design",
                        "title": "Manager"
                    },
                    "phones": [
                        {
                            "phone": "+1 (940) 555-1234",
                            "type": "HOME"
                        },
                        {
                            "phone": "+1 (650) 555-1234",
                            "type": "WORK",
                            "wa_id": "16505551234"
                        }
                    ],
                    "urls": [
                        {
                             "url": "https://www.facebook.com",
                             "type": "WORK"
                        }
                    ]
                }
            ]
}

لمزيد من المعلومات حول المعلمات، يمكنك الرجوع إلى:

• المعلمات الشائعة لكل طلبات الرسائل: ضمن type، استخدم contact.
• المعلمات المخصصة لرسائل جهات الاتصال

  • الكائن address
  • الكائن emails
  • الكائن name
  • الكائن org
  • الكائن phone
  • الكائن urls

الخطوة الثانية: التحقق من الاستجابة

تظهر الاستجابة الناجحة على النحو التالي:

{
    "messages": [{
       "id": "message-id"
    }]
}

رسائل المواقع

الخطوة الأولى: إجراء طلب POST إلى /messages

POST /v1/messages

{
    "to": "recipient-wa-id",
    "type": "location",
    "location": {
        "longitude": -122.425332,
        "latitude": 37.758056,
        "name": "Facebook HQ",
        "address": "1 Hacker Way, Menlo Park, CA 94025"
    }
}

لمزيد من المعلومات حول المعلمات، يمكنك الرجوع إلى:

• المعلمات الشائعة لكل طلبات الرسائل: ضمن type، استخدم location.
• المعلمات المخصصة لرسائل الموقع

الخطوة الثانية: التحقق من الاستجابة

تبدو الاستجابة الناجحة على النحو التالي:

{
    "messages": [{
       "id": "message-id"
    }]
}

معرفة المزيد

• الرسائل النصية
• رسائل الوسائط
• قوالب الرسائل
• وثائق /messages