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

# Enviar mensagem de audio.

> Envia arquivos de áudio (mp3, ogg, opus) via WhatsApp.

<Badge size="lg" shape="rounded" color="blue" stroke color="blue">POST</Badge> /message/audio

<CodeGroup>
  ```javascript Node.js theme={null}
  await zap.sendMessageAudio('my-session-id', {
    to: '5564999999999',
    audioUrl: 'https://files.loce.io/promo.mp3'
  });
  ```

  ```python python.py theme={null}
  zap = LoceZap(API_KEY)
  zap.send_message_audio(SESSION_ID, "5564999999999", "https://files.loce.io/audio.mp3")
  ```

  ```curl curl theme={null}
  curl -X POST https://<sua-api>/v1/message/audio \
    -H "Authorization: Bearer <seu_token_jwt>" \
    -H "Content-Type: application/json" \
    -d '{
      "sessionId": "sessao-123",
      "phone": "5511999998888",
      "audioUrl": "https://meuservidor.com/audio.ogg",
      "ptt": true,
      "quoteId": "wamid.HBgMMQ=="
    }'
  ```
</CodeGroup>

* `ptt` `true` envia como áudio gravado (push-to-talk). Se `false`, o envio é como arquivo de áudio comum.


## OpenAPI

````yaml POST /message/audio
openapi: 3.1.0
info:
  title: Loce Zap API
  description: >-
    API REST para conectar sessões do WhatsApp e enviar mensagens de texto,
    mídia e automações via Loce Zap.
  version: 1.0.0
servers:
  - url: https://apizap.loce.io/v1
    description: Ambiente de produção
security:
  - bearerAuth: []
paths:
  /message/audio:
    post:
      summary: Enviar áudio
      description: Envia arquivos de áudio (mp3, ogg, opus) via WhatsApp.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AudioMessageRequest'
      responses:
        '200':
          description: Mensagem de áudio enfileirada.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageResponse'
components:
  schemas:
    AudioMessageRequest:
      allOf:
        - $ref: '#/components/schemas/MessageBase'
        - type: object
          required:
            - audioUrl
          properties:
            audioUrl:
              type: string
              format: uri
              description: URL pública do arquivo de áudio (.mp3, .ogg, .opus).
    MessageResponse:
      type: object
      properties:
        messageId:
          type: string
        sessionId:
          type: string
        phone:
          type: string
        type:
          type: string
        status:
          type: string
        quoteId:
          type: string
        createdAt:
          type: string
          format: date-time
    MessageBase:
      type: object
      required:
        - sessionId
        - phone
      properties:
        sessionId:
          type: string
          description: Sessão que enviará a mensagem.
        phone:
          type: string
          description: Destino no formato MSISDN com DDI e DDD.
        quoteId:
          type: string
          description: ID da mensagem original quando for uma resposta.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key

````