WhatsApp Business API in Brasilien — LGPD-Compliance-Checkliste, PT-BR Template-Beispiele, BRL-Preistabelle, AWS São Paulo Webhook-Hosting-Diagramm
In diesem Leitfaden: Warum Brasilien #1 ist · Brasilianische WhatsApp-Kultur (Sprachnachrichten!) · LGPD-Compliance-Anforderungen · PT-BR Template-Muster · Preise in BRL · PIX-Zahlungsintegration · hreflang für pt-BR · AWS São Paulo Hosting · Opt-in-Anforderungen · SocialHook PT-BR-Einrichtung

Warum Brasilien WhatsApps wichtigster Markt ist

147M+
Aktive WhatsApp-Nutzer in Brasilien
93%
Smartphone-Penetration mit WhatsApp-Nutzung
#1
Land, in dem Meta WhatsApp Pay eingeführt hat
79%
Brasilianer bevorzugen WhatsApp für Geschäftskontakte

Brasilien ist nicht nur ein großer WhatsApp-Markt — es ist strukturell anders als jeder andere Markt. WhatsApp in Brasilien fungiert als Standard-Kommunikationsschicht für alles: Kundenservice, Vertrieb, Bankbenachrichtigungen, Behördendienste, Bestellbestätigungen, Terminvereinbarungen und sozialer Kontakt. E-Mail in Brasilien ist für formale rechtliche Korrespondenz. SMS sind für OTPs. WhatsApp ist für alles andere.

Wenn Sie eine WhatsApp-Integration für brasilianische Nutzer entwickeln, bauen Sie keinen ergänzenden Kanal — Sie bauen den Kanal. Die API muss vom ersten Tag an korrekt sein. LGPD-Compliance kann nicht nachträglich ergänzt werden. Die Qualität der PT-BR-Templates ist wichtig, weil Nutzer jedes Wort lesen. Und Sprachnachrichten sind kein Randfall — sie sind die primäre Kommunikationsform der Brasilianer.

Brasilianische WhatsApp-Kultur: Was Entwickler verstehen müssen

Das WhatsApp-Verhalten in Brasilien unterscheidet sich von europäischen und nordamerikanischen Normen in mehreren Punkten, die sich direkt auf die Architektur Ihrer Integration auswirken:

  • WhatsApp ersetzt alle anderen Kanäle. Ein brasilianischer Kunde, der Ihr Unternehmen kontaktiert, erwartet, alles über WhatsApp zu erledigen — anfragen, kaufen, Bestellungen verfolgen, Support anfordern, eine Nota Fiscal erhalten. Wenn Ihr Bot das nicht leisten kann, wechselt er zu einem Wettbewerber, der es kann.
  • Erwartungen an die Antwortlatenz sind hoch. Brasilianische Nutzer erwarten Antworten innerhalb von Minuten, nicht Stunden. Ein KI-Agent, der Anfragen außerhalb der Geschäftszeiten sofort bearbeitet, ist kein Luxus — es ist eine grundlegende Erwartung, die der Kommunikationskultur entspricht.
  • Informelle Sprache ist Standard, auch im Geschäftsleben. Brasilianische PT-BR-Geschäftskommunikation ist erheblich informeller als europäisches Portugiesisch oder sogar Englisch. Die Verwendung von „você" statt „tu", Verkleinerungsformen und Vornamen ab der ersten Nachricht ist normal und wird erwartet.
  • Gruppenkultur in der Kommunikation. Brasilianer nutzen WhatsApp-Gruppen intensiv für Gemeinschaften, Nachbarschaften und Familie. Diesen Kontext zu verstehen hilft beim Design von Broadcast-Kampagnen — Brasilianer sind sehr sensibel dafür, ob Nachrichten wie persönliche Kommunikation oder Massen-Broadcast wirken.

Sprachnachrichten: Brasiliens erstklassiger Nachrichtentyp

Brasilien hat eine der höchsten Pro-Kopf-Nutzungsraten für Sprachnachrichten weltweit. Dies ist keine Anekdote — es ist dokumentiertes Verhalten. Viele Brasilianer empfinden Tippen als langsam oder unpersönlich und verwenden standardmäßig Sprachnachrichten für alles: von Pizzabestellungen bis zur Meldung eines Rechnungsproblems bis zur Diskussion von Vertragsbedingungen.

Für Entwickler hat dies eine direkte architektonische Konsequenz: Ihr WhatsApp-Webhook-Handler muss Sprachnachrichten als erstklassige Nachrichten behandeln, nicht als Randfälle. Wenn Ihr KI-Agent mit „desculpe, só aceito mensagens de texto" (Entschuldigung, ich akzeptiere nur Textnachrichten) auf eine Sprachnachricht antwortet, haben Sie die Mehrheit der brasilianischen Kunden, die Sprache bevorzugen, im Stich gelassen.

Die korrekte Implementierung für brasilianische Deployments:

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-Compliance für WhatsApp-API-Deployments

Brasiliens Lei Geral de Proteção de Dados (LGPD), Gesetz 13.709/2018, ist Brasiliens umfassendes Datenschutzgesetz — strukturell ähnlich der DSGVO, aber mit brasilienspezifischen Anforderungen. Es gilt für die Verarbeitung personenbezogener Daten von Personen in Brasilien, unabhängig davon, wo Ihr Unternehmen oder Ihre Server ansässig sind.

Für WhatsApp-API-Deployments schafft die LGPD spezifische Verpflichtungen in Ihrer gesamten Datenpipeline — vom Moment, in dem ein Kunde seine erste Nachricht sendet, bis zur Langzeitspeicherung von Gesprächsdaten. Das ist nicht optional. Die brasilianische Datenschutzbehörde (ANPD — Autoridade Nacional de Proteção de Dados) hat Durchsetzungsbefugnisse einschließlich Bußgelder von bis zu 2 % des Umsatzes in Brasilien, begrenzt auf R$50 Millionen pro Verstoß.

Rechtsgrundlage für die Verarbeitung (Art. 7 LGPD)
Sie müssen eine Rechtsgrundlage für die Verarbeitung von Gesprächsdaten haben. Für Marketing-Nachrichten: ausdrückliche Einwilligung. Für transaktionale Nachrichten (Bestellbestätigungen, Lieferaktualisierungen): berechtigtes Interesse oder Vertragserfüllung. Dokumentieren Sie Ihre Rechtsgrundlage pro Verarbeitungsaktivität.
Informiertes Opt-in für Marketing (Art. 8 LGPD)
Das Opt-in für Marketing-Nachrichten muss ausdrücklich, informiert und spezifisch sein. Vorausgefüllte Kontrollkästchen und gebündelte Einwilligungen sind verboten. Ihr Opt-in muss klar angeben: welche Nachrichten der Kunde erhält, wie häufig und wie er sich abmelden kann. Speichern Sie Opt-in-Zeitstempel, IP-Adressen und die Version des Einwilligungstexts.
Recht auf Löschung (Art. 18 LGPD)
Kunden können die Löschung aller personenbezogenen Daten verlangen, die Sie besitzen, einschließlich des WhatsApp-Gesprächsverlaufs. Ihr System muss die vollständige Datenlöschung pro Kundentelefonnummer unterstützen — Gesprächsprotokolle, Transkripte, Mediendateien, CRM-Datensätze. Implementieren Sie einen Löschungs-API-Endpunkt und antworten Sie innerhalb von 15 Tagen.
Datenverarbeitungsvertrag (DPA) mit Auftragsverarbeitern
Wenn Sie SocialHook oder eine andere Drittanbieter-Webhook-Plattform zur Verarbeitung von Gesprächsdaten nutzen, benötigen Sie einen unterzeichneten DPA. Als Auftragsverarbeiter, der in Ihrem Namen (als Verantwortlicher) handelt, müssen sie sich zur LGPD-konformen Datenverarbeitung verpflichten. SocialHooks DPA ist unter /en/legal/dpa verfügbar.
Meldepflicht bei Datenpannen (Art. 48 LGPD)
Sicherheitsvorfälle mit personenbezogenen Daten brasilianischer Nutzer müssen der ANPD in einem angemessenen Zeitrahmen gemeldet werden (ANPD-Empfehlung: so schnell wie möglich, idealerweise innerhalb von 72 Stunden bei schwerwiegenden Vorfällen). Implementieren Sie Überwachung für unbefugten Zugriff auf Gesprächsdaten und verfügen Sie über einen Notfallreaktionsplan.
Datenhaltung in Brasilien (empfohlen)
Die LGPD schreibt keine Datenhaltung innerhalb Brasiliens vor (im Gegensatz zu einigen Sektoren unter BACEN-Vorschriften), aber die Hosting-Gesprächsdaten auf AWS São Paulo (sa-east-1) reduziert das regulatorische Risiko und verbessert die Webhook-Latenz für brasilianische Nutzer erheblich. Siehe den Hosting-Abschnitt unten.

Brasilianische Opt-in-Anforderungen: Was anders ist

Sowohl Metas WhatsApp-Richtlinien als auch die LGPD erfordern ein ausdrückliches Opt-in für unternehmensinitierte Nachrichten. In Brasilien machen der kulturelle und rechtliche Kontext die Implementierungsdetails wichtig:

  • Opt-in-Texte müssen auf PT-BR sein. Ein englischsprachiges Opt-in-Formular für einen brasilianischen Kunden ist unter der LGPD rechtlich fragwürdig — Kunden müssen verstehen, womit sie einverstanden sind. Verwenden Sie klares, einfaches PT-BR.
  • CPF-Feld als Identitätsverknüpfung. Brasilianische Kunden erwarten oft, ihre CPF (Cadastro de Pessoas Físicas — Steuer-ID) für einen personalisierten Service anzugeben. Wenn Sie die CPF erfassen, handelt es sich um personenbezogene Daten, die eine eigene Rechtsgrundlage und Schutz gemäß LGPD erfordern.
  • WhatsApp-Link-Opt-in. Ein gängiges brasilianisches Opt-in-Muster: ein WhatsApp-Link (wa.me/{number}?text=Quero+receber+ofertas), über den der Kunde Kontakt aufnimmt. Dies ist ein starkes Opt-in-Signal — der Kunde hat Sie aktiv angeschrieben. Erfassen Sie es mit einem Zeitstempel.
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

Brasilianisch-portugiesische Template-Muster

Template-Nachrichten an brasilianische Nutzer müssen pt_BR als Sprachcode verwenden — nicht pt (europäisches Portugiesisch). Brasilianer erkennen sofort europäisch-portugiesische Konstruktionen, die das Vertrauen und die Markenwahrnehmung untergraben. Hier sind produktionsreife PT-BR-Templates für häufige Anwendungsfälle:

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-Schreibtipps, die wichtig sind: Verwenden Sie você (nicht tu). Verwenden Sie Vornamen ab der ersten Nachricht. Fügen Sie Emojis hinzu — Brasilianer verwenden sie freizügig in der Geschäftskommunikation. Verwenden Sie Oi oder Olá (nicht Caro). Verwenden Sie informelle Verbformen. Fügen Sie 😊 oder 🙏 ein — sie wirken warm, nicht unprofessionell. Lassen Sie jedes Template vor der Einreichung von einem brasilianischen Muttersprachler prüfen — regionale Ausdrücke variieren und maschinelle Übersetzungen produzieren oft europäisch-portugiesische Konstruktionen, die brasilianische Nutzer sofort erkennen.

Gesprächspreise im BRL-Kontext

Meta berechnet WhatsApp-Gesprächsgebühren weltweit in USD — es gibt keine BRL-Abrechnungsoption. Brasilianische Unternehmen zahlen in USD, was bedeutet, dass Wechselkursschwankungen eine reale betriebliche Sorge bei der Kostenplanung sind. Hier sind die Gesprächsraten für Brasilien ab 2026, mit ungefähren BRL-Äquivalenten bei R$5,00/USD (aktuelle Kurse prüfen):

Kategorie USD / Gespräch ~BRL / Gespräch Kostenloses Kontingent
Service (eingehend) $0,0075 ~R$ 0,04 Erste 1.000/Monat kostenlos
Utility (Bestellbestätigungen, Alerts) $0,0158 ~R$ 0,08 —
Authentifizierung (OTPs) $0,0315 ~R$ 0,16 —
Marketing (Aktionen, Kampagnen) $0,0625 ~R$ 0,31 —
Click-to-WhatsApp (72h kostenloses Fenster) $0,00 R$ 0,00 Kostenlos für 72h nach Anzeigenklick
Kostenoptimierung für brasilianische Deployments: Nutzen Sie Click-to-WhatsApp-Anzeigen auf Facebook und Instagram, um eingehende Gespräche zu generieren — diese öffnen ein kostenloses 72-Stunden-Marketing-Fenster. Die Kosten für Social-Media-Anzeigen in Brasilien sind generell niedriger als in den USA/EU, und die 93%-WhatsApp-Durchdringung bedeutet, dass der Konversionspfad vom Anzeigenklick zum WhatsApp-Gespräch bis zum Kauf extrem kurz ist. Die Anzeigenkosten amortisieren sich über ein kostenloses 72-Stunden-Fenster. Außerdem: Klassifizieren Sie Nachrichten als Utility statt Marketing, wo es legitim anwendbar ist — das reduziert die Kosten um 60 % pro Gespräch.

PIX-Integration: WhatsApp Commerce in Brasilien

PIX ist Brasiliens Sofortzahlungssystem, das vom Banco Central do Brasil betrieben wird. Es verarbeitete 2025 über 40 Milliarden Transaktionen und ist die dominierende Zahlungsmethode für den gesamten brasilianischen digitalen Handel. Brasilianische Kunden erwarten, innerhalb eines WhatsApp-Gesprächs per PIX bezahlen zu können — einen PIX-Schlüssel oder QR-Code im Chat zu generieren ist eine konversionskritische Funktion für E-Commerce-Deployments.

Während WhatsApp Pay (Metas natives Zahlungsprodukt) in Brasilien operiert, verwenden die meisten technischen Implementierungen PIX direkt über Ihren Zahlungsanbieter. So senden Sie einen PIX-Zahlungslink innerhalb einer WhatsApp-Sitzung:

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! 🙏` ); } });

Korrekte hreflang-Einrichtung für PT-BR

Wenn Ihr Produkt sowohl brasilianisch- als auch europäisch-portugiesischsprachige Nutzer bedient, ist die hreflang-Implementierung entscheidend. Der Sprachcode pt-BR (mit Bindestrich, nicht Unterstrich — hreflang verwendet Bindestriche) teilt Google mit, welche Version brasilianischen Nutzern angezeigt werden soll. Eine falsche hreflang-Implementierung bedeutet, dass brasilianische Nutzer möglicherweise europäisch-portugiesische Inhalte sehen und umgekehrt.

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 -->

Hosting Ihres Webhook-Servers: AWS São Paulo (sa-east-1)

Brasilianische Nutzer, die WhatsApp-Nachrichten senden, erleben Latenz an zwei Punkten: der Verarbeitung durch Metas Cloud API und der Antwortzeit Ihres Webhook-Servers. Sie kontrollieren den zweiten. Das Hosting Ihres Webhook-Handlers in AWS São Paulo (sa-east-1) reduziert die Round-Trip-Latenz im Vergleich zu US East oder EU-Regionen erheblich.

  • US East (us-east-1) → Brasilien: ~130–180ms zusätzliche Round-Trip vs São Paulo
  • EU West (eu-west-1) → Brasilien: ~200–250ms zusätzliche Round-Trip
  • São Paulo (sa-east-1) → Brasilien: <30ms Round-Trip

Bei synchroner Webhook-Verarbeitung (wo Ihr Server innerhalb von Metas 20-Sekunden-Timeout antworten muss) spielt der Latenzunterschied eine Rolle — besonders wenn Ihr Handler nachgelagerte API-Aufrufe macht (CRM, KI-Agent, Zahlungsanbieter). Hosting in São Paulo gibt Ihnen deutlich mehr Spielraum vor dem Timeout.

SocialHook für brasilianische Deployments: SocialHooks Webhook-Bereitstellungsinfrastruktur löst das Latenzproblem anders — wir empfangen Events von Meta und leiten sie sofort an Ihren Server weiter, unabhängig davon, wo Ihr Server gehostet wird. Wenn Sie SocialHook als eingehende Webhook-Schicht verwenden, kann Ihr Anwendungsserver in jeder Region sein und dennoch zuverlässig Events mit automatischen Wiederholungsversuchen erhalten. Sie erhalten den Vorteil der Low-Latency-Bereitstellung ohne Änderung Ihrer Infrastruktur. Der Pauschaltarif von $50/Monat gilt weltweit einschließlich brasilianischer Telefonnummern.

SocialHook-Einrichtung für brasilianische Nummern (PT-BR)

Die Verbindung einer brasilianischen WhatsApp-Business-Nummer mit SocialHook funktioniert identisch wie bei jedem anderen Land — aber das normalisierte Payload enthält die brasilianische Telefonnummer im E.164-Format mit dem Ländervorwahl-Präfix +55. Ein Beispiel-Eingehend-Event von einem brasilianischen Kunden:

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.

Ein brasilienspezifisches Detail: Mobiltelefonnummern in Brasilien verwenden ein 9-stelliges Format (mit einer führenden 9), während Festnetzanschlüsse 8 Ziffern verwenden. Dies wurde 2016 universell. E.164-Format für ein São Paulo-Mobiltelefon: +55 11 9 1234-5678 = +5511912345678. Beim Senden ausgehender Nachrichten immer Leerzeichen und Bindestriche entfernen und +55 voranstellen. SocialHook normalisiert eingehende Nummern automatisch auf E.164.

FAQ

Häufige Fragen

Ist Brasilien der größte WhatsApp-Markt der Welt?
Brasilien hat die höchste WhatsApp-Penetrationsrate aller großen Länder weltweit — über 93 % der Smartphone-Nutzer verwenden WhatsApp, das sind ungefähr 147 Millionen aktive Nutzer. Brasilien ist auch der Ort, wo Meta WhatsApp Pay eingeführt hat. Für jeden Entwickler, der brasilianische Nutzer anspricht, ist WhatsApp kein optionaler Kanal — es ist die primäre Kommunikations-, Kundenservice- und Commerce-Plattform.
Gilt die LGPD für mein WhatsApp-API-Deployment in Brasilien?
Ja — wenn Sie personenbezogene Daten von Personen in Brasilien verarbeiten, gilt die LGPD unabhängig davon, wo Ihr Unternehmen oder Ihre Server ansässig sind. Wichtige Anforderungen für die WhatsApp-API: ausdrückliche Einwilligung für Marketing-Nachrichten, eine Rechtsgrundlage für alle Verarbeitungen, Unterstützung des Löschungsrechts pro Kundentelefonnummer, DPA mit allen Datenverarbeitern (wie SocialHook) und Meldung von Datenpannen an die ANPD bei schwerwiegenden Vorfällen. Konsultieren Sie einen brasilianischen Datenschutzanwalt für Ihr spezifisches Deployment.
Welchen Sprachcode soll ich für WhatsApp-Templates in brasilianischem Portugiesisch verwenden?
Verwenden Sie pt_BR (mit Unterstrich — das ist das Format der Meta Cloud API) für das Feld language.code des Templates. Dies unterscheidet sich von pt (europäisches Portugiesisch) und pt_PT. Hinweis: hreflang verwendet pt-BR (mit Bindestrich) — das sind unterschiedliche Standards. Brasilianisches Portugiesisch hat erhebliche Unterschiede zum europäischen Portugiesisch — lassen Sie Templates immer von einem brasilianischen Muttersprachler vor der Einreichung prüfen.
Wie soll ich Sprachnachrichten von brasilianischen WhatsApp-Nutzern verarbeiten?
Behandeln Sie Sprachnachrichten als primären Nachrichtentyp, nicht als Randfall. Brasilien hat eine der weltweit höchsten Pro-Kopf-Nutzungsraten für Sprachnachrichten — viele brasilianische Kunden bevorzugen Sprache für die gesamte Geschäftskommunikation. Wenn msg.type === 'audio' und msg.audio.voice === true: Laden Sie die OGG/Opus-Datei herunter, konvertieren Sie sie über ffmpeg in MP3, transkribieren Sie mit Whisper (language: 'pt') und verarbeiten Sie das Transkript als Kundennachricht. Den vollständigen Code finden Sie im Abschnitt über Sprachnachrichten oben.
Wie werden brasilianische Telefonnummern in E.164 für WhatsApp formatiert?
Brasilianische Mobilnummern: +55 (Ländervorwahl) + 2-stellige Ortsvorwahl + 9-stellige Nummer beginnend mit 9. Beispiel São Paulo Mobiltelefon: +5511912345678. Festnetz: +55 + Ortsvorwahl + 8-stellige Nummer. Die WhatsApp Cloud API liefert brasilianische Nummern ohne Leerzeichen oder Bindestriche. SocialHook normalisiert alle eingehenden Nummern automatisch auf E.164, einschließlich des Präfixes +55. Entfernen Sie beim Aufbau des Felds to für ausgehende Sendungen immer Leerzeichen und Bindestriche.
Was ist die beste Hosting-Region für einen WhatsApp-Webhook-Server für Brasilien?
AWS São Paulo (sa-east-1) ist die optimale Wahl — es bietet die niedrigste Latenz für brasilianische Nutzer und Metas regionale Infrastruktur. Alternative: SocialHook übernimmt die Webhook-Bereitstellung weltweit, sodass Ihr Anwendungsserver bei Verwendung von SocialHook als eingehende Webhook-Schicht in jeder Region sein kann und dennoch zuverlässig Events erhält. Die LGPD schreibt keine Datenhaltung in Brasilien vor (für die meisten Geschäftssektoren), aber São Paulo Hosting reduziert gleichzeitig das regulatorische Risiko und die Latenz.
Feature
WhatsApp-Webhook-Integration
Normalisierte PT-BR Events werden an Ihren Server geliefert. Brasilianische Nummern vollständig unterstützt. $50/Monat pauschal.
Tutorial
Sprachnachrichten in Webhooks verarbeiten
OGG → MP3 → Whisper Transkription — unverzichtbar für brasilianische Deployments, wo Sprache primär ist.
Preise
Kostenloses Kontingent & Preise erklärt
1.000 kostenlose Service-Gespräche/Monat, 72h-Click-to-WhatsApp-Fenster — optimieren Sie Ihre brasilianischen Kosten.

Verbinden Sie Ihre brasilianische Nummer.
Empfangen Sie Sprache und Text.

Fügen Sie Ihre brasilianische WhatsApp-Business-Nummer zu SocialHook hinzu. Jede Kundennachricht — Text, Sprachnachricht, Bild, Dokument — kommt als sauberes PT-BR JSON an Ihrem Webhook an. Sprachnachrichten markiert. Medien-IDs zum Herunterladen bereit. HMAC verifiziert. R$0 pro Nachricht auf der eingehenden Seite.

Começar grátis → Dokumentation lesen
Ohne Kreditkarte · $50/Monat nach der Testphase · Unbegrenzt eingehend