Tellia APIPara desenvolvedores
A régua de comunicação da Tellia dentro do seu produto
Envie um vídeo pela API e receba nota de 0 a 100, dimensões, régua de cenário, métricas da fala e um relatório pronto para mostrar ao seu usuário.
Sandbox grátis · pré-pago em reais, sem mensalidade · o vídeo não é guardado
curl https://www.tellia.com.br/api/v1/analises \
-H "Authorization: Bearer $TELLIA_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 9b2f6c1e-pitch-4821" \
-d '{
"uploadId": "up_4Zt9QmW2xLr7Kp1Vb8Nc3Hs6",
"fileName": "files/a1b2c3d4e5",
"duracaoSeg": 95,
"regua": "vendas",
"consentimento": {
"coletadoEm": "2026-10-30T13:58:00Z",
"versaoTexto": "consentimento-v1"
}
}'Para quem constrói
Plataformas que já têm o usuário gravando ou apresentando e querem devolver um retorno sério sobre a comunicação, sem montar um time de pesquisa para isso.
RH e recrutamento
Prepare candidatos para entrevistas e desenvolva lideranças dentro da sua plataforma. O resultado é para treino e desenvolvimento: não entra em decisão de seleção.
Edtechs e LMS
A atividade de apresentação vira retorno em poucos minutos: nota, pontos fortes, ajustes e um plano de 7 dias para o aluno treinar.
Treinamento e coaching
Meça antes e depois com a mesma régua versionada e mostre a evolução dos participantes com números, não com impressão.
Vendas
Plataformas de enablement e CRM avaliam pitches com a régua de vendas: problema do cliente, prova, objeção e próximo passo.
Como funciona
- 1
Envie o vídeo
Peça um envio em POST /v1/uploads e mande o arquivo em partes. Vídeo grande de celular passa sem problema.
- 2
Crie a análise
POST /v1/analises com a régua do cenário, o contexto da fala e o atestado do consentimento da pessoa filmada.
- 3
Receba o resultado
Um webhook assinado avisa quando fica pronta, em poucos minutos. Ou consulte GET /v1/analises/{id} quando quiser.
O que você recebe
- Nota de 0 a 100 na régua universal, com a faixa e a versão da régua.
- As 4 dimensões: clareza, domínio do assunto, segurança e engajamento.
- Régua de cenário com critérios de 0 a 4: pitch e conversa de vendas; comunicar mudança ou direção ao time; feedback e conversa difícil; atendimento a cliente insatisfeito; porta-voz e entrevista à imprensa; ensinar e explicar; respostas de entrevista de emprego.
- Métricas da fala: palavras por minuto, total de palavras e tempo até a ideia principal.
- Relatório pronto para mostrar: resumo, pontos fortes, ajustes, momentos do vídeo e plano de 7 dias.
A Tellia mede o que é observável na fala e no vídeo. Nada de diagnóstico, leitura de emoção ou de personalidade: o retorno é sobre comunicação.
{
"id": "Xb3kP9qL2mT7vR4sW8nY",
"objeto": "analise",
"status": "pronta",
"referencia": "usuario-4821",
"notaGeral": 76,
"faixa": "Bom",
"dimensoes": [
{
"id": "clareza",
"nome": "Clareza",
"nota": 82,
"faixa": "Bom"
},
{
"id": "dominioAssunto",
"nome": "Domínio do assunto",
"nota": 79,
"faixa": "Bom"
},
{
"id": "seguranca",
"nome": "Segurança",
"nota": 68,
"faixa": "Médio"
},
{
"id": "engajamento",
"nome": "Engajamento",
"nota": 74,
"faixa": "Bom"
}
],
"cenario": {
"reguaId": "vendas",
"nome": "Pitch e conversa de vendas",
"versao": "1.0",
"nota": 70,
"faixa": "consistente",
"criterios": [
{
"id": "ven-problema",
"nome": "Problema do cliente antes do produto",
"nota": 3,
"escala": 4
},
{
"id": "ven-implicacao",
"nome": "Consequência e valor quantificados",
"nota": 4,
"escala": 4
}
]
},
"metricas": {
"palavrasPorMinuto": 140,
"totalPalavras": 221,
"abertura": {
"segundosAteIdeiaPrincipal": 8,
"estimado": true,
"faixa": "direta"
}
},
"relatorio": {
"resumo": "Abre pelo problema do cliente e explica bem a solução. Falta fechar com um próximo passo claro.",
"pontosFortes": [
"Começa pela dor do cliente, antes de falar do produto."
],
"ajustes": [
"Termine com um pedido concreto: data e horário da demonstração."
]
}
}Preços
Por análise completa, pré-pago em reais. Cada análise desconta do saldo o valor da sua faixa.
Sandbox: grátis
Chave de teste com as mesmas rotas e o mesmo formato de resposta. Respostas simuladas, custo zero, nada vai para a IA.
Pré-pago
R$ 149 por análise
Compre saldo e use quando quiser. Sem mensalidade e sem contrato.
Criar conta500 ou mais por mês
R$ 119 por análise
Para quem já roda em volume. A faixa é definida com a equipe pelo volume mensal.
Falar com a equipe2.000 ou mais por mês
R$ 99 por análise
Para plataformas grandes. A faixa é definida com a equipe pelo volume mensal.
Falar com a equipeNegociado
a partir deR$ 79 por análise
Volume alto ou condição especial (selo, faturamento, contrato). Fale com a equipe.
Falar com a equipe- Saldo comprado pelo painel, com Pix, boleto ou cartão. A primeira compra é de pelo menos R$ 7.450 (50 análises no pré-pago); as seguintes, a partir de R$ 1.490.
- O saldo vale por 12 meses a partir da compra. Saldo vencido não volta com uma compra nova.
- Cada análise completa aceita vídeo de até 10 minutos e 1 GB.
- Falha nossa devolve o valor ao saldo, sozinha.
LGPD de fábrica
O vídeo não é guardado
Ele passa pelo processamento e é apagado assim que as medições são extraídas. Ficam só os dados da análise, por até 12 meses (então são apagados sozinhos), e você apaga antes pela API quando quiser.
Consentimento atestado
Toda criação informa quando a pessoa filmada consentiu e qual texto ela aceitou. A documentação traz um texto modelo pronto para usar.
Contrato de operador
Você é o controlador e a Tellia é a operadora. Está tudo nos Termos da API, com suboperadores, prazos e incidentes.
Cada chave aparece uma única vez, na criação; a Tellia guarda só o hash dela. Política de Privacidade.
Em breve na API
Métricas levesEm breve
As medições da fala, sem o relatório completo.
EntrevistaEm breve
Avaliação do conteúdo das respostas, só pela fala.
ReuniõesEm breve
Ata e leitura da condução de reuniões gravadas.
Perguntas frequentes
Preciso pagar para testar?+
Não. Crie a conta, aceite os Termos da API e gere uma chave de teste. O sandbox usa as mesmas rotas e devolve o mesmo formato, com respostas simuladas e custo zero.
Quanto tempo leva uma análise?+
Em geral, poucos minutos depois do envio. Você recebe o webhook analise.concluida quando fica pronta e não precisa consultar em laço.
Posso chamar a API direto do navegador ou do app?+
Não com a sua chave. A chave é um segredo do seu servidor: o app do usuário fala com o seu back-end, e o seu back-end fala com a Tellia.
A nota é comparável entre análises?+
A régua universal é versionada e é a única comparável entre análises. Cada resultado traz a versão da régua usada, então você sabe quando uma comparação vale.
Posso usar para decidir uma contratação?+
Não. A análise completa considera expressões do rosto e da voz, que não podem entrar em processo seletivo, e nenhum resultado pode decidir sozinho sobre uma pessoa (Termos da API, seção 4). Use para treino e desenvolvimento, como preparar candidatos para entrevistas.
E se a análise falhar?+
Se a falha for nossa, o valor volta sozinho ao saldo e você recebe o evento analise.falhou.
Quais vídeos a API aceita?+
MP4, WebM, MOV e MKV, com até 10 minutos e 1 GB. O vídeo do celular já serve.
Comece pelo sandbox
Em poucos minutos você cadastra a empresa, aceita os Termos da API, gera a chave de teste e faz a primeira chamada. A produção é liberada pela equipe.
Quer ver antes como é a integração? Guia de 5 minutos
Fale com a equipe
Volume alto, faixa de escala, contrato ou dúvida técnica: respondemos em até 1 dia útil.