---
title: "Chatbot de WhatsApp em árabe: arquitetura com áudio e LLM"
description: "Uma arquitetura que funciona para um assistente de WhatsApp em árabe: webhook, fila, transcrição de áudios, resposta do LLM, regras de política e custos, com Python."
url: https://broadrouter.com/pt/blog/arabic-whatsapp-chatbot-architecture/
lang: pt-BR
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Traduzido do inglês com ajuda de IA. [Leia o original em inglês](https://broadrouter.com/blog/arabic-whatsapp-chatbot-architecture/) (atualizado em 2026-11-16).

# Arquitetura de chatbot de WhatsApp em árabe: de áudios a respostas

Pela equipe da BroadNet Inference · 5 min de leitura · Publicado em 2026-11-14 · Atualizado em 2026-11-16

Um assistente de WhatsApp em árabe tem cinco partes: um webhook que recebe as mensagens da WhatsApp Business Platform, uma fila, fala para texto para os áudios, um LLM que redige a resposta e um remetente que responde pela API. Converter um áudio e transcrevê-lo com o BroadNet Transcribe Arabic custa $0.0042 por minuto de áudio.

## Pontos principais

-   Confirme o webhook na hora e faça o trabalho lento (download, transcrição, LLM) a partir de uma fila.
-   Os áudios do WhatsApp chegam como Ogg/Opus. Converta para WAV mono de 16 kHz com ffmpeg e depois transcreva com language=ar.
-   Só envie mensagens para quem deu opt-in e responda dentro da janela de atendimento ao cliente. Nunca envie mensagens não solicitadas.
-   Mantenha as primeiras respostas a contatos novos curtas, em texto simples e sem links.
-   Transcrever 10.000 áudios de 30 segundos com o BroadNet Transcribe Arabic custa $21.00.

**Nesta página**

1.  Quais são as partes de um chatbot de WhatsApp em árabe?
2.  Quais regras de política do WhatsApp valem para um chatbot?
3.  Quanto custa manter um bot de WhatsApp em árabe?
4.  Como manter os áudios privados?
5.  Checklist de lançamento

Um chatbot de WhatsApp em árabe precisa de cinco partes: um webhook que recebe as mensagens da WhatsApp Business Platform oficial, uma fila, fala para texto para os áudios, um LLM que redige as respostas em árabe e um remetente que responde dentro da janela de 24 horas do WhatsApp. Os áudios importam porque muitos clientes que falam árabe falam em dialeto em vez de digitar.

O BroadRouter é mantido pela BroadNet, então os exemplos usam a BroadNet Inference. Qualquer provedor de fala para texto e de chat compatível com a OpenAI se encaixa nos mesmos lugares.

## Quais são as partes de um chatbot de WhatsApp em árabe?

```
WhatsApp user
   │  text or voice note
   ▼
WhatsApp Business Platform (Cloud API)
   │  webhook POST
   ▼
1. Webhook receiver ── verify signature, store event, return 200
   │
   ▼
2. Queue (Redis, SQS, a database table)
   │
   ▼
3. Worker
   ├─ voice note? download media → ffmpeg → speech to text
   ├─ build prompt: system rules + recent history + new message
   └─ LLM drafts reply (or hands over to a human)
   │
   ▼
4. Sender ── POST /messages on the Cloud API
   │
   ▼
5. Store ── conversation state, opt-in status, audit log
```

### 1\. Receptor do webhook

A WhatsApp Cloud API entrega as mensagens recebidas como requisições HTTPS POST para um webhook que você registra. Duas regras mantêm essa parte saudável:

-   **Verifique toda requisição.** A documentação da Meta manda calcular um HMAC-SHA256 do payload JSON com o app secret e comparar com o header `X-Hub-Signature-256`. Rejeite tudo o que não bater.
-   **Retorne 200 rápido.** Guarde o evento e confirme o recebimento. Não baixe áudio nem chame um LLM dentro do handler do webhook. Se a entrega falhar, a Meta tenta de novo “immediately, then a few more times with decreasing frequency over the next 7 days” (tradução: imediatamente, depois mais algumas vezes com frequência decrescente ao longo dos 7 dias seguintes) e pede que você trate a deduplicação.

Use o id da mensagem do WhatsApp como [chave de idempotência](https://broadrouter.com/pt/glossary/idempotency-key/), para que um webhook reentregue nunca gere duas respostas.

### 2\. Fila

Uma fila separa o tempo de entrega do WhatsApp do seu tempo de processamento. Ela também permite limitar a concorrência de acordo com seus limites de inferência. Uma chave da BroadNet no pagamento por uso permite 30 requisições por minuto e 4 ao mesmo tempo, então o formato certo é um pequeno pool de workers com novas tentativas em 429. Veja [erros e novas tentativas](https://broadrouter.com/pt/guides/errors-and-retries/) e [como lidar com rate limits 429](https://broadrouter.com/pt/blog/handle-llm-api-429-rate-limits/).

### 3\. Worker: de áudios a texto

Para um áudio, o webhook entrega um objeto `audio` com um `id` de mídia, um `mime_type` como `audio/ogg; codecs=opus` e `voice: true` para gravações feitas no WhatsApp. O worker faz um GET no id da mídia para obter a URL de download, baixa o arquivo com seu access token e então converte e transcreve. O endpoint da BroadNet aceita WAV ou MP3, então converta antes:

```python
import os, subprocess, tempfile
from openai import OpenAI

client = OpenAI(base_url="https://inference.broadnet.ai/v1", api_key=os.environ["BROADNET_API_KEY"])

def transcribe_voice_note(ogg_bytes: bytes) -> str:
    with tempfile.TemporaryDirectory() as d:
        src, wav = os.path.join(d, "in.ogg"), os.path.join(d, "in.wav")
        open(src, "wb").write(ogg_bytes)
        subprocess.run(["ffmpeg", "-y", "-loglevel", "error", "-i", src,
                        "-ar", "16000", "-ac", "1", wav], check=True)
        with open(wav, "rb") as audio:
            return client.audio.transcriptions.create(
                model="broadnet/cohere-transcribe-arabic",
                file=audio,
                language="ar",   # without it, Arabic can come back in Latin letters
            ).text
```

O diretório temporário some depois da chamada, o que mantém o áudio fora dos seus discos. O [guia de áudios do WhatsApp](https://broadrouter.com/pt/guides/transcribe-whatsapp-voice-notes/) tem uma versão em lote para conversas exportadas, e o [guia de fala para texto em árabe](https://broadrouter.com/pt/guides/arabic-speech-to-text-api/) trata de formatos e limites. Os arquivos precisam ficar abaixo de 26.214.400 bytes (25 MiB); áudios comuns ficam muito abaixo disso.

### 3b. Worker: redigindo a resposta

Trate uma transcrição exatamente como uma mensagem digitada, mas avise o modelo de que ela veio da fala, já que transcrições não têm pontuação e podem conter erros de reconhecimento:

```python
SYSTEM = """You are the WhatsApp assistant of a clinic in Dubai.
Customers write or speak in Gulf Arabic, other dialects, MSA, English or Arabizi.
Reply in simple Modern Standard Arabic unless the customer used English.
Keep replies under 60 words. Plain text only: no links, no markdown.
You can: answer opening hours, explain how to book, collect name and preferred time.
If the message is a complaint, medical question or you are unsure, reply that a
staff member will follow up, and set handover=true."""

def draft_reply(history: list[dict], text: str, from_voice: bool) -> str:
    note = "(transcribed voice note, may contain errors) " if from_voice else ""
    r = client.chat.completions.create(
        model="broadnet/qwen3.8-27b",
        max_tokens=1500,
        messages=[{"role": "system", "content": SYSTEM}, *history[-10:],
                  {"role": "user", "content": note + text}],
    )
    return r.choices[0].message.content
```

Para o roteamento, peça ao modelo [saída estruturada](https://broadrouter.com/pt/glossary/structured-output/) (`intent`, `handover`, `reply`) em vez de texto livre e aja com base nos campos; o [gerador gratuito de JSON schema](https://broadrouter.com/tools/json-schema-generator/) escreve o schema a partir de uma resposta de exemplo. Nos testes da BroadNet, o [Qwen3.8 27B](https://broadrouter.com/pt/models/qwen3.8-27b/) entendeu os dialetos do Golfo e egípcio e escreveu árabe fluente; o [DeepSeek V4.1 Flash](https://broadrouter.com/pt/models/deepseek-v4.1-flash/) é mais barato por token e é o modelo dos planos ilimitados da BroadNet. Os dois raciocinam antes de responder, então deixe folga em `max_tokens`. O tratamento de dialetos é aprofundado em [árabe do Golfo, egípcio e levantino com LLMs](https://broadrouter.com/pt/blog/arabic-llm-gulf-egyptian-dialects/).

### 4\. Remetente

As respostas saem pelo endpoint de mensagens da Cloud API para o seu phone number id. Envie texto simples nas respostas de conversa. A formatação do WhatsApp (negrito, listas) aparece, mas tabelas e títulos em Markdown não, então diga ao modelo para não gerá-los.

### 5\. Armazenamento

Guarde o estado da conversa (os últimos dez turnos bastam para a maioria dos bots de suporte), o status de opt-in do cliente e um log de auditoria do que o bot enviou e por quê. Não guarde mais do que precisa: transcrições de áudios muitas vezes contêm nomes, endereços e dados de saúde.

## Quais regras de política do WhatsApp valem para um chatbot?

O WhatsApp é rígido com o uso que as empresas fazem dele, e as regras protegem seu número tanto quanto seus clientes. Leia a [WhatsApp Business Messaging Policy](https://whatsappbusiness.com/policy/) antes do lançamento. Na prática:

1.  **Opt-in primeiro.** A política só permite contatar pessoas que deram o número a você e aceitaram receber suas mensagens no WhatsApp. Um cliente que escreve para você não está consentindo com marketing.
2.  **Nada de mensagens não solicitadas.** A política diz: “Do not confuse, deceive, defraud, mislead, spam, or surprise people with your communications.” (tradução: não confunda, engane, fraude, induza ao erro, faça spam nem surpreenda as pessoas com suas comunicações). Nunca envie primeiras mensagens a quem não entrou em contato com você nem deu opt-in.
3.  **Respeite a janela de atendimento ao cliente de 24 horas.** Respostas livres são permitidas até 24 horas depois da última mensagem do cliente. Fora dela, só é possível enviar templates de mensagem aprovados.
4.  **Ofereça um humano.** Respostas automáticas são permitidas dentro da janela de 24 horas, mas a política exige “prompt, clear, and direct escalation paths” (tradução: caminhos de escalonamento rápidos, claros e diretos) até uma pessoa.
5.  **Respeite os opt-outs.** A política diz que você deve atender a todo pedido de bloqueio, interrupção ou opt-out. Trate “stop” ou “توقف” como um deles.

Mais uma regra é nossa, não da Meta: **mantenha simples as primeiras respostas a contatos novos.** Uma resposta curta, em texto simples e sem URLs, é o mais seguro. Mensagens cheias de links vindas de uma empresa desconhecida parecem spam para o usuário, que pode bloquear e denunciar você. Mande links depois, quando o cliente pedir.

## Quanto custa manter um bot de WhatsApp em árabe?

Fala para texto é cobrada por minuto de áudio. Com o BroadNet Transcribe Arabic:

| Volume | Custo |
| --- | --- |
| Um minuto de áudios | $0.0042 |
| Uma hora de áudios | $0.25 |
| 10.000 áudios de 30 segundos | $21.00 |

As respostas do LLM são cobradas por token no pagamento por uso: por 1M de tokens, o Qwen3.8 27B custa $0.175 de input e $2.17 de output, e o DeepSeek V4.1 Flash $0.175 de input e $0.52 de output. Uma resposta de suporte com dez turnos de histórico tem alguns milhares de tokens, com o raciocínio incluído, então uma única resposta custa alguns milésimos dos preços por 1M acima. Coloque seu volume de mensagens na [calculadora gratuita de custo de API de LLM](https://broadrouter.com/tools/llm-api-cost-calculator/) para ter um valor mensal. Se o bot roda no DeepSeek V4.1 Flash o dia inteiro, compare com o plano Full Moon de $60 na [página de preços](https://broadrouter.com/pt/pricing/).

## Como manter os áudios privados?

Áudios estão entre os dados mais pessoais que uma empresa trata. A BroadNet Inference não retém áudio, prompts nem transcrições após a requisição (veja [retenção zero de dados](https://broadrouter.com/pt/privacy/)), mas isso só cobre a etapa de inferência. Decida por quanto tempo sua fila, seus logs e seu banco de dados guardam as transcrições, e apague os arquivos de mídia depois do processamento.

## Checklist de lançamento

-   Assinatura do webhook verificada, 200 retornado antes do processamento.
-   Idempotência pelo id da mensagem do WhatsApp.
-   Áudios convertidos para WAV e transcritos com `language=ar`.
-   Pool de workers dimensionado para seus rate limits, com backoff em 429.
-   O system prompt define dialeto, registro, tamanho e “sem links”.
-   Caminho de transferência para um humano, testado.
-   Opt-in registrado; nenhum envio não solicitado; só templates fora da janela de 24 horas.
-   Transcrições apagadas em uma rotina programada.

Se você só precisa transformar áudios em tickets, e não de um bot que responde, [áudios para texto nas empresas](https://broadrouter.com/pt/blog/voice-notes-to-text-for-business/) cobre esse pipeline mais simples.

Ferramentas gratuitas sobre o tema (em inglês)

-   [Arabic token counter](https://broadrouter.com/tools/arabic-token-counter/) Arabic vs English token counts per tokenizer: the "Arabic tax" in tokens and money.
-   [Arabic text normalizer](https://broadrouter.com/tools/arabic-text-normalizer/) Tashkeel, tatweel, alef, ya, ta marbuta, digits and invisible characters, with a matching Python function.
-   [Speech-to-text cost calculator](https://broadrouter.com/tools/speech-to-text-cost-calculator/) Hours, calls or voice notes to a monthly transcription bill, against your current provider.

[Ferramentas gratuitas (em inglês)](https://broadrouter.com/tools/)

## Termos neste artigo

[Token](https://broadrouter.com/pt/glossary/token/)

Um token é a unidade de texto que um modelo de linguagem lê e escreve: uma palavra, parte de uma palavra, um sinal de pontuação ou uma sequência de bytes gerada pelo tokenizador do modelo. As APIs de LLM contam, limitam e normalmente cobram o uso em tokens.

[Fala para texto (speech-to-text)](https://broadrouter.com/pt/glossary/speech-to-text/)

Fala para texto, ou reconhecimento automático de fala (ASR), é a tecnologia que converte áudio falado em texto. Uma API de fala para texto recebe um arquivo ou stream de áudio e retorna uma transcrição, normalmente cobrada por minuto de áudio. A precisão é medida pela taxa de erro de palavras e varia com sotaque, dialeto e qualidade da gravação.

[Rate limit (limite de taxa)](https://broadrouter.com/pt/glossary/rate-limit/)

Um rate limit é um teto que uma API impõe a quanto um cliente pode usá-la em um intervalo de tempo, como requisições por minuto ou tokens por minuto. As requisições acima do limite são recusadas, normalmente com HTTP 429 Too Many Requests, até que o uso volte a ficar abaixo dele.

[Pagamento por uso (pay-as-you-go)](https://broadrouter.com/pt/glossary/pay-as-you-go/)

Pagamento por uso é um modelo de preço em que você paga só pelo que usa, medido por unidade, como tokens, requisições ou minutos de áudio, sem assinatura nem compromisso mínimo. A maioria das APIs de LLM cobra assim, a partir de um saldo pré-pago ou de uma fatura periódica.

[Concorrência (concurrency)](https://broadrouter.com/pt/glossary/concurrency/)

Concorrência é o número de requisições que um cliente tem em andamento ao mesmo tempo. APIs de LLM muitas vezes a limitam por chave ou por plano, separadamente das requisições por minuto, porque cada requisição aberta ocupa capacidade de GPU até a resposta terminar.

[Tool calling (chamada de ferramentas)](https://broadrouter.com/pt/glossary/tool-calling/)

Tool calling, também chamado de function calling ou chamada de ferramentas, é um recurso de APIs de LLM em que o modelo devolve um pedido estruturado para executar uma função definida pelo desenvolvedor, com argumentos JSON. A aplicação executa a função e devolve o resultado; o modelo nunca executa código sozinho.

[WAV (arquivo de áudio WAV)](https://broadrouter.com/pt/glossary/wav/)

WAV (Waveform Audio File Format, ou WAVE) é um contêiner de áudio baseado no formato RIFF da Microsoft e da IBM. Ele costuma guardar amostras PCM lineares sem compressão, então o tamanho é previsível: taxa de amostragem vezes bytes por amostra vezes canais, por segundo.

[Árabe dialetal (dialectal Arabic)](https://broadrouter.com/pt/glossary/dialectal-arabic/)

Árabe dialetal é o árabe falado no dia a dia de uma região ou cidade, como o árabe egípcio, do Golfo, levantino ou magrebino. Os dialetos diferem do árabe padrão moderno em sons, palavras e gramática, não têm ortografia padrão e são cada vez mais escritos na internet, o que os torna mais difíceis para modelos de linguagem.

## Perguntas frequentes

### Posso mandar mensagem para clientes que nunca me escreveram?

Só se eles deram opt-in para receber mensagens da sua empresa, e só com templates de mensagem aprovados. Mensagens não solicitadas violam as políticas do WhatsApp e podem fazer seu número ser restringido.

### Por que converter os áudios antes de transcrever?

Os áudios do WhatsApp são arquivos Ogg/Opus, e o endpoint de transcrição da BroadNet aceita WAV ou MP3. Um único comando ffmpeg converte para WAV mono de 16 kHz.

### Qual LLM deve redigir as respostas?

Teste com suas próprias mensagens. A BroadNet informa que, nos testes dela, o Qwen3.8 27B entendeu os dialetos do Golfo e egípcio e escreveu árabe fluente; o DeepSeek V4.1 Flash é mais barato por token e está disponível em planos de preço fixo.

### Por quanto tempo um bot de WhatsApp pode responder sem template?

Dentro da janela de atendimento ao cliente de 24 horas que segue a última mensagem do cliente, você pode enviar respostas livres. Fora dela, a WhatsApp Business Messaging Policy permite apenas templates de mensagem aprovados.

### Chatbots de WhatsApp precisam de transferência para um humano?

Sim. A política permite automação, mas exige caminhos de escalonamento rápidos, claros e diretos, como transferência para um atendente humano no chat, um telefone, um e-mail ou um formulário de suporte.

### A BroadNet guarda os áudios?

Não. A BroadNet Inference processa áudio e transcrições para a requisição e não os retém. Seus próprios servidores e o WhatsApp ainda guardam cópias, então planeje a retenção lá também.

## Continue lendo

-   [Classificação de texto em árabe com LLM: sentimento, intenção, triagem](https://broadrouter.com/pt/blog/arabic-text-classification-llm/)
-   [Transcrever áudios para empresas: do WhatsApp e Telegram a tickets](https://broadrouter.com/pt/blog/voice-notes-to-text-for-business/)
-   [Árabe do Golfo, egípcio e levantino: como os LLMs lidam com dialetos](https://broadrouter.com/pt/blog/arabic-llm-gulf-egyptian-dialects/)
-   [Engenharia de prompt em árabe: registro, RTL, números e texto misto](https://broadrouter.com/pt/blog/arabic-prompt-engineering/)
-   [Arabizi e LLMs: como lidar com o franco-árabe e números como 3 e 7](https://broadrouter.com/pt/blog/arabizi-llm-handling/)
-   [Erro 429 em API de LLM: backoff, jitter e limitadores](https://broadrouter.com/pt/blog/handle-llm-api-429-rate-limits/)
-   [Diacríticos no árabe com um LLM: prompt, checagens e DER](https://broadrouter.com/pt/blog/arabic-diacritization-llm/)
-   [Correção gramatical e ortográfica do árabe com um LLM: passo a passo](https://broadrouter.com/pt/blog/arabic-grammar-spelling-correction-llm/)
-   [Guia: Transcrever áudios do WhatsApp para texto com uma API](https://broadrouter.com/pt/guides/transcribe-whatsapp-voice-notes/)
-   [Guia: API de transcrição de áudio em árabe, passo a passo](https://broadrouter.com/pt/guides/arabic-speech-to-text-api/)
-   [Guia: Códigos de erro da BroadNet Inference e quando tentar de novo](https://broadrouter.com/pt/guides/errors-and-retries/)

Teste com a sua carga de trabalho real. Contas novas começam com US$ 5 de crédito para Gemma e transcrição. DeepSeek, GLM e Qwen3.8 exigem uma recarga.

[Começar](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-blog-arabic-whatsapp-chatbot-architecture&utm_content=page-cta) ·

**Fontes**

-   [Meta, WhatsApp Cloud API: criar um endpoint de webhook (X-Hub-Signature-256, novas tentativas por 7 dias; consultado em 2026-11-14)](https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/create-webhook-endpoint)
-   [Meta, referência de webhooks da WhatsApp Cloud API: mensagens de áudio (consultado em 2026-11-14)](https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/messages/audio)
-   [WhatsApp Business Messaging Policy (consultado em 2026-11-14)](https://whatsappbusiness.com/policy/)
-   [Referência da API da BroadNet Inference, transcrição e conversão com ffmpeg (consultado em 2026-11-14) (em inglês)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-blog-arabic-whatsapp-chatbot-architecture&utm_content=sources)
-   [Preços da BroadNet Inference em formato legível por máquina, pricing.json (consultado em 2026-11-14) (em inglês)](https://inference.broadnet.ai/pricing.json?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-blog-arabic-whatsapp-chatbot-architecture&utm_content=sources)
