Skip to main content
Criando seu primeiro agente manualmente? O dashboard orienta este fluxo exato — criar o agente, adicionar um número, simular, revisar — com um assistente guiado. Comece pelo início rápido do dashboard.
O fluxo canônico de “atender um telefone com uma IA”, pelo seu terminal. Você vai:
  1. Criar um agente com um prompt e uma voz.
  2. Provisionar (ou trazer) um número de telefone e atribuir o agente como seu atendente de chamadas recebidas.
  3. Ligar para o número. Observe o registro da chamada, a transcrição e a gravação.
Total de chamadas à API: quatro. Tempo total: menos de cinco minutos.

​
1. Crie um agente

Um agente reúne o prompt, a voz e o nível de produto que conduzirão a chamada. Consulte Agentes para ver todos os campos de configuração; o mínimo é:
Salve o id retornado — você precisará dele na etapa 2.
Escolha spark para perguntas e respostas simples com o menor custo, ou bolt quando a velocidade for mais importante. Atualize para storm-base-with-ack quando seu prompt precisar de raciocínio mais profundo e puder tolerar um preenchimento de meio segundo enquanto o modelo pensa. Consulte os níveis de produto.

​
2. Obtenha um número de telefone

Se você só precisa de algo para testar ligando, provisione um número de demonstração do pool do ThunderPhone:
A resposta inclui um id e um number no formato E.164. Os números de demonstração começam com status="provisioning" e se tornam active em poucos segundos — consulte GET /v1/phone-numbers/{id} para acompanhar a transição, se necessário.
Para produção, ignore os números de demonstração e traga seus próprios números via VoIP. Os números de demonstração aceitam apenas chamadas recebidas e têm volume limitado.

​
3. Atribua o agente

Associe o agente da etapa 1 à direção de chamadas recebidas do número:
Pronto — o número está ativo. Você também pode definir outbound_agent_id no mesmo PATCH para que o número também esteja pronto para realizar chamadas.

​
4. Atenda uma chamada

Ligue para o número pelo seu telefone. O agente atende, se apresenta conforme o seu prompt e a conversa começa. Enquanto a chamada está em andamento, ela aparece em GET /v1/calls com status="in_progress". Quando termina, o registro é atualizado com end_reason, duration_seconds, billable_minutes e, posteriormente, uma URL de gravação e uma avaliação de IA.

​
5. Inspecione os resultados

Busque a lista de chamadas recentes:
Obtenha a transcrição:
E a URL da gravação (temporária e assinada):
Se você tiver assinado o webhook telephony.complete, receberá os mesmos dados como um POST para o seu servidor — consulte call.complete.

​
Próximas etapas

Configuração dinâmica por chamada

Escolha um agente diferente para cada pessoa que liga com base no número de telefone ou em uma lógica personalizada em um webhook.

Adicionar integrações de ferramentas

Permita que o agente chame suas APIs durante a conversa.

Receber webhooks de call.complete

Envie cada chamada concluída para seu pipeline de CRM / análise.

Avaliação por IA e relatórios de problemas

Avalie automaticamente todas as chamadas e encaminhe as sinalizadas para revisão.