> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notifique.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Criar fluxo IVR (rascunho)



## OpenAPI

````yaml /es/voice-api/api-reference/openapi-voice.json post /v1/voice/flows
openapi: 3.0.3
info:
  title: Notifique API Voice
  description: >-
    Faça ligações de voz e controle chamadas em andamento. Autentique com
    `Authorization: Bearer sk_live_...` ou `x-api-key`.
  version: 1.0.0
servers:
  - url: https://api.notifique.dev
    description: Produção
security:
  - ntfVoiceBearerAuth: []
  - ntfVoiceApiKeyHeader: []
tags:
  - name: 'Voice: Chamadas'
    description: Originar, listar, consultar e controlar chamadas de voz.
  - name: 'Voice: Fluxos IVR'
    description: 'Criar, publicar e gerenciar URAs (IVR) usadas em `type: ivr`.'
paths:
  /v1/voice/flows:
    post:
      tags:
        - 'Voice: Fluxos IVR'
      summary: Criar fluxo IVR (rascunho)
      operationId: ntfVoice_postV1VoiceFlows
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - name
                - graph
              properties:
                name:
                  type: string
                description:
                  type: string
                graph:
                  type: object
                  additionalProperties: true
            example:
              name: Menu principal
              graph:
                entry: menu
                nodes:
                  - id: menu
                    type: gather
                    prompt: Pressione 1 para vendas.
                    maxDigits: 1
                    timeoutSecs: 10
                    branches:
                      '1': vendas
                    default: fim
                  - id: vendas
                    type: speak
                    text: Obrigado.
                    next: fim
                  - id: fim
                    type: hangup
      responses:
        '201':
          description: Fluxo criado em DRAFT.
components:
  securitySchemes:
    ntfVoiceBearerAuth:
      type: http
      scheme: bearer
      description: 'API Key no formato Bearer (ex.: sk_live_...).'
    ntfVoiceApiKeyHeader:
      type: apiKey
      in: header
      name: x-api-key

````