stream_url1 pernaO áudio entra e sai de um WebSocket seu, em tempo real. É o caminho do agente de voz.
A perna telefônica para software que precisa falar com pessoas.
Crédito de cortesia. Sem mensalidade.
curl -X POST https://api.callface.ai/v1/calls \
-H "Authorization: Bearer sk_test_..." \
-d '{
"to": "+5511987654321",
"stream_url": "wss://meu-agente.app/voz"
}'{
"id": "call_01J8ZQK4M2",
"status": "queued",
}Por que confiar na rede
Interconexão direta com mais de 20 operadoras, roteamento e mídia operados por nós, em datacenter no Brasil — não é revenda de trunk, não é wrapper sobre plataforma estrangeira.
Já roda em produção para



Uma chamada, uma terminação
Cada chamada declara exatamente uma. É a única decisão de arquitetura que você precisa tomar.
stream_url1 pernaO áudio entra e sai de um WebSocket seu, em tempo real. É o caminho do agente de voz.
connect_to2 pernasA plataforma liga para o destino e, quando alguém atende, faz a ponte com um número seu. Sem você operar a originação.
O que a rede de operadoras permite
Por causa da interconexão direta com operadoras locais, toda chamada já sai com identificação atribuída pelo DDD do destino — sem você comprar, alugar ou gerenciar numeração. É comportamento de fábrica, não obrigação: quando você já tem numeração própria, dá para usar ela.
Número que a pessoa reconhece é atendido. Número estranho não é.
Gerados do mesmo OpenAPI, versionados junto com a API
import { Callface } from "@callface/node";
const callface = new Callface({ apiKey: process.env.CALLFACE_API_KEY });
const call = await callface.calls.create({
to: "+5511987654321",
stream_url: "wss://meu-agente.app/voz",
});
console.log(call.id, call.status);Ciclo de vida
Resposta em milissegundos com status queued. O desfecho chega depois no seu endpoint, em call.ended, assinado com HMAC.
POST https://meu-app.com/webhooks/callface
X-Callface-Signature: t=1756650131,v1=9f2c...{
"type": "call.ended",
"call_id": "call_01J8ZQK4M2",
"outcome": "answered",
"duration_seconds": 47,
"caller_id": "+551130428700",
"cost_brl": "0.0627"
}Atribuída pelo DDD do destino, sem você gerenciar numeração.
HMAC em todo call.ended, verificação em 10 linhas.
O plano de controle inteiro roda sem sair para a rede telefônica.
Reserva na originação, liquidação pelo tempo falado.
stream_urlA perna telefônica para o seu cérebro.
Liga, confirma, cai no calendário.
Chamada com identificação que a pessoa atende.
Liga assim que o lead entra, enquanto ele lembra de ter preenchido o formulário.
Liga para o destino e passa para um humano só quando atende.
connect_toConta por e-mail, chave de teste e crédito de cortesia. Sem cartão.
Não. A conta abre por e-mail e já vem com crédito de cortesia.
Crédito pré-pago em reais, cobrado por segundo falado. Chamada não atendida não custa nada.
R$ 0,08 por minuto. A medição é por segundo, então você paga pelo tempo que a chamada durou de fato — não pelo minuto arredondado.
Sim, via connect_to: a plataforma liga para o destino e faz a ponte com um número seu.
É nossa. Asterisk, roteamento e mídia operados por nós — já em produção antes de existir agente de voz.
Sim, para todo o país.