إرسال الرسائل النصية

يمكنك استخدام العقدة messages لإرسال رسائل نصية إلى عملائك.

قبل البدء

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

القيود:

• يمكن أن يصل طول الرسالة النصية إلى 4096 حرفًا كحد أقصى.

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

بمجرد أن يتوفر لديك معرف WhatsApp للمستخدم الذي تريد مراسلته، يمكنك استخدامه في إرسال رسالة نصية. حدّد text في الحقل type.

POST /v1/messages
{
    "preview_url": false | true,
    "recipient_type": "individual",
    "to": "whatsapp-id",
    "type": "text",
    "text": {
        "body": "your-text-message-content"
    }
}

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

• المعلمات المشتركة لكل طلبات الرسائل
• معلمات الرسائل النصية

إذا كنت تريد تنسيق رسالتك، يمكنك الرجوع إلى التنسيق في الرسائل النصية.

إرسال عناوين URL في الرسائل النصية

يتعرّف تطبيق واتساب على الهاتف المحمول افتراضيًّا على عناوين URL ويجعلها قابلة للنقر. ولتضمين معاينة عنوان URL، أدرج "preview_url": true في نص الرسالة وتأكد من أن عنوان URL يبدأ بـ http:// أو https://. علمًا بأن اسم المضيف مطلوب، وعناوين IP غير متطابقة.

لاحظ أن استخدام preview_url هنا يختلف عن API السحابة. راجع وثائق رسائل API السحابة.

المثال

{
    "preview_url": true,
    "to": "whatsapp-id",
    "text": {
        "body": "You have to check out this amazing messaging service https://www.whatsapp.com/"
     }

في أغلب الأحيان عند إرسال عنوان URL سواء أكان مرفقًا بمعاينة أم لا، سيرى مستلم الرسالة عنوان URL الذي يمكنه النقر عليه.

لن تظهر معاينات عنوان URL إلا بعد اتخاذ أحد الإجراءات التالية:

1. أرسل النشاط التجاري قالب رسالة إلى المستخدم.
2. يبدأ المستخدم في إجراء محادثة باستخدام رابط "انقر للدردشة".
3. يضيف المستخدم رقم هاتف النشاط التجاري إلى دفتر عناوينه، ويبدأ في إجراء محادثة.

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

تتضمن الاستجابة الناجحة كائن messages يتضمن معرف الرسالة التي تم إنشاؤها حديثًا.

{
  "messages": [{
    "id": "gBEGkYiEB1VXAglK1ZEqA1YKPrU"
  }]
}  

تتضمن الاستجابة غير الناجحة رسالة خطأ. لمزيد من المعلومات، يمكنك الرجوع إلى رموز الخطأ والحالة.