في هذا الدليل: جدول مرجعي لأنواع الوسائط · انتهاء صلاحية URL خلال 5 دقائق · خط أنابيب التنزيل الكامل · جميع مخططات حمولة الوسائط · التعامل مع الصور والمستندات · تحويل المذكرة الصوتية OGG→MP3 · تفريغ Whisper · أنماط تخزين S3/GCS · معالج كامل بجميع الأنواع · تنسيق SocialHook المطبّع
أنواع الوسائط: جدول مرجعي كامل
تُسلّم Cloud API 8 أنواع من رسائل الوسائط، لكل منها صيغ وحدود حجم ومتطلبات معالجة مختلفة. اعرف القيود قبل أن تبني المعالج.
| قيمة type | الصيغ المقبولة | حد الحجم | ملاحظات خاصة | |
|---|---|---|---|---|
| image | JPEG, PNG | 5 ميجابايت | caption اختياري. GIF غير مدعوم مدمجاً — أرسله كمستند. |
|
| audio | AAC, AMR, MP3, OGG/Opus | 16 ميجابايت | voice: true إذا كانت مسجّلة داخل التطبيق (OGG/Opus). ملفات الصوت العادية قد تختلف. حوّل OGG دائماً قبل التفريغ. |
|
| video | MP4, 3GPP | 16 ميجابايت | caption اختياري. يُنصح بفيديو H.264 + صوت AAC لأوسع توافق. |
|
| document | أي نوع MIME تقبله Meta | 100 ميجابايت | يتضمن filename — خزّنه. PDF, DOCX, XLSX، صور كمستندات، إلخ. |
|
| sticker | WebP | ثابت 500 كيلوبايت / متحرّك 100 كيلوبايت | animated: true إذا كان متحركاً. صيغة WebP — تدعمها المتصفحات أصلياً الآن. |
انتهاء صلاحية URL خلال 5 دقائق — التفصيل الذي يكسر معظم التطبيقات
هذا أكثر تفصيل يُغفله مطورو معالجة وسائط WhatsApp شيوعاً، ويسبب أكثر أخطاء الإنتاج. عندما تستدعي نقطة وسائط Cloud API لحل معرّف الوسائط، تستقبل URL تنزيل مؤقتاً. هذا الـ URL صالح لمدة تقارب 5 دقائق.
النمطان اللذان يستخدمهما المطورون — ولماذا أحدهما يفشل:
- ❌ خزّن الـ URL، نزّل لاحقاً — تستقبل webhook، تستدعي نقطة الوسائط، تخزّن الـ URL المؤقت في قاعدة بياناتك للمعالجة غير المتزامنة. بحلول الوقت الذي يلتقطه فيه عاملك، انتهت صلاحية الـ URL. تحصل على 403. هذا النمط يفشل.
- ✓ نزّل فوراً، خزّن الملف — تستقبل webhook، تحل معرّف الوسائط إلى URL فوراً، تنزّل البايتات فوراً، تخزّن الملف على تخزينك الخاص (S3, GCS, القرص)، تحفظ فقط مسار التخزين في قاعدة بياناتك. تعمل المعالجة غير المتزامنة على الملف المخزّن. هذا النمط صحيح.
بديل: خزّن معرّف الوسائط، حلّه عند الطلب. إذا لم تكن بحاجة إلى الملف فوراً، يمكنك تخزين معرّف الوسائط فقط وحله جديداً عندما تحتاج الملف. معرّفات الوسائط صالحة لمدة 30 يوماً — أطول بكثير من URL التنزيل المؤقت. هذا مفيد عندما لا تكون متأكداً ما إذا كنت ستحتاج البايتات أصلاً (مثلاً الملصقات التي قد تتجاهلها). فقط اعلم أن استدعاء الحل يضيف زمن استجابة عندما تحتاج إليه أخيراً.
خط أنابيب التنزيل: المعرّف ← URL ← البايتات ← التخزين
1
استقبل webhook — استخرج معرّف الوسائط
msg.image.id / msg.audio.id / msg.document.id — ليس URL، فقط مرجع
2
أعد HTTP 200 فوراً افعل هذا أولاً
أقرّ لـ Meta قبل أي تنزيلات. ادفع معالجة الوسائط إلى قائمة غير متزامنة.
3
حل معرّف الوسائط ← URL تنزيل مؤقت
GET graph.facebook.com/v21.0/{media_id} — يتطلب Authorization: Bearer {token} — يعيد url (تنتهي ~5 دقائق) + mime_type + file_size
4
نزّل بايتات الملف خلال 5 دقائق
GET {download_url} — يتطلب أيضاً Authorization: Bearer {token} — يعيد بايتات ثنائية خام
5
خزّن الملف على S3 / GCS / القرص المحلي
نظّم حسب: media/{client_id}/{media_type}/{date}/{media_id}.{ext}
6
عالج (خاص بالنوع)
صورة: استخرج البيانات الوصفية، أنشئ صورة مصغّرة. صوت/صوتي: حوّل OGG→MP3، فرّغ. مستند: استخرج النص للبحث. فيديو: أنشئ إطار مصغّر.
مخططات الحمولة لكل نوع وسائط
إليك بنية كائن قيمة webhook الدقيقة لكل نوع وسائط. التداخل من الغلاف العلوي (entry[0].changes[0].value.messages[0]) مستخرج بالفعل عند استخدام تنسيق SocialHook المطبّع.
// رسالة صورة
{ "type": "image", "image": { "id": "wamid.img...", "mime_type": "image/jpeg", "sha256": "abc...", "caption": "optional" }}
// رسالة صوت (مذكرة صوتية داخل التطبيق)
{ "type": "audio", "audio": { "id": "wamid.aud...", "mime_type": "audio/ogg; codecs=opus", "sha256": "def...", "voice": true }}
// رسالة صوت (ملف صوتي، ليس مذكرة)
{ "type": "audio", "audio": { "id": "wamid.aud...", "mime_type": "audio/mpeg", "sha256": "ghi..." }}
// ملاحظة: حقل voice غائب أو false لملفات الصوت المرفوعة
// رسالة فيديو
{ "type": "video", "video": { "id": "wamid.vid...", "mime_type": "video/mp4", "sha256": "jkl...", "caption": "optional" }}
// رسالة مستند
{ "type": "document", "document": { "id": "wamid.doc...", "mime_type": "application/pdf", "sha256": "mno...", "filename": "invoice-2026.pdf", "caption": "optional" }}
// رسالة ملصق
{ "type": "sticker", "sticker": { "id": "wamid.stk...", "mime_type": "image/webp", "sha256": "pqr...", "animated": false }}
التعامل مع الصور والمستندات
تشترك الصور والمستندات في نفس نمط التنزيل من خطوتين. الفرق الرئيسي: المستندات تتضمن حقل filename يجب أن تحتفظ به في مفتاح تخزينك — إنه ما سمّى به العميل الملف وما ستريد إظهاره في واجهتك.
const GRAPH = 'https://graph.facebook.com/v21.0';
const TOKEN = process.env.WA_TOKEN;
// الخطوة 1: حل معرّف الوسائط ← URL تنزيل مؤقت (تنتهي ~5 دقائق)
async function resolveMediaUrl(mediaId) {
const res = await fetch(`${GRAPH}/${mediaId}`, {
headers: { 'Authorization': `Bearer ${TOKEN}` },
});
if (!res.ok) throw new Error(`Media resolve failed: ${res.status}`);
const { url, mime_type, file_size } = await res.json();
return { url, mime_type, file_size };
}
// الخطوة 2: نزّل بايتات الملف من الـ URL المؤقت
async function downloadMedia(downloadUrl) {
const res = await fetch(downloadUrl, {
headers: { 'Authorization': `Bearer ${TOKEN}` }, // مطلوب!
});
if (!res.ok) throw new Error(`Media download failed: ${res.status}`);
return Buffer.from(await res.arrayBuffer());
}
// المعالج الكامل: حل ← تنزيل ← تخزين
async function handleMediaMessage(msg, from) {
const type = msg.type; // 'image' | 'document' | 'video' | 'sticker'
const media = msg[type];
const mediaId = media.id;
const filename = media.filename ?? mediaId; // المستندات لها filename
const caption = media.caption ?? null;
// حل ثم نزّل فوراً — تنتهي صلاحية URL خلال ~5 دقائق
const { url, mime_type } = await resolveMediaUrl(mediaId);
const bytes = await downloadMedia(url);
// خزّن الملف — انظر قسم أنماط التخزين
const storagePath = await storeFile(bytes, type, mediaId, mime_type, filename);
return {
mediaId,
storagePath,
mimeType: mime_type,
filename,
caption,
from,
type,
};
}
import os, requests
GRAPH = "https://graph.facebook.com/v21.0"
TOKEN = os.environ["WA_TOKEN"]
HEADERS = { "Authorization": f"Bearer {TOKEN}" }
def resolve_media_url(media_id: str) -> dict:
"""الخطوة 1: حل معرّف الوسائط ← URL تنزيل مؤقت."""
res = requests.get(f"{GRAPH}/{media_id}", headers=HEADERS)
res.raise_for_status()
return res.json() # { url, mime_type, file_size, id }
def download_media(download_url: str) -> bytes:
"""الخطوة 2: نزّل بايتات الملف — تنتهي صلاحية URL خلال ~5 دقائق."""
res = requests.get(download_url, headers=HEADERS) # التوثيق مطلوب هنا أيضاً!
res.raise_for_status()
return res.content
def handle_media_message(msg: dict, sender: str) -> dict:
media_type = msg["type"]
media = msg[media_type]
media_id = media["id"]
filename = media.get("filename", media_id)
caption = media.get("caption")
# حل ثم نزّل فوراً — URL صالح ~5 دقائق فقط
media_info = resolve_media_url(media_id)
file_bytes = download_media(media_info["url"])
storage_path = store_file(file_bytes, media_type, media_id, media_info["mime_type"], filename)
return {
"media_id": media_id,
"storage_path": storage_path,
"mime_type": media_info["mime_type"],
"filename": filename,
"caption": caption,
"sender": sender,
"type": media_type,
}
المذكرات الصوتية: التحويل من OGG/Opus إلى MP3
المذكرات الصوتية المسجّلة في WhatsApp مُرمّزة بصيغة OGG/Opus. يمكنك التعرف عليها بعلامة voice: true في حمولة الصوت وقيمة mime_type: "audio/ogg; codecs=opus". هذه الصيغة غير مدعومة من OpenAI Whisper للتفريغ، ولديها دعم تشغيل محدود في المتصفحات.
الحل: حوّل إلى MP3 باستخدام ffmpeg. ffmpeg هو أداة تحويل الصوت العالمية، متوفر على كل نظام تشغيل رئيسي وجميع بيئات السحابة.
# Ubuntu / Debian
apt-get install -y ffmpeg
# macOS
brew install ffmpeg
# Docker — أضف إلى Dockerfile
RUN apt-get update && apt-get install -y ffmpeg && rm -rf /var/lib/apt/lists/*
# غلاف Node.js (اختياري — يتجنب تنفيذ الشل)
npm install fluent-ffmpeg
const ffmpeg = require('fluent-ffmpeg');
const { Readable } = require('stream');
const path = require('path');
const os = require('os');
const fs = require('fs/promises');
async function convertOggToMp3(oggBuffer) {
const tmpDir = os.tmpdir();
const inputPath = path.join(tmpDir, `voice-${Date.now()}.ogg`);
const outPath = path.join(tmpDir, `voice-${Date.now()}.mp3`);
// اكتب buffer OGG إلى ملف مؤقت
await fs.writeFile(inputPath, oggBuffer);
// التحويل OGG/Opus → MP3
await new Promise((resolve, reject) => {
ffmpeg(inputPath)
.audioCodec('libmp3lame')
.audioBitrate('128k') // جودة جيدة بحجم معقول
.audioFrequency(44100) // معدل عينات قياسي لـ Whisper
.save(outPath)
.on('end', resolve)
.on('error', reject);
});
// اقرأ بايتات MP3
const mp3Buffer = await fs.readFile(outPath);
// نظّف الملفات المؤقتة
await Promise.all([fs.unlink(inputPath), fs.unlink(outPath)]);
return mp3Buffer;
}
// معالج المذكرة الصوتية: تنزيل ← كشف ← تحويل ← تخزين
async function handleAudioMessage(msg, from) {
const { id: mediaId, voice, mime_type } = msg.audio;
const isVoiceNote = voice === true;
const { url } = await resolveMediaUrl(mediaId);
const rawBytes = await downloadMedia(url);
let finalBytes = rawBytes;
let finalMime = mime_type;
if (isVoiceNote || mime_type.includes('ogg')) {
// التحويل OGG/Opus → MP3 للتوافق + تفريغ Whisper
finalBytes = await convertOggToMp3(rawBytes);
finalMime = 'audio/mpeg';
}
const storagePath = await storeFile(finalBytes, 'audio', mediaId, finalMime);
return { mediaId, storagePath, isVoiceNote, mime_type: finalMime };
}
import subprocess, tempfile, os
from pathlib import Path
def convert_ogg_to_mp3(ogg_bytes: bytes) -> bytes:
"""تحويل بايتات مذكرة صوتية OGG/Opus ← بايتات MP3 عبر ffmpeg."""
with tempfile.TemporaryDirectory() as tmp_dir:
input_path = Path(tmp_dir) / "input.ogg"
output_path = Path(tmp_dir) / "output.mp3"
# اكتب بايتات OGG إلى ملف مؤقت
input_path.write_bytes(ogg_bytes)
# شغّل تحويل ffmpeg
result = subprocess.run([
"ffmpeg", "-y", # استبدال دون سؤال
"-i", str(input_path),
"-codec:a", "libmp3lame", # مرمّز MP3
"-qscale:a", "2", # جودة ~190kbps
"-ar", "44100", # معدل عينات لتوافق Whisper
str(output_path)
], capture_output=True)
if result.returncode != 0:
raise RuntimeError(f"ffmpeg failed: {result.stderr.decode()}")
return output_path.read_bytes()
def handle_audio_message(msg: dict, sender: str) -> dict:
audio = msg["audio"]
media_id = audio["id"]
is_voice = audio.get("voice", False)
mime_type = audio.get("mime_type", "")
media_info = resolve_media_url(media_id)
raw_bytes = download_media(media_info["url"])
if is_voice or "ogg" in mime_type:
final_bytes = convert_ogg_to_mp3(raw_bytes)
final_mime = "audio/mpeg"
else:
final_bytes = raw_bytes
final_mime = mime_type
storage_path = store_file(final_bytes, "audio", media_id, final_mime)
return { "media_id": media_id, "path": storage_path, "is_voice": is_voice }
تفريغ المذكرات الصوتية باستخدام OpenAI Whisper
بمجرد حصولك على MP3، أرسله إلى Whisper API من OpenAI. يدعم Whisper 57 لغة، ويتعامل مع الضوضاء الخلفية بشكل جيد، ويكلّف ~0.006 دولار لكل دقيقة صوت — مذكرة صوتية مدتها 30 ثانية تكلّف أقل من سنت لتفريغها. ثم يصبح التفريغ نصاً قابلاً للبحث ومعالجة بالذكاء الاصطناعي.
const OpenAI = require('openai');
const { Readable } = require('stream');
const oai = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });
async function transcribeAudio(mp3Buffer, language = 'en') {
// يتوقع Whisper كائناً شبيهاً بـ File — لفّ الـ buffer
const file = new File([mp3Buffer], 'voice_note.mp3', { type: 'audio/mpeg' });
const response = await oai.audio.transcriptions.create({
model: 'whisper-1',
file,
language, // اختياري — كشف تلقائي إذا حُذف
response_format: 'verbose_json', // يتضمن الثقة + الأجزاء
});
return {
text: response.text, // التفريغ الكامل
language: response.language, // اللغة المكتشفة
duration: response.duration, // مدة الصوت بالثواني
segments: response.segments, // توقيت على مستوى الكلمة (verbose_json فقط)
};
}
// خط أنابيب المذكرة الصوتية الكامل: تنزيل ← تحويل ← تفريغ ← تخزين
async function processVoiceNote(msg, from) {
const { mediaId, storagePath, isVoiceNote } = await handleAudioMessage(msg, from);
if (!isVoiceNote) return { mediaId, storagePath, transcript: null };
// اقرأ MP3 المخزّن للتفريغ
const mp3Buffer = await readFromStorage(storagePath);
const transcript = await transcribeAudio(mp3Buffer);
// خزّن التفريغ بجانب الصوت
await saveTranscript(mediaId, from, transcript);
console.log(`[${from}] Voice note: "${transcript.text}"`);
return { mediaId, storagePath, transcript };
}
import io
from openai import OpenAI
client = OpenAI(api_key=os.environ["OPENAI_API_KEY"])
def transcribe_audio(mp3_bytes: bytes, language: str = "en") -> dict:
"""تفريغ بايتات صوت MP3 باستخدام OpenAI Whisper."""
audio_file = io.BytesIO(mp3_bytes)
audio_file.name = "voice_note.mp3" # تقرأ الـ SDK الـ .name لكشف MIME
response = client.audio.transcriptions.create(
model="whisper-1",
file=audio_file,
language=language, # احذف للكشف التلقائي
response_format="verbose_json" # يتضمن الأجزاء + الثقة
)
return {
"text": response.text,
"language": response.language,
"duration": response.duration,
}
def process_voice_note(msg: dict, sender: str) -> dict:
result = handle_audio_message(msg, sender)
if not result["is_voice"]:
return {**result, "transcript": None}
mp3_bytes = read_from_storage(result["path"])
transcript = transcribe_audio(mp3_bytes)
save_transcript(result["media_id"], sender, transcript)
return {**result, "transcript": transcript}
ماذا تفعل بالتفريغ: خزّنه بجانب ملف الصوت. مرّره إلى وكيل الذكاء الاصطناعي الخاص بك كرسالة المستخدم (بدلاً من "تم استلام رسالة صوتية"). فهرسته في قاعدة بيانات البحث الخاصة بك. سجّله في CRM الخاص بك كنص المحادثة. يرسل العملاء مذكرات صوتية لأن الكتابة أبطأ — معاملة مذكراتهم الصوتية كنص قابل للبحث يحسّن بشكل كبير قدرة وكيل الذكاء الاصطناعي الخاص بك على الفهم والرد بشكل صحيح.
أنماط التخزين: نظّم ملفات الوسائط لديك
كيفية تنظيم الملفات في S3 أو GCS مهمّة للأداء، والفوترة، وتصحيح الأخطاء. إليك نمط مفتاح التخزين الذي يتسع بنظافة عبر عدة عملاء وأنواع رسائل:
const { S3Client, PutObjectCommand } = require('@aws-sdk/client-s3');
const mime2ext = require('mime-types');
const s3 = new S3Client({ region: process.env.AWS_REGION });
const BUCKET = process.env.S3_BUCKET;
async function storeFile(bytes, type, mediaId, mimeType, filename) {
const ext = mime2ext.extension(mimeType) || 'bin';
const date = new Date().toISOString().slice(0, 10); // YYYY-MM-DD
// مفتاح منظّم: media/{type}/{date}/{mediaId}.{ext}
// للمستندات، احتفظ بالاسم الأصلي في البيانات الوصفية
const key = `media/${type}/${date}/${mediaId}.${ext}`;
await s3.send(new PutObjectCommand({
Bucket: BUCKET,
Key: key,
Body: bytes,
ContentType: mimeType,
Metadata: {
'original-filename': filename || mediaId,
'media-id': mediaId,
},
}));
return `s3://${BUCKET}/${key}`; // خزّن هذا المسار في قاعدة بياناتك
}
// أمثلة مفاتيح S3:
// media/image/2026-05-13/wamid.img123.jpeg
// media/audio/2026-05-13/wamid.aud456.mp3 ← مُحوّل من OGG
// media/document/2026-05-13/wamid.doc789.pdf
// media/video/2026-05-13/wamid.vid012.mp4
معالج webhook كامل للوسائط (جميع الأنواع)
دالة واحدة تستقبل حدث وسائط مطبّع وتوجّهه إلى المعالج الصحيح حسب النوع:
async function dispatchMedia(event) {
const { from, message } = event;
const { type } = message;
// رسائل نصية — ليست وسائط، تعامل معها بشكل منفصل
if (type === 'text') return handleText(from, message.text.body);
// أنواع رسائل غير وسائط
if (['location', 'contacts', 'reaction', 'interactive'].includes(type)) {
return handleNonMedia(from, message);
}
// أنواع الوسائط — جميعها تتطلب التنزيل
switch (type) {
case 'image':
case 'video':
case 'sticker':
case 'document': {
const result = await handleMediaMessage(message, from);
await saveMediaRecord(from, result);
break;
}
case 'audio': {
// المذكرات الصوتية تُفرّغ؛ ملفات الصوت العادية تُخزّن فقط
const result = await processVoiceNote(message, from);
await saveMediaRecord(from, result);
// إذا فُرّغت المذكرة الصوتية، عامل التفريغ كإدخال نصي
if (result.transcript?.text) {
console.log(`Voice note from ${from}: "${result.transcript.text}"`);
await handleText(from, result.transcript.text, { isVoiceNote: true });
}
break;
}
default:
console.warn(`Unhandled media type: ${type}`);
}
}
SocialHook: معرّفات وسائط مستخرجة مسبقاً بتنسيق مطبّع
عند استخدام SocialHook، تصل حمولة الوسائط مستخرجة بالفعل من غلاف Cloud API المتداخل من Meta. بدلاً من التنقل في entry[0].changes[0].value.messages[0]، تستقبل حدثاً مسطّحاً:
// رسالة صورة
{
"platform": "whatsapp",
"event": "message.received",
"from": "+1 555 000 1234",
"message": {
"type": "image",
"id": "wamid.HBgL...",
"image": {
"id": "12345678901234", // ← استخدم هذا لحل الـ URL
"mime_type": "image/jpeg",
"caption": "Here's the damage to my package"
}
},
"signature_verified": true
}
// مذكرة صوتية
{
"message": {
"type": "audio",
"audio": {
"id": "98765432109876",
"mime_type": "audio/ogg; codecs=opus",
"voice": true // ← هذا يخبرك بتشغيل تحويل OGG→MP3
}
}
}
دالة dispatchMedia(event) الخاصة بك أعلاه تستقبل هذا التنسيق مباشرة — لا حاجة لتحليل إضافي. معرّف الوسائط في event.message.image.id (أو .audio.id، .document.id، إلخ)، جاهز لتمريره إلى resolveMediaUrl().
FAQ
أسئلة شائعة
كيف أنزّل الوسائط من webhook WhatsApp Cloud API؟
خطوتان: (1) استدعِ
GET graph.facebook.com/v21.0/{media_id} مع رمز وصولك للحصول على URL تنزيل مؤقت. (2) اجلب هذا الـ URL (مع رمز وصولك في ترويسة Authorization أيضاً) للحصول على بايتات الملف. نزّل فوراً — تنتهي صلاحية الـ URL خلال 5 دقائق تقريباً. خزّن بايتات الملف على S3/GCS/القرص، لا الـ URL المؤقت.لماذا يعيد URL تنزيل وسائط WhatsApp الخاص بي خطأ 403؟
سببان: (1) انتهت صلاحية الـ URL — URLs تنزيل وسائط WhatsApp صالحة لمدة 5 دقائق تقريباً. إذا خزّنت الـ URL وجلبته لاحقاً، فقد انتهت صلاحيته. أعد الحل من معرّف الوسائط. (2) ترويسة Authorization مفقودة — يتطلب URL التنزيل نفسه أيضاً
Authorization: Bearer {ACCESS_TOKEN} في الطلب. URLs وسائط WhatsApp ليست URLs CDN عامة.ما صيغة المذكرات الصوتية في WhatsApp وكيف أحوّلها؟
المذكرات الصوتية في WhatsApp بصيغة OGG/Opus (يمكن التعرف عليها بـ
voice: true في الحمولة و mime_type: "audio/ogg; codecs=opus"). حوّل إلى MP3 باستخدام ffmpeg: ffmpeg -i input.ogg -codec:a libmp3lame -qscale:a 2 output.mp3. OGG/Opus غير مدعوم من OpenAI Whisper أو معظم المتصفحات — حوّل دائماً قبل التفريغ أو التشغيل. كود Node.js وPython الكامل في قسم المذكرات الصوتية أعلاه.كيف أفرّغ مذكرات WhatsApp الصوتية باستخدام Whisper؟
نزّل OGG ← حوّل إلى MP3 بـ ffmpeg ← أرسل إلى OpenAI Audio Transcriptions API بـ
model: "whisper-1". يعيد Whisper نص التفريغ. التكلفة ~0.006 دولار لكل دقيقة صوت. مذكرة صوتية 30 ثانية تكلّف أقل من ثلث سنت. ثم يمكن معاملة التفريغ كرسالة نصية عادية من قبل وكيل الذكاء الاصطناعي أو CRM لديك.كم تستمر صلاحية معرّفات وسائط WhatsApp؟
معرّفات الوسائط صالحة لمدة 30 يوماً. URL التنزيل المؤقت الذي تحصل عليه من حل المعرّف صالح لمدة 5 دقائق تقريباً. هذا يعني أنه يمكنك بأمان تخزين معرّف الوسائط فقط في قاعدة بياناتك وحله جديداً عندما تحتاج الملف (خلال 30 يوماً). بعد 30 يوماً، تُحذف الوسائط من خوادم Meta ويصبح المعرّف غير صالح.
ما هي حدود حجم ملفات وسائط WhatsApp؟
حسب النوع: صورة (JPEG, PNG) — 5 ميجابايت. صوت — 16 ميجابايت. فيديو — 16 ميجابايت. مستند — 100 ميجابايت. ملصق — 500 كيلوبايت ثابت، 100 كيلوبايت متحرّك. الرسائل بوسائط تتجاوز هذه الحدود تُرفض قبل أن يُطلق webhook الخاص بك — يرى المرسل الفشل، لا أنت.
احصل على معرّفات الوسائط
يبدأ خط أنابيبك بـ
حدث webhook نظيف.
يسلّم SocialHook كل حدث وسائط WhatsApp — صورة، مذكرة صوتية، مستند — كـ JSON مستخرج مسبقاً إلى معالجك. تحصل على معرّف الوسائط الجاهز للحل، ونوع MIME، وعلامة الصوت. لا تحليل لـ Cloud API. فقط مرّره مباشرة إلى دالة التنزيل لديك.
لا حاجة لبطاقة ائتمان · 50 دولاراً شهرياً بعد التجربة · إلغاء في أي وقت