Skip to main content
As chamadas de saída permitem que você forneça um número de destino e uma configuração de agente ao ThunderPhone para que a IA faça a chamada em seu nome. Casos de uso típicos:
  • Confirmações de agendamentos
  • Retornos de pesquisas
  • Acompanhamentos de “segunda tentativa” após uma chamada perdida
  • Notificações no estilo de despacho
Vai ligar para uma lista inteira? O recurso Campanhas do painel (/dashboard/campaigns) recebe um CSV de contatos e gerencia janelas de chamada com reconhecimento de fuso horário, simultaneidade e política de tentativas para você. Este guia aborda chamadas programáticas individuais.

​
Pré-requisitos

1

Tenha um número VoIP

As chamadas de saída exigem que você seja proprietário do from_number por meio de uma conexão VoIP. Números de demonstração aceitam apenas chamadas recebidas. Consulte Use seus próprios números.
2

Crie um agente

Um prompt voltado para chamadas de saída normalmente começa com o agente se identificando e explicando seu propósito — “Olá, aqui é da Acme, ligando para confirmar seu agendamento de amanhã às 15h…” Defina outbound_speak_order como agent_first (o padrão).
3

Mantenha um saldo positivo

Chamadas de saída retornam 402 Payment Required se o saldo for ≤ $0.00. Adicione saldo via POST /v1/billing/top-up ou ative a recarga automática.

​
Faça uma chamada com um agente salvo

O caminho mais simples — referencie um agente pelo ID:
Resposta:
status: "initiated" significa apenas que a solicitação foi aceita — a chamada ainda não está conectada. Consulte GET /v1/calls/{call_id} para obter o status em tempo real (in_progress → completed / failed).

​
Faça uma chamada com configuração inline

Se você quiser um prompt pontual que não vale a pena salvar como agente, passe config em vez disso. A estrutura corresponde ao esquema de resposta do call.incoming webhook:

​
Acompanhe a chamada

Em paralelo, assine o telephony.complete webhook — a forma mais rápida de saber que uma chamada terminou. Se você não puder receber webhooks de entrada, consulte GET /v1/calls/{call_id} a cada poucos segundos; o registro inclui end_reason, duration_seconds e a URL da gravação quando a chamada termina.

​
Modos de falha que vale a pena tratar

​
Como controlar o tempo em espera

As chamadas realizadas que se prolongam porque quem atende demora para responder (árvores de URA, filas) podem ser limitadas com max_hold_seconds:
O agente encerra a chamada se nenhum áudio humano for recebido nos últimos N segundos. O padrão é 900 (15 minutos).

​
Próximas etapas

Referência de chamadas realizadas

Todos os campos de solicitação e códigos de erro.

Receber call.complete

Envie chamadas realizadas concluídas para o seu sistema.

Faturamento

Recarga automática para que chamadas realizadas nunca falhem por falta de saldo.

Testar agentes de chamadas realizadas

Faça um teste do seu agente de chamadas realizadas antes da produção.