Skip to main content
Udgående opkald lader dig overdrage et destinationsnummer og en agentkonfiguration til ThunderPhone og lade AI’en foretage opkaldet på dine vegne. Typiske anvendelser:
  • Aftalebekræftelser
  • Opfølgende opkald til undersøgelser
  • “Andet forsøg”-opfølgninger efter et ubesvaret opkald
  • Notifikationer i dispatch-stil
Ringer du til en hel liste? Dashboardets funktion Kampagner (/dashboard/campaigns) tager en CSV med kontakter og håndterer opkaldsvinduer med tidszonehensyn, samtidighed og genforsøgspolitik for dig. Denne vejledning dækker enkelte programmatisk foretagne opkald.

Forudsætninger

1

Tilføj et VoIP-nummer

Udgående opkald kræver, at du ejer from_number via en VoIP-forbindelse. Demo-numre er kun til indgående opkald. Se Medbring dine egne numre.
2

Opret en agent

En prompt til udgående opkald starter typisk med, at agenten identificerer sig selv og sit formål — “Hej, det er Acme, der ringer for at bekræfte din aftale i morgen kl. 15…” Angiv outbound_speak_order til agent_first (standardindstillingen).
3

Hold en positiv saldo

Udgående opkald returnerer 402 Payment Required, hvis saldoen er ≤ $0.00. Fyld saldoen op via POST /v1/billing/top-up eller aktiver automatisk genopfyldning.

Foretag et opkald med en gemt agent

Den enkleste metode — referer til en agent via id:
Svar:
status: "initiated" betyder blot, at anmodningen blev accepteret — opkaldet er endnu ikke forbundet. Forespørg GET /v1/calls/{call_id} for live-status (in_progresscompleted / failed).

Foretag et opkald med indlejret konfiguration

Hvis du vil bruge en engangsprompt, som ikke er værd at gemme som en agent, skal du sende config i stedet. Strukturen svarer til svarskemaet for call.incoming webhook:

Følg opkaldet

Abonner parallelt på telephony.complete webhook — den hurtigste måde at vide, at et opkald er afsluttet. Hvis du ikke kan modtage indgående webhooks, skal du forespørge GET /v1/calls/{call_id} hvert par sekunder; posten indeholder end_reason, duration_seconds og optagelsens URL, når opkaldet afsluttes.

Fejltilstande, der er værd at håndtere

Styring af ventetid

Udgående opkald, der varer længe, fordi den kaldte part er langsom til at svare (IVR-træer, køer), kan begrænses med max_hold_seconds:
Agenten lægger på, hvis der ikke er modtaget menneskelig lyd i de seneste N sekunder. Standardværdien er 900 (15 minutter).

Næste trin

Reference for udgående opkald

Alle anmodningsfelter og fejlkoder.

Modtag call.complete

Stream afsluttede udgående opkald til dit system.

Fakturering

Automatisk optankning, så udgående opkald aldrig fejler på grund af saldoen.

Test udgående agenter

Kør en prøvekørsel af din udgående agent før produktion.