> ## Documentation Index
> Fetch the complete documentation index at: https://developers.namuai-lab.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Transcrire une note vocale WhatsApp

> D’une note vocale sur votre téléphone à du texte sur votre écran, sans rien convertir.

6 min

Transcrire une note vocale WhatsApp

**Ce que vous allez construire :** une commande qui transcrit chaque note vocale d’un dossier et écrit le texte à côté de chacune.

**Ce qu’il vous faut :** `curl`, ou Python avec la [bibliothèque Python](https://developers.namuai-lab.com/fr/sdks/python.md) (`pip install namu-ai`), et la variable `NAMU_API_KEY` définie.

**1. Copier la note vocale sur votre ordinateur**

Dans WhatsApp, appuyez longuement sur la note vocale → **Partager** (Android) ou **Transférer → Partager** (iPhone) → envoyez-la à vous-même par e-mail ou enregistrez-la dans Fichiers. Vous obtenez un fichier comme `PTT-20261108-WA0003.opus`, qui est de l’Ogg Opus. Gardez-le tel quel : l’API le lit directement.

**2. En transcrire une**

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl https://api.namuai-lab.com/v1/transcribe \
  -H "Authorization: Bearer $NAMU_API_KEY" \
  -F file=@PTT-20261108-WA0003.opus \
  -F language=ha
```

Envoyez `dje` pour le zarma ou `fr` pour le français.

**3. Transcrire un dossier entier**

```python transcribe_folder.py theme={"theme":{"light":"github-light","dark":"github-dark"}}
import sys
from pathlib import Path

from namu import Namu, NamuError

client = Namu()
folder, language = Path(sys.argv[1]), (sys.argv[2] if len(sys.argv) > 2 else "ha")
AUDIO = {".opus", ".ogg", ".m4a", ".mp3", ".wav", ".aac", ".webm", ".flac"}

for note in sorted(p for p in folder.iterdir() if p.suffix.lower() in AUDIO):
    text_file = note.with_suffix(".txt")
    if text_file.exists():
        continue
    try:
        result = client.transcribe(note, language=language)
    except NamuError as e:
        print(f"{note.name}: {e.type}")
        continue
    text_file.write_text(result["text"] + "\n", encoding="utf-8")
    print(f"{note.name} ({result['audio_seconds']:.0f} s): {result['text'][:60]}")
```

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
python transcribe_folder.py ./voice-notes ha
```

## Bon à savoir

* Le texte arrive en minuscules, sans ponctuation.
* Les notes de plus de 5 minutes renvoient `audio_too_long` : [découpez-les d’abord](https://developers.namuai-lab.com/fr/guides/audio-formats.md).
* Demandez avant de transcrire la note vocale de quelqu’un : c’est sa voix, et ce sont ses mots.

## Pour aller plus loin

> [card] [Construire un interprète](https://developers.namuai-lab.com/fr/tutorials/hausa-french-interpreter.md)
>
> Traduire ce qui a été dit

> [card] [Transcription](https://developers.namuai-lab.com/fr/capabilities/speech-to-text.md)
>
> Toutes les options


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.