IVR é a URA telefônica: menu de áudio, coleta de teclas, transferência e gravação — sem código na hora da ligação, só apontando para um fluxo publicado.
Em poucas palavras
- Crie um fluxo (
DRAFT) com o grafo de nós.
- Publique (
POST .../publish) → status PUBLISHED.
- Origine com
type: "ivr" e payload.flowId.
Escopo de escrita: voice:write. Leitura e disparo: voice:read / voice:call.
Rotas de fluxos (/v1/voice/flows)
Criar um fluxo
Resposta (201)
Publicar
Somente fluxos PUBLISHED podem ser usados em POST /v1/voice/calls.
IVR inline (sem salvar fluxo)
Envie o grafo completo em payload.flow (mesma estrutura de graph acima). Útil para automações com grafo embutido.
Tipos de nó
Um nó record na URA liga gravação na operadora mesmo que record: false na chamada. Use só quando precisar.
Configure o número com inboundVoiceAction: "IVR_FLOW" e associe um fluxo publicado no painel ou via PATCH /v1/phone-numbers/:id (quando disponível no recurso).
Próximos passos