Skip to main content
Voz é o telefone no seu sistema: você liga com um número do workspace, fala texto (TTS), toca áudio, coleta dígitos (DTMF) e encerra ou transfere, sem montar operadora e tronco SIP do zero.

​
O que é Voz na Notifique?

É o canal para originar e controlar chamadas usando números contratados no workspace. Funciona para confirmação de pedido, URA simples (pressione 1, 2…), discador e atendimento inbound com eventos na sua URL. Você pode:
  • Originar chamadas de saída com TTS, áudio ou coleta DTMF
  • Controlar a sessão em tempo real (speak, gather, transfer, hangup, etc.)
  • Gravar trechos da ligação e baixar o arquivo depois
  • Receber chamadas inbound com encaminhamento, TTS ou controle via webhook
  • Acompanhar cada etapa por API ou webhooks
Pense numa central telefônica enxuta: disca, fala, escuta teclas e avisa seu backend a cada passo.
Diferente do WhatsApp, voz não usa instância de canal. Você precisa de um número contratado e ativo no workspace, saldo ou créditos (cobrança por minuto) e API Key com permissão para discar.

​
Quando usar?

Sem número ativo contratado, o canal não disca.

​
Como funciona na prática

  1. Contrate um número e deixe ele ativo — a ligação parte dessa linha (Números de Telefone)
  2. Escolha quem liga e quem recebe (from e to na API)
  3. Ao atender, defina o que acontece: texto falado (TTS), áudio gravado ou menu de teclas
  4. A plataforma disca, conecta e atualiza o status; webhooks avisam cada etapa
  5. Controle a ligação em andamento pela API (falar mais, transferir, encerrar)
  6. Quando alguém liga para você, configure encaminhamento, mensagem automática ou controle via webhook no número
Cada API Key pertence a um workspace. Na v1 não envie x-workspace-id. Use clientState para correlacionar com seu CRM ou fila.

​
Ciclo da chamada

Depois de originar, a ligação passa por QUEUED, INITIATED, RINGING, ANSWERED, COMPLETED ou FAILED. Webhooks como voice.call.answered e voice.call.completed mantêm seu backend sincronizado sem polling.

​
O que dá para fazer

  • Originar para 1 a 500 destinos por chamada (to em array)
  • Listar e consultar histórico (voice:read)
  • Executar ações em chamada ativa (voice:control)
  • Baixar gravação quando voice.call.recording.ready chegar
  • Agendar discagem futura (painel e mesma regra de plano que SMS/Push)
  • Traduzir o script falado (speakText e prompt de gather) por idioma do contato
  • Webhook dedicado por chamada (options.webhook) além dos webhooks globais do workspace
  • Detectar caixa postal com amdMode (disabled, detect, premium)
  • Consultar preço por país de destino via Consulta de preços ou painel
  • Reagir ao ciclo do número (phone_number.activated, phone_number.suspended, etc.)
Detalhe de campos e erros: referência da API na aba Voz. Cobrança: Cobrança.

​
Opções extras (como nos outros canais)

Alinhado a SMS, Push e E-mail:
  • Traduzir o texto falado — o sistema fala em português, inglês ou outro idioma conforme o contato no CRM (Localização e i18n)
  • Agendar a discagem — liga depois, em data e hora futura (plano pago, igual SMS)
  • Webhook só desta chamada — eventos de uma ligação específica vão para uma URL extra
  • Metadados — tags da sua campanha ou CRM gravadas junto com a ligação
Guia de webhooks: Eventos dos webhooks.
Tradução automática vale para texto falado e menu de teclas. Áudio gravado por URL e URA publicada usam o conteúdo que você enviou — sem tradução automática nessa rota.

​
Depois da primeira ligação

  • Acompanhe por webhooks (voice.call.* e phone_number.*)
  • Monte URA com gather + voice.call.dtmf / voice.call.gather.ended
  • Teste inbound com WEBHOOK_CONTROL no número

​
Próximos passos