How do I make the AI agent reply with audio on WhatsApp?
Open the agent under Settings → Accounts Hub → My agents, go to the Voz (Voice) tab, pick the voice, turn on Responder com áudio (Reply with audio) and set under Quando mandar áudio (When to send audio) when it swaps text for a voice note. Publish the agent for it to apply to conversations.
Before you start:
- The Voz com IA (AI voice) feature must be on in the workspace modules, under the IA module.
- The agent must already answer on WhatsApp (How do I put the AI agent to answer on WhatsApp, Instagram, Telegram, Webchat or email?).
1. Pick the voice
Under Voz do agente (Agent voice), click Ouvir prévia (Play preview) to hear each voice and click a card to pick it. Padrão do workspace (Workspace default) uses the voice set under Max > Vozes. Voices made by your team carry the Treinada pelo time (Trained by the team) badge.
Under Max > Vozes, each voice's Usar no agente (Use in agent) button opens this tab with the voice already picked in the draft.
2. Tune how it speaks
Under Ajuste fino (Fine tuning):
- Modelo (Model): Padrão has the best Portuguese pronunciation; Rápido costs half; Expressivo sounds more human.
- Estabilidade (Stability): higher keeps the voice steady; lower adds variation between sentences.
- Fidelidade à voz original (Similarity): how closely speech follows the chosen voice's timbre.
- Velocidade (Speed): the middle is normal speed.
- Expressividade (Expressiveness): higher makes speech more emotional.
Under Fala e pronúncia > Dicionário de pronúncia (Pronunciation dictionary), add terms the voice mispronounces (company name, acronym, product) and write under Como falar how they should sound. Click Ouvir pronúncia to check.
3. Turn audio on and choose when to send it
Under Áudio no WhatsApp, turn on Responder com áudio and pick a mode under Quando mandar áudio:
4. Check the limits
The limits apply in every mode and keep the conversation from turning audio-only:
- Áudios seguidos, no máximo (Audio in a row, at most): after this number, the next reply goes as text.
- Resposta maior que isso vai em texto (Longer replies go as text): long replies never become audio.
- Links, valores e códigos sempre em texto (Links, amounts and codes always as text): a reply with a link, email, R$ amount, long number or Pix goes as text so the contact can copy and click.
Instagram and the site chat don't play voice notes: there the reply always goes as text. On WhatsApp and Telegram the audio arrives as a voice note.
5. Test before publishing
In the Testar agora (Test now) panel, type a reply and click Ouvir como áudio (Play as audio). The preview uses the draft voice and tuning. Then click Publicar on the agent.
Test a call with the agent
In the Testar agora panel, switch to Ligação (Call). The published agent replies, with the draft voice and tuning, so the agent must be published and on.
- Ligar pelo navegador (Call in the browser): allow the microphone and talk to the agent. Click Encerrar ligação (End call) to hang up.
- Me ligar (Call me): type your phone with area code (or the country code with
+) and the agent calls you within a few seconds.
Under Fala e pronúncia, Primeira fala da ligação (First line of the call) is what the agent says when the call connects; empty, it waits for you to speak. Deixar o contato interromper (Let the contact interrupt) makes the agent stop when you start talking, and Som ambiente (Background sound) adds a light office sound. The test call stops at 10 minutes.
Related
- How do I put the AI agent to answer on WhatsApp, Instagram, Telegram, Webchat or email?
- How do I train an AI voice?
- How do I generate an AI voice audio from text?
If it didn't work
- The agent replied with text: the reply hit a limit (too long, with a link or amount, or past the audio-in-a-row limit), or the channel doesn't play audio.
- In Quando o lead mandar áudio mode, it only switches to audio when the contact's last message was audio.
- You changed the voice and nothing happened: the agent uses the published version. Click Publicar.
- The call doesn't start: publish and turn on the agent, and allow the browser microphone.
- Me ligar rejected the number: use area code and number, or the country code with
+. - The Voz tab is missing: the Voz com IA feature is off in the workspace modules.