Especificações técnicas

Tudo o que as equipas técnicas precisam para avaliar a IdentityCall: formatos de ficheiro, capacidades da API, métodos de integração, segurança e conformidade.

Suporte de áudio e ficheiros

Especificação	Detalhes
Formatos suportados	MP3, WAV, M4A, FLAC, OGG, WebM, MP4 (áudio extraído)
Tamanho máximo de ficheiro	2 GB por ficheiro
Duração mínima de áudio	Qualquer duração para transcrição; 3+ segundos para a biometria de voz
Taxa de amostragem	8kHz – 48kHz (16kHz+ recomendado para uma precisão ótima)
Canais	Mono e estéreo suportados; os canais estéreo são processados de forma independente
Codificação	Deteção e conversão automáticas de formato; sem necessidade de pré-processamento

Idiomas suportados (50+)

Árabe
Neerlandês
Hindi
Polaco
Bengali
Inglês
Húngaro
Português
Búlgaro
Filipino
Indonésio
Romeno
Catalão
Finlandês
Italiano
Russo
Chinês (mandarim)
Francês
Japonês
Eslovaco
Chinês (cantonês)
Alemão
Coreano
Espanhol
Croata
Grego
Malaio
Sueco
Checo
Guzerate
Norueguês
Tâmil
Dinamarquês
Hebraico
Persa
Turco, Ucraniano, + mais

Referência da API

API RESTful com respostas em JSON. Todos os endpoints exigem autenticação e devolvem formatos de erro consistentes.

Autenticação

Tipo	Autenticação por token Bearer
Cabeçalho	Authorization: Bearer <YOUR_API_KEY>
Gestão de chaves	Gere e revogue chaves a partir do painel
Âmbitos	As chaves podem ser limitadas a projetos específicos ou a acesso total à conta

Endpoints principais

POST /api/v1/public/recordings	Carregar ficheiro de áudio para processamento
GET /api/v1/public/recordings/{id}	Obter o estado e os metadados da gravação
GET /api/v1/public/recordings/{id}/transcription	Obter a transcrição completa com diarização de locutores
GET /api/v1/public/recordings/{id}/results	Pontuações de objetivos, categorias, campos extraídos, identificação de locutor
GET /api/v1/public/recordings/{id}/summary	Resumo da chamada gerado por IA
GET /api/v1/public/projects	Listar e gerir projetos
GET /api/v1/public/operators	Gerir operadores (agentes)
GET /api/v1/public/virtual_numbers/available	Explorar números de telefone disponíveis para compra
POST /api/v1/public/virtual_numbers/purchase	Comprar um número de telefone

Webhooks

recording.analyzed

Disparado quando o processamento termina - transcrição, pontuação e análise concluídas. O payload inclui as secções que ativar: metadados, resumo, transcrição, objetivos, categorias, dados extraídos.

Formato da resposta

								{
  "data": {},
  "meta": {
    "request_id": "req_abc123",
    "processing_time_ms": 1250
  }
}

Formato da resposta

								{
  "error": {
    "code": "invalid_audio_format",
    "message": "Unsupported file format. See documentation for supported formats.",
    "request_id": "req_abc123"
  }
}

Limites de taxa

Plano	Limite
Starter	Varia consoante o plano - ver preços
Professional	Limites mais altos com margem para picos
Enterprise	Limites personalizados disponíveis

Métodos de integração

Várias formas de ligar a IdentityCall à sua infraestrutura atual. Escolha com base no seu caso de uso e nos seus requisitos técnicos.

API de upload de ficheiros

Ideal para

Processamento em lote, análise de histórico, gravações de qualquer fonte

Como funciona

Envie ficheiros de áudio por POST para /api/v1/public/recordings. Receba um webhook ou consulte os resultados.

Formatos

Todos os formatos de áudio suportados até 2GB

Processamento

Assíncrono - o upload devolve de imediato, os resultados são entregues via webhook

Números virtuais (rastreio em direto)

Ideal para

Rastreio de chamadas em tempo real, atribuição de marketing, call centers de receção

Como funciona

Aprovisione números via API ou painel. As chamadas são gravadas e processadas automaticamente.

Tipos de número

Números locais e gratuitos disponíveis

Funcionalidades

Saudações, encaminhamento de chamadas, webhooks em tempo real, atribuição de origem

Receção por SFTP

Ideal para

Sistemas PBX existentes, contact centers e gravadores que exportam ficheiros de áudio

Como funciona

O seu sistema coloca as gravações numa pasta SFTP dedicada; a IdentityCall importa-as e processa-as automaticamente

Requisitos

Qualquer sistema que consiga exportar gravações por SFTP

Configuração

Credenciais de SFTP aprovisionadas no painel

Integrações diretas

HubSpot

Integração nativa - os dados das chamadas fluem para a cronologia do contacto

Salesforce

Em breve - sincronize transcrições, perfis e análises com os registos

Pipedrive

Em breve - resultados e resumos de chamadas nos seus negócios

Slack

Notificações e resumos para os canais

Telnyx

Suporta os números virtuais - aprovisionamento, gravação e webhooks

Integração personalizada

Webhooks

Notificações de eventos em tempo real para os seus endpoints

REST API

Acesso programático total a todas as funcionalidades

Formatos de exportação

JSON, CSV para transcrições e análises

Relatórios agendados

Entrega de relatórios por email numa periodicidade semanal ou mensal

Segurança e conformidade

Segurança de nível empresarial com quadros de conformidade para setores regulados.

Certificações e normas

ISO 27001	Certificado - sistema de gestão de segurança da informação
GDPR	Conforme - regulamento de proteção de dados da UE (RGPD)
CCPA	Conforme - California Consumer Privacy Act
HIPAA	Disponível como extra para clientes da área da saúde

Encriptação

Em trânsito	TLS 1.3 para todo o tráfego da API e da web
Em repouso	Encriptação AES-256 para os dados armazenados
Gestão de chaves	Chaves geridas através de um serviço seguro de gestão de chaves

Infraestrutura

Alojamento	Centros de dados dedicados na UE (Hetzner, Finlândia)
Arquitetura	Isolamento da base de dados em rede privada, cargas de trabalho em Docker
Monitorização	Monitorização e alertas automatizados 24/7
Cópias de segurança	Cópias de segurança diárias automatizadas com recuperação para um ponto no tempo

Controlo de acesso

Autenticação	Email/palavra-passe com suporte para MFA, Google OAuth 2.0
Acesso baseado em funções (RBAC)	Funções Owner, Admin e Member com permissões granulares
Limitação de chaves de API	As chaves podem ser restringidas a projetos específicos
Registos de auditoria	Todos os acessos e alterações são registados com marcas temporais

Segurança dos dados de voz

Embeddings de voz	Armazenados como vetores de 256 dimensões - não podem ser revertidos para recriar áudio
Retenção de áudio	Configurável por projeto; os embeddings de voz podem ser retidos após a eliminação do áudio
Eliminação de dados	Eliminação total a pedido; os embeddings podem ser removidos de forma independente

Funcionalidades de conformidade

Pedidos dos titulares dos dados	Endpoints da API para pedidos de acesso, exportação e eliminação
Gestão de consentimento	Fluxos de trabalho de aviso de gravação e de consentimento
Residência dos dados	Todos os dados dos clientes alojados na UE
Acordos de tratamento	DPA disponível para conformidade com o RGPD

Tratamento de dados

Controlo total sobre a forma como os seus dados são armazenados, retidos e exportados.

Retenção de dados

Gravações de áudio	30, 90, 365 dias, ou indefinido - configurável por projeto
Transcrições	Segue a retenção do áudio ou é retida de forma independente
Embeddings de voz	Podem ser retidos após a eliminação do áudio para um reconhecimento de locutor contínuo
Análises e pontuações	Retidas com a transcrição ou exportadas de forma independente
Registos de auditoria	Retidos durante o período de conformidade (mínimo de 1 ano)

Residência dos dados

Região de alojamento	União Europeia - centros de dados na Finlândia
Armazenamento de objetos	Cópias de segurança encriptadas em armazenamento compatível com S3 (Cloudflare R2)
Isolamento de dados	A base de dados corre numa rede privada, inacessível a partir da Internet pública

Opções de exportação

JSON	Acesso programático, respostas da API, payloads de webhook
CSV	Análise em folha de cálculo, importações para ferramentas de BI
PDF	Resumos de transcrição legíveis por humanos
Transcrição em bruto	Texto simples com marcas temporais

Eliminação de dados

Gravação individual	Eliminar via painel ou API
Perfil de voz	Remover o perfil e todos os embeddings associados
Projeto completo	Eliminar todas as gravações, perfis e análises
Encerramento da conta	Todos os dados eliminados permanentemente no prazo de 30 dias

Recursos adicionais

Documentação completa da API	/api-docs
Visão geral de segurança	/security
Preços e planos	/pricing
Contactar vendas	/contact

Pronto para avaliar?

Comece uma avaliação gratuita para testar a nossa API com o seu próprio áudio. Acesso total, sem necessidade de cartão de crédito.

Começar avaliação gratuita Falar com vendas