API de chamadas com IA com especificação OpenAPI 3.1: constrói com ela hoje.
Uma API REST de pagamento por utilização para chamadas telefónicas ativas com IA, descrita numa especificação pública OpenAPI 3.1. Chaves bearer, gestão completa de contactos e campanhas, transcrições, gravações e relatórios.
O que a API do FoxEra Calls cobre
A API REST do FoxEra Calls permite que o teu próprio código, plataforma de automação ou GPT Action inicie e gira chamadas telefónicas ativas com IA. Cobre todo o ciclo de vida da campanha:
- Contactos — cria, atualiza e organiza contactos em pastas.
- Campanhas — pré-visualiza uma campanha (número de contactos, custo estimado, agente de chamadas), cria-a, agenda-a, aprova-a ou cancela-a.
- Resultados — lê o resultado de cada chamada: atendida, caixa de voz, sem resposta, e a reação do potencial cliente.
- Transcrições e gravações — obtém a transcrição completa e uma ligação à gravação de qualquer chamada concluída.
- Relatórios — resumos ao nível da campanha: total de chamadas, minutos ligados, custo, contactos interessados.
- Conta — verifica o saldo de crédito, define o horário de chamadas, escolhe o agente de IA (Cass, Alex ou Andrea), edita e aprova o guião.
A autenticação usa chaves de API bearer (formato fxk_...). Cada chave está limitada a um espaço de trabalho e pode ser revogada instantaneamente nas tuas definições para programadores.
A especificação OpenAPI 3.1
A API completa está descrita num documento OpenAPI 3.1 num URL público:
https://app.foxera.co.uk/api/public/openapi.json
Podes importar esta especificação para qualquer ferramenta que leia OpenAPI: Postman, Insomnia, Swagger UI ou o teu próprio gerador de código. É também o formato que as GPT Actions aceitam diretamente: cola o URL e o teu GPT personalizado consegue chamar a API sem escrever código de integração.
A especificação documenta cada endpoint, corpo de pedido, formato de resposta e código de erro. Se quiseres transformar a especificação em ferramentas MCP para um assistente de IA, a comparação entre MCP e chave de API explica quando cada abordagem se encaixa.
Como começar
- Cria uma conta grátis do FoxEra Calls em foxera.co.uk. As contas novas recebem £7 de crédito grátis para chamadas.
- Vai às tuas definições para programadores e gera uma chave de API. A chave começa por
fxk_e atua apenas dentro do teu espaço de trabalho. - Inclui a chave como token bearer no cabeçalho
Authorizationde cada pedido. - Começa por adicionar alguns contactos através da API e depois pré-visualiza uma campanha para ver o número de contactos e o custo estimado antes de aprovar.
A API usa convenções REST padrão: corpos de pedido e resposta em JSON, códigos de estado HTTP para os erros e paginação nos endpoints de listagem. Todos os detalhes estão no guia para programadores.
Fluxo de segurança e aprovação
A API aplica as mesmas regras de segurança que o painel e o servidor MCP:
- Número confirmado — cada campanha exige que o número exato de contactos seja confirmado antes da aprovação.
- Passo de aprovação em separado — criar uma campanha não inicia as chamadas. Tens de a aprovar explicitamente num segundo pedido.
- Horário de chamadas — as chamadas só são feitas dentro do horário que configurares. Fora desse horário, a campanha espera.
- Chaves limitadas — cada chave de API funciona apenas dentro de um espaço de trabalho. Revogar uma chave interrompe todo o acesso de imediato.
- Registo completo — cada ação da API fica registada com uma data/hora, para que possas auditar exatamente o que aconteceu e quando.
Estas regras são aplicadas do lado do servidor, independentemente do cliente ou modelo que esteja a chamar a API. Lê mais sobre as medidas de segurança para agentes de IA em chamadas ativas.
Casos de uso da API
A API é pensada para programadores e criadores de automações que querem integrar as chamadas ativas nos seus próprios sistemas:
- Integração com CRM — envia contactos novos do teu CRM para a FoxEra e recupera os resultados das chamadas, mantendo os dois sistemas sincronizados.
- Plataformas de automação — ativa uma campanha de chamadas a partir do n8n, do Make ou de um webhook do Zapier quando chega um contacto novo ao teu processo.
- GPT Actions — importa a especificação OpenAPI para um GPT personalizado para que possa gerir campanhas de forma conversacional.
- Painéis de relatórios — leva os dados de campanha para a tua própria análise ou CRM de chamadas ativas para um relatório combinado.
- Agentes personalizados — cria um agente autónomo que investiga potenciais clientes, os adiciona à FoxEra, pré-visualiza uma campanha e pede a tua aprovação antes de marcar.
Se preferires uma interface conversacional em vez de código, podes ligar o ChatGPT ou qualquer assistente através do servidor MCP.
Preços
A própria API é gratuita. Só pagas pelas chamadas que se ligam, a partir de 12p por minuto ligado, sem subscrição nem taxa de plataforma. As contas novas começam com £7 de crédito grátis para chamadas.
Cada pré-visualização de campanha mostra o custo estimado antes de aprovares, por isso não há surpresas. Compara isto com os modelos de taxa mensal por utilizador na página de preços ou usa a calculadora de custos para estimar uma campanha.
Perguntas frequentes
Onde está alojada a especificação OpenAPI?
A especificação está em https://app.foxera.co.uk/api/public/openapi.json. É pública e está sempre atualizada. Importa-a para o Postman, o Swagger UI ou qualquer ferramenta que leia OpenAPI 3.1.
Quanto custa usar a API?
A API é gratuita. Só pagas pelos minutos de chamada ligados, a partir de 12p por minuto ligado. As contas novas recebem £7 de crédito grátis para chamadas.
A API pode iniciar chamadas sem a minha aprovação?
Não. Criar uma campanha não inicia as chamadas. Tens de confirmar o número de contactos e enviar um pedido de aprovação em separado. Isto é aplicado do lado do servidor.
A API funciona com GPT Actions?
Sim. A especificação OpenAPI 3.1 pode ser importada diretamente para uma GPT Action. O teu GPT personalizado consegue então gerir contactos, campanhas e resultados de forma conversacional.