Open in
Slack અથવા ચેટ એપમાંથી કૉલ ચલાવો
જાહેર API નો ઉપયોગ કરીને કૉલ શરૂ કરે, તેમને લાઇવ અનુસરે, એજન્ટને માર્ગદર્શન આપે અને તેના પ્રશ્નોના જવાબ આપે એવો તમારો પોતાનો Slack, Teams અથવા વેબ-ચેટ બોટ બનાવો.
તમે તમારી ટીમ પહેલેથી વાપરે છે તે ચેટ એપમાંથી એજન્ટને ચલાવી શકો છો. એક મેસેજ કૉલ શરૂ કરે છે. કૉલ થ્રેડમાં લાઇવ રીતે આગળ વધે છે. થ્રેડમાં આપેલો જવાબ એજન્ટને દિશા આપે છે. જ્યારે એજન્ટને નિર્ણયની જરૂર હોય, ત્યારે તે ત્યાં તમને પૂછે છે અને તમારા જવાબની રાહ જુએ છે.
ThunderPhone તમારા માટે આ બોટ હોસ્ટ કરતું નથી. તમે (અથવા તમારો કોડિંગ એજન્ટ) એક નાનું સર્વર બનાવો છો જે તમારી ચેટ એપને જાહેર API સાથે જોડે છે. આ પેજ તેના ભાગો બતાવે છે. Slack, Microsoft Teams, Discord અથવા ખાનગી વેબ ચેટ પેજ માટે તે સમાન છે; ઉદાહરણોમાં Slack વપરાય છે.
તે કેવી રીતે સાથે કાર્ય કરે છે
| તમે ચેટમાં આ કરો છો | તમારો બોટ આ કૉલ કરે છે | શું થાય છે |
|---|---|---|
| "Comcast ને કૉલ કરો અને સેવા બંધ થવાનો અંદાજિત સમય મેળવો" મોકલો | મેસેજને context તરીકે રાખીને POST /v1/call | એજન્ટ ડાયલ કરે છે. તમારો બોટ કૉલ માટે થ્રેડ ખોલે છે |
| થ્રેડ જુઓ | telephony.turn વેબહૂક મેળવે છે | એજન્ટ અથવા બીજી વ્યક્તિ કહે છે તે દરેક લાઇન થ્રેડમાં દેખાય છે |
| કૉલ દરમિયાન થ્રેડમાં જવાબ આપો | POST /v1/calls/{call_id}/whisper | એજન્ટને તમારી નોંધ ખાનગી રીતે મળે છે અને તે તેના પર કાર્ય કરે છે. બીજી વ્યક્તિ તેને ક્યારેય સાંભળતી નથી |
| એજન્ટના પ્રશ્નનો જવાબ આપો | તમારું ટૂલ એન્ડપૉઇન્ટ તમારો જવાબ પરત કરે છે અથવા પછીથી તેને POST /v1/calls/{call_id}/tool-results વડે પહોંચાડે છે | એજન્ટ તેની સાથે કૉલ ચાલુ રાખે છે; હોલ્ડ મોડમાં બીજી વ્યક્તિને ત્યાં સુધી હોલ્ડ સંગીત સંભળાય છે |
| પરિણામ વાંચો | telephony.complete મેળવે છે | તમારો બોટ સારાંશ અને પરિણામ પોસ્ટ કરે છે |
તમારો બોટ એક મેપિંગ રાખે છે: કયો ચેટ થ્રેડ કયા call_id સાથે સંબંધિત છે.
શરૂ કરતાં પહેલાં
- એક API કી, જે તમારા સર્વર પર રાખવામાં આવે અને ક્યારેય બ્રાઉઝર અથવા ચેટમાં નહીં. સંસ્થાની સેટિંગ્સ → કીઝ હેઠળ એક બનાવો (જુઓ કીઝ).
- આઉટબાઉન્ડ-સક્ષમ નંબર અને એજન્ટ કૉલ માટે. મેસેજ
દરેક કૉલનો
contextબને છે, તેથી એક સામાન્ય એજન્ટ દરેક કાર્ય સંભાળે છે. - એક સર્વર જે Railway, Fly.io, Render અથવા તમારા પોતાના હોસ્ટ જેવા વેબહૂક પ્રાપ્ત કરી શકે.
- એક વેબહૂક એન્ડપૉઇન્ટ જે તે સર્વર તરફ નિર્દેશ કરે અને
telephony.turnઅનેtelephony.completeપર સબ્સ્ક્રાઇબ હોય. ટર્ન ઇવેન્ટ્સ ફક્ત તે એન્ડપૉઇન્ટને મોકલવામાં આવે છે જે તેમને સૂચિબદ્ધ કરે છે. જુઓ વેબહૂક્સ. ટર્ન ઇવેન્ટ્સ માટે એજન્ટનું કૉલ રેકોર્ડિંગ ચાલુ હોવું જરૂરી છે, અને કૉલના અંતનોsummaryમેળવવા માટે એજન્ટની કૉલ સારાંશ જનરેટ કરો સેટિંગ જરૂરી છે; તેમના વિના તે ફીલ્ડ્સ ખાલી રહે છે. - તમારી પોતાની ચેટ એપ. Slack માટે, તમારા વર્કસ્પેસમાં એક એપ બનાવો api.slack.com/apps પર.
1. સંદેશમાંથી કૉલ શરૂ કરો
જ્યારે તમારો બોટ સંદેશ મેળવે છે (ડાયરેક્ટ સંદેશ અથવા @mention),
ત્યારે Slack ની વિનંતીને તરત સ્વીકારો (Slack 3 સેકન્ડમાં સ્વીકારવામાં ન આવેલી કોઈપણ વિનંતી ફરી મોકલે છે) અને બાકીનું કાર્ય પૃષ્ઠભૂમિમાં કરો. તપાસો
કે મોકલનારને કૉલ કરવાની મંજૂરી છે, પછી સંદેશને context તરીકે ઉપયોગ કરીને કૉલ શરૂ કરો:
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": "+18005550100",
"agent_id": 12,
"context": "Matthew asked: get the outage ETA for account 4471. Wait on hold if needed.",
"idempotency_key": "slack-D012AB3CD-1731000000.000100"
}'પરત મળેલ call_id ને Slack થ્રેડ સાથે સાચવો (channel અને સંદેશનો
ts) અને થ્રેડમાં જવાબ આપો ("કૉલ થઈ રહ્યો છે…"). idempotency_key ને ચેનલ અને સંદેશના ts પરથી બનાવો (ts ફક્ત તેના ચેનલમાં જ અનન્ય હોય છે), જેથી ફરી મોકલાયેલી Slack ઇવેન્ટ બીજો કૉલ ન કરે. જો વિનંતીમાં નંબરને બદલે કોઈ વ્યક્તિનું નામ હોય, તો તમારો બોટ
પહેલા નંબર શોધે છે. ThunderPhone ફક્ત તમે મોકલો તે to_number પર ડાયલ કરે છે.
2. થ્રેડમાં કૉલને અનુસરો
દરેક telephony.turn વેબહૂકમાં call_id, વક્તા (role:
એજન્ટ માટે assistant, બીજા વ્યક્તિ માટે user), text અને
ટર્નનું position હોય છે. call_id દ્વારા થ્રેડ શોધો અને
લાઇન પોસ્ટ કરો.
- તેની પર કાર્યવાહી કરતાં પહેલાં દરેક વેબહૂકની ચકાસણી કરો. જુઓ વેબહૂક હસ્તાક્ષરોની ચકાસણી કરો.
- એન્વલપના
event_idપર ડિડુપ્લિકેટ કરો અનેpositionમુજબ ક્રમ ગોઠવો. ડિલિવરી ઓછામાં ઓછી એક વાર થાય છે, અને ટર્ન ક્રમની બહાર આવી શકે છે. - લાઇનોને બેચ કરો જો વ્યસ્ત કૉલ થ્રેડને ભરાવી દે; દર થોડી સેકન્ડે પોસ્ટ કરવું દરેક લાઇન માટે એક સંદેશ કરતાં વધુ વાંચનીય છે.
જ્યારે telephony.complete આવે, ત્યારે કૉલ કેવી રીતે સમાપ્ત થયો તે (તેનું status
અને end_reason), summary, અને કોઈપણ કાઢવામાં આવેલ ડેટા પોસ્ટ કરો, અને
થ્રેડ બંધ કરો. ફીલ્ડ્સ માટે કૉલ પૂર્ણ જુઓ.
3. થ્રેડમાંથી કૉલને માર્ગદર્શન આપો
જ્યારે કોઈ વ્યક્તિ લાઇવ કૉલના થ્રેડમાં જવાબ આપે, ત્યારે જવાબને વ્હિસ્પર તરીકે મોકલો, સિવાય કે એજન્ટ પ્રશ્નના જવાબની રાહ જોતો હોય (પગલું 4), જેમાં જવાબ જ ઉત્તર છે:
curl -X POST https://api.thunderphone.com/v1/calls/987654321/whisper \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"text": "Ask whether they can waive the late fee."}'એજન્ટ તેને ખાનગી રીતે સાંભળે છે અને તેને તેના આગામી ટર્નમાં સામેલ કરે છે; બીજી
વ્યક્તિ ક્યારેય વ્હિસ્પર પોતે સાંભળતી નથી. વ્હિસ્પર 1 થી 1000 અક્ષરોનો હોય છે. 409
નો અર્થ છે કે કૉલ હવે લાઇવ નથી: થ્રેડને જણાવો કે કૉલ સમાપ્ત થઈ ગયો છે.
4. એજન્ટને તમને પૂછવા દો
એજન્ટને એક ટૂલ આપો, ઉદાહરણ તરીકે એક question
પેરામીટર સાથેનું ask_owner, જે તમારા સર્વરને કૉલ કરે છે. તેને
API કનેક્શન તરીકે બનાવો અને એજન્ટ સાથે લિંક કરો.
દરેક ટૂલ વિનંતી તેના X-ThunderPhone-Call-ID હેડરમાં કૉલની માહિતી ધરાવે છે.
જવાબ પાછો મેળવવાની ત્રણ રીતો છે.
કૉલને હોલ્ડ પર રાખો (10 મિનિટ સુધી). ટૂલને હોલ્ડ મોડ પર સેટ કરો: spec.wait_mode
"hold" અને spec.timeout 600 સેકન્ડ સુધી (ટાઇમઆઉટ વિના હોલ્ડ
20 સેકન્ડ સુધી રહે છે), આ માટે
API નો ઉપયોગ કરો (ડેશબોર્ડ
એડિટરમાં હજી બંનેમાંથી કોઈ ફિલ્ડ નથી). તમારું એન્ડપોઇન્ટ પ્રશ્નને કૉલના થ્રેડમાં પોસ્ટ કરે છે અને
તરત જ પેન્ડિંગ પરિણામ સાથે જવાબ આપે છે:
{"status": "pending", "request_id": "q-C012AB3CD-1731000042.000300"}સામેની વ્યક્તિ એજન્ટ પાસેથી એક વાક્ય સાંભળે છે, પછી હોલ્ડ મ્યુઝિક વાગે છે. ફોન
મેનૂ અથવા વૉઇસમેઇલમાં એજન્ટ તેના બદલે બોલીને અપડેટ આપે છે, અને
ફુલ-ડુપ્લેક્સ એજન્ટ હોલ્ડ કરતું નથી: તેને પરિણામ તરીકે પેન્ડિંગ જવાબ મળે છે. જ્યારે
થ્રેડમાં જવાબ આવે, ત્યારે તેને
POST /v1/calls/{call_id}/tool-results દ્વારા મોકલો:
curl -X POST https://api.thunderphone.com/v1/calls/987654321/tool-results \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"request_id": "q-C012AB3CD-1731000042.000300", "result": {"answer": "Yes, book Tuesday at 10."}}'મ્યુઝિક ધીમે ધીમે બંધ થાય છે અને એજન્ટ તમારા જવાબ સાથે આગળ વધે છે. જો કોઈ
timeout પહેલાં જવાબ ન આપે, તો એજન્ટને જણાવવામાં આવે છે કે કોઈ જવાબ આવ્યો નથી અને તે
સામેની વ્યક્તિને આગળના પગલાં સૂચવે છે. કૉલ માટે પ્રશ્ન પેન્ડિંગ હોય ત્યારે,
તેના થ્રેડમાં આવતો આગલો જવાબ તેનો ઉત્તર આપે છે: તેને ટૂલ પરિણામ તરીકે મોકલો અને
વ્હિસ્પર તરીકે પણ મોકલશો નહીં (વ્હિસ્પર ટૂલ પરત આવે પછી જ એજન્ટ સુધી પહોંચે છે).
જુઓ
લાંબી રાહ.
વિનંતીમાં રાહ જુઓ (3 મિનિટ સુધી). તમારું એન્ડપોઇન્ટ પ્રશ્ન પોસ્ટ કરે છે,
જવાબની રાહ જુએ છે અને તેને પરત કરે છે, જેમ કે {"answer": "Yes, book Tuesday at 10."}.
API દ્વારા ટૂલનું spec.timeout 180 સેકન્ડ સુધી સેટ કરો (ડિફૉલ્ટ
20 છે). તમારા એન્ડપોઇન્ટને તેની પોતાની ડેડલાઇન થોડી સેકન્ડ ઓછી આપો
(ઉદાહરણ તરીકે 170 સેકન્ડ), જેથી કોઈ જવાબ ન આપે ત્યારે પણ તે એજન્ટ ઉપયોગ કરી શકે એવું
કંઈક પરત કરે, જેમ કે
{"answer": null, "note": "No reply yet. Offer to take a message."}. જે ટૂલ
તેની timeout સુધી પહોંચે છે તે એજન્ટ સુધી ભૂલ તરીકે પહોંચે છે, અને તમારા હોસ્ટે
વિનંતીને એટલા સમય સુધી ખુલ્લી રાખવી જરૂરી છે. રાહ જોતી વખતે, એજન્ટ સામેની વ્યક્તિને કહે છે
કે તે તપાસી રહ્યું છે, લગભગ 12 સેકન્ડ પછી કહે છે કે તે હજી કામ કરી રહ્યું છે, અને
ત્યારબાદ લગભગ દર 15 સેકન્ડે ટૂંકું અપડેટ આપે છે. હોલ્ડ મોડ અહીં પણ કાર્ય કરે છે:
spec.wait_mode ને "hold" પર સેટ કરો અને સામેની વ્યક્તિ અપડેટના બદલે મ્યુઝિક
સાંભળે છે.
વ્હિસ્પર દ્વારા જવાબ આપો. તમારું એન્ડપોઇન્ટ પ્રશ્ન પોસ્ટ કરે છે અને તરત જ પરત કરે છે,
ઉદાહરણ તરીકે {"status": "asked", "note": "Matthew has been asked; his answer will come as guidance."}.
જ્યારે જવાબ આવે, ત્યારે તેને વ્હિસ્પર તરીકે મોકલો (પગલું 3), અને એજન્ટ
તરત જ તેનો જવાબ આપે છે. 10 મિનિટથી વધુ સમય લઈ શકે એવા જવાબો માટે આનો ઉપયોગ કરો.
કૉલ હોલ્ડ પર રાખવામાં આવતો નથી: તમારા prompt એ એજન્ટને આ દરમિયાન શું કરવું તે જણાવવું જોઈએ,
જેમ કે વ્યક્તિને સાથ આપવો અથવા તેને પાછો કૉલ કરવાની ઑફર કરવી.
દરેક કિસ્સામાં, એજન્ટના prompt માં ટૂલ ક્યારે વાપરવું અને રાહ જોતી વખતે સામેની વ્યક્તિને શું કહેવું તે જણાવો:
When you need Matthew's decision, use ask_owner with a short question.
Tell the person you're checking with Matthew and it may take a minute.
If there's no answer, offer to take a message or have Matthew call back.આયોજન માટેની મર્યાદાઓ
- તમારું endpoint ટૂલના
timeoutની અંદર, વધુમાં વધુ 180 સેકન્ડમાં જવાબ આપવું આવશ્યક છે. હોલ્ડ મોડમાં રહેલું ટૂલ બાકી રહેલા પરિણામ સાથે કૉલને વધુમાં વધુ 600 સેકન્ડ સુધી હોલ્ડ પર રાખી શકે છે. - ટૂલ રાહ જોતું હોય ત્યારે, એજન્ટ બીજી વ્યક્તિને જવાબ આપતો નથી. હોલ્ડ મોડમાં તેઓ સંગીત સાંભળે છે; અન્યથા, ટૂંકા બોલાયેલા અપડેટ્સ સાંભળે છે.
- વિસ્પર વધુમાં વધુ 1000 અક્ષરોનો હોઈ શકે છે.
telephony.turnડિલિવરી ઓછામાં ઓછી એક વાર થાય છે અને ક્રમની બહાર હોઈ શકે છે.
સુરક્ષા ચેકલિસ્ટ
- API કી તમારા સર્વર પર રાખો.
- વેબહૂક્સ અને ટૂલ વિનંતીઓ પર ThunderPhone ની સહી ચકાસો, અને Slack ની વિનંતીઓ પર Slack નું સાઇનિંગ સિક્રેટ ચકાસો. ThunderPhone ની બે સહીઓ અલગ સિક્રેટ્સ વાપરે છે: વેબહૂક ડિલિવરી વેબહૂક endpoint ના પોતાના સિક્રેટનો ઉપયોગ કરે છે, અને ટૂલ વિનંતીઓ તમારી સંસ્થાના
GET /v1/webhookમાંથી મળતા વેબહૂક સિક્રેટનો ઉપયોગ કરે છે. - કોણ કૉલ શરૂ કરી શકે તે નક્કી કરો: કૉલ મૂકતા પહેલાં Slack વપરાશકર્તા ID તપાસો.
- આઉટબાઉન્ડ કૉલ્સ અન્ય કોઈપણ કૉલ જેવા જ નિયમો અનુસરે છે. આઉટબાઉન્ડ કૉલિંગના કાયદા જુઓ.
કોડિંગ એજન્ટ સાથે બનાવો
તમારા કોડિંગ એજન્ટને ડૉક્સ MCP સર્વર અને આ પેજ તરફ દોરો, અને તેને "મારા ThunderPhone એજન્ટ માટે આ માર્ગદર્શિકાનું પાલન કરતો Slack બોટ" બનાવવા કહો. ThunderPhone ઍપમાં સહાયક Zeus એજન્ટનો ભાગ સેટ અપ કરી શકે છે (વેબહૂક endpoint, ટૂલ અને prompt લાઇન્સ) અને ચેટમાં બોટ માટે પ્રારંભિક કોડ લખી શકે છે.