> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# رسائل تفاعلية تجريبية

> إرسال أزرار الرد، والمكالمات إلى الإجراء، وقوائم الاختيار، وطلبات الموقع، والرسوم المتحركة للصورة.

`POST /send/interactive` يرسل رسائل WhatsApp الأصلية-flow عبر الجهاز المحدد. استخدم المصادقة الأساسية، `X-Device-Id`، وجهاز JSON. هذه النقطة النهائية تدعم إرسال REST فورا. إرسال المجدولة ولا تكشف MCP عن ذلك.

> [!WARNING]
>
> نقطة النهاية التجريبية هذه تستخدم بروتوكول WhatsApp غير رسمي. التقديم المتلقي يختلف حسب العميل ويمكن أن يتغير بدون إشعار. اختبار على العملاء المستهدفين قبل الاستخدام. يؤكد نجاح استجابة API إرسال القبول، وليس التسليم أو التقديم.

عيّن عنوان URL للسيرفر ووثائق الاعتماد قبل تشغيل أمثلة الستريل. استخدم عنوان HTTPS العام للخادم البعيد وشمل `APP_BASE_PATH` عند تكوينه.

```bash theme={null}
export GOWA_URL=http://localhost:3000
export GOWA_USER=admin
export GOWA_PASSWORD=replace-with-your-password
export DEVICE_ID=my-device
```

## أزرار الإرسال

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" \
  -H 'Content-Type: application/json' -H "X-Device-Id: $DEVICE_ID" \
  "$GOWA_URL/send/interactive" --data '{
    "phone": "628123456789",
    "body": "Confirm your order?",
    "footer": "Order 123",
    "buttons": [
      {"name": "quick_reply", "params": {"display_text": "Confirm", "id": "confirm"}},
      {"name": "quick_reply", "params": {"display_text": "Cancel", "id": "cancel"}}
    ]
  }'
```

يقبل `phone` رقم هاتف أو معرّف JID كاملًا لمستخدم أو مجموعة. يتطلب الإرسال إلى المجموعة العضوية فيها وإذن النشر. لا يُدعم مستلمو النشرات الإخبارية وقوائم البث.

قدّم إما `buttons` أو `cards` في المستوى الأعلى. يفشل التحقق من الصحة عند تقديم كليهما أو عدم تقديم أي منهما.

| اسم الزر | البارامترات المطلوبة |
| - | - |
| `quick_reply` | سلاسل `display_text` و `id` غير فارغة. |
| `cta_url` | غير فارغ `display_text` و HTTP مطلق أو HTTPS `url`. |
| `cta_copy` | سلاسل `display_text` و `copy_code` غير فارغة. |
| `cta_call` | سلاسل `display_text` و `phone_number` غير فارغة. |
| `single_select` | يجب ألا يكون `title` و`sections` فارغين. يحتاج كل قسم إلى `rows` غير فارغة؛ ويحتاج كل صف إلى السلسلتين النصيتين `id` و`title` غير الفارغتين. |
| `send_location` | كائن JSON مثل `{}`. يجب أن يكون الزر الوحيد في رسالة بدون بطاقات. |

بالنسبة لقائمة الاختيار، استخدم هذه البارامترات:

```json theme={null}
{
  "name": "single_select",
  "params": {
    "title": "Choose a size",
    "sections": [{
      "title": "Sizes",
      "rows": [
        {"id": "small", "title": "Small"},
        {"id": "large", "title": "Large"}
      ]
    }]
  }
}
```

## طلب موقع

```json theme={null}
{
  "phone": "628123456789",
  "body": "Share your delivery location",
  "buttons": [{"name": "send_location", "params": {}}]
}
```

أرسل هذا JSON إلى `/send/interactive`. يجب على المستلم أن يختار مشاركة الموقع. نقطة النهاية لا تسترجع الموقع بدون إجراءاتهم.

## إرسال صورة مشابهة

```json theme={null}
{
  "phone": "628123456789",
  "body": "Choose a product",
  "cards": [
    {
      "title": "Product A",
      "body": "Available in blue",
      "image_base64": "<raw JPEG or PNG base64>",
      "buttons": [{"name": "quick_reply", "params": {"display_text": "Choose A", "id": "choose_a"}}]
    },
    {
      "title": "Product B",
      "body": "Available in green",
      "image_base64": "<raw JPEG or PNG base64>",
      "buttons": [{"name": "quick_reply", "params": {"display_text": "Choose B", "id": "choose_b"}}]
    }
  ]
}
```

استبدال العناصر النائبة للصور بالقاعدة القياسية 64، بدون بادئة عنوان URL للبيانات. الصور اختيارية على بطاقات فردية. تقوم GOWA بتغيير حجم الصور الموفرة لتناسب 1280 نقطة، وتحويلها إلى JPEG ، وإنشاء مصغرات ، وتحميلها إلى WhatsApp. عناوين URL للصور البعيدة غير مقبولة.

## حدود الطلب

| الحقل | الحد |
| - | - |
| رسالة `body` | مطلوب وغير فارغ بحد أقصى 4096 بايت. |
| رسالة `footer` | حد أقصى 256 بايت. |
| `buttons` | 1-10 لكل رسالة أو بطاقة. |
| زر `params` | كائن JSON ، الحد الأقصى 16,384 بايت. |
| `cards` | 2-10 بطاقات |
| بطاقة `body` | مطلوب وغير فارغ بحد أقصى 4096 بايت. |
| بطاقة `title` و `footer` | أقصى 256 بايت لكل منها. |
| بطاقة `image_base64` | الحد الأقصى البالغ 000 800 2 من الأحرف المشفرة و 000 000 2 من البايتات المشفرة أيضا رهنا بالحد الأقصى لحجم صورة الخادم. |
| تفكيك الصورة | JPEG أو PNG، بحد أقصى 4096 بكسل في الجانب. |

الحد الإجمالي لجسم طلب HTTP للسيرفر ينطبق أيضًا. استخدم الصور الصغيرة عند إرسال العديد من البطاقات. خيارات أو أحجام غير صالحة ترجع خطأ في التحقق قبل الإرسال.

## التعامل مع الردود والإيصالات

يرسل بنجاح مظروف النجاح العادي مع `results.message_id` والوضع الذي يقول أن تقديم المستلم لا يمكن التحقق منه. استخدام [webhooks](https://gowa-docs.mintlify.site/ar/concepts/webhooks.md) للردود ولأحداث `message.ack` للإيصالات. إعادة المحاولة بعد مهلة غامضة يمكن تكرار الرسائل.

أبلغ اختبارات اندرويد في أسفل الأندرويد عن إجراءات الرد على العمل، وعنوان URL، والنسخ، والمكالمة، والاختيار، والموقع، والرسوم المتحركة. هذه التقارير لا تثبت التوافق عبر الحسابات أو iOS أو WhatsApp Web. بطاقات العربات الفردية يمكن أن تظهر الأيقونات المعلقة حتى عندما تكون للرسالة الأم علامات فحص ويمكن للمستلم أن يرد. هذه المشكلة لا تزال بدون حل.

نقطة النهاية لا تسجل القوالب الرسمية أو تدعم التدفقات الواردة، الكتالوجات، أو الدفعات الأصلية.


## Related topics

- [إرسال رسالة تفاعلية تجريبية](https://gowa-docs.mintlify.site/ar/api-reference/send/إرسال-رسالة-تفاعلية-تجريبية.md)
- [الحصول على رسائل من محادثة محددة](https://gowa-docs.mintlify.site/ar/api-reference/chat/الحصول-على-رسائل-من-محادثة-محددة.md)
- [GOWA: واجهة WhatsApp REST API](https://gowa-docs.mintlify.site/ar/index.md)
- [مزامنة سجل الرسائل إلى Chatwoot](https://gowa-docs.mintlify.site/ar/api-reference/chatwoot/مزامنة-سجل-الرسائل-إلى-chatwoot.md)
- [تكامل Chatwoot](https://gowa-docs.mintlify.site/ar/integrations/chatwoot.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.