Ring utgående samtal (API)

Med utgående samtal kan du ge ThunderPhone ett destinationsnummer och en agentkonfiguration och låta AI:n ringa samtalet åt dig. Vanliga användningsområden:

Bekräftelser av bokade tider
Återuppringningar för enkäter
Uppföljningar med ett andra försök efter ett missat samtal
Aviseringar i dispatch-stil

Ringer du en hel lista? Instrumentpanelens funktion Kampanjer (/dashboard/campaigns) tar emot en CSV-fil med kontakter och hanterar tidszonsanpassade samtalsfönster, samtidighet och återuppringningspolicy åt dig. Den här guiden handlar om enskilda programmatiska samtal.

Förutsättningar

Skaffa ett VoIP-nummer

Utgående samtal kräver att du äger from_number via en VoIP-anslutning. Demnummer är endast för inkommande samtal. Se Ta med egna nummer.

Skapa en röstagent

En prompt för utgående samtal börjar ofta med att röstagenten identifierar sig själv och sitt syfte — “Hej, det här är Acme som ringer för att bekräfta din tid i morgon klockan 15…” Ange outbound_speak_order till agent_first (standardvärdet).

Ha ett positivt saldo

Utgående samtal returnerar 402 Payment Required om saldot är ≤ $0.00. Fyll på via POST /v1/billing/top-up eller aktivera automatisk påfyllning.

Ring med en sparad röstagent

Det enklaste sättet — referera till en röstagent med id:

curl -X POST https://api.thunderphone.com/v1/call \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from_number": "+15551234567",
    "to_number":   "+14155550199",
    "agent_id":    12
  }'

Svar:

{ "call_id": 987654321, "status": "initiated" }

status: "initiated" betyder bara att begäran accepterades — samtalet är inte uppkopplat ännu. Hämta GET /v1/calls/{call_id} för aktuell status (in_progress → completed / failed).

Ring med inline-konfiguration

Om du vill ha en engångsprompt som inte är värd att spara som en röstagent kan du skicka config i stället. Strukturen matchar svarsformatet för call.incoming-webhooken:

curl -X POST https://api.thunderphone.com/v1/call \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from_number": "+15551234567",
    "to_number":   "+14155550199",
    "config": {
      "prompt":  "You are confirming Jane Doe appointment for 3pm tomorrow…",
      "voice":   "john",
      "product": "spark"
    }
  }'

Följ samtalet

Prenumerera parallellt på telephony.complete-webhooken — det snabbaste sättet att få veta att ett samtal har avslutats. Om du inte kan ta emot inkommande webhooks kan du hämta GET /v1/calls/{call_id} med några sekunders mellanrum; posten innehåller end_reason, duration_seconds och inspelnings-URL:en när samtalet avslutas.

Fel som är värda att hantera

Fel	Åtgärd
`402 Payment Required`	Fyll på saldot eller aktivera automatisk påfyllning
`403` utgående samtal blockerat (demnummer)	Skaffa ett VoIP-nummer i stället
`403` utgående samtal blockerat (ej verifierat VoIP)	Kör `POST /v1/phone-numbers/{id}/verify-voip`
`404 from_number is not registered to this organization`	Bekräfta att `from_number` matchar ett telefonnummer som du äger
`502 Bad Gateway`	Tillfälligt SIP-/LiveKit-fel; det är säkert att försöka igen

Styra väntetid

Utgående samtal som drar ut på tiden eftersom den uppringda parten svarar långsamt (IVR-träd, köer) kan begränsas med max_hold_seconds:

{
  "from_number": "+15551234567",
  "to_number":   "+14155550199",
  "agent_id":    12,
  "max_hold_seconds": 120
}

Röstagenten lägger på om inget mänskligt ljud har tagits emot under de senaste N sekunderna. Standardvärdet är 900 (15 minuter).

Nästa steg

Referens för utgående samtal

Alla förfrågningsfält och felkoder.

Ta emot call.complete

Strömma avslutade utgående samtal till ditt system.

Fakturering

Automatisk påfyllning så att utgående samtal aldrig misslyckas på grund av saldo.

Testa utgående agenter

Testkör din utgående agent före produktion.

Getting Started

Using the dashboard

Connect tools & data

Analyze & improve

Team & account

Developer cookbook

Operations

Ring utgående samtal (API)

Förutsättningar

Ring med en sparad röstagent

Ring med inline-konfiguration

Följ samtalet

Fel som är värda att hantera

Styra väntetid

Nästa steg

Referens för utgående samtal

Ta emot call.complete

Fakturering

Testa utgående agenter

​Förutsättningar

​Ring med en sparad röstagent

​Ring med inline-konfiguration

​Följ samtalet

​Fel som är värda att hantera

​Styra väntetid

​Nästa steg

Referens för utgående samtal

Ta emot call.complete

Fakturering

Testa utgående agenter

Förutsättningar

Ring med en sparad röstagent

Ring med inline-konfiguration

Följ samtalet

Fel som är värda att hantera

Styra väntetid

Nästa steg