الانتقال من v1 لـ v2

انقل من مفاتيح وendpoints v1 لكل رقم لمفاتيح الحساب في v2 وواجهة REST واحدة وويب هوك v2 الموقّع — خطوة خطوة.

v1 لسه شغال، فتقدر تنقل طلب طلب. شكل الرسالة هو هو: الـ body اللي بتبعته لـ v1 POST /whatsapp/public/messages شغال على v2 POST /v2/messages لما تضيف numberId.

المصادقة

	v1	v2
المفتاح	v1`x-api-key` لكل رقم	v2مفاتيح حساب: `Authorization: Bearer wsl_live_…`
الصلاحيات	v1ثابتة لكل رقم	v2صلاحيات، تقييد أرقام، قائمة IP، صلاحية، تغيير
اختيار الرقم	v1من المفتاح	v2`numberId` في الـ body / المسار

مفتاح الرقم من v1 شغال كمان على endpoints الرسايل في v2 لنفس الرقم، فتقدر تغيّر الروابط الأول والمفاتيح بعدين.

الـ endpoints

v1 (`/api/v1/whatsapp/public/…`)	v2 (`/api/v2/…`)
`POST messages` و `message/send` و `media/send` و `interactive/send`	v2 (`/api/v2/…`)`POST /v2/messages`
`POST media/upload`	v2 (`/api/v2/…`)`POST /v2/media`
`POST messages/{id}/react` · `edit` · `delete`	v2 (`/api/v2/…`)`POST /v2/messages/{id}/reactions` · `PATCH /v2/messages/{id}` · `DELETE /v2/messages/{id}`
`GET interactions/{id}`	v2 (`/api/v2/…`)ويب هوك `interactive.reply` · `GET /v2/messages/{id}`
لوحة التحكم بس	v2 (`/api/v2/…`)الأرقام والحملات والردود التلقائية والـ OTP وحماية الرقم والإحصائيات والجروبات والويب هوك — كلها في v2

الأخطاء

v1 بيرد { statusCode, code, message, … }؛ و v2 بيرد { error: { code, message, details?, docsUrl, requestId } }. الأكواد بتفضل بنفس أساميها لو موجودة في الاتنين. اقرا error.code.

الويب هوك

حقل v1	v2
`messageId`	v2`data.messageId`
`from` / `senderPhoneNumber`	v2`data.from.phone` (`data.from.lid` لما واتساب يخفي الرقم)
`fromName`	v2`data.from.name`
`messageType`	v2`data.type`
`content` / `caption`	v2`data.text` / `data.caption`
`mediaUrl`	v2`data.media.url` (موقّع) / `data.media.id`
`latitude` / `longitude`	v2`data.location.lat` / `.lng`
`isGroup` / `groupId`	v2`data.chat.type` / `data.chat.groupId`
`rawMessage`	v2اتشال

الخطوات

اعمل مفتاح حساب بالصلاحيات اللي محتاجها (الإعدادات ← مفاتيح API).
وجّه طلبات الإرسال لـ POST /v2/messages ومعاها numberId و Idempotency-Key.
عدّل كود الويب هوك يقرا غلاف v2 (التحقق من التوقيع بنفس الطريقة)، وحوّل الرقم للويب هوك الإصدار 2، وابعت حدث تجريبي وتابع السجل.
بدّل الاستعلام المتكرر بالويب هوك (message.status و campaign.status و number.status).
ألغي مفاتيح الأرقام القديمة اللي مش محتاجها.

مرجع v1 لسه موجود.