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

# Reproduzir áudio na chamada

> Transmite um arquivo de áudio para uma chamada ativa. Aceita este corpo JSON (`filePath` no servidor) ou um upload `multipart/form-data` com os campos `callId`, `audio` (ou `file`) e `hangupAfterPlay`.



## OpenAPI

````yaml openapi.evolution-go.pt.json POST /call/media/play
openapi: 3.1.0
info:
  title: Evolution GO Layer
  version: 1.0.0
  description: >-
    Camada de API do Pilot Status — Evolution GO. Base URL
    `https://pilotstatus.com.br/api/layer/evolution-go`. Autentique com o header
    `apikey` (sua chave `ps_` do Pilot Status) ou `Authorization: Bearer`.
    Endpoints de instância/sessão NÃO estão disponíveis na camada.
servers:
  - url: https://pilotstatus.com.br/api/layer/evolution-go
security:
  - apiKey: []
tags:
  - name: Chamada (voz)
  - name: Chat
  - name: Comunidade
  - name: Grupo
  - name: Etiqueta (label)
  - name: Mensagem
  - name: Newsletter / Canais
  - name: Envio (balanceado)
  - name: Usuário / Contatos
paths:
  /call/media/play:
    post:
      tags:
        - Chamada (voz)
      summary: Reproduzir áudio na chamada
      description: >-
        Transmite um arquivo de áudio para uma chamada ativa. Aceita este corpo
        JSON (`filePath` no servidor) ou um upload `multipart/form-data` com os
        campos `callId`, `audio` (ou `file`) e `hangupAfterPlay`.
      operationId: post__call_media_play
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                callId:
                  type: string
                  description: Identificador da chamada ativa em que reproduzir.
                  example: 3EB0C767D26A8B4E7F1A
                filePath:
                  type: string
                  description: >-
                    Caminho no servidor para o arquivo de áudio (`.mp3`, `.wav`
                    ou `.opus`).
                  example: /audios/greeting.mp3
                hangupAfterPlay:
                  type: boolean
                  description: >-
                    Quando `true`, encerra a chamada automaticamente assim que a
                    reprodução termina. O padrão é `false`.
                  example: true
              required:
                - callId
                - filePath
      responses:
        '200':
          description: Sucesso — corpo de resposta nativo do provedor.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Operation status, always "success" on 200
                  data:
                    type: object
                    description: >-
                      Only present for multipart/form-data uploads; absent for
                      JSON (filePath) requests
                    properties:
                      source:
                        type: string
                        description: Origin of the played audio, e.g. "multipart"
                      filePath:
                        type: string
                        description: Server-side temp path of the uploaded audio file
              example:
                message: success
        default:
          description: Erro — erro do provedor ou da camada.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                  error:
                    type: string
                  message:
                    type: string
                  response:
                    type: object
              example:
                status: 400
                error: Bad Request
                message: Invalid payload
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: apikey
      description: >-
        Your Pilot Status API key (ps_...). Evolution GO also accepts
        `Authorization: Bearer <key>`.

````