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

Pilns process: konfigurējiet balss aģentu, piesaistiet to tālruņa numuram, pieņemiet zvanu un pārskatiet transkriptu.

Standarta plūsma „atbildēt uz tālruni ar MI” 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, transkripciju un ierakstu.

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

1. Izveidojiet aģentu#

Balss aģents apvieno uzvedni, balsi un produkta līmeni, kas nodrošinās zvanu. Balss aģentam varat arī iestatīt zvanu ierobežojumus, piemēram, max_call_duration_seconds un ring_duration_seconds. Balss aģenti atbalsta arī intro_clip un intro_ring_count, lai pirms balss aģenta uzrunas atskaņotu iepriekš ierakstītu ievadu un līdz diviem zvana signāliem. Jaunajiem balss aģentiem ir nepieciešama arī laika josla. Ja jūsu balss aģents ir daudzvalodu, varat iestatīt language_switching, lai noteiktu, vai tas pirms valodas maiņas jautā vai pielāgojas zvanītāja valodai. Visus konfigurācijas laukus skatiet sadaļā Aģenti; minimālā konfigurācija 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 nepieciešams tikai numurs, uz kuru zvanīt, iegūstiet ThunderPhone numuru no ThunderPhone numuru 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"}'

Atbildē ir id un number E.164 formātā. ThunderPhone numuru sākotnējais status="provisioning" kļūst par active dažu sekunžu laikā — ja tas jums ir svarīgi, aptaujājiet GET /v1/phone-numbers/{id}, lai sekotu pārejai.

3. Piešķiriet aģentu#

Saistiet 1. darbībā izveidoto aģentu ar numura ienākošo zvanu virzienu:

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. Kad jūsu organizācijai ir apstiprināti izejošie zvani, tajā pašā PATCH varat iestatīt arī outbound_agent_id. Līdz tam API noraida šo piešķiršanu ar 400.

Ja ienākošos zvanus novirzāt, izmantojot konfigurācijas tīmekļa aizķeri, nevis fiksētu inbound_agent_id, šis tīmekļa aizķeris tagad katram zvanam var atgriezt timezone kopā ar agent_id un variables.

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 sākas saruna.

Kamēr zvans notiek, tas ir redzams 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 novērtējumu.

Ienākošie zvani tiek ieskaitīti jūsu organizācijas vienlaicīgo zvanu limitā (pēc noklusējuma 20 aktīvi zvani, kas tiek koplietoti ar izejošajiem, tīmekļa un testa zvaniem). Zvans, kas tiek saņemts, kad limits ir sasniegts, tiek noraidīts, pirms balss aģents atbild, un pārtraukts; par to netiek iekasēta maksa, un tas tiek reģistrēts kā neveiksmīgs zvans ar beigu iemeslu concurrent_call_limit_reached. Rakstiet uz support@thunderphone.com, ja jums nepieciešams lielāks limits.

5. Pārbaudiet 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, jūs saņemsiet tos pašus datus kā POST pieprasījumu savā serverī — skatiet call.complete.

Ja jūsu balss aģentam ir konfigurēti datu iegūšanas lauki, pabeigtā zvana datos var būt iekļauti arī strukturēti iegūtie dati.

Nākamās darbības#