---
title: "Slack અથવા ચેટ એપમાંથી કૉલ ચલાવો"
description: "જાહેર API નો ઉપયોગ કરીને કૉલ શરૂ કરે, તેમને લાઇવ અનુસરે, એજન્ટને માર્ગદર્શન આપે અને તેના પ્રશ્નોના જવાબ આપે એવો તમારો પોતાનો Slack, Teams અથવા વેબ-ચેટ બોટ બનાવો."
---

તમે તમારી ટીમ પહેલેથી વાપરે છે તે ચેટ એપમાંથી એજન્ટને ચલાવી શકો છો. એક મેસેજ
કૉલ શરૂ કરે છે. કૉલ થ્રેડમાં લાઇવ રીતે આગળ વધે છે. થ્રેડમાં આપેલો જવાબ
એજન્ટને દિશા આપે છે. જ્યારે એજન્ટને નિર્ણયની જરૂર હોય, ત્યારે તે ત્યાં તમને પૂછે છે અને
તમારા જવાબની રાહ જુએ છે.

ThunderPhone તમારા માટે આ બોટ હોસ્ટ કરતું નથી. તમે (અથવા તમારો કોડિંગ એજન્ટ) એક
નાનું સર્વર બનાવો છો જે તમારી ચેટ એપને જાહેર API સાથે જોડે છે. આ પેજ
તેના ભાગો બતાવે છે. Slack, Microsoft Teams, Discord અથવા ખાનગી
વેબ ચેટ પેજ માટે તે સમાન છે; ઉદાહરણોમાં Slack વપરાય છે.

## તે કેવી રીતે સાથે કાર્ય કરે છે

| તમે ચેટમાં આ કરો છો | તમારો બોટ આ કૉલ કરે છે | શું થાય છે |
|---|---|---|
| "Comcast ને કૉલ કરો અને સેવા બંધ થવાનો અંદાજિત સમય મેળવો" મોકલો | મેસેજને `context` તરીકે રાખીને [`POST /v1/call`](/api-reference/outbound-calls) | એજન્ટ ડાયલ કરે છે. તમારો બોટ કૉલ માટે થ્રેડ ખોલે છે |
| થ્રેડ જુઓ | [`telephony.turn`](/gu/webhooks/events) વેબહૂક મેળવે છે | એજન્ટ અથવા બીજી વ્યક્તિ કહે છે તે દરેક લાઇન થ્રેડમાં દેખાય છે |
| કૉલ દરમિયાન થ્રેડમાં જવાબ આપો | [`POST /v1/calls/{call_id}/whisper`](/api-reference/calls#whisper-to-the-agent) | એજન્ટને તમારી નોંધ ખાનગી રીતે મળે છે અને તે તેના પર કાર્ય કરે છે. બીજી વ્યક્તિ તેને ક્યારેય સાંભળતી નથી |
| એજન્ટના પ્રશ્નનો જવાબ આપો | તમારું [ટૂલ એન્ડપૉઇન્ટ](/gu/guides/build-tool-integration) તમારો જવાબ પરત કરે છે અથવા પછીથી તેને [`POST /v1/calls/{call_id}/tool-results`](/api-reference/calls#deliver-a-tool-result) વડે પહોંચાડે છે | એજન્ટ તેની સાથે કૉલ ચાલુ રાખે છે; હોલ્ડ મોડમાં બીજી વ્યક્તિને ત્યાં સુધી હોલ્ડ સંગીત સંભળાય છે |
| પરિણામ વાંચો | [`telephony.complete`](/gu/webhooks/events) મેળવે છે | તમારો બોટ સારાંશ અને પરિણામ પોસ્ટ કરે છે |

તમારો બોટ એક મેપિંગ રાખે છે: કયો ચેટ થ્રેડ કયા `call_id` સાથે સંબંધિત છે.

## શરૂ કરતાં પહેલાં

- **એક API કી**, જે તમારા સર્વર પર રાખવામાં આવે અને ક્યારેય બ્રાઉઝર અથવા ચેટમાં નહીં.
  **સંસ્થાની સેટિંગ્સ → કીઝ** હેઠળ એક બનાવો (જુઓ
  [કીઝ](/gu/guides/organization-settings)).
- **આઉટબાઉન્ડ-સક્ષમ નંબર અને એજન્ટ** કૉલ માટે. મેસેજ
  દરેક કૉલનો `context` બને છે, તેથી એક સામાન્ય એજન્ટ દરેક કાર્ય સંભાળે છે.
- **એક સર્વર** જે Railway, Fly.io, Render અથવા
  તમારા પોતાના હોસ્ટ જેવા વેબહૂક પ્રાપ્ત કરી શકે.
- **એક વેબહૂક એન્ડપૉઇન્ટ** જે તે સર્વર તરફ નિર્દેશ કરે અને
  `telephony.turn` અને `telephony.complete` પર સબ્સ્ક્રાઇબ હોય. ટર્ન ઇવેન્ટ્સ ફક્ત તે
  એન્ડપૉઇન્ટને મોકલવામાં આવે છે જે તેમને સૂચિબદ્ધ કરે છે. જુઓ [વેબહૂક્સ](/gu/webhooks/endpoints).
  ટર્ન ઇવેન્ટ્સ માટે એજન્ટનું કૉલ રેકોર્ડિંગ ચાલુ હોવું જરૂરી છે, અને કૉલના અંતનો
  `summary` મેળવવા માટે એજન્ટની **કૉલ સારાંશ જનરેટ કરો** સેટિંગ જરૂરી છે; તેમના વિના
  તે ફીલ્ડ્સ ખાલી રહે છે.
- **તમારી પોતાની ચેટ એપ.** Slack માટે, તમારા વર્કસ્પેસમાં એક એપ બનાવો
  [api.slack.com/apps](https://api.slack.com/apps) પર.

<Tip>
  તમારા પોતાના વર્કસ્પેસ માટે બનાવેલી Slack એપ વાપરો અને ચેનલ હિસ્ટરી વાંચવાને બદલે
  Slackની ઇવેન્ટ્સ API દ્વારા મેસેજ મેળવો. Slack તેના Marketplace બહાર અન્ય વર્કસ્પેસમાં
  વિતરિત એપ્સ પર કડક વાંચન મર્યાદાઓ મૂકે છે; તમે તમારા પોતાના વર્કસ્પેસ માટે બનાવેલી એપ પર
  તે લાગુ પડતી નથી, અને કોઈ વાંચન કર્યા વિના ઇવેન્ટ્સ બનતી વખતે જ તમારી પાસે પહોંચે છે.
  સામાન્ય બોટ સ્કોપ્સ: `chat:write`, `app_mentions:read`, `im:history` (ડાયરેક્ટ
  મેસેજ), `channels:history` અને `groups:history` (બોટ જે જાહેર અને ખાનગી ચેનલોમાં છે તેમાં
  થ્રેડ જવાબો). બોટ ઇવેન્ટ્સ `app_mention`, `message.im`, `message.channels` અને
  `message.groups` પર સબ્સ્ક્રાઇબ કરો, અને લોકો બોટને ડાયરેક્ટ મેસેજ કરી શકે તે માટે એપ હોમ હેઠળનો
  મેસેજેસ ટૅબ ચાલુ કરો.
</Tip>

## 1. સંદેશમાંથી કૉલ શરૂ કરો

જ્યારે તમારો બોટ સંદેશ મેળવે છે (ડાયરેક્ટ સંદેશ અથવા @mention),
ત્યારે Slack ની વિનંતીને તરત સ્વીકારો (Slack 3 સેકન્ડમાં સ્વીકારવામાં ન આવેલી કોઈપણ વિનંતી ફરી મોકલે છે) અને બાકીનું કાર્ય પૃષ્ઠભૂમિમાં કરો. તપાસો
કે મોકલનારને કૉલ કરવાની મંજૂરી છે, પછી સંદેશને `context` તરીકે ઉપયોગ કરીને કૉલ શરૂ કરો:

```bash
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` દ્વારા થ્રેડ શોધો અને
લાઇન પોસ્ટ કરો.

- તેની પર કાર્યવાહી કરતાં પહેલાં **દરેક વેબહૂકની ચકાસણી કરો**. જુઓ
  [વેબહૂક હસ્તાક્ષરોની ચકાસણી કરો](/gu/guides/verify-webhook-signatures).
- **એન્વલપના `event_id` પર ડિડુપ્લિકેટ કરો અને `position` મુજબ ક્રમ ગોઠવો.**
  ડિલિવરી ઓછામાં ઓછી એક વાર થાય છે, અને ટર્ન ક્રમની બહાર આવી શકે છે.
- **લાઇનોને બેચ કરો** જો વ્યસ્ત કૉલ થ્રેડને ભરાવી દે; દર થોડી
  સેકન્ડે પોસ્ટ કરવું દરેક લાઇન માટે એક સંદેશ કરતાં વધુ વાંચનીય છે.

જ્યારે `telephony.complete` આવે, ત્યારે કૉલ કેવી રીતે સમાપ્ત થયો તે (તેનું `status`
અને `end_reason`), `summary`, અને કોઈપણ કાઢવામાં આવેલ ડેટા પોસ્ટ કરો, અને
થ્રેડ બંધ કરો. ફીલ્ડ્સ માટે [કૉલ પૂર્ણ](/gu/webhooks/call-complete) જુઓ.

## 3. થ્રેડમાંથી કૉલને માર્ગદર્શન આપો

જ્યારે કોઈ વ્યક્તિ લાઇવ કૉલના થ્રેડમાં જવાબ આપે, ત્યારે જવાબને વ્હિસ્પર તરીકે મોકલો,
સિવાય કે એજન્ટ પ્રશ્નના જવાબની રાહ જોતો હોય (પગલું 4), જેમાં જવાબ
જ ઉત્તર છે:

```bash
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 કનેક્શન](/gu/guides/build-tool-integration) તરીકે બનાવો અને એજન્ટ સાથે લિંક કરો.
દરેક ટૂલ વિનંતી તેના `X-ThunderPhone-Call-ID` હેડરમાં કૉલની માહિતી ધરાવે છે.

જવાબ પાછો મેળવવાની ત્રણ રીતો છે.

**કૉલને હોલ્ડ પર રાખો (10 મિનિટ સુધી).** ટૂલને હોલ્ડ મોડ પર સેટ કરો: `spec.wait_mode`
`"hold"` અને `spec.timeout` 600 સેકન્ડ સુધી (ટાઇમઆઉટ વિના હોલ્ડ
20 સેકન્ડ સુધી રહે છે), આ માટે
[API](/api-reference/integrations#timeout-and-wait-mode) નો ઉપયોગ કરો (ડેશબોર્ડ
એડિટરમાં હજી બંનેમાંથી કોઈ ફિલ્ડ નથી). તમારું એન્ડપોઇન્ટ પ્રશ્નને કૉલના થ્રેડમાં પોસ્ટ કરે છે અને
તરત જ પેન્ડિંગ પરિણામ સાથે જવાબ આપે છે:

```json
{"status": "pending", "request_id": "q-C012AB3CD-1731000042.000300"}
```

સામેની વ્યક્તિ એજન્ટ પાસેથી એક વાક્ય સાંભળે છે, પછી હોલ્ડ મ્યુઝિક વાગે છે. ફોન
મેનૂ અથવા વૉઇસમેઇલમાં એજન્ટ તેના બદલે બોલીને અપડેટ આપે છે, અને
ફુલ-ડુપ્લેક્સ એજન્ટ હોલ્ડ કરતું નથી: તેને પરિણામ તરીકે પેન્ડિંગ જવાબ મળે છે. જ્યારે
થ્રેડમાં જવાબ આવે, ત્યારે તેને
[`POST /v1/calls/{call_id}/tool-results`](/api-reference/calls#deliver-a-tool-result) દ્વારા મોકલો:

```bash
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` પહેલાં જવાબ ન આપે, તો એજન્ટને જણાવવામાં આવે છે કે કોઈ જવાબ આવ્યો નથી અને તે
સામેની વ્યક્તિને આગળના પગલાં સૂચવે છે. કૉલ માટે પ્રશ્ન પેન્ડિંગ હોય ત્યારે,
તેના થ્રેડમાં આવતો આગલો જવાબ તેનો ઉત્તર આપે છે: તેને ટૂલ પરિણામ તરીકે મોકલો અને
વ્હિસ્પર તરીકે પણ મોકલશો નહીં (વ્હિસ્પર ટૂલ પરત આવે પછી જ એજન્ટ સુધી પહોંચે છે).
જુઓ
[લાંબી રાહ](/gu/tools/overview).

**વિનંતીમાં રાહ જુઓ (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 માં ટૂલ ક્યારે વાપરવું અને રાહ જોતી વખતે
સામેની વ્યક્તિને શું કહેવું તે જણાવો:

```text
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`](/api-reference/organizations#legacy-single-url-webhook)માંથી મળતા વેબહૂક સિક્રેટનો ઉપયોગ કરે છે.
- કોણ કૉલ શરૂ કરી શકે તે નક્કી કરો: કૉલ મૂકતા પહેલાં Slack વપરાશકર્તા ID તપાસો.
- આઉટબાઉન્ડ કૉલ્સ અન્ય કોઈપણ કૉલ જેવા જ નિયમો અનુસરે છે. [આઉટબાઉન્ડ કૉલિંગના કાયદા](/gu/guides/outbound-calling-laws) જુઓ.

## કોડિંગ એજન્ટ સાથે બનાવો

તમારા કોડિંગ એજન્ટને [ડૉક્સ MCP સર્વર](/gu/guides/docs-mcp) અને આ પેજ તરફ દોરો, અને તેને "મારા ThunderPhone એજન્ટ માટે આ માર્ગદર્શિકાનું પાલન કરતો Slack બોટ" બનાવવા કહો. ThunderPhone ઍપમાં સહાયક Zeus એજન્ટનો ભાગ સેટ અપ કરી શકે છે (વેબહૂક endpoint, ટૂલ અને prompt લાઇન્સ) અને ચેટમાં બોટ માટે પ્રારંભિક કોડ લખી શકે છે.
