واجهة برمجة تطبيقات WhatsApp Business في البرازيل — قائمة تحقق امتثال LGPD، أمثلة قوالب PT-BR، جدول أسعار BRL، مخطط استضافة الويب هوك على AWS São Paulo
في هذا الدليل: لماذا البرازيل #1 · ثقافة واتساب في البرازيل (الرسائل الصوتية!) · متطلبات الامتثال LGPD · أنماط القوالب PT-BR · الأسعار بـ BRL · تكامل مدفوعات PIX · hreflang لـ pt-BR · استضافة AWS São Paulo · متطلبات الاشتراك · إعداد SocialHook PT-BR

لماذا البرازيل هي السوق الأهم لـ WhatsApp

147M+
مستخدم نشط لـ WhatsApp في البرازيل
93%
نسبة انتشار الهواتف الذكية المستخدمة لـ WhatsApp
#1
البلد الذي أطلقت فيه Meta خدمة WhatsApp Pay
79%
البرازيليون الذين يفضلون WhatsApp للتواصل التجاري

البرازيل ليست مجرد سوق كبير لـ WhatsApp — إنها مختلفة هيكلياً عن كل سوق آخر. يعمل WhatsApp في البرازيل كطبقة التواصل الافتراضية لكل شيء: خدمة العملاء، والمبيعات، وإشعارات البنوك، والخدمات الحكومية، وتأكيدات الطلبات، وجدولة المواعيد، والتواصل الاجتماعي. البريد الإلكتروني في البرازيل للمراسلات القانونية الرسمية. الرسائل القصيرة للرموز المؤقتة OTPs. WhatsApp لكل شيء آخر.

عندما تبني تكاملاً مع WhatsApp يستهدف المستخدمين البرازيليين، فأنت لا تبني قناة إضافية — بل تبني القناة الأساسية. يجب أن تكون واجهة برمجة التطبيقات صحيحة منذ اليوم الأول. لا يمكن إضافة امتثال LGPD لاحقاً. جودة القوالب PT-BR مهمة لأن المستخدمين يقرؤون كل كلمة. والرسائل الصوتية ليست حالة هامشية — إنها الطريقة الأساسية للتواصل لدى البرازيليين.

ثقافة WhatsApp في البرازيل: ما يجب على المطورين فهمه

يختلف سلوك WhatsApp في البرازيل عن المعايير الأوروبية والأمريكية الشمالية بعدة طرق تؤثر مباشرة على كيفية بناء تكاملك:

  • WhatsApp يحل محل جميع القنوات الأخرى. العميل البرازيلي الذي يتواصل مع شركتك يتوقع إنجاز كل شيء عبر WhatsApp — الاستفسار، والشراء، وتتبع الطلبات، وطلب الدعم، والحصول على فاتورة ضريبية. إذا لم يتمكن روبوتك من التعامل مع كل هذا، سيذهب إلى منافس يستطيع ذلك.
  • توقعات زمن الاستجابة عالية جداً. يتوقع المستخدمون البرازيليون ردوداً في غضون دقائق، لا ساعات. وكيل الذكاء الاصطناعي الذي يتعامل مع الاستفسارات خارج ساعات العمل فورياً ليس رفاهية — إنه توقع أساسي يتوافق مع ثقافة التواصل.
  • اللغة غير الرسمية هي المعيار، حتى في الأعمال. التواصل التجاري PT-BR في البرازيل أكثر غير رسمية بشكل ملحوظ من البرتغالية الأوروبية أو حتى الإنجليزية. استخدام "você" بدلاً من "tu"، وإدراج المصغرات، واستخدام الأسماء الأولى من الرسالة الأولى أمر طبيعي ومتوقع.
  • ثقافة التواصل الجماعي. يستخدم البرازيليون مجموعات WhatsApp بشكل مكثف للمجتمعات والأحياء والعائلة. فهم هذا السياق يساعد عند تصميم حملات البث — البرازيليون حساسون جداً للرسائل التي تشعر وكأنها تواصل شخصي مقابل البث الجماعي.

الرسائل الصوتية: نوع الرسائل الأول في البرازيل

تمتلك البرازيل واحدة من أعلى معدلات استخدام الرسائل الصوتية للفرد في العالم. هذه ليست قصة — إنها سلوك موثق. كثير من البرازيليين يجدون الكتابة بطيئة أو غير شخصية ويلجؤون إلى الرسائل الصوتية لكل شيء من طلب البيتزا إلى الإبلاغ عن مشكلة في الفاتورة إلى مناقشة شروط العقد.

بالنسبة للمطورين، هذا له تداعيات معمارية مباشرة: يجب أن يتعامل معالج الويب هوك الخاص بـ WhatsApp مع الرسائل الصوتية كرسائل من الدرجة الأولى، وليس كحالات هامشية. إذا أجاب وكيل الذكاء الاصطناعي بـ "desculpe, só aceito mensagens de texto" (آسف، أقبل فقط الرسائل النصية) على رسالة صوتية، فقد أخفقت مع غالبية العملاء البرازيليين الذين يفضلون الصوت.

التنفيذ الصحيح للنشر في البرازيل:

Node.js — PT-BR voice note handler
brazilVoiceHandler.js
const OpenAI = require('openai'); const oai = new OpenAI({ apiKey: process.env.OPENAI_API_KEY }); async function handleBrazilianVoiceNote(audioBuffer) { // Whisper supports Portuguese natively — use 'pt' not 'pt-BR' // Brazilian PT has regional variations — Whisper handles them well const transcript = await oai.audio.transcriptions.create({ model: 'whisper-1', file: new File([audioBuffer], 'voz.mp3', { type: 'audio/mpeg' }), language: 'pt', // Portuguese — best for PT-BR response_format: 'json', }); console.log(`Áudio transcrito: "${transcript.text}"`); return transcript.text; } // In your main dispatcher — treat voice exactly like text async function dispatch(event) { const { from, message } = event; let userText = null; if (message.type === 'text') { userText = message.text.body; } else if (message.type === 'audio' && message.audio.voice) { const mp3 = await downloadAndConvertVoiceNote(message.audio.id); userText = await handleBrazilianVoiceNote(mp3); // Acknowledge the voice note naturally in PT-BR await sendWhatsApp(from, `🎧 Ouvi seu áudio! "${userText}" — deixa eu ajudar...`); } else { await sendWhatsApp(from, "Oi! Por favor, manda sua dúvida por texto ou áudio. 😊"); return; } // Both text and voice note transcript go through the same AI agent if (userText) await callAIAgent(from, userText); }

امتثال LGPD لعمليات نشر واجهة برمجة تطبيقات WhatsApp

قانون البرازيل Lei Geral de Proteção de Dados (LGPD)، القانون 13.709/2018، هو قانون حماية البيانات الشامل في البرازيل — مشابه هيكلياً للائحة الأوروبية GDPR ولكن بمتطلبات خاصة بالبرازيل. ينطبق على جميع معالجة البيانات الشخصية للأفراد الموجودين في البرازيل، بغض النظر عن مكان وجود شركتك أو خوادمك.

بالنسبة لعمليات نشر واجهة برمجة تطبيقات WhatsApp، تُنشئ LGPD التزامات محددة عبر خط أنابيب البيانات بأكمله — من لحظة إرسال العميل لرسالته الأولى إلى التخزين طويل الأمد لبيانات المحادثة. هذا ليس اختيارياً. تمتلك هيئة حماية البيانات البرازيلية (ANPD — Autoridade Nacional de Proteção de Dados) صلاحيات تنفيذية تشمل غرامات تصل إلى 2٪ من الإيرادات في البرازيل، بحد أقصى R$50 مليون لكل مخالفة.

الأساس القانوني للمعالجة (المادة 7 LGPD)
يجب أن يكون لديك أساس قانوني لمعالجة بيانات المحادثة. للرسائل التسويقية: موافقة صريحة. للرسائل المعاملاتية (تأكيدات الطلبات، وتحديثات التسليم): المصلحة المشروعة أو الوفاء بالعقد. وثّق أساسك القانوني لكل نشاط معالجة.
الاشتراك المستنير للتسويق (المادة 8 LGPD)
يجب أن يكون الاشتراك في الرسائل التسويقية صريحاً ومستنيراً ومحدداً. مربعات الاختيار المحددة مسبقاً والموافقة المجمعة محظورة. يجب أن يوضح نموذج الاشتراك بوضوح: ما هي الرسائل التي سيتلقاها العميل، وعدد مراتها، وكيفية إلغاء الاشتراك. احفظ طوابع وقت الاشتراك وعناوين IP ونسخة نص الموافقة.
حق الحذف (المادة 18 LGPD)
يمكن للعملاء طلب حذف جميع البيانات الشخصية التي تحتفظ بها، بما في ذلك سجل محادثات WhatsApp. يجب أن يدعم نظامك الحذف الكامل للبيانات لكل رقم هاتف عميل — سجلات المحادثات، والنصوص، وملفات الوسائط، وسجلات CRM. نفّذ نقطة نهاية API للحذف واستجب خلال 15 يوماً.
اتفاقية معالجة البيانات (DPA) مع المعالجين
إذا كنت تستخدم SocialHook أو أي منصة ويب هوك تابعة لجهة خارجية لمعالجة بيانات المحادثة، فأنت بحاجة إلى DPA موقّعة. بوصفهم معالجاً يعمل نيابةً عنك (بصفتك المتحكم)، يجب أن يلتزموا بالتعامل مع البيانات وفق LGPD. تتوفر DPA الخاصة بـ SocialHook على /en/legal/dpa.
الإخطار بالخروقات الأمنية (المادة 48 LGPD)
يجب الإبلاغ عن الحوادث الأمنية المتعلقة بالبيانات الشخصية للمستخدمين البرازيليين إلى ANPD في إطار زمني معقول (توجيه ANPD: في أقرب وقت ممكن، بشكل مثالي خلال 72 ساعة للحوادث الخطيرة). نفّذ مراقبة للوصول غير المصرح به إلى بيانات المحادثة وامتلك خطة استجابة للحوادث.
إقامة البيانات في البرازيل (موصى به)
لا تفرض LGPD إقامة البيانات داخل البرازيل (على عكس بعض القطاعات بموجب لوائح BACEN)، لكن استضافة بيانات المحادثة على AWS São Paulo (sa-east-1) يقلل من المخاطر التنظيمية ويحسن بشكل كبير زمن الاستجابة للويب هوك للمستخدمين البرازيليين. راجع قسم الاستضافة أدناه.

متطلبات الاشتراك البرازيلية: ما الذي يختلف

تتطلب سياسات WhatsApp الخاصة بـ Meta وكذلك LGPD موافقة صريحة للاشتراك في الرسائل التي تبدأها الأعمال. في البرازيل، يجعل السياق الثقافي والقانوني تفاصيل التنفيذ مهمة:

  • يجب أن تكون لغة الاشتراك بـ PT-BR. نموذج الاشتراك باللغة الإنجليزية للعميل البرازيلي مشكوك فيه قانونياً بموجب LGPD — يجب أن يفهم العملاء ما يوافقون عليه. استخدم PT-BR واضحة وبسيطة.
  • حقل CPF كرابط هوية. كثيراً ما يتوقع العملاء البرازيليون مشاركة رقم CPF (Cadastro de Pessoas Físicas — رقم التعريف الضريبي) للحصول على خدمة مخصصة. إذا جمعت CPF، فهذه بيانات شخصية تتطلب أساسها القانوني الخاص وحمايتها بموجب LGPD.
  • الاشتراك عبر رابط WhatsApp. نمط اشتراك برازيلي شائع: رابط WhatsApp (wa.me/{number}?text=Quero+receber+ofertas) حيث يبادر العميل بالتواصل. هذه إشارة اشتراك قوية — العميل تواصل معك بنشاط. التقطها مع طابع وقت.
PT-BR Opt-in message template
opt-in-template-ptbr.txt
Olá, {{1}}! 👋 Obrigado por entrar em contato com {{2}}. Para continuar recebendo nossas mensagens pelo WhatsApp, confirme seu interesse respondendo *SIM*. Ao confirmar, você concorda em receber: - Atualizações de pedidos e entregas - Novidades e promoções (máx. 2x por semana) Para cancelar a qualquer momento, responda *SAIR*. Seus dados são protegidos conforme a LGPD. Política de privacidade: {{3}} // Template name: opt_in_confirmation_ptbr // Category: UTILITY // Language: pt_BR // Variables: {{1}} name, {{2}} company, {{3}} privacy URL

أنماط قوالب البرتغالية البرازيلية

يجب أن تستخدم رسائل القوالب للمستخدمين البرازيليين pt_BR كرمز للغة — وليس pt (البرتغالية الأوروبية). يلاحظ البرازيليون فوراً التراكيب البرتغالية الأوروبية، مما يقوّض الثقة وتصور العلامة التجارية. إليك قوالب PT-BR على مستوى الإنتاج لحالات الاستخدام الشائعة:

Utility — Confirmação de pedido
Oi {{1}}! ✅ Seu pedido #{{2}} foi confirmado com sucesso. Valor total: R$ {{3}}. Você receberá uma nova mensagem quando seu pedido sair para entrega. Qualquer dúvida, é só chamar aqui! 😊
Template name: order_confirmed_ptbr · Language: pt_BR · Vars: name, order_id, total
Utility — Rastreamento de entrega
{{1}}, boa notícia! 🚚 Seu pedido #{{2}} saiu para entrega e deve chegar hoje entre {{3}} e {{4}}. Acompanhe em tempo real: {{5}}
Template name: shipping_update_ptbr · Language: pt_BR · Vars: name, order_id, time_start, time_end, tracking_url
Authentication — Código de verificação
Seu código de verificação {{2}} é: *{{1}}*. Válido por 10 minutos. Não compartilhe este código com ninguém. Caso não tenha solicitado, ignore esta mensagem.
Template name: auth_otp_ptbr · Language: pt_BR · Vars: otp_code, app_name · Use AUTHENTICATION category for lower cost
Marketing — Promoção
{{1}}, você ganhou acesso antecipado! 🎉 Amanhã lançamos {{2}} com desconto exclusivo de {{3}}% para quem confirmar agora. Quer garantir o seu? Responda *QUERO* ou acesse: {{4}}
Template name: early_access_ptbr · Language: pt_BR · Vars: name, product, discount, link · MARKETING category — subject to frequency capping
Utility — Lembrete de compromisso
Oi {{1}}! Só passando para lembrar: você tem um compromisso agendado *amanhã, {{2}} às {{3}}* com {{4}}. Confirma presença? Responda *SIM* ou *REAGENDAR* 😊
Template name: appointment_reminder_ptbr · Language: pt_BR · Vars: name, date, time, business_name
نصائح كتابة PT-BR المهمة: استخدم você (وليس tu). استخدم الأسماء الأولى من الرسالة الأولى. أضف الرموز التعبيرية — يستخدمها البرازيليون بسخاء في التواصل التجاري. استخدم Oi أو Olá (وليس Caro). استخدم أشكالاً فعلية غير رسمية. أدرج 😊 أو 🙏 — تُقرأ على أنها دفء، وليست غير مهنية. اطلب من متحدث برازيلي أصيل مراجعة كل قالب قبل الإرسال — تتفاوت التعبيرات الإقليمية وكثيراً ما تنتج الترجمة الآلية تراكيب البرتغالية الأوروبية التي يكتشفها المستخدمون البرازيليون فوراً.

أسعار المحادثات في سياق BRL

تفرض Meta رسوم محادثات WhatsApp بالدولار الأمريكي عالمياً — لا يوجد خيار فوترة بـ BRL. تدفع الشركات البرازيلية بالدولار الأمريكي، مما يعني أن تقلبات أسعار الصرف قلق تشغيلي حقيقي لوضع ميزانية التكاليف. إليك أسعار المحادثات للبرازيل اعتباراً من عام 2026، مع معادلات BRL التقريبية بسعر R$5.00/USD (تحقق من الأسعار الحالية):

الفئة USD / محادثة ~BRL / محادثة المستوى المجاني
الخدمة (الواردة) $0.0075 ~R$ 0.04 أول 1,000/شهر مجاناً
المنفعة (تأكيدات الطلبات، التنبيهات) $0.0158 ~R$ 0.08 —
المصادقة (OTPs) $0.0315 ~R$ 0.16 —
التسويق (العروض الترويجية، الحملات) $0.0625 ~R$ 0.31 —
Click-to-WhatsApp (نافذة مجانية 72 ساعة) $0.00 R$ 0.00 مجاناً لمدة 72 ساعة بعد النقر على الإعلان
تحسين التكلفة للنشر البرازيلي: استخدم إعلانات Click-to-WhatsApp على Facebook وInstagram لتوليد محادثات واردة — هذه تفتح نافذة تسويق مجانية لمدة 72 ساعة. تكاليف إعلانات وسائل التواصل الاجتماعي البرازيلية أقل عموماً من الولايات المتحدة/الاتحاد الأوروبي، وانتشار WhatsApp بنسبة 93% يعني أن مسار التحويل من النقر على الإعلان إلى محادثة WhatsApp إلى الشراء قصير للغاية. تكلفة الإعلان تُستهلك على مدى نافذة مجانية لمدة 72 ساعة. أيضاً: صنّف الرسائل كـ Utility بدلاً من Marketing حيثما ينطبق بشكل مشروع — يقلل التكلفة بنسبة 60% لكل محادثة.

تكامل PIX: تجارة WhatsApp في البرازيل

PIX هو نظام الدفع الفوري البرازيلي الذي يُشغّله Banco Central do Brasil. معالج أكثر من 40 مليار معاملة في 2025 وهو طريقة الدفع المهيمنة لجميع التجارة الرقمية البرازيلية. يتوقع العملاء البرازيليون القدرة على الدفع عبر PIX من داخل محادثة WhatsApp — إنشاء مفتاح PIX أو رمز QR داخل الدردشة ميزة حاسمة للتحويل في عمليات النشر للتجارة الإلكترونية.

بينما يعمل WhatsApp Pay (منتج الدفع الأصلي من Meta) في البرازيل، تستخدم معظم التطبيقات التقنية PIX مباشرة عبر معالج الدفع الخاص بك. إليك كيفية إرسال رابط دفع PIX داخل جلسة WhatsApp:

Node.js — PIX payment link via WhatsApp
pixPaymentFlow.js
// Generate a PIX payment and send the link/QR code via WhatsApp // Works with any PIX payment processor (Mercado Pago, PagSeguro, Stripe BR, etc.) async function sendPixPayment(to, orderDetails) { const { orderId, amount, description } = orderDetails; // 1. Generate PIX via your payment processor API const pixPayment = await createPixPayment({ amount: amount, // in BRL cents (e.g. 4990 = R$49,90) description: description, expiresIn: 3600, // 1 hour expiry for urgency }); // 2. Send the PIX link + instructions via WhatsApp // Within 24h service window — no template needed, send as free-form text await sendWhatsApp(to, `✅ *Pedido #${orderId} confirmado!*\n\n` + `💰 Total: *R$ ${(amount / 100).toFixed(2).replace('.', ',')}*\n\n` + `Para pagar via *PIX* agora, clique:\n${pixPayment.checkoutUrl}\n\n` + `⏰ Link válido por 1 hora.\n` + `Após o pagamento, você receberá a confirmação aqui mesmo. 🙏` ); // 3. Also send the PIX copy-paste code for convenience if (pixPayment.pixCode) { await sendWhatsApp(to, `Ou copie e cole o código PIX:\n\n` + `\`${pixPayment.pixCode}\`` // backtick = monospace in WhatsApp ); } } // Listen for PIX confirmation webhook from payment processor // Then notify customer on WhatsApp automatically app.post('/webhooks/payment', async (req, res) => { res.sendStatus(200); const { orderId, status, customerPhone } = req.body; if (status === 'paid') { await sendWhatsApp(customerPhone, `🎉 *Pagamento recebido!*\n\nSeu pedido #${orderId} já está sendo preparado. ` + `Você receberá uma atualização quando sair para entrega. Obrigado! 🙏` ); } });

إعداد hreflang بشكل صحيح لـ PT-BR

إذا كان منتجك يخدم متحدثي البرتغالية البرازيلية والأوروبية، فإن تطبيق hreflang أمر بالغ الأهمية. رمز اللغة pt-BR (بشرطة، وليس شرطة سفلية — يستخدم hreflang الشرطات) يخبر Google بأي نسخة تعرضها للمستخدمين البرازيليين. التطبيق الخاطئ لـ hreflang يعني أن المستخدمين البرازيليين قد يرون محتوى البرتغالية الأوروبية والعكس.

HTML head — correct hreflang for Brazil
hreflang-brazil.html
<!-- In your HTML head -- hreflang for Brazilian Portuguese --> <link rel="alternate" hreflang="en" href="https://socialhook.io/en/page"> <link rel="alternate" hreflang="pt-BR" href="https://socialhook.io/pt/page"> <link rel="alternate" hreflang="pt-PT" href="https://socialhook.io/pt-pt/page"> <!-- only if you have European PT --> <link rel="alternate" hreflang="es" href="https://socialhook.io/es/page"> <link rel="alternate" hreflang="x-default" href="https://socialhook.io/en/page"> <!-- WhatsApp Cloud API: use pt_BR (underscore) in template language.code --> <!-- hreflang uses pt-BR (hyphen) -- they differ! --> <!-- JSON-LD for Brazilian Portuguese content --> { "@context": "https://schema.org", "@type": "WebPage", "inLanguage": "pt-BR", "url": "https://socialhook.io/pt/page" } <!-- Also set the lang attribute correctly --> <html lang="pt-BR"> <!-- for PT-BR pages -->

استضافة خادم الويب هوك الخاص بك: AWS São Paulo (sa-east-1)

يعاني المستخدمون البرازيليون الذين يرسلون رسائل WhatsApp من زمن الاستجابة في نقطتين: معالجة Cloud API الخاصة بـ Meta ووقت استجابة خادم الويب هوك الخاص بك. أنت تتحكم في النقطة الثانية. استضافة معالج الويب هوك في AWS São Paulo (sa-east-1) يقلل بشكل ملحوظ من زمن الرحلة الذهاب والإياب مقارنةً بمناطق US East أو EU.

  • US East (us-east-1) → البرازيل: ~130–180 مللي ثانية إضافية للرحلة الذهاب والإياب مقابل São Paulo
  • EU West (eu-west-1) → البرازيل: ~200–250 مللي ثانية إضافية للرحلة الذهاب والإياب
  • São Paulo (sa-east-1) → البرازيل: <30 مللي ثانية للرحلة الذهاب والإياب

بالنسبة لمعالجة الويب هوك المتزامنة (حيث يجب أن يستجيب خادمك ضمن مهلة 20 ثانية من Meta)، يهم الفرق في زمن الاستجابة — خاصةً إذا كان معالجك يجري استدعاءات API للمراحل اللاحقة (CRM، وكيل الذكاء الاصطناعي، معالج الدفع). يمنحك الاستضافة في São Paulo هامشاً أكبر بكثير قبل انتهاء المهلة.

SocialHook للنشر البرازيلي: تتعامل البنية التحتية لتسليم الويب هوك في SocialHook مع مشكلة زمن الاستجابة بشكل مختلف — نتلقى الأحداث من Meta ونعيد توجيهها إلى خادمك فوراً، بغض النظر عن مكان استضافة خادمك. إذا كنت تستخدم SocialHook كطبقة الويب هوك الواردة، يمكن أن يكون خادم التطبيق الخاص بك في أي منطقة ولا يزال يتلقى الأحداث بشكل موثوق مع إعادة المحاولة التلقائية. تحصل على فائدة التسليم بزمن استجابة منخفض دون تغيير بنيتك التحتية. يُطبّق السعر الثابت البالغ $50/شهر عالمياً بما في ذلك أرقام الهواتف البرازيلية.

إعداد SocialHook للأرقام البرازيلية (PT-BR)

ربط رقم WhatsApp Business برازيلي بـ SocialHook يعمل بشكل مطابق لأي بلد آخر — لكن الحمل المعياري يتضمن رقم الهاتف البرازيلي بتنسيق E.164 مع رمز الدولة +55. مثال على حدث وارد من عميل برازيلي:

SocialHook — Brazilian WhatsApp event
{ "platform": "whatsapp", "event": "message.received", "from": "+55 11 9 1234-5678", // São Paulo mobile — +55 country code "timestamp": 1747231892, "conversation_id": "conv_br_8j3k...", "message": { "type": "audio", // voice note — common in Brazil "id": "wamid.HBgL...", "audio": { "id": "98765432109876", "mime_type": "audio/ogg; codecs=opus", "voice": true // this is a voice note — convert OGG → MP3 → Whisper } }, "signature_verified": true } // Brazilian mobile numbers: +55 + 2-digit area code + 9-digit number (with leading 9) // São Paulo area code: 11 (landline) or 11 + 9 prefix for mobile // Rio de Janeiro: 21, Belo Horizonte: 31, Brasília: 61, etc.

تفصيل خاص بالبرازيل: تستخدم أرقام الهواتف المحمولة في البرازيل تنسيقاً مكوناً من 9 أرقام (مع 9 رائدة) بينما تستخدم الخطوط الأرضية 8 أرقام. أصبح هذا عالمياً في 2016. تنسيق E.164 لهاتف محمول في São Paulo: +55 11 9 1234-5678 = +5511912345678. عند إرسال الرسائل الصادرة، احذف دائماً المسافات والشرطات وأضف +55 كبادئة. يُعيّر SocialHook الأرقام الواردة تلقائياً إلى تنسيق E.164.

FAQ

الأسئلة الشائعة

هل البرازيل أكبر سوق لـ WhatsApp في العالم؟
تمتلك البرازيل أعلى معدل انتشار لـ WhatsApp في أي دولة كبيرة على مستوى العالم — أكثر من 93٪ من مستخدمي الهواتف الذكية يستخدمون WhatsApp، حوالي 147 مليون مستخدم نشط. البرازيل أيضاً هي المكان الذي أطلقت فيه Meta خدمة WhatsApp Pay. بالنسبة لأي مطور يستهدف المستخدمين البرازيليين، WhatsApp ليس قناة اختيارية — إنها منصة التواصل وخدمة العملاء والتجارة الأساسية.
هل تنطبق LGPD على نشر واجهة برمجة تطبيقات WhatsApp في البرازيل؟
نعم — إذا كنت تعالج البيانات الشخصية للأفراد الموجودين في البرازيل، تنطبق LGPD بغض النظر عن مكان وجود شركتك أو خوادمك. المتطلبات الرئيسية لواجهة برمجة تطبيقات WhatsApp: موافقة صريحة للرسائل التسويقية، وأساس قانوني لجميع المعالجة، ودعم حق الحذف لكل رقم هاتف عميل، و DPA مع أي معالجي بيانات (مثل SocialHook)، وإخطار الاختراق إلى ANPD للحوادث الخطيرة. استشر محامياً برازيلياً متخصصاً في حماية البيانات لنشرك المحدد.
ما رمز اللغة الذي يجب أن أستخدمه لقوالب WhatsApp باللغة البرتغالية البرازيلية؟
استخدم pt_BR (بشرطة سفلية — هذا هو تنسيق Cloud API الخاص بـ Meta) لحقل language.code في القالب. هذا يختلف عن pt (البرتغالية الأوروبية) وpt_PT. ملاحظة: يستخدم hreflang pt-BR (بشرطة) — هذه معايير مختلفة. للغة البرتغالية البرازيلية اختلافات كبيرة عن البرتغالية الأوروبية — اطلب دائماً من متحدث برازيلي أصيل مراجعة القوالب قبل الإرسال.
كيف يجب أن أتعامل مع الرسائل الصوتية من مستخدمي WhatsApp البرازيليين؟
تعامل مع الرسائل الصوتية كـ نوع رسائل أساسي، وليس حالة هامشية. تمتلك البرازيل واحدة من أعلى معدلات استخدام الرسائل الصوتية للفرد في العالم — كثير من العملاء البرازيليين يفضلون الصوت لجميع التواصل التجاري. عندما يكون msg.type === 'audio' وmsg.audio.voice === true: حمّل ملف OGG/Opus، وحوّله إلى MP3 عبر ffmpeg، وفسّره بـ Whisper (language: 'pt')، واعالج النص كرسالة العميل. راجع قسم الرسائل الصوتية أعلاه للحصول على الكود الكامل.
كيف تُنسّق أرقام الهواتف البرازيلية بتنسيق E.164 لـ WhatsApp؟
أرقام الهواتف المحمولة البرازيلية: +55 (رمز الدولة) + رمز المنطقة مكوّن من رقمين + رقم مكوّن من 9 أرقام يبدأ بـ 9. مثال على هاتف محمول في São Paulo: +5511912345678. الخطوط الأرضية: +55 + رمز المنطقة + رقم مكوّن من 8 أرقام. تُسلّم WhatsApp Cloud API الأرقام البرازيلية بدون مسافات أو شرطات. يُعيّر SocialHook جميع الأرقام الواردة تلقائياً إلى E.164، بما في ذلك البادئة +55. احذف دائماً المسافات والشرطات عند إنشاء حقل to للإرسالات الصادرة.
ما أفضل منطقة استضافة لخادم ويب هوك WhatsApp يستهدف البرازيل؟
AWS São Paulo (sa-east-1) هو الخيار الأمثل — يوفر أقل زمن استجابة للمستخدمين البرازيليين والبنية التحتية الإقليمية لـ Meta. البديل: يتعامل SocialHook مع تسليم الويب هوك عالمياً، لذا إذا كنت تستخدم SocialHook كطبقة الويب هوك الواردة، يمكن أن يكون خادم تطبيقك في أي منطقة ولا يزال يتلقى الأحداث بشكل موثوق. لا تفرض LGPD إقامة البيانات في البرازيل (لمعظم القطاعات التجارية)، لكن الاستضافة في São Paulo تقلل المخاطر التنظيمية وزمن الاستجابة في آنٍ واحد.
ميزة
تكامل ويب هوك WhatsApp
أحداث PT-BR معيّرة يتم تسليمها إلى خادمك. الأرقام البرازيلية مدعومة بالكامل. $50/شهر ثابت.
برنامج تعليمي
معالجة الرسائل الصوتية في الويب هوك
نسخ OGG → MP3 → Whisper — ضروري للنشر البرازيلي حيث الصوت هو الأساسي.
التسعير
المستوى المجاني والتسعير موضّحان
1,000 محادثة خدمة مجانية/شهر، نوافذ مجانية 72 ساعة Click-to-WhatsApp — حسّن تكاليفك البرازيلية.

اربط رقمك البرازيلي.
استقبل الصوت والنص.

أضف رقم WhatsApp Business البرازيلي الخاص بك إلى SocialHook. كل رسالة عميل — نص، ورسالة صوتية، وصورة، ومستند — تصل كـ JSON نظيف PT-BR إلى ويب هوك الخاص بك. الرسائل الصوتية مُعلَّمة. معرفات الوسائط جاهزة للتنزيل. HMAC تم التحقق منه. R$0 لكل رسالة على جانب الرسائل الواردة.

Começar grátis → اقرأ التوثيق
بدون بطاقة ائتمان · $50/شهر بعد الفترة التجريبية · واردة غير محدودة