Introdução
Documentação para executar agentes de voz em produção em chamadas telefônicas reais e widgets web incorporáveis: inícios rápidos, guias e a referência completa da API do ThunderPhone.
O ThunderPhone permite criar agentes de voz com IA que fazem e atendem chamadas telefônicas reais e viabilizam conversas por microfone no seu site. A documentação é dividida em quatro abas:
Inícios rápidos, conceitos e guias práticos para o painel e a API. Comece aqui se você é iniciante.
Cada endpoint, campo de solicitação e formato de resposta.
O widget web incorporável — componente React, hook headless e tag de script CDN.
Eventos em tempo real, assinatura e semântica de entrega.
O que você pode criar
Atenda chamadas para um número seu com um agente de IA que segue seu prompt, usa suas ferramentas e transfere para humanos quando necessário.
Faça chamadas programaticamente a partir do seu código — fluxos de pesquisa, acompanhamento ou confirmação.
Adicione nosso widget web incorporável ao seu site para que clientes cliquem para falar. Não é necessário número de telefone.
Execute cenários predefinidos no seu agente em lotes para que regressões sejam detectadas antes que os clientes as ouçam.
Duas formas de começar
No painel (recomendado para seu primeiro agente) — crie uma conta e o painel orientará você em um assistente de configuração de cinco etapas: criar um agente, configurar o faturamento, adicionar um número de telefone, executar uma simulação e revisar a chamada. O início rápido do painel reproduz esse assistente passo a passo.
No terminal — o início rápido da API realiza a mesma primeira chamada em quatro chamadas REST.
- Conheça os conceitos
Conceitos — um mapa de todos os objetos que você usará e de onde cada um fica no painel.
- Execute um início rápido
Início rápido do painel ou início rápido da API — faça sua primeira chamada com um agente de IA.
- Escolha um guia
Siga um guia prático para seu cenário ou consulte a referência da API.
Explore os guias
Crie um agente, adicione saldo, obtenha um número, simule e revise chamadas.
Aplicativos OAuth, APIs personalizadas, servidores MCP e provedores de VoIP.
Relatórios, observabilidade, experimentos, problemas e alertas.
Convites e funções, chaves de API, segurança e SSO.
URL base
https://api.thunderphone.com/v1
A autenticação usa o esquema Bearer padrão do OAuth 2.0 com uma
chave de API da organização sk_live_. Sua chave identifica automaticamente a
organização de destino — não há ID da organização nos caminhos de URL. Consulte
Autenticação para detalhes.