BroadRouter

n8n ile WhatsApp sesli notlarını metne çevirin

Güncellendi

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

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 (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):

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:

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, 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 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 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 bakın.

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.

Markdown olarak okuChatGPT asistanına sorClaude asistanına sorPerplexity asistanına sor