Lista todas as vozes comerciais disponíveis no QuickerSpot para narração e vinhetas.

Utilize esta ferramenta antes de criar uma campanha ou recado para escolher o timbre de voz mais apropriado para o seu produto/anúncio.

Retorna um JSON contendo uma lista de objetos com id, elevenlabs_id e name.

Cria uma nova campanha comercial no QuickerSpot e gera o roteiro em formato texto via IA.

Esta operação é síncrona para a geração do roteiro (leva de 5 a 15 segundos). Após a criação, o estado da campanha fica como PENDING aguardando aprovação do roteiro.

Parâmetros:

• name: Nome identificador da campanha (ex: "Ofertas de Fim de Semana").

• data: Lista opcional de produtos com preços, ex: [{"product": "Detergente 500ml", "price": "R$ 2,99"}].

• voice_tone: Tom de voz desejado (ex: "Friendly", "Enthusiastic", "Professional", "Urgent"). Default: "Friendly".

• slogan: Slogan comercial da loja ou marca (opcional).

• free_text: Instrução ou texto livre em formato plain text para a IA gerar o comercial (opcional se enviar data).

• voice_id: ID da voz selecionada (consulte via list_voices) (opcional).

• background_music: Trilha sonora de fundo (opcional).

• audio_style: Estilo do áudio ("standard" | "dramatic") (opcional).

• production_mode: Modo de produção ("standard" | "ai_production") (opcional).

Retorna um JSON com os dados da campanha criada, o ID da campanha (campaign_id ou id) e os roteiros gerados.

Aprova (ou edita) o roteiro de uma campanha e dispara a produção de áudio (TTS e mixagem) em background.

Parâmetros:

• campaign_id: ID da campanha a ser aprovada.

• script: Texto do roteiro final editado (opcional). Se não informado, utiliza o roteiro gerado pela IA.

• action: Ação a realizar ("approve" para aprovar e gerar áudio, ou "regenerate" para solicitar novo roteiro). Default: "approve".

Retorna uma confirmação de que o processamento foi iniciado em background (Status 202 Accepted). Use get_campaign_status após alguns segundos para verificar a conclusão da produção.

Consulta o status atual, roteiros e links para os arquivos de áudio de uma campanha específica.

Utilize esta ferramenta para verificar se o áudio de uma campanha já terminou de ser produzido.

Status possíveis:

• PENDING: Aguardando aprovação do roteiro.

• PROCESSING: Áudio sendo gerado e mixado em background.

• COMPLETED: Áudio gerado com sucesso. As URLs dos arquivos MP3 estão disponíveis no campo audios.

• FAILED: Ocorreu uma falha durante o processamento.

Parâmetros:

• campaign_id: ID da campanha a ser consultada.

Lista todas as campanhas comerciais pertencentes ao usuário vinculado à API Key M2M.

Retorna uma lista em JSON com o histórico de campanhas, incluindo status e URLs de áudio.

Gera um áudio instantâneo de recado curto (fast-lane TTS sem fluxo de aprovação HITL).

Ideal para anúncios rápidos de loja, avisos de estacionamento, chamadas de clientes ou recados operacionais. O áudio gerado já inclui vinheta/chime sonora no início.

Parâmetros:

• text: Texto do recado a ser sintetizado (máximo 300 caracteres).

• voice_id: ID da voz (opcional).

Retorna um JSON contendo os detalhes do áudio e a URL direta para download/reprodução do MP3.