Pesquisar artigos na Base de Dados de Conhecimento

Documentação da API do Transcritor

Documentação: API de Transcrição de Áudio - Agente de AI Transcritor

Visão Geral

A API Agente de AI Transcritor permite a transcrição automática de arquivos de áudio para texto, vinculando a transcrição diretamente aos recursos no Perfex CRM (Propostas, Orçamentos, Projetos, etc.). O processo utiliza a conversão automática de formato de áudio e a tecnologia de inteligência artificial da OpenAI para garantir precisão.

Requisição

Endpoint

POST <SEU_DOMINIO>/taffarel_dev_file_manager_plus/api/transcrever

Parâmetros do Formulário (Form Data)

Parâmetro Tipo Descrição
file Arquivo O arquivo de áudio no formato AAC a ser transcrito. Exemplo: file=@"/caminho/do/arquivo.aac"
rel_type String Tipo de recurso ao qual o arquivo será anexado. Valores possíveis: proposal, estimate, project, etc.
rel_id Inteiro ID do recurso ao qual a transcrição será vinculada. Exemplo: rel_id="1"

Exemplo de Requisição usando cURL

curl --location 'http://taffareldev.develop/taffarel_dev_file_manager_plus/api/transcrever' \
--header 'Cookie: sp_session=vbuo49ujvv91315c7jqv5b1e0mji40vg' \
--form 'file=@"/home/acer-note/CLIENTES/Edmison/valter.aac"' \
--form 'rel_type="proposal"' \
--form 'rel_id="1"'

Respostas da API

Sucesso

Status Code: 200 OK

{
  "status": "success",
  "message": "Transcrição concluída com sucesso.",
  "transcription": {
    "text": "Texto transcrito do áudio.",
    "resource": {
      "type": "proposal",
      "id": 1
    }
  }
}

Erro

Status Code: 400 Bad Request

{
  "status": "error",
  "message": "Formato de arquivo inválido. Apenas AAC é suportado."
}

Considerações Importantes

  • O formato de entrada suportado atualmente é AAC.
  • A API utiliza a tecnologia de IA da OpenAI para processamento de linguagem natural.
  • Certifique-se de que o rel_type e rel_id correspondem a recursos existentes no Perfex CRM para evitar erros.

Segurança

  • Proteja suas credenciais e mantenha as sessões seguras para evitar acessos não autorizados.

Suporte

Para dúvidas ou suporte, entre em contato com a equipe de desenvolvimento pelo site Taffarel.dev.

Você achou esse artigo útil?

Artigos relacionados