---
title: "n8n WhatsApp 음성 메시지 전사 워크플로, 단계별 가이드 | BroadRouter"
description: "WhatsApp 음성 메시지를 받아 Meta에서 내려받고, ffmpeg로 변환한 뒤 아랍어나 다른 13개 언어로 전사하는 n8n 워크플로입니다."
url: https://broadrouter.com/ko/guides/n8n-whatsapp-voice-note-transcription/
lang: ko
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

이 페이지는 영어 원문을 AI의 도움을 받아 번역했습니다. [영어 원문 읽기](https://broadrouter.com/guides/n8n-whatsapp-voice-note-transcription/) (2026-11-16 업데이트).

# n8n에서 WhatsApp 음성 메시지 전사하기

업데이트 2026-11-16

n8n 노드 8개를 쓰세요. Messages 이벤트의 WhatsApp Trigger, 오디오만 통과시키는 If 노드, 미디어 URL을 받는 WhatsApp Download 작업, .ogg 파일을 가져오는 HTTP Request, 그 파일을 저장하는 Read/Write Files 노드, WAV로 바꾸는 Execute Command 노드의 ffmpeg, WAV를 불러오는 두 번째 Read/Write Files 노드, /v1/audio/transcriptions로 보내는 HTTP Request입니다. ffmpeg가 설치된 셀프 호스팅 n8n이 필요합니다.

이 워크플로는 들어오는 WhatsApp 음성 메시지를 n8n 안에서 하나하나 텍스트로 바꿉니다. [WhatsApp 음성 메시지 가이드의 스크립트](https://broadrouter.com/ko/guides/transcribe-whatsapp-voice-notes/)를 n8n으로 옮긴 것으로, ffmpeg 변환과 전사 호출이 같습니다. 아래 노드 이름과 옵션은 2026-11-14에 n8n 문서와 소스 코드로 확인했으며, 링크는 출처에 있습니다.

## 준비물

-   **셀프 호스팅 n8n.** n8n 문서에 따르면 Execute Command 노드는 n8n Cloud에서 쓸 수 없고, n8n 2.0부터 기본적으로 비활성화되어 있습니다.
-   **n8n 호스트의 ffmpeg.** Docker에서는 명령이 Docker 호스트가 아니라 n8n 컨테이너 안에서 실행되므로, 이미지에 ffmpeg가 있어야 합니다.
-   **n8n의 WhatsApp Business Cloud 자격 증명.** WhatsApp Business Account가 연결된 Meta 앱에 연결되어 있어야 하며, 그 앱의 액세스 토큰도 필요합니다.
-   **BroadNet API 키.** 새 계정은 카드 없이 초기 크레딧($5 상당)을 받으며, 두 전사 모델 모두 이 크레딧으로 실행됩니다.

## n8n 준비: ffmpeg, Execute Command, 파일 폴더

공식 n8n Docker 이미지에는 패키지 관리자가 없습니다. n8n 문서는 커스텀 이미지에서 `apk`를 복원해 curl을 설치하는 방법을 보여 주는데, 같은 Dockerfile에서 `curl` 대신 `ffmpeg`를 쓰면 ffmpeg를 설치할 수 있습니다.

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

`docker build -t n8n-ffmpeg .`로 빌드하고, `n8nio/n8n` 대신 `n8n-ffmpeg`를 실행하세요. `ffmpeg`로 바꾼 부분은 n8n의 curl 예제를 저희가 수정한 것이므로, Execute Command 노드에서 `ffmpeg -version`을 한 번 실행해 확인하세요.

그런 다음 환경 변수 두 개를 설정하세요.

| 변수 | 값 | 이유 |
| --- | --- | --- |
| `NODES_EXCLUDE` | `"[]"` | Execute Command는 기본적으로 차단되어 있습니다. 빈 목록을 넣으면 이 노드와 함께 n8n이 기본으로 차단하는 다른 노드도 모두 풀리므로, 계속 차단할 노드는 다시 추가하세요. |
| `N8N_RESTRICT_FILE_ACCESS_TO` | 설정하지 않음 | n8n 2.0부터 기본값은 `~/.n8n-files`입니다. 공식 이미지에서는 `/home/node/.n8n-files`이며, 아래에서 이 폴더를 씁니다. |

## 노드별 워크플로

| # | 노드 | 설정 |
| --- | --- | --- |
| 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 }}`, 헤더 `Authorization: Bearer <WhatsApp access token>`, Response Format **File**, Put Output in Field `data` |
| 5 | Read/Write Files from Disk | **Write File to Disk**, 경로 `/home/node/.n8n-files/{{ $('WhatsApp Trigger').item.json.messages[0].audio.id }}.ogg`, Input Binary Field `data` |
| 6 | Execute Command | 아래 ffmpeg 명령 |
| 7 | Read/Write Files from Disk | **Read File(s) From Disk**, `.wav` 경로, Put Output File in Field `data` |
| 8 | HTTP Request | 전사 엔드포인트로 POST(아래 참고) |

5~7번 노드가 있는 이유는 Execute Command가 셸 명령을 실행할 뿐 n8n 바이너리 데이터를 받지 않기 때문입니다. 그래서 파일을 디스크에 썼다가 다시 읽습니다.

### 직접 만드는 대신 워크플로 가져오기

[n8n JSON 워크플로 다운로드](https://broadrouter.com/downloads/n8n-whatsapp-voice-note-transcription.json)(노드 8개, 아랍어용 설정)를 받아 n8n에서 **Import from File**로 가져오세요. 키나 토큰은 들어 있지 않습니다. 로그인이 필요한 노드에는 이름이 `REPLACE:`로 시작하는 자리표시자 자격 증명이 들어 있으니, 이 노드 네 개를 열어 각자의 자격 증명을 고르세요. 노드 타입 이름과 파라미터 이름은 2026-11-14에 n8n 소스 코드로 확인했습니다. 아래 가이드에서 노드를 하나씩 설명하므로 직접 만들 수도 있습니다.

### 1–2. 메시지에서 트리거하고 오디오만 남기기

n8n 소스를 보면 WhatsApp Trigger는 Meta 웹훅의 change마다 항목 하나를 출력하며, 메시지 목록은 `messages` 아래에 있습니다. 텍스트, 이미지, 음성 메시지가 모두 **Messages** 이벤트로 들어오므로, If 노드는 첫 메시지의 `type`이 `audio`인 항목만 통과시킵니다. 전달 확인과 읽음 확인도 같은 이벤트로 들어오지만 `messages` 목록이 없습니다. `?? ''`가 이 빈 값을 빈 문자열로 바꿔 주므로 엄격한 타입 검사가 실패하지 않습니다.

WhatsApp은 앱당 등록된 웹훅 URL 하나만 허용합니다. n8n 문서는 트리거의 테스트 URL과 프로덕션 URL을 오가면 이 값을 덮어쓰게 되어, 다른 URL은 이벤트를 받지 못한다고 경고합니다.

### 3–4. Meta에서 음성 메시지 내려받기

WhatsApp 노드의 **Download** 작업은 미디어 ID로 Meta의 미디어 엔드포인트를 호출하고, 오디오가 아니라 `url`이 담긴 JSON을 반환합니다. Meta 문서에 따르면 이 URL은 5분 동안 유효하며, 액세스 토큰 없이는 다운로드가 실패합니다. 그래서 다음 HTTP Request 노드가 `Authorization` 헤더에 토큰을 넣어 `{{ $json.url }}` 주소에서 파일을 가져오고, 응답을 `data` 필드에 파일로 저장합니다. n8n에서는 토큰을 노드에 직접 입력하지 말고 **Header Auth** 자격 증명(이름 `Authorization`, 값은 `Bearer` 뒤에 토큰)에 저장하세요.

### 5–7. ffmpeg로 WAV 변환하기

파일을 디스크에 쓴 다음(5번 노드), Execute Command 노드(6번 노드)에서 변환하세요.

```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`은 16kHz 모노 WAV를 만듭니다. BroadNet 문서가 음성 메시지에 쓰는 변환과 같습니다. 미디어 ID는 숫자이므로 파일 이름에 써도 안전합니다. 7번 노드가 `.wav` 파일을 다시 `data` 필드로 읽어 옵니다.

### 8\. 전사하기

BroadNet용 두 번째 **Header Auth** 자격 증명(이름 `Authorization`, 값은 `Bearer` 뒤에 BroadNet 키)을 만드세요. 그런 다음 마지막 HTTP Request 노드를 설정합니다.

| 필드 | 값 |
| --- | --- |
| Method | POST |
| URL | `https://inference.broadnet.ai/v1/audio/transcriptions` |
| Authentication | Generic Credential Type, **Header Auth**, BroadNet 자격 증명 |
| Send Body | 켬, Body Content Type **Form-Data** |
| Body 파라미터 `model` | `broadnet/cohere-transcribe-arabic` (다른 13개 언어는 `broadnet/cohere-transcribe`) |
| Body 파라미터 `language` | `ar` (또는 `en`, `es`, …) |
| Body 파라미터 `file` | Parameter Type **n8n Binary File**, Input Data Field Name `data` |

응답은 `text`에 전사본이 담긴 JSON이므로, 이후 노드에서는 `{{ $json.text }}` 식으로 읽습니다. 다음 curl 호출과 같은 요청입니다.

```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`는 항상 보내세요. 이 값이 없으면 아랍어가 라틴 문자로 음역되어 돌아올 수 있습니다.

## 텍스트 활용하기

CRM이나 헬프데스크에 저장하거나, 채팅 모델에 넘겨 메시지를 요약하거나 분류하세요. [n8n OpenAI 호환 가이드](https://broadrouter.com/ko/guides/n8n-openai-compatible/)에서 같은 키로 n8n의 OpenAI Chat Model 노드를 BroadNet에 연결하는 방법을 볼 수 있습니다. 정리하려면 마지막에 Execute Command 노드를 하나 더 두어 해당 미디어 ID의 파일 두 개를 삭제하세요.

## 문제 해결

-   **트리거가 아무것도 받지 못함.** 워크플로가 프로덕션 URL로 게시되었는지, Meta 앱이 WhatsApp Business Account를 구독하고 있는지 확인하세요. n8n 문서에 따르면 n8n은 이 구독을 만들지 않습니다.
-   **미디어 다운로드가 404를 반환함.** 5분이 지나 URL이 만료된 것입니다. Meta 문서는 미디어 URL을 새로 요청하고, 그래도 실패하면 액세스 토큰을 갱신하라고 안내합니다.
-   **“Unrecognized node type” 또는 Execute Command가 없음.** n8n 2.0부터 기본적으로 차단되어 있습니다. `NODES_EXCLUDE`를 설정하세요.
-   **`ffmpeg: not found`.** 이미지에 ffmpeg가 없습니다. 위의 커스텀 이미지를 빌드하세요.
-   **파일 접근이 허용되지 않음.** `/home/node/.n8n-files` 아래에 쓰거나, `N8N_RESTRICT_FILE_ACCESS_TO`를 사용하는 폴더로 설정하세요.
-   **BroadNet의 400, 413, 429.** 413은 파일이 26,214,400바이트(16kHz 모노 WAV로 약 13분)를 넘었다는 뜻이고, 429는 동시 요청이 너무 많다는 뜻입니다. [BroadNet 오류 코드와 재시도](https://broadrouter.com/ko/guides/errors-and-retries/)를 참고하세요.

정확도, 방언, BroadNet 가격을 다른 음성 인식 API와 비교한 내용은 [아랍어 음성 인식 가이드](https://broadrouter.com/ko/guides/arabic-speech-to-text-api/)에서 다룹니다. 20개가 넘는 음성 인식 제품의 일괄 처리·스트리밍 정가를 출처와 확인 날짜와 함께 보려면 공개 [음성 인식 API 가격 지수](https://broadrouter.com/data/speech-to-text-api-prices/)를 참고하세요.

## 이 가이드의 용어

[음성 인식(Speech-to-text, STT)](https://broadrouter.com/ko/glossary/speech-to-text/)

음성 인식(STT)은 자동 음성 인식(ASR)이라고도 하며, 말소리 오디오를 글로 변환하는 기술입니다. 음성 인식 API는 오디오 파일이나 스트림을 받아 전사 텍스트를 반환하며, 보통 오디오 분당 요금이 붙습니다. 정확도는 단어 오류율로 측정하며 억양, 방언, 녹음 품질에 따라 달라집니다.

[OpenAI 호환 API(OpenAI-compatible API)](https://broadrouter.com/ko/glossary/openai-compatible-api/)

OpenAI 호환 API는 POST /v1/chat/completions처럼 OpenAI API와 같은 요청 및 응답 형식을 받는 HTTP API입니다. 그래서 OpenAI SDK와 도구는 base URL, API 키, 모델 이름만 바꾸면 이 API를 그대로 사용할 수 있습니다.

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

WAV(Waveform Audio File Format, WAVE)는 Microsoft와 IBM의 RIFF 형식을 바탕으로 한 오디오 컨테이너입니다. 보통 비압축 선형 PCM 샘플을 담기 때문에 크기를 예측하기 쉽습니다. 초당 크기는 샘플링 레이트 × 샘플당 바이트 수 × 채널 수입니다.

## 자주 묻는 질문

### 이 워크플로가 n8n Cloud에서도 실행되나요?

이대로는 안 됩니다. n8n 문서에 따르면 Execute Command 노드는 n8n Cloud에서 쓸 수 없고, 변환 단계에는 n8n을 실행하는 머신에 ffmpeg가 있어야 합니다. n8n Cloud에서는 직접 관리하는 외부 서비스에서 오디오를 변환하고 HTTP Request 노드로 호출하세요.

### WhatsApp .ogg 파일을 전사 엔드포인트로 바로 보낼 수 없는 이유는 무엇인가요?

WhatsApp 음성 메시지는 Ogg 컨테이너에 담긴 Opus 오디오입니다. BroadNet 전사 엔드포인트는 WAV와 MP3를 받으므로, 워크플로가 먼저 ffmpeg로 각 메시지를 16kHz 모노 WAV로 변환합니다.

### WhatsApp Download 작업이 오디오 파일을 돌려주지 않는 이유는 무엇인가요?

n8n 소스를 보면 Download 작업은 Meta의 GET 미디어 엔드포인트를 호출하는데, 이 엔드포인트는 임시 URL이 담긴 JSON 객체를 반환합니다. 두 번째 HTTP Request 노드가 WhatsApp 액세스 토큰으로 그 URL을 가져옵니다. Meta에 따르면 URL은 5분 동안 유효합니다.

### 워크플로를 게시한 뒤 WhatsApp Trigger가 아무것도 받지 못하는 이유는 무엇인가요?

WhatsApp은 앱당 웹훅 URL 하나만 허용하므로, n8n의 테스트 URL과 프로덕션 URL을 오가면 덮어쓰게 됩니다. 또 n8n 문서에 따르면 n8n은 Meta 앱을 WhatsApp Business Account에 구독시키지 않습니다. Meta의 Subscribed Apps API에서 구독을 확인하세요.

### 이 방식으로 WhatsApp 음성 메시지를 전사하면 비용이 얼마나 드나요?

BroadNet은 오디오 분당 요금을 받습니다. BroadNet Transcribe Arabic은 분당 $0.0042 요금, BroadNet Transcribe는 분당 $0.002 요금입니다. 30초짜리 아랍어 음성 메시지 10,000개를 전사하는 비용은 $21.00입니다. n8n과 Meta 요금은 별도입니다.

## 관련 가이드

-   [API로 WhatsApp 음성 메시지를 텍스트로 전사하기](https://broadrouter.com/ko/guides/transcribe-whatsapp-voice-notes/)
-   [n8n에서 BroadNet Inference 사용하기(OpenAI 자격 증명, Base URL)](https://broadrouter.com/ko/guides/n8n-openai-compatible/)
-   [아랍어 음성 인식(STT) API 사용법: 단계별 가이드](https://broadrouter.com/ko/guides/arabic-speech-to-text-api/)
-   [BroadNet Inference 오류 코드와 재시도해야 하는 경우](https://broadrouter.com/ko/guides/errors-and-retries/)
-   [BroadNet Inference와 함께 쓸 수 있는 모든 도구 (영어)](https://broadrouter.com/integrations/): SDK, 코딩 에이전트, 채팅 UI, 자동화 도구와 각 도구의 정확한 설정

실제 워크로드로 테스트해 보세요. 신규 계정에는 US$5 상당의 초기 크레딧이 제공되며 Gemma 및 음성 전사에 사용할 수 있습니다. DeepSeek, GLM 및 Qwen3.8 모델은 충전이 필요합니다.

[시작하기](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-guides-n8n-whatsapp-voice-note-transcription&utm_content=page-cta) ·

**출처**

-   [n8n 문서, WhatsApp Trigger 노드(이벤트, 앱당 웹훅 하나, 2026-11-14 확인)](https://docs.n8n.io/integrations/builtin/trigger-nodes/n8n-nodes-base.whatsapptrigger/)
-   [n8n 문서, WhatsApp Business Cloud 노드(Media 작업, 2026-11-14 확인)](https://docs.n8n.io/integrations/builtin/app-nodes/n8n-nodes-base.whatsapp/)
-   [n8n 소스, WhatsApp 미디어 작업(Download는 미디어 URL을 반환, 2026-11-14 확인)](https://github.com/n8n-io/n8n/blob/master/packages/nodes-base/nodes/WhatsApp/MediaDescription.ts)
-   [n8n 소스, WhatsApp Trigger 출력(웹훅 change 값마다 항목 하나, 2026-11-14 확인)](https://github.com/n8n-io/n8n/blob/master/packages/nodes-base/nodes/WhatsApp/WhatsAppTrigger.node.ts)
-   [n8n 문서, HTTP Request 노드(Form-Data, n8n Binary File, Response Format File, 2026-11-14 확인)](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.httprequest/)
-   [n8n 문서, Execute Command 노드(셀프 호스팅 전용, n8n 2.0부터 기본 비활성화, Docker 예제, 2026-11-14 확인)](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.executecommand/)
-   [n8n 문서, 노드 차단(NODES\_EXCLUDE, 2026-11-14 확인)](https://docs.n8n.io/hosting/securing/blocking-nodes/)
-   [n8n 문서, Read/Write Files from Disk(N8N\_RESTRICT\_FILE\_ACCESS\_TO 기본값, 2026-11-14 확인)](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.readwritefile/)
-   [Meta WhatsApp Cloud API, 미디어(다운로드에 액세스 토큰 필요, URL 유효 시간 5분, 2026-11-14 확인)](https://developers.facebook.com/docs/whatsapp/cloud-api/reference/media)
-   [Meta WhatsApp Cloud API, 오디오 메시지(음성 메시지는 Opus 코덱의 OGG, 2026-11-14 확인)](https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/audio-messages)
-   [BroadNet Inference API 레퍼런스, 전사 (영어)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-guides-n8n-whatsapp-voice-note-transcription&utm_content=sources#requests)
