Developer cookbook

Apstrādājiet ienākošos zvanus (API)

No sākuma līdz beigām: konfigurējiet balss aģentu, piešķiriet to tālruņa numuram, pieņemiet zvanu un pārskatiet transkriptu.

Standarta plūsma “atbildēt uz tālruni ar balss aģentu” no jūsu termināļa. Jūs:

1. Izveidosiet aģentu ar uzvedni un balsi.
2. Nodrošināsiet (vai pievienosiet) tālruņa numuru un piešķirsiet aģentu kā tā ienākošo zvanu apstrādātāju.
3. Piezvanīsiet uz numuru. Apskatīsiet zvanu žurnālu, transkriptu un ierakstu.

Kopējais API izsaukumu skaits: četri. Kopējais laiks: mazāk nekā piecas minūtes.

1. Izveidojiet aģentu#

Aģents apvieno uzvedni, balsi un produkta līmeni, kas vadīs zvanu. Visus konfigurācijas laukus skatiet sadaļā Aģenti; minimālais nepieciešamais ir:

curl -X POST https://api.thunderphone.com/v1/agents \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name":    "Acme Support",
    "prompt":  "You are a friendly support agent for Acme. Help callers with orders and returns. Keep answers short.",
    "voice":   "john",
    "product": "spark"
  }'

Saglabājiet atgriezto id — tas būs nepieciešams 2. darbībā.

2. Iegūstiet tālruņa numuru#

Ja jums vienkārši nepieciešams numurs, uz kuru zvanīt, nodrošiniet demonstrācijas numuru no ThunderPhone kopas:

curl -X POST https://api.thunderphone.com/v1/phone-numbers \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"area_code": "415"}'

Atbilde ietver id un number E.164 formātā. Demonstrācijas numuri sākas ar status="provisioning" un dažu sekunžu laikā kļūst active — aptaujājiet GET /v1/phone-numbers/{id}, lai sekotu pārejai, ja tas jums ir svarīgi.

3. Piešķiriet aģentu#

Piesaistiet 1. darbībā izveidoto aģentu numura ienākošo zvanu apstrādei:

curl -X PATCH https://api.thunderphone.com/v1/phone-numbers/{phone_id} \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"inbound_agent_id": 12}'

Tas arī viss — numurs ir aktīvs. Tajā pašā PATCH varat iestatīt arī outbound_agent_id, lai numurs būtu gatavs arī izejošajiem zvaniem.

4. Pieņemiet zvanu#

Zvaniet uz numuru no sava tālruņa. Aģents atbild, iepazīstina ar sevi atbilstoši jūsu uzvednei, un saruna sākas.

Kamēr zvans notiek, tas tiek rādīts sadaļā GET /v1/calls ar status="in_progress". Kad tas beidzas, ieraksts tiek atjaunināts ar end_reason, duration_seconds, billable_minutes un (vēlāk) ieraksta URL un MI vērtējumu.

5. Pārskatiet rezultātus#

Iegūstiet pēdējo zvanu sarakstu:

curl 'https://api.thunderphone.com/v1/calls?limit=5' \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

Iegūstiet transkriptu:

curl https://api.thunderphone.com/v1/calls/{call_id}/transcript \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

Un ieraksta URL (īslaicīgs, parakstīts):

curl https://api.thunderphone.com/v1/calls/{call_id}/audio \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

Ja esat abonējis telephony.complete tīmekļa aizķeri, saņemsiet tos pašus datus kā POST pieprasījumu savā serverī — skatiet call.complete.

Nākamās darbības#