Skip to main content
Met uitgaand bellen kun je ThunderPhone een bestemmingsnummer en een agentconfiguratie geven, waarna de AI namens jou het gesprek voert. Veelvoorkomende toepassingen:
  • Afspraakbevestigingen
  • Terugbellen voor enquêtes
  • Opvolging bij een “tweede poging” na een gemiste oproep
  • Meldingen in dispatchstijl
Een hele lijst bellen? De functie Campagnes van het dashboard (/dashboard/campaigns) verwerkt een CSV met contacten en regelt tijdzonebewuste belvensters, gelijktijdigheid en het beleid voor opnieuw proberen voor je. Deze gids behandelt afzonderlijke programmatische oproepen.

​
Vereisten

1

Zorg voor een VoIP-nummer

Voor uitgaand bellen moet je eigenaar zijn van het from_number via een VoIP-verbinding. Demonummers zijn alleen voor inkomende gesprekken. Zie Gebruik je eigen nummers.
2

Maak een agent

Een prompt voor uitgaande gesprekken begint meestal met de agent die zichzelf en het doel identificeert — “Hallo, je spreekt met Acme om je afspraak voor morgen om 15.00 uur te bevestigen…” Stel outbound_speak_order in op agent_first (de standaardwaarde).
3

Houd een positief saldo aan

Uitgaande oproepen retourneren 402 Payment Required als het saldo ≤ $0.00 is. Waardeer op via POST /v1/billing/top-up of schakel automatisch opwaarderen in.

​
Plaats een oproep met een opgeslagen agent

De eenvoudigste manier — verwijs naar een agent op id:
Antwoord:
status: "initiated" betekent alleen dat de aanvraag is geaccepteerd — de oproep is nog niet verbonden. Poll GET /v1/calls/{call_id} voor de actuele status (in_progress → completed / failed).

​
Plaats een oproep met inlineconfiguratie

Als je een eenmalige prompt wilt die het niet waard is om als agent op te slaan, geef dan config door. De structuur komt overeen met het antwoordschema van de call.incoming-webhook:

​
Volg de oproep

Abonneer je parallel hierop op de telephony.complete-webhook — de snelste manier om te weten dat een oproep is beëindigd. Als je geen inkomende webhooks kunt ontvangen, poll dan elke paar seconden GET /v1/calls/{call_id}; het record bevat end_reason, duration_seconds en de opname-URL zodra de oproep eindigt.

​
Foutmodi die je moet afhandelen

​
De wachttijd beheren

Uitgaande oproepen die lang duren doordat de gebelde partij traag reageert (IVR-menu’s, wachtrijen) kun je beperken met max_hold_seconds:
De agent verbreekt de oproep als er in de afgelopen N seconden geen menselijke audio is ontvangen. De standaardwaarde is 900 (15 minuten).

​
Volgende stappen

Referentie voor uitgaande oproepen

Elk aanvraagveld en elke foutcode.

call.complete ontvangen

Stream voltooide uitgaande oproepen naar je systeem.

Facturering

Automatisch opwaarderen zodat uitgaande oproepen nooit mislukken door onvoldoende saldo.

Uitgaande agenten testen

Test je uitgaande agent droog voordat je naar productie gaat.