Open in
Slack ਜਾਂ ਚੈਟ ਐਪ ਤੋਂ ਕਾਲਾਂ ਚਲਾਓ
ਆਪਣਾ Slack, Teams ਜਾਂ ਵੈੱਬ-ਚੈਟ ਬੌਟ ਬਣਾਓ ਜੋ ਕਾਲਾਂ ਸ਼ੁਰੂ ਕਰੇ, ਉਹਨਾਂ ਨੂੰ ਲਾਈਵ ਫਾਲੋ ਕਰੇ, ਏਜੰਟ ਨੂੰ ਦਿਸ਼ਾ ਦੇਵੇ ਅਤੇ ਜਨਤਕ API ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਇਸਦੇ ਸਵਾਲਾਂ ਦੇ ਜਵਾਬ ਦੇਵੇ।
ਤੁਸੀਂ ਆਪਣੀ ਟੀਮ ਵੱਲੋਂ ਪਹਿਲਾਂ ਹੀ ਵਰਤੀ ਜਾ ਰਹੀ ਚੈਟ ਐਪ ਤੋਂ ਇੱਕ ਏਜੰਟ ਚਲਾ ਸਕਦੇ ਹੋ। ਇੱਕ ਸੁਨੇਹਾ ਕਾਲ ਸ਼ੁਰੂ ਕਰਦਾ ਹੈ। ਕਾਲ ਇੱਕ ਥ੍ਰੈਡ ਵਿੱਚ ਲਾਈਵ ਚੱਲਦੀ ਹੈ। ਥ੍ਰੈਡ ਵਿੱਚ ਜਵਾਬ ਏਜੰਟ ਨੂੰ ਦਿਸ਼ਾ ਦਿੰਦਾ ਹੈ। ਜਦੋਂ ਏਜੰਟ ਨੂੰ ਕੋਈ ਫ਼ੈਸਲਾ ਚਾਹੀਦਾ ਹੁੰਦਾ ਹੈ, ਉਹ ਉੱਥੇ ਤੁਹਾਨੂੰ ਪੁੱਛਦਾ ਹੈ ਅਤੇ ਤੁਹਾਡੇ ਜਵਾਬ ਦੀ ਉਡੀਕ ਕਰਦਾ ਹੈ।
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. ਸੁਨੇਹੇ ਤੋਂ ਕਾਲ ਸ਼ੁਰੂ ਕਰੋ
ਜਦੋਂ ਤੁਹਾਡੇ ਬੋਟ ਨੂੰ ਕੋਈ ਸੁਨੇਹਾ ਮਿਲਦਾ ਹੈ (ਸਿੱਧਾ ਸੁਨੇਹਾ ਜਾਂ @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 ਕੁੰਜੀ ਆਪਣੇ ਸਰਵਰ 'ਤੇ ਰੱਖੋ।
- webhooks ਅਤੇ ਟੂਲ ਬੇਨਤੀਆਂ 'ਤੇ ThunderPhone ਦੇ ਦਸਤਖਤਾਂ ਦੀ, ਅਤੇ Slack ਦੀਆਂ ਬੇਨਤੀਆਂ 'ਤੇ Slack ਦੇ signing secret ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ। ThunderPhone ਦੇ ਦੋਵੇਂ ਦਸਤਖਤ ਵੱਖ-ਵੱਖ secrets ਵਰਤਦੇ ਹਨ: webhook ਡਿਲਿਵਰੀਆਂ webhook endpoint ਦਾ ਆਪਣਾ secret ਵਰਤਦੀਆਂ ਹਨ, ਅਤੇ ਟੂਲ ਬੇਨਤੀਆਂ ਤੁਹਾਡੀ ਸੰਸਥਾ ਦਾ
GET /v1/webhookਵਾਲਾ webhook secret ਵਰਤਦੀਆਂ ਹਨ। - ਫੈਸਲਾ ਕਰੋ ਕਿ ਕੌਣ ਕਾਲਾਂ ਸ਼ੁਰੂ ਕਰ ਸਕਦਾ ਹੈ: ਕਾਲ ਲਗਾਉਣ ਤੋਂ ਪਹਿਲਾਂ Slack user ID ਦੀ ਜਾਂਚ ਕਰੋ।
- ਆਊਟਬਾਊਂਡ ਕਾਲਾਂ ਹੋਰ ਸਭ ਕਾਲਾਂ ਵਾਂਗ ਹੀ ਨਿਯਮਾਂ ਦੀ ਪਾਲਣਾ ਕਰਦੀਆਂ ਹਨ। ਆਊਟਬਾਊਂਡ ਕਾਲਿੰਗ ਕਾਨੂੰਨ ਵੇਖੋ।
ਇਸਨੂੰ coding agent ਨਾਲ ਬਣਾਓ
ਆਪਣੇ coding agent ਨੂੰ docs MCP server ਅਤੇ ਇਸ ਪੰਨੇ ਵੱਲ ਦਿਓ, ਅਤੇ ਕਹੋ ਕਿ "ਮੇਰੇ ThunderPhone ਏਜੰਟ ਲਈ ਇੱਕ Slack bot ਬਣਾਓ ਜੋ ਇਸ ਗਾਈਡ ਦੀ ਪਾਲਣਾ ਕਰਦਾ ਹੋਵੇ"। ThunderPhone ਐਪ ਵਿੱਚ ਮੌਜੂਦ ਸਹਾਇਕ Zeus ਏਜੰਟ ਵਾਲਾ ਪਾਸਾ ਸੈੱਟ ਅੱਪ ਕਰ ਸਕਦਾ ਹੈ (webhook endpoint, ਟੂਲ ਅਤੇ prompt ਲਾਈਨਾਂ) ਅਤੇ ਚੈਟ ਵਿੱਚ bot ਲਈ ਸ਼ੁਰੂਆਤੀ ਕੋਡ ਲਿਖ ਸਕਦਾ ਹੈ।