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

Veidojat savu pirmo aģentu manuāli? Informācijas panelis ved cauri tieši šai plūsmai — izveidojiet aģentu, pievienojiet numuru, simulējiet, pārskatiet — ar vadītu vedni. Sāciet ar informācijas paneļa ātro sākumu.

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

Izveidosiet aģentu ar uzvedni un balsi.
Nodrošināsiet (vai pievienosiet) tālruņa numuru un piešķirsiet aģentu kā tā ienākošo zvanu apstrādātāju.
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ā.

Vienkāršiem jautājumiem un atbildēm ar zemākajām izmaksām izvēlieties spark, bet bolt — ja vissvarīgākais ir ātrums. Ja jūsu uzvednei nepieciešama padziļinātāka spriešana un tā var pieļaut pussekundes aizpildījumu, kamēr modelis domā, pārejiet uz storm-base-with-ack. Skatiet produktu līmeņus.

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.

Ražošanas videi izlaidiet demonstrācijas numurus un pievienojiet savus numurus, izmantojot VoIP. Demonstrācijas numuri ir paredzēti tikai ienākošajiem zvaniem, un tiem ir apjoma ierobežojums.

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

Dinamiska konfigurācija katram zvanam

Izvēlieties citu balss aģentu katram zvanītājam, pamatojoties uz tālruņa numuru vai pielāgotu loģiku tīmekļa aizķerē.

Pievienojiet rīku integrācijas

Ļaujiet balss aģentam sarunas laikā izsaukt jūsu API.

Saņemiet call.complete tīmekļa aizķeres

Straumējiet katru pabeigto zvanu uz savu CRM / analītikas konveijeru.

MI vērtēšana un problēmu pārskati

Automātiski novērtējiet katru zvanu un novirziet atzīmētos zvanus pārskatīšanai.

Getting Started

Using the dashboard

Connect tools & data

Analyze & improve

Team & account

Developer cookbook

Operations

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

1. Izveidojiet aģentu

2. Iegūstiet tālruņa numuru

3. Piešķiriet aģentu

4. Pieņemiet zvanu

5. Pārskatiet rezultātus

Nākamās darbības

Dinamiska konfigurācija katram zvanam

Pievienojiet rīku integrācijas

Saņemiet call.complete tīmekļa aizķeres

MI vērtēšana un problēmu pārskati

​1. Izveidojiet aģentu

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

​3. Piešķiriet aģentu

​4. Pieņemiet zvanu

​5. Pārskatiet rezultātus

​Nākamās darbības

Dinamiska konfigurācija katram zvanam

Pievienojiet rīku integrācijas

Saņemiet call.complete tīmekļa aizķeres

MI vērtēšana un problēmu pārskati

1. Izveidojiet aģentu

2. Iegūstiet tālruņa numuru

3. Piešķiriet aģentu

4. Pieņemiet zvanu

5. Pārskatiet rezultātus

Nākamās darbības