Open in
Обрађујте долазне позиве (API)
Од почетка до краја: конфигуришите агента, доделите га телефонском броју, примите позив и прегледајте транскрипт.
Канонски ток „одговорите на позив помоћу AI“ из Вашег терминала. Ви ћете:
- Направити агента са упитом и гласом.
- Обезбедити (или донети) телефонски број и доделити агента као његовог обрађивача долазних позива.
- Позвати број. Посматрати дневник позива, транскрипт и снимак.
Укупно API позива: четири. Укупно време: мање од пет минута.
1. Направите агента
Агент обједињује упит, глас и ниво производа који ће покретати
позив. На агенту можете подесити и ограничења позива, као што су max_call_duration_seconds
и ring_duration_seconds. За одлазне позиве можете подесити и
max_hold_seconds да бисте ограничили колико дуго агент чека на чекању пре завршетка
позива. Bolt агенти такође подржавају audio_tier, endpointing и intelligence
за контролу начина на који слушају и одговарају: intelligence је core или pro,
а audio_tier (слушање) је lite, standard, plus или max (Max није
широко доступан). Старије вредности (lite и standard за
intelligence; lean, hearing и deep_hearing за слушање) и даље се
прихватају. Агенти са пуним дуплексом задржавају исти глас на подржаним језицима,
па се промена гласа по језику не примењује на те позиве. Агенти такође
подржавају intro_clip и intro_ring_count за репродукцију унапред снимљеног увода и
до два звона пре него што агент проговори. Новим агентима је потребна и временска зона. Ако
је Ваш агент вишејезичан, можете подесити language_switching да контролишете
да ли пита пре промене језика или прати језик позиваоца.
На агенту можете подесити и words да контролишете како изговара одређене термине
и које термине препознаје.
Погледајте Агенти за сва конфигурациона поља; најмање потребно је:
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": "bolt"
}'Сачувајте враћени id — биће Вам потребан у кораку 2.
2. Набавите телефонски број
Ако Вам је само потребан број за позивање, набавите ThunderPhone број из ThunderPhone скупа:
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"}'Одговор садржи id и number у формату E.164. ThunderPhone
бројеви почињу са status="provisioning" и постају active у року од неколико
секунди — анкетирајте
GET /v1/phone-numbers/{id}
да бисте пратили прелаз ако Вам је то важно.
3. Доделите агента
Повежите агента из корака 1 са долазним смером броја:
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}'То је све — број је активан. Након што одлазно позивање буде одобрено за Вашу
организацију, можете да поставите и outbound_agent_id у истом PATCH захтеву. До
тада API одбија то додељивање са 400.
Ако усмеравате долазне позиве преко конфигурационог вебхука уместо фиксног
inbound_agent_id, тај вебхук сада може да врати timezone за сваки позив,
заједно са agent_id и variables. За Bolt агенте, приликом уписивања путем
API-ја можете и да подесите audio_tier, endpointing и intelligence на
агенту. API и даље прихвата старији назив eagerness као алијас за
endpointing. Ако Ваш агент користи API везе са trigger="call_start",
ThunderPhone може да покрене те алатке једном на почетку сваког телефонског
позива, пре поздрава, користећи њихове сачуване call_start_arguments.
Повратни позиви на Ваше одлазне позиве
Када неко узврати позив на број који га је позвао у последњих 30
дана, агент који одговара добија кратку напомену са контекстом о том позиву:
када је обављен, који агент га је упутио и шта се догодило (без одговора,
говорна пошта или разговор). Број без агента за долазне позиве шаље
исте детаље Вашем веб-хуку за конфигурацију као returning_call. Ако тај
број нема веб-хук или веб-хук прекорачи време чекања или није доступан,
позив се усмерава агенту који је упутио ранији позив уместо да се прекине.
ИД позиваоца може бити лажиран, па се сажетак и променљиве ранијег
позива деле само ако администратор укључи Делите детаље ранијег позива
у оквиру Организација → Опште → Повратни позиви. Погледајте
Повратни позиви.
4. Примите позив
Позовите број са свог телефона. Агент се јавља, представља се према Вашем упиту и разговор почиње.
Док је позив у току, приказује се у
GET /v1/calls са
status="in_progress". Када се заврши, запис се ажурира са
end_reason, duration_seconds, billable_minutes и (на крају)
URL-ом снимка и AI оценом.
Долазни позиви се рачунају у ограничење ваше организације за
истовремене позиве (подразумевано 20
позива у току, заједнички за одлазне, веб и тест позиве). Позив који стигне када је ограничење достигнуто одбија се пре него што се агент јави и прекида се, не наплаћује се и бележи се као неуспешан позив са разлогом завршетка concurrent_call_limit_reached. Пошаљите е-поруку на support@thunderphone.com ако Вам је
потребно веће ограничење.
5. Прегледајте резултате
Преузмите листу недавних позива:
curl 'https://api.thunderphone.com/v1/calls?limit=5' \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"Преузмите транскрипт:
curl https://api.thunderphone.com/v1/calls/{call_id}/transcript \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"И URL снимка (краткотрајан, потписан):
curl https://api.thunderphone.com/v1/calls/{call_id}/audio \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"Ако сте се претплатили на
telephony.complete веб-хук,
добићете исте податке као POST захтев на вашем серверу — погледајте
call.complete.
Ако Ваш агент има конфигурисана поља за издвајање, садржај завршеног позива може да садржи и структуриране издвојене податке. Сажетци позива пишу се на језику који Ваша организација користи у ThunderPhone-у, осим ако агент не замени то подешавање.
Следећи кораци
Изаберите различитог агента за сваког позиваоца на основу броја телефона или прилагођене логике у веб-хуку.
Дозволите агенту да позива ваше API-је усред разговора.
Усмерите позиваоце директно или проверите одредиште пре него што их повежете.
Проследите сваки завршени позив у ваш CRM / ток аналитике.
Аутоматски оцените сваки позив и усмерите означене на преглед.