Open in
Slack లేదా చాట్ యాప్ నుంచి కాల్లను నిర్వహించండి
పబ్లిక్ APIని ఉపయోగించి కాల్లను ప్రారంభించే, వాటిని ప్రత్యక్షంగా అనుసరించే, ఏజెంట్ను మార్గనిర్దేశం చేసే మరియు దాని ప్రశ్నలకు సమాధానం ఇచ్చే మీ స్వంత Slack, Teams లేదా వెబ్-చాట్ బాట్ను రూపొందించండి.
మీ బృందం ఇప్పటికే ఉపయోగిస్తున్న చాట్ యాప్ నుంచే ఏజెంట్ను నియంత్రించవచ్చు. ఒక సందేశం కాల్ను ప్రారంభిస్తుంది. కాల్ థ్రెడ్లో ప్రత్యక్షంగా కొనసాగుతుంది. థ్రెడ్లో ఇచ్చే ప్రత్యుత్తరం ఏజెంట్ను దిశానిర్దేశం చేస్తుంది. ఏజెంట్కు నిర్ణయం అవసరమైనప్పుడు, అది మిమ్మల్ని అక్కడే అడిగి మీ సమాధానం కోసం వేచి ఉంటుంది.
ThunderPhone ఈ బాట్ను మీ కోసం హోస్ట్ చేయదు. మీరు (లేదా మీ కోడింగ్ ఏజెంట్) మీ చాట్ యాప్ను పబ్లిక్ APIకి అనుసంధానించే చిన్న సర్వర్ను రూపొందిస్తారు. ఈ పేజీ భాగాలను చూపిస్తుంది. Slack, Microsoft Teams, Discord లేదా ప్రైవేట్ వెబ్ చాట్ పేజీకి ఇవే వర్తిస్తాయి; ఉదాహరణలు Slackను ఉపయోగిస్తాయి.
ఇది ఎలా కలిసి పనిచేస్తుంది
| మీరు చాట్లో చేసేది | మీ బాట్ కాల్ చేసేది | జరిగేది |
|---|---|---|
| "Comcastకు కాల్ చేసి, సేవా అంతరాయం ETA తెలుసుకోండి" పంపండి | సందేశాన్ని 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. సందేశం నుండి కాల్ ప్రారంభించండి
మీ బాట్కు సందేశం వచ్చినప్పుడు (డైరెక్ట్ మెసేజ్ లేదా @మెన్షన్),
Slack అభ్యర్థనను వెంటనే అంగీకరించండి (3 సెకన్లలోపు అంగీకరించని వాటిని Slack మళ్లీ ప్రయత్నిస్తుంది)
మరియు మిగతా పనిని బ్యాక్గ్రౌండ్లో చేయండి. పంపిన వ్యక్తికి కాల్లు చేసే అనుమతి ఉందో
తనిఖీ చేసి, సందేశాన్ని 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 ఈవెంట్ రెండో కాల్ను ప్రారంభించదు. అభ్యర్థనలో నంబర్కు బదులుగా
వ్యక్తి పేరు ఉంటే, మీ బాట్ ముందుగా ఆ నంబర్ను వెతుకుతుంది. మీరు పంపిన to_numberకే
ThunderPhone డయల్ చేస్తుంది.
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.ముందుగానే పరిగణించాల్సిన పరిమితులు
- మీ ఎండ్పాయింట్ టూల్ యొక్క
timeoutలోపల, గరిష్ఠంగా 180 సెకన్లలో ప్రతిస్పందించాలి. హోల్డ్ మోడ్లో ఉన్న టూల్ పెండింగ్ ఫలితంతో కాల్ను గరిష్ఠంగా 600 సెకన్ల వరకు హోల్డ్లో ఉంచగలదు. - టూల్ వేచి ఉన్నప్పుడు, ఏజెంట్ అవతలి వ్యక్తికి సమాధానం ఇవ్వదు. హోల్డ్ మోడ్లో వారికి సంగీతం వినిపిస్తుంది; లేకపోతే, చిన్న మౌఖిక నవీకరణలు వినిపిస్తాయి.
- విస్పర్ గరిష్ఠంగా 1000 అక్షరాలు మాత్రమే ఉంటుంది.
telephony.turnడెలివరీ కనీసం ఒక్కసారైనా జరుగుతుంది మరియు క్రమం తప్పి రావచ్చు.
భద్రతా తనిఖీ జాబితా
- API కీని మీ సర్వర్లో ఉంచండి.
- వెబ్హుక్లు మరియు టూల్ అభ్యర్థనలపై ThunderPhone సంతకాలను, అలాగే
Slack అభ్యర్థనలపై Slack సైనింగ్ సీక్రెట్ను ధృవీకరించండి. రెండు ThunderPhone
సంతకాలు వేర్వేరు సీక్రెట్లను ఉపయోగిస్తాయి: వెబ్హుక్ డెలివరీలు వెబ్హుక్
ఎండ్పాయింట్కు చెందిన సొంత సీక్రెట్ను ఉపయోగిస్తాయి, టూల్ అభ్యర్థనలు మీ సంస్థ
యొక్క
GET /v1/webhookనుండి వెబ్హుక్ సీక్రెట్ను ఉపయోగిస్తాయి. - కాల్లను ఎవరు ప్రారంభించవచ్చో నిర్ణయించండి: కాల్ చేయడానికి ముందు Slack వినియోగదారు IDని తనిఖీ చేయండి.
- అవుట్బౌండ్ కాల్లు ఇతర కాల్ల మాదిరిగానే అదే నియమాలను అనుసరిస్తాయి. చూడండి అవుట్బౌండ్ కాలింగ్ చట్టాలు.
కోడింగ్ ఏజెంట్తో రూపొందించండి
మీ కోడింగ్ ఏజెంట్కు డాక్యుమెంటేషన్ MCP సర్వర్ మరియు ఈ పేజీని చూపించి, "ఈ గైడ్ను అనుసరించే నా ThunderPhone ఏజెంట్ కోసం Slack బాట్" అని అడగండి. ThunderPhone యాప్లోని అసిస్టెంట్ Zeus, ఏజెంట్ వైపు సెటప్ను (వెబ్హుక్ ఎండ్పాయింట్, టూల్ మరియు prompt పంక్తులు) కాన్ఫిగర్ చేసి, చాట్లో బాట్ కోసం ప్రారంభ కోడ్ను రాయగలదు.