---
title: "Slack ਜਾਂ ਚੈਟ ਐਪ ਤੋਂ ਕਾਲਾਂ ਚਲਾਓ"
description: "ਆਪਣਾ Slack, Teams ਜਾਂ ਵੈੱਬ-ਚੈਟ ਬੌਟ ਬਣਾਓ ਜੋ ਕਾਲਾਂ ਸ਼ੁਰੂ ਕਰੇ, ਉਹਨਾਂ ਨੂੰ ਲਾਈਵ ਫਾਲੋ ਕਰੇ, ਏਜੰਟ ਨੂੰ ਦਿਸ਼ਾ ਦੇਵੇ ਅਤੇ ਜਨਤਕ API ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਇਸਦੇ ਸਵਾਲਾਂ ਦੇ ਜਵਾਬ ਦੇਵੇ।"
---

ਤੁਸੀਂ ਆਪਣੀ ਟੀਮ ਵੱਲੋਂ ਪਹਿਲਾਂ ਹੀ ਵਰਤੀ ਜਾ ਰਹੀ ਚੈਟ ਐਪ ਤੋਂ ਇੱਕ ਏਜੰਟ ਚਲਾ ਸਕਦੇ ਹੋ। ਇੱਕ ਸੁਨੇਹਾ
ਕਾਲ ਸ਼ੁਰੂ ਕਰਦਾ ਹੈ। ਕਾਲ ਇੱਕ ਥ੍ਰੈਡ ਵਿੱਚ ਲਾਈਵ ਚੱਲਦੀ ਹੈ। ਥ੍ਰੈਡ ਵਿੱਚ ਜਵਾਬ
ਏਜੰਟ ਨੂੰ ਦਿਸ਼ਾ ਦਿੰਦਾ ਹੈ। ਜਦੋਂ ਏਜੰਟ ਨੂੰ ਕੋਈ ਫ਼ੈਸਲਾ ਚਾਹੀਦਾ ਹੁੰਦਾ ਹੈ, ਉਹ ਉੱਥੇ ਤੁਹਾਨੂੰ ਪੁੱਛਦਾ ਹੈ ਅਤੇ
ਤੁਹਾਡੇ ਜਵਾਬ ਦੀ ਉਡੀਕ ਕਰਦਾ ਹੈ।

ThunderPhone ਤੁਹਾਡੇ ਲਈ ਇਸ ਬੋਟ ਨੂੰ ਹੋਸਟ ਨਹੀਂ ਕਰਦਾ। ਤੁਸੀਂ (ਜਾਂ ਤੁਹਾਡਾ ਕੋਡਿੰਗ ਏਜੰਟ) ਇੱਕ
ਛੋਟਾ ਸਰਵਰ ਬਣਾਉਂਦੇ ਹੋ ਜੋ ਤੁਹਾਡੀ ਚੈਟ ਐਪ ਨੂੰ ਜਨਤਕ API ਨਾਲ ਜੋੜਦਾ ਹੈ। ਇਹ ਪੰਨਾ ਇਸ ਦੇ
ਹਿੱਸੇ ਦਿਖਾਉਂਦਾ ਹੈ। ਇਹ Slack, Microsoft Teams, Discord ਜਾਂ ਕਿਸੇ ਨਿੱਜੀ
ਵੈੱਬ ਚੈਟ ਪੰਨੇ ਲਈ ਇੱਕੋ ਜਿਹੇ ਹਨ; ਉਦਾਹਰਨਾਂ ਵਿੱਚ Slack ਵਰਤਿਆ ਗਿਆ ਹੈ।

## ਇਹ ਇਕੱਠੇ ਕਿਵੇਂ ਕੰਮ ਕਰਦਾ ਹੈ

| ਤੁਸੀਂ ਚੈਟ ਵਿੱਚ ਇਹ ਕਰਦੇ ਹੋ | ਤੁਹਾਡਾ ਬੋਟ ਇਹ ਕਾਲ ਕਰਦਾ ਹੈ | ਕੀ ਹੁੰਦਾ ਹੈ |
|---|---|---|
| "Comcast ਨੂੰ ਕਾਲ ਕਰੋ ਅਤੇ ਆਊਟੇਜ ਦਾ ETA ਲਵੋ" ਭੇਜੋ | ਸੁਨੇਹੇ ਨੂੰ `context` ਵਜੋਂ ਵਰਤ ਕੇ [`POST /v1/call`](/api-reference/outbound-calls) | ਏਜੰਟ ਡਾਇਲ ਕਰਦਾ ਹੈ। ਤੁਹਾਡਾ ਬੋਟ ਕਾਲ ਲਈ ਇੱਕ ਥ੍ਰੈਡ ਖੋਲ੍ਹਦਾ ਹੈ |
| ਥ੍ਰੈਡ ਦੇਖੋ | [`telephony.turn`](/pa/webhooks/events) ਵੈੱਬਹੁੱਕ ਪ੍ਰਾਪਤ ਕਰਦਾ ਹੈ | ਏਜੰਟ ਜਾਂ ਦੂਜਾ ਵਿਅਕਤੀ ਜੋ ਵੀ ਲਾਈਨ ਕਹਿੰਦਾ ਹੈ, ਉਹ ਥ੍ਰੈਡ ਵਿੱਚ ਦਿਖਾਈ ਦਿੰਦੀ ਹੈ |
| ਕਾਲ ਦੌਰਾਨ ਥ੍ਰੈਡ ਵਿੱਚ ਜਵਾਬ ਦਿਓ | [`POST /v1/calls/{call_id}/whisper`](/api-reference/calls#whisper-to-the-agent) | ਏਜੰਟ ਨੂੰ ਤੁਹਾਡਾ ਨੋਟ ਨਿੱਜੀ ਤੌਰ 'ਤੇ ਮਿਲਦਾ ਹੈ ਅਤੇ ਉਹ ਉਸ ਮੁਤਾਬਕ ਕਾਰਵਾਈ ਕਰਦਾ ਹੈ। ਦੂਜਾ ਵਿਅਕਤੀ ਇਸਨੂੰ ਕਦੇ ਨਹੀਂ ਸੁਣਦਾ |
| ਏਜੰਟ ਦੇ ਸਵਾਲ ਦਾ ਜਵਾਬ ਦਿਓ | ਤੁਹਾਡਾ [ਟੂਲ ਐਂਡਪੌਇੰਟ](/pa/guides/build-tool-integration) ਤੁਹਾਡਾ ਜਵਾਬ ਵਾਪਸ ਕਰਦਾ ਹੈ, ਜਾਂ ਬਾਅਦ ਵਿੱਚ [`POST /v1/calls/{call_id}/tool-results`](/api-reference/calls#deliver-a-tool-result) ਰਾਹੀਂ ਪਹੁੰਚਾਉਂਦਾ ਹੈ | ਏਜੰਟ ਇਸ ਨਾਲ ਕਾਲ ਜਾਰੀ ਰੱਖਦਾ ਹੈ; ਹੋਲਡ ਮੋਡ ਵਿੱਚ ਇਸ ਦੌਰਾਨ ਦੂਜਾ ਵਿਅਕਤੀ ਹੋਲਡ ਸੰਗੀਤ ਸੁਣਦਾ ਹੈ |
| ਨਤੀਜਾ ਪੜ੍ਹੋ | [`telephony.complete`](/pa/webhooks/events) ਪ੍ਰਾਪਤ ਕਰਦਾ ਹੈ | ਤੁਹਾਡਾ ਬੋਟ ਸੰਖੇਪ ਅਤੇ ਨਤੀਜਾ ਪੋਸਟ ਕਰਦਾ ਹੈ |

ਤੁਹਾਡਾ ਬੋਟ ਇੱਕ ਮੈਪਿੰਗ ਰੱਖਦਾ ਹੈ: ਕਿਹੜਾ ਚੈਟ ਥ੍ਰੈਡ ਕਿਸ `call_id` ਨਾਲ ਸਬੰਧਿਤ ਹੈ।

## ਸ਼ੁਰੂ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ

- **ਇੱਕ API ਕੁੰਜੀ**, ਜੋ ਤੁਹਾਡੇ ਸਰਵਰ 'ਤੇ ਰੱਖੀ ਜਾਂਦੀ ਹੈ ਅਤੇ ਕਦੇ ਵੀ ਬ੍ਰਾਊਜ਼ਰ ਜਾਂ ਚੈਟ ਵਿੱਚ ਨਹੀਂ।
  ਇਸਨੂੰ **ਸੰਗਠਨ ਸੈਟਿੰਗਾਂ → ਕੁੰਜੀਆਂ** ਹੇਠ ਬਣਾਓ (ਵੇਖੋ
  [ਕੁੰਜੀਆਂ](/pa/guides/organization-settings))।
- **ਕਾਲਾਂ ਲਈ ਆਊਟਬਾਊਂਡ-ਸਮਰੱਥ ਨੰਬਰ ਅਤੇ ਇੱਕ ਏਜੰਟ**। ਸੁਨੇਹਾ
  ਹਰ ਕਾਲ ਦਾ `context` ਬਣਦਾ ਹੈ, ਇਸ ਲਈ ਇੱਕ ਆਮ ਏਜੰਟ ਹਰ ਕੰਮ ਸੰਭਾਲ ਸਕਦਾ ਹੈ।
- **ਇੱਕ ਸਰਵਰ** ਜੋ ਵੈੱਬਹੁੱਕ ਪ੍ਰਾਪਤ ਕਰ ਸਕਦਾ ਹੋਵੇ, ਜਿਵੇਂ Railway, Fly.io, Render ਜਾਂ
  ਤੁਹਾਡਾ ਆਪਣਾ ਹੋਸਟ।
- **ਇੱਕ ਵੈੱਬਹੁੱਕ ਐਂਡਪੌਇੰਟ** ਜੋ ਉਸ ਸਰਵਰ ਵੱਲ ਇਸ਼ਾਰਾ ਕਰਦਾ ਹੋਵੇ ਅਤੇ
  `telephony.turn` ਅਤੇ `telephony.complete` ਲਈ ਸਬਸਕ੍ਰਾਈਬ ਹੋਵੇ। ਟਰਨ ਇਵੈਂਟ ਸਿਰਫ਼ ਉਨ੍ਹਾਂ
  ਐਂਡਪੌਇੰਟਾਂ ਨੂੰ ਭੇਜੇ ਜਾਂਦੇ ਹਨ ਜੋ ਉਨ੍ਹਾਂ ਨੂੰ ਸੂਚੀਬੱਧ ਕਰਦੇ ਹਨ। ਵੇਖੋ [ਵੈੱਬਹੁੱਕ](/pa/webhooks/endpoints)।
  ਟਰਨ ਇਵੈਂਟਾਂ ਲਈ ਏਜੰਟ ਦੀ ਕਾਲ ਰਿਕਾਰਡਿੰਗ ਚਾਲੂ ਹੋਣੀ ਚਾਹੀਦੀ ਹੈ, ਅਤੇ ਕਾਲ ਦੇ ਅੰਤ ਵਾਲੇ
  `summary` ਲਈ ਏਜੰਟ ਦੀ **ਕਾਲ ਸੰਖੇਪ ਬਣਾਓ** ਸੈਟਿੰਗ ਚਾਹੀਦੀ ਹੈ; ਇਨ੍ਹਾਂ ਤੋਂ ਬਿਨਾਂ
  ਉਹ ਫ਼ੀਲਡ ਖਾਲੀ ਰਹਿੰਦੇ ਹਨ।
- **ਤੁਹਾਡੀ ਆਪਣੀ ਚੈਟ ਐਪ।** Slack ਲਈ, ਆਪਣੇ ਵਰਕਸਪੇਸ ਵਿੱਚ
  [api.slack.com/apps](https://api.slack.com/apps) 'ਤੇ ਇੱਕ ਐਪ ਬਣਾਓ।

<Tip>
  ਆਪਣੇ ਖੁਦ ਦੇ ਵਰਕਸਪੇਸ ਲਈ ਬਣਾਈ Slack ਐਪ ਵਰਤੋ, ਅਤੇ ਚੈਨਲ ਹਿਸਟਰੀ ਪੜ੍ਹਨ ਦੀ ਬਜਾਏ
  Slack ਦੇ Events API ਰਾਹੀਂ ਸੁਨੇਹੇ ਪ੍ਰਾਪਤ ਕਰੋ। Slack ਆਪਣੇ Marketplace ਤੋਂ ਬਾਹਰ ਹੋਰ
  ਵਰਕਸਪੇਸਾਂ ਵਿੱਚ ਵੰਡੀਆਂ ਐਪਾਂ 'ਤੇ ਪੜ੍ਹਨ ਦੀਆਂ ਸਖ਼ਤ ਸੀਮਾਵਾਂ ਲਗਾਉਂਦਾ ਹੈ; ਆਪਣੇ ਵਰਕਸਪੇਸ ਲਈ
  ਬਣਾਈ ਐਪ ਉਨ੍ਹਾਂ ਸੀਮਾਵਾਂ ਅਧੀਨ ਨਹੀਂ ਹੁੰਦੀ, ਅਤੇ ਬਿਨਾਂ ਕੋਈ ਰੀਡ ਕੀਤੇ ਇਵੈਂਟ ਤੁਹਾਡੇ ਤੱਕ
  ਹੋਣ ਦੇ ਨਾਲ ਹੀ ਪਹੁੰਚ ਜਾਂਦੇ ਹਨ। ਆਮ ਬੋਟ ਸਕੋਪ: `chat:write`, `app_mentions:read`, `im:history` (ਸਿੱਧੇ
  ਸੁਨੇਹੇ), `channels:history` ਅਤੇ `groups:history` (ਉਨ੍ਹਾਂ ਜਨਤਕ ਅਤੇ ਨਿੱਜੀ ਚੈਨਲਾਂ ਵਿੱਚ
  ਥ੍ਰੈਡ ਜਵਾਬ ਜਿੱਥੇ ਬੋਟ ਮੌਜੂਦ ਹੈ)। ਬੋਟ ਇਵੈਂਟਾਂ `app_mention`, `message.im`, `message.channels` ਅਤੇ
  `message.groups` ਲਈ ਸਬਸਕ੍ਰਾਈਬ ਕਰੋ, ਅਤੇ ਲੋਕਾਂ ਨੂੰ ਬੋਟ ਨੂੰ DM ਕਰਨ ਦੇਣ ਲਈ App Home ਹੇਠ
  Messages ਟੈਬ ਚਾਲੂ ਕਰੋ।
</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` ਰਾਹੀਂ ਥ੍ਰੈੱਡ ਲੱਭੋ ਅਤੇ
ਲਾਈਨ ਪੋਸਟ ਕਰੋ।

- ਇਸ 'ਤੇ ਕਾਰਵਾਈ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ **ਹਰ ਵੈੱਬਹੁੱਕ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ**। ਵੇਖੋ
  [ਵੈੱਬਹੁੱਕ ਦਸਤਖ਼ਤਾਂ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ](/pa/guides/verify-webhook-signatures)।
- **ਐਨਵਲਪ ਦੇ `event_id` ਦੇ ਆਧਾਰ 'ਤੇ ਡੀਡੁਪਲੀਕੇਟ ਕਰੋ ਅਤੇ `position` ਅਨੁਸਾਰ ਕ੍ਰਮਬੱਧ ਕਰੋ।**
  ਡਿਲਿਵਰੀ ਘੱਟੋ-ਘੱਟ ਇੱਕ ਵਾਰ ਹੁੰਦੀ ਹੈ ਅਤੇ ਵਾਰੀਆਂ ਕ੍ਰਮ ਤੋਂ ਬਾਹਰ ਆ ਸਕਦੀਆਂ ਹਨ।
- ਜੇ ਕੋਈ ਰੁੱਝੀ ਹੋਈ ਕਾਲ ਥ੍ਰੈੱਡ ਨੂੰ ਭਰ ਸਕਦੀ ਹੋਵੇ ਤਾਂ **ਲਾਈਨਾਂ ਨੂੰ ਬੈਚ ਕਰੋ**; ਹਰ
  ਲਾਈਨ ਲਈ ਇੱਕ ਸੁਨੇਹੇ ਦੀ ਬਜਾਏ ਹਰ ਕੁਝ ਸਕਿੰਟਾਂ ਬਾਅਦ ਪੋਸਟ ਕਰਨਾ ਵਧੀਆ ਪੜ੍ਹਿਆ ਜਾਂਦਾ ਹੈ।

ਜਦੋਂ `telephony.complete` ਆਵੇ, ਤਾਂ ਕਾਲ ਕਿਵੇਂ ਖਤਮ ਹੋਈ (`status`
ਅਤੇ `end_reason`), `summary`, ਅਤੇ ਕੱਢਿਆ ਗਿਆ ਕੋਈ ਵੀ ਡਾਟਾ ਪੋਸਟ ਕਰੋ ਅਤੇ
ਥ੍ਰੈੱਡ ਬੰਦ ਕਰੋ। ਫੀਲਡਾਂ ਲਈ [ਕਾਲ ਪੂਰੀ ਹੋਈ](/pa/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 ਕਨੈਕਸ਼ਨ](/pa/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` ਤੋਂ ਪਹਿਲਾਂ ਜਵਾਬ ਨਹੀਂ ਦਿੰਦਾ, ਤਾਂ ਏਜੰਟ ਨੂੰ ਦੱਸਿਆ ਜਾਂਦਾ ਹੈ ਕਿ ਕੋਈ ਜਵਾਬ ਨਹੀਂ ਆਇਆ ਅਤੇ ਉਹ
ਦੂਜੇ ਵਿਅਕਤੀ ਨੂੰ ਅਗਲੇ ਕਦਮ ਪੇਸ਼ ਕਰਦਾ ਹੈ। ਜਦੋਂ ਕਾਲ ਲਈ ਕੋਈ ਸਵਾਲ ਪੈਂਡਿੰਗ ਹੋਵੇ, ਤਾਂ ਉਸ ਦੇ
ਥ੍ਰੈਡ ਵਿੱਚ ਅਗਲਾ ਜਵਾਬ ਉਸਦਾ ਜਵਾਬ ਹੁੰਦਾ ਹੈ: ਇਸਨੂੰ ਟੂਲ ਨਤੀਜੇ ਵਜੋਂ ਭੇਜੋ ਅਤੇ
ਇਸਨੂੰ ਵਿਸਪਰ ਵਜੋਂ ਵੀ ਨਾ ਭੇਜੋ (ਵਿਸਪਰ ਟੂਲ ਵਾਪਸ ਆਉਣ ਤੋਂ ਬਾਅਦ ਹੀ ਏਜੰਟ ਤੱਕ ਪਹੁੰਚਦਾ ਹੈ)।
ਵੇਖੋ
[ਲੰਬੀਆਂ ਉਡੀਕਾਂ](/pa/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 ਕੁੰਜੀ ਆਪਣੇ ਸਰਵਰ 'ਤੇ ਰੱਖੋ।
- webhooks ਅਤੇ ਟੂਲ ਬੇਨਤੀਆਂ 'ਤੇ ThunderPhone ਦੇ ਦਸਤਖਤਾਂ ਦੀ, ਅਤੇ Slack ਦੀਆਂ ਬੇਨਤੀਆਂ 'ਤੇ Slack ਦੇ signing secret ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ। ThunderPhone ਦੇ ਦੋਵੇਂ ਦਸਤਖਤ ਵੱਖ-ਵੱਖ secrets ਵਰਤਦੇ ਹਨ: webhook ਡਿਲਿਵਰੀਆਂ webhook endpoint ਦਾ ਆਪਣਾ secret ਵਰਤਦੀਆਂ ਹਨ, ਅਤੇ ਟੂਲ ਬੇਨਤੀਆਂ ਤੁਹਾਡੀ ਸੰਸਥਾ ਦਾ [`GET /v1/webhook`](/api-reference/organizations#legacy-single-url-webhook) ਵਾਲਾ webhook secret ਵਰਤਦੀਆਂ ਹਨ।
- ਫੈਸਲਾ ਕਰੋ ਕਿ ਕੌਣ ਕਾਲਾਂ ਸ਼ੁਰੂ ਕਰ ਸਕਦਾ ਹੈ: ਕਾਲ ਲਗਾਉਣ ਤੋਂ ਪਹਿਲਾਂ Slack user ID ਦੀ ਜਾਂਚ ਕਰੋ।
- ਆਊਟਬਾਊਂਡ ਕਾਲਾਂ ਹੋਰ ਸਭ ਕਾਲਾਂ ਵਾਂਗ ਹੀ ਨਿਯਮਾਂ ਦੀ ਪਾਲਣਾ ਕਰਦੀਆਂ ਹਨ। [ਆਊਟਬਾਊਂਡ ਕਾਲਿੰਗ ਕਾਨੂੰਨ](/pa/guides/outbound-calling-laws) ਵੇਖੋ।

## ਇਸਨੂੰ coding agent ਨਾਲ ਬਣਾਓ

ਆਪਣੇ coding agent ਨੂੰ [docs MCP server](/pa/guides/docs-mcp) ਅਤੇ ਇਸ ਪੰਨੇ ਵੱਲ ਦਿਓ, ਅਤੇ ਕਹੋ ਕਿ "ਮੇਰੇ ThunderPhone ਏਜੰਟ ਲਈ ਇੱਕ Slack bot ਬਣਾਓ ਜੋ ਇਸ ਗਾਈਡ ਦੀ ਪਾਲਣਾ ਕਰਦਾ ਹੋਵੇ"। ThunderPhone ਐਪ ਵਿੱਚ ਮੌਜੂਦ ਸਹਾਇਕ Zeus ਏਜੰਟ ਵਾਲਾ ਪਾਸਾ ਸੈੱਟ ਅੱਪ ਕਰ ਸਕਦਾ ਹੈ (webhook endpoint, ਟੂਲ ਅਤੇ prompt ਲਾਈਨਾਂ) ਅਤੇ ਚੈਟ ਵਿੱਚ bot ਲਈ ਸ਼ੁਰੂਆਤੀ ਕੋਡ ਲਿਖ ਸਕਦਾ ਹੈ।
