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_EXCLUDEayarlayın. ffmpeg: not found. İmajda ffmpeg yok; yukarıdaki özel imajı derleyin.- Dosyaya erişime izin verilmiyor.
/home/node/.n8n-filesaltına yazın veyaN8N_RESTRICT_FILE_ACCESS_TOdeğ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.
