Integração Telefônica & PABX ONVOX
Padronização de saída, bloco canônico de metadados CDR e entrega segura de gravação da telefonia Onvox.
Integração Telefônica & PABX ONVOX
A integração com o ecossistema de telefonia ONVOX padroniza a entrega de dados das chamadas analisadas pela Onvox AI, enriquecendo o dossiê da análise com metadados originais de bilhetagem (CDR) e link direto para reprodução de áudio.
1. Identificação do Provedor na Saída
Nas respostas da API (GET /api/analyses/:id), no Dossiê Público e nos eventos de Webhook (analysis.completed):
source:"onvox"provider:"onvox"externalCallId: O identificador numérico da chamada (ex.:"1784291064.69"), sem prefixos de armazenamento interno.
2. Bloco Canônico onvox
Quando a análise se origina de uma chamada telefônica Onvox, o objeto onvox é adicionado ao JSON com os dados originais:
{
"onvox": {
"call_id": "1784291064.69",
"call_from_name": "Helena Pereira",
"call_from_number": "1018",
"call_to": "4532408500",
"record_file": "20260717092426-1784291064.69-1018-4532408500-Outbound.wav"
}
}Dicionário de Campos
| Campo | Tipo | Descrição |
|---|---|---|
call_id | string | null | ID único da ligação no CDR do PABX |
call_from_name | string | null | Nome do agente ou ramal de origem |
call_from_number | string | null | Número do ramal que originou/atendeu |
call_to | string | null | Número de destino / telefone do cliente |
record_file | string | null | Nome do arquivo original gravado pelo PABX |
3. Entrega de Áudio Segura (audioUrl)
O áudio da gravação é mantido no armazenamento seguro (MinIO/S3). Ao consultar a análise ou receber o webhook, o campo audioUrl retorna uma URL pré-assinada (presigned URL) com validade temporária para streaming ou download direto no CRM/player do cliente:
{
"audioUrl": "https://storage.evoluai.com.br/evoluai-media/integrations/onvox/comp_1001/uuid.wav?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600&X-Amz-Signature=...",
"audioDurationSeconds": 184
}