---
title: "n8n WhatsApp sesli not transkripsiyonu, adım adım | BroadRouter"
description: "WhatsApp sesli notunu alan, Meta'dan indiren, ffmpeg ile dönüştüren ve Arapça ya da 13 başka dilde metne çeviren bir n8n iş akışı."
url: https://broadrouter.com/tr/guides/n8n-whatsapp-voice-note-transcription/
lang: tr
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

İngilizceden yapay zekâ desteğiyle çevrilmiştir. [İngilizce aslını okuyun](https://broadrouter.com/guides/n8n-whatsapp-voice-note-transcription/) (güncelleme: 2026-11-16).

# n8n ile WhatsApp sesli notlarını metne çevirin

Güncellendi 2026-11-16

Sekiz n8n düğümü kullanın: Messages olayında bir WhatsApp Trigger, yalnızca sesi geçiren bir If düğümü, medya URL'si için WhatsApp Download işlemi, .ogg dosyasını çeken bir HTTP Request, onu kaydeden bir Read/Write Files düğümü, WAV üretmek için Execute Command düğümünde ffmpeg, WAV'ı yükleyen ikinci bir Read/Write Files düğümü ve /v1/audio/transcriptions adresine bir HTTP Request. Kendi sunucunuzda barındırılan (self-hosted), ffmpeg kurulu bir n8n gerekir.

Bu iş akışı, gelen her WhatsApp sesli notunu n8n içinde metne dönüştürür. [WhatsApp sesli notları rehberindeki betiğin](https://broadrouter.com/tr/guides/transcribe-whatsapp-voice-notes/) n8n sürümüdür: aynı ffmpeg dönüşümü ve aynı transkripsiyon çağrısı. Aşağıdaki düğüm adları ve seçenekler 2026-11-14’te n8n’in belgeleri ve kaynak koduyla karşılaştırıldı; bağlantılar kaynaklar bölümündedir.

## Neye ihtiyacınız var

-   **Self-hosted n8n.** n8n belgelerine göre Execute Command düğümü n8n Cloud’da yoktur ve n8n 2.0’dan itibaren varsayılan olarak kapalıdır.
-   **n8n ana makinesinde ffmpeg.** Docker’da komut Docker ana makinesinde değil n8n konteynerinin içinde çalışır; bu yüzden ffmpeg imajda bulunmalıdır.
-   **n8n’de bir WhatsApp Business Cloud kimlik bilgisi**: WhatsApp Business Account’unuzun bağlı olduğu bir Meta uygulamasına bağlı olmalı; ayrıca o uygulamanın erişim token’ı gerekir.
-   **Bir BroadNet API anahtarı.** Yeni hesaplar kart gerekmeden $5 başlangıç kredisi alır ve iki transkripsiyon modeli de bu krediyle çalışır.

## n8n’i hazırlayın: ffmpeg, Execute Command ve bir dosya klasörü

Resmî n8n Docker imajında paket yöneticisi yoktur. n8n belgeleri, curl kurmak için özel bir imajda `apk` paket yöneticisini geri getirmeyi gösterir; aynı Dockerfile’da `curl` yerine `ffmpeg` yazarsanız ffmpeg elde edersiniz:

```dockerfile
FROM n8nio/n8n
USER root

# Restore the apk package manager (removed from the base image)
COPY --from=alpine:3.22 /sbin/apk /sbin/apk
COPY --from=alpine:3.22 /lib/apk /lib/apk
COPY --from=alpine:3.22 /usr/lib/libapk* /usr/lib/

RUN apk add --no-cache ffmpeg
USER node
```

İmajı `docker build -t n8n-ffmpeg .` ile derleyin ve `n8nio/n8n` yerine `n8n-ffmpeg` çalıştırın. `ffmpeg` değişikliği, n8n’in curl örneğine bizim yaptığımız bir değişikliktir; bu yüzden doğrulamak için bir Execute Command düğümünde bir kez `ffmpeg -version` çalıştırın.

Ardından iki ortam değişkeni ayarlayın:

| Değişken | Değer | Neden |
| --- | --- | --- |
| `NODES_EXCLUDE` | `"[]"` | Execute Command varsayılan olarak engellidir. Boş bir liste onun ve n8n’in varsayılan olarak engellediği diğer tüm düğümlerin engelini kaldırır; engelli kalmasını istediklerinizi listeye geri ekleyin. |
| `N8N_RESTRICT_FILE_ACCESS_TO` | ayarlamayın | n8n 2.0’dan itibaren varsayılanı `~/.n8n-files` olur. Resmî imajda bu, aşağıda kullanılan `/home/node/.n8n-files` klasörüdür. |

## İş akışı, düğüm düğüm

| # | Düğüm | Ayar |
| --- | --- | --- |
| 1 | WhatsApp Trigger | Event: **Messages** |
| 2 | If | `{{ $json.messages?.[0]?.type ?? '' }}` is equal to `audio` |
| 3 | WhatsApp Business Cloud | Resource **Media**, Operation **Download**, Media ID `{{ $json.messages[0].audio.id }}` |
| 4 | HTTP Request | GET `{{ $json.url }}`, başlık `Authorization: Bearer <WhatsApp access token>`, Response Format **File**, Put Output in Field `data` |
| 5 | Read/Write Files from Disk | **Write File to Disk**, yol `/home/node/.n8n-files/{{ $('WhatsApp Trigger').item.json.messages[0].audio.id }}.ogg`, Input Binary Field `data` |
| 6 | Execute Command | aşağıdaki ffmpeg komutu |
| 7 | Read/Write Files from Disk | **Read File(s) From Disk**, `.wav` yolu, Put Output File in Field `data` |
| 8 | HTTP Request | transkripsiyon uç noktasına POST, aşağıda |

5–7 numaralı düğümlerin nedeni şu: Execute Command bir kabuk komutu çalıştırır ve n8n ikili (binary) verisini almaz; bu yüzden dosya diske yazılır ve geri okunur.

### İş akışını kurmak yerine içe aktarın

[İş akışını n8n JSON olarak indirin](https://broadrouter.com/downloads/n8n-whatsapp-voice-note-transcription.json) (8 düğüm, Arapça için ayarlı) ve n8n’de **Import from File** ile içe aktarın. İçinde anahtar veya token yoktur. Giriş gerektiren her düğümde adı `REPLACE:` ile başlayan bir yer tutucu kimlik bilgisi vardır; bu dört düğümü açıp kendi kimlik bilgilerinizi seçin. Düğüm türü adları ve parametre adları 2026-11-14’te n8n’in kaynak koduyla karşılaştırıldı; aşağıdaki rehber her düğümü açıklar, dolayısıyla iş akışını elle de kurabilirsiniz.

### 1–2. Mesajlarda tetikleyin, yalnızca sesi tutun

n8n kaynak kodunda WhatsApp Trigger, Meta’nın webhook’undaki her değişiklik için bir öğe üretir; mesaj listesi `messages` altındadır. Metin, görsel ve sesli notların hepsi **Messages** olayıyla gelir; bu yüzden If düğümü yalnızca ilk mesajının `type` değeri `audio` olan öğeleri geçirir. İletim ve okundu bilgileri de aynı olayla, `messages` listesi olmadan gelir; `?? ''` bu eksik değeri boş bir dizgeye çevirir, böylece katı tür denetimi bu öğelerde hata vermez.

WhatsApp uygulama başına tek bir kayıtlı webhook URL’sine izin verir. n8n belgeleri, tetikleyicinin test ve production URL’leri arasında geçiş yapmanın bu URL’nin üzerine yazdığı, dolayısıyla diğer URL’nin olay almayı bıraktığı konusunda uyarır.

### 3–4. Sesli notu Meta’dan indirin

WhatsApp düğümünün **Download** işlemi, Meta’nın medya uç noktasını medya kimliğiyle çağırır ve sesi değil, `url` içeren bir JSON döndürür. Meta belgelerine göre bu URL 5 dakika geçerlidir ve erişim token’ınız olmadan indirme başarısız olur. Bu yüzden sonraki HTTP Request düğümü `{{ $json.url }}` adresini, token’ı bir `Authorization` başlığına koyarak çeker ve yanıtı `data` alanına dosya olarak kaydeder. n8n’de token’ı düğüme yazmak yerine bir **Header Auth** kimlik bilgisinde saklayın (ad `Authorization`, değer `Bearer` ve ardından token).

### 5–7. ffmpeg ile WAV’a dönüştürün

Dosyayı diske yazın (5. düğüm), ardından Execute Command düğümünde dönüştürün (6. düğüm):

```bash
ffmpeg -y -loglevel error -i /home/node/.n8n-files/{{ $('WhatsApp Trigger').item.json.messages[0].audio.id }}.ogg -ar 16000 -ac 1 /home/node/.n8n-files/{{ $('WhatsApp Trigger').item.json.messages[0].audio.id }}.wav
```

`-ar 16000 -ac 1` 16 kHz mono WAV üretir; BroadNet belgelerinin sesli notlar için kullandığı dönüşüm budur. Medya kimliği bir sayıdır, bu yüzden dosya adında kullanmak güvenlidir. 7. düğüm `.wav` dosyasını `data` alanına geri okur.

### 8\. Metne çevirin

BroadNet için ikinci bir **Header Auth** kimlik bilgisi oluşturun (ad `Authorization`, değer `Bearer` ve ardından BroadNet anahtarınız). Ardından son HTTP Request düğümünü yapılandırın:

| Alan | Değer |
| --- | --- |
| Method | POST |
| URL | `https://inference.broadnet.ai/v1/audio/transcriptions` |
| Authentication | Generic Credential Type, **Header Auth**, BroadNet kimlik bilgisi |
| Send Body | açık, Body Content Type **Form-Data** |
| Gövde parametresi `model` | `broadnet/cohere-transcribe-arabic` (diğer 13 dil için `broadnet/cohere-transcribe`) |
| Gövde parametresi `language` | `ar` (veya `en`, `es`, …) |
| Gövde parametresi `file` | Parameter Type **n8n Binary File**, Input Data Field Name `data` |

Yanıt, transkripti `text` alanında içeren bir JSON’dur; sonraki düğümler `{{ $json.text }}` değerini okur. Bu istek, şu curl çağrısıyla aynıdır:

```bash
curl https://inference.broadnet.ai/v1/audio/transcriptions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -F model=broadnet/cohere-transcribe-arabic \
  -F language=ar \
  -F file=@voice-note.wav
```

`language` parametresini her zaman gönderin. Gönderilmezse Arapça, Latin harflerine çevriyazılmış (transliterasyon) olarak dönebilir.

## Metinle ne yapmalı

Metni CRM’inize veya yardım masanıza kaydedin ya da mesajı özetlemesi veya sınıflandırması için bir sohbet modeline verin. [n8n OpenAI uyumlu rehberi](https://broadrouter.com/tr/guides/n8n-openai-compatible/), n8n’in OpenAI Chat Model düğümünü aynı anahtarla BroadNet’e nasıl yönlendireceğinizi gösterir. Temizlik için, o medya kimliğine ait iki dosyayı silen son bir Execute Command düğümü ekleyin.

## Sorun giderme

-   **Tetikleyici hiçbir şey almıyor.** İş akışının production URL’sinde yayında olduğunu ve Meta uygulamanızın WhatsApp Business Account’a abone olduğunu kontrol edin; n8n belgelerine göre bu aboneliği n8n oluşturmaz.
-   **Medya indirme 404 döndürüyor.** URL’nin 5 dakikalık süresi doldu. Meta belgeleri yeni bir medya URL’si istemeyi, bu da başarısız olursa erişim token’ını yenilemeyi söyler.
-   **“Unrecognized node type” veya Execute Command görünmüyor.** n8n 2.0’dan itibaren varsayılan olarak engellidir; `NODES_EXCLUDE` ayarlayın.
-   **`ffmpeg: not found`.** İmajda ffmpeg yok; yukarıdaki özel imajı derleyin.
-   **Dosyaya erişime izin verilmiyor.** `/home/node/.n8n-files` altına yazın veya `N8N_RESTRICT_FILE_ACCESS_TO` değişkenini kullandığınız klasöre ayarlayın.
-   **BroadNet’ten 400, 413 veya 429.** 413, dosyanın 26.214.400 baytı (16 kHz mono WAV’da yaklaşık 13 dakika) aştığı anlamına gelir; 429 aynı anda çok fazla istek demektir. [BroadNet hata kodları ve yeniden denemeler](https://broadrouter.com/tr/guides/errors-and-retries/) rehberine bakın.

Doğruluk, lehçeler ve BroadNet fiyatının diğer konuşmadan metne API’leriyle karşılaştırması [Arapça konuşmadan metne rehberinde](https://broadrouter.com/tr/guides/arabic-speech-to-text-api/) ele alınır. 20’den fazla konuşmadan metne ürününün toplu (batch) ve akış (streaming) liste fiyatları için, her biri kaynağı ve kontrol tarihiyle birlikte, açık [konuşmadan metne API fiyat endeksine](https://broadrouter.com/data/speech-to-text-api-prices/) bakın.

## Bu rehberdeki terimler

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

Token, bir dil modelinin okuduğu ve yazdığı metin birimidir: modelin tokenizer'ının ürettiği bir kelime, kelime parçası, noktalama işareti veya bayt dizisi. LLM API'leri kullanımı token cinsinden sayar, sınırlar ve genellikle faturalandırır.

[Akış (streaming)](https://broadrouter.com/tr/glossary/streaming/)

Akış (streaming), bir dil modeli yanıtını sonda tek parça halinde değil, hâlâ üretilirken küçük parçalar halinde döndürme yöntemidir. OpenAI uyumlu API'ler, istekte stream değeri true olduğunda server-sent events (SSE) üzerinden akış yapar.

[Konuşmadan metne (speech-to-text)](https://broadrouter.com/tr/glossary/speech-to-text/)

Konuşmadan metne (speech-to-text), otomatik konuşma tanıma (ASR) olarak da bilinir; konuşulan sesi yazılı metne dönüştüren teknolojidir. Bir konuşmadan metne API'si ses dosyası veya akışı alıp transkript döndürür ve genellikle ses dakikası başına fiyatlandırılır. Doğruluk kelime hata oranıyla ölçülür; aksana, lehçeye ve kayıt kalitesine göre değişir.

[WAV](https://broadrouter.com/tr/glossary/wav/)

WAV (Waveform Audio File Format veya WAVE), Microsoft ve IBM'in RIFF formatı üzerine kurulu bir ses kapsayıcısıdır. Genellikle sıkıştırılmamış doğrusal PCM örnekleri taşır; bu yüzden boyutu öngörülebilirdir: saniye başına örnekleme hızı çarpı örnek başına bayt çarpı kanal sayısı.

[API anahtarı (API key)](https://broadrouter.com/tr/glossary/api-key/)

API anahtarı, bir API'yi çağıran istemciyi tanımlayan ve yetkilendiren gizli bir dizedir. LLM API'leri genellikle anahtarı Authorization: Bearer başlığında bekler; anahtarı elinde tutan herkes, sahibi olan hesaba faturalandırılan istekler yapabilir.

## Sık sorulan sorular

### Bu iş akışı n8n Cloud'da çalışır mı?

Yazıldığı hâliyle hayır. n8n belgelerine göre Execute Command düğümü n8n Cloud'da yoktur ve dönüştürme adımı, n8n'i çalıştıran makinede ffmpeg gerektirir. n8n Cloud'da sesi kontrolünüzdeki harici bir serviste dönüştürün ve o servisi bir HTTP Request düğümüyle çağırın.

### WhatsApp .ogg dosyasını neden doğrudan transkripsiyon uç noktasına gönderemiyorum?

WhatsApp sesli notları Ogg kapsayıcısında Opus sestir. BroadNet'in transkripsiyon uç noktası WAV ve MP3 kabul eder; bu yüzden iş akışı her notu önce ffmpeg ile 16 kHz mono WAV'a dönüştürür.

### WhatsApp Download işlemi neden ses dosyasını döndürmüyor?

n8n kaynak kodunda Download işlemi Meta'nın GET media uç noktasını çağırır; bu uç nokta geçici bir URL içeren bir JSON nesnesi döndürür. İkinci bir HTTP Request düğümü bu URL'yi WhatsApp erişim token'ınızla çeker. Meta'ya göre URL 5 dakika geçerlidir.

### İş akışını yayınladıktan sonra WhatsApp Trigger neden hiçbir şey almıyor?

WhatsApp uygulama başına tek bir webhook URL'sine izin verir; bu yüzden n8n'in test ve production URL'leri arasında geçiş yapmak onun üzerine yazar. n8n belgeleri ayrıca n8n'in Meta uygulamanızı WhatsApp Business Account'a abone etmediğini belirtir; bu aboneliği Meta'nın Subscribed Apps API'sinde kontrol edin.

### WhatsApp sesli notlarını bu yolla metne çevirmek ne kadara mal olur?

BroadNet ses dakikası başına ücret alır: BroadNet Transcribe Arabic ile $0.0042, BroadNet Transcribe ile $0.002. Her biri 30 saniyelik 10.000 Arapça sesli notun maliyeti $21.00. n8n ve Meta ücretleri ayrıdır.

## İlgili rehberler

-   [WhatsApp sesli notlarını API ile metne çevirin](https://broadrouter.com/tr/guides/transcribe-whatsapp-voice-notes/)
-   [n8n'de BroadNet Inference kullanımı (OpenAI kimlik bilgisi, Base URL)](https://broadrouter.com/tr/guides/n8n-openai-compatible/)
-   [Adım adım Arapça ses metne çevirme API'si](https://broadrouter.com/tr/guides/arabic-speech-to-text-api/)
-   [BroadNet Inference hata kodları ve ne zaman yeniden denenmeli](https://broadrouter.com/tr/guides/errors-and-retries/)
-   [BroadNet Inference ile çalışan tüm araçlar (İngilizce)](https://broadrouter.com/integrations/): SDK'lar, kodlama ajanları, sohbet arayüzleri ve otomasyon araçları, her biri için tam ayarlarıyla

Gerçek iş yükünüzle deneyin. Yeni hesaplar şunlar için US$5 kredi ile başlar: Gemma ve transkripsiyon. Bakiye yüklemesi gerekenler: DeepSeek, GLM ve Qwen3.8.

[Başlayın](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-guides-n8n-whatsapp-voice-note-transcription&utm_content=page-cta) ·

**Kaynaklar**

-   [n8n belgeleri, WhatsApp Trigger düğümü (olaylar, uygulama başına tek webhook; 2026-11-14 tarihinde kontrol edildi)](https://docs.n8n.io/integrations/builtin/trigger-nodes/n8n-nodes-base.whatsapptrigger/)
-   [n8n belgeleri, WhatsApp Business Cloud düğümü (Media işlemleri; 2026-11-14 tarihinde kontrol edildi)](https://docs.n8n.io/integrations/builtin/app-nodes/n8n-nodes-base.whatsapp/)
-   [n8n kaynak kodu, WhatsApp medya işlemleri (Download medya URL'sini döndürür; 2026-11-14 tarihinde kontrol edildi)](https://github.com/n8n-io/n8n/blob/master/packages/nodes-base/nodes/WhatsApp/MediaDescription.ts)
-   [n8n kaynak kodu, WhatsApp Trigger çıktısı (webhook'taki her change değeri için bir öğe; 2026-11-14 tarihinde kontrol edildi)](https://github.com/n8n-io/n8n/blob/master/packages/nodes-base/nodes/WhatsApp/WhatsAppTrigger.node.ts)
-   [n8n belgeleri, HTTP Request düğümü (Form-Data, n8n Binary File, Response Format File; 2026-11-14 tarihinde kontrol edildi)](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.httprequest/)
-   [n8n belgeleri, Execute Command düğümü (yalnızca self-hosted, n8n 2.0'dan itibaren varsayılan olarak kapalı, Docker örneği; 2026-11-14 tarihinde kontrol edildi)](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.executecommand/)
-   [n8n belgeleri, düğüm engelleme (NODES\_EXCLUDE; 2026-11-14 tarihinde kontrol edildi)](https://docs.n8n.io/hosting/securing/blocking-nodes/)
-   [n8n belgeleri, Read/Write Files from Disk (N8N\_RESTRICT\_FILE\_ACCESS\_TO varsayılanı; 2026-11-14 tarihinde kontrol edildi)](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.readwritefile/)
-   [Meta WhatsApp Cloud API, medya (indirme için erişim token'ı gerekir; URL 5 dakika geçerlidir; 2026-11-14 tarihinde kontrol edildi)](https://developers.facebook.com/docs/whatsapp/cloud-api/reference/media)
-   [Meta WhatsApp Cloud API, ses mesajları (sesli notlar Opus kodlu OGG'dir; 2026-11-14 tarihinde kontrol edildi)](https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/audio-messages)
-   [BroadNet Inference API referansı, transkripsiyon (İngilizce)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-guides-n8n-whatsapp-voice-note-transcription&utm_content=sources#requests)
