WhatsApp Audio Transcriber Bot
Overview
Automatically transcribe WhatsApp audio messages to text using AI-powered speech recognition. This workflow receives audio messages via webhook, processes them through Groq's Whisper API, and replies with the transcribed text in the same conversation.
Use Cases
-
Accessibility : Help users with hearing impairments access audio content
-
Workplace Communication : Quickly scan audio messages in professional settings
-
Language Learning : Get text versions of audio for better comprehension
-
Meeting Notes : Convert voice messages to searchable text format
-
Multilingual Support : Transcribe audio in Portuguese (configurable for other languages)
How it Works
-
Message Reception : Webhook receives WhatsApp messages in real-time
-
Audio Detection : Filters only audio messages using Switch node
-
Format Conversion : Converts base64 audio to MP3 file format
-
AI Transcription : Processes audio through Groq API with Whisper Large V3 model
-
Response Delivery : Sends transcribed text back to the original conversation
Key Features
- ✅ Real-time Processing : Instant transcription of incoming audio messages
- ✅ High Accuracy : Uses Whisper Large V3 model for reliable transcription
- ✅ Auto-Reply : Automatically responds in the same WhatsApp conversation
- ✅ Message Quoting : References the original audio message in the reply
- ✅ Portuguese Optimized : Configured for Brazilian Portuguese transcription
- ✅ Self-Message Filtering : Ignores messages sent by the bot itself
Prerequisites
Required Services
-
Evolution API : WhatsApp integration service
-
Groq API : AI transcription service (Whisper model)
-
n8n Instance : Workflow automation platform
API Keys & Configuration
- Groq API key (set as environment variable:
GROQ_API_KEY )
- Evolution API instance properly configured
- Webhook URL configured in Evolution API
Setup Instructions
-
Import Workflow : Import the JSON workflow into your n8n instance
-
Configure Environment : Set
GROQ_API_KEY environment variable
-
Setup Webhook : Configure Evolution API to send messages to the webhook endpoint
-
Test Connection : Send a test audio message to verify the workflow
Workflow Nodes
-
Webhook : Receives WhatsApp messages from Evolution API
-
Edit Fields : Extracts relevant data (number, name, message, audio)
-
Switch : Filters only audio messages (
audioMessage type)
-
Convert to File : Transforms base64 audio to MP3 format
-
HTTP Request : Sends audio to Groq API for transcription
-
Evolution API : Sends transcribed text back to WhatsApp
Configuration Options
Groq API Settings
-
Model :
whisper-large-v3
-
Language :
pt (Portuguese)
-
Temperature :
0 (maximum accuracy)
-
Response Format :
json
Customization Options
- Change language by modifying the
language parameter
- Adjust temperature for different accuracy/creativity balance
- Modify response format for different output styles
Response Format
*Mensagem transcrita automaticamente.*
[Transcribed text content]
Technical Specifications
-
Input : Base64 encoded audio from WhatsApp
-
Output : Plain text transcription
-
Processing Time : Typically 2-5 seconds per audio message
-
Supported Audio : MP3 format (converted from WhatsApp audio)
-
Language : Portuguese (configurable)
Troubleshooting
-
No Response : Check Groq API key and webhook configuration
-
Poor Transcription : Ensure audio quality and check language settings
-
Error Messages : Monitor n8n execution logs for detailed error information
Version History
-
v0.0.1 : Initial release with basic transcription functionality
