Open in
ਫੰਕਸ਼ਨ ਟੂਲਜ਼
ਆਪਣੇ AI ਏਜੰਟਾਂ ਨੂੰ ਫੰਕਸ਼ਨ ਟੂਲਜ਼ ਦਿਓ ਜੋ ਗੱਲਬਾਤ ਦੌਰਾਨ ਬਾਹਰੀ API ਕਾਲ ਕਰਦੇ ਹਨ — ਗਾਹਕ ਡਾਟਾ ਪ੍ਰਾਪਤ ਕਰੋ, ਅਪਾਇੰਟਮੈਂਟ ਬੁੱਕ ਕਰੋ, ਰਿਕਾਰਡ ਅੱਪਡੇਟ ਕਰੋ — ਟਾਈਪ ਕੀਤੇ ਪੈਰਾਮੀਟਰਾਂ ਨਾਲ।
ਫੰਕਸ਼ਨ ਟੂਲ ਤੁਹਾਡੇ AI ਏਜੰਟਾਂ ਨੂੰ ਫ਼ੋਨ ਕਾਲਾਂ ਦੌਰਾਨ ਬਾਹਰੀ APIs ਨੂੰ ਇਨਵੋਕ ਕਰਨ ਦੀ ਆਗਿਆ ਦਿੰਦੇ ਹਨ। ਗਾਹਕ ਡਾਟਾ ਲੱਭਣ, ਉਪਲਬਧਤਾ ਜਾਂਚਣ, ਅਪਾਇੰਟਮੈਂਟ ਬੁੱਕ ਕਰਨ, ਜਾਂ ਤੁਹਾਡੇ ਬੈਕਐਂਡ ਵੱਲੋਂ ਸਮਰਥਿਤ ਕੋਈ ਵੀ ਕਾਰਵਾਈ ਕਰਨ ਲਈ ਇਨ੍ਹਾਂ ਦੀ ਵਰਤੋਂ ਕਰੋ।
ਇਹ ਕਿਵੇਂ ਕੰਮ ਕਰਦਾ ਹੈ
- ਤੁਸੀਂ ਸਕੀਮਾ ਨਾਲ ਟੂਲ ਪਰਿਭਾਸ਼ਿਤ ਕਰਦੇ ਹੋ (ਟੂਲ ਕਿਹੜੇ ਆਰਗੂਮੈਂਟ ਸਵੀਕਾਰ ਕਰਦਾ ਹੈ)
- ਤੁਸੀਂ ਇੱਕ
endpointਕਨਫਿਗਰੇਸ਼ਨ ਦਿੰਦੇ ਹੋ (ThunderPhone ਤੁਹਾਡੀ API ਨੂੰ ਕਿੱਥੇ ਕਾਲ ਕਰਦਾ ਹੈ) — ਜਾਂ ਆਪਣੀ ਸੰਸਥਾ ਦੇ ਵੈੱਬਹੁੱਕ 'ਤੇ ਟੂਲ ਕਾਲਾਂ ਪ੍ਰਾਪਤ ਕਰਨ ਲਈ ਇਸਨੂੰ ਨਾ ਦਿਓ - ਕਾਲ ਦੌਰਾਨ, AI ਗੱਲਬਾਤ ਦੇ ਆਧਾਰ 'ਤੇ ਫ਼ੈਸਲਾ ਕਰਦਾ ਹੈ ਕਿ ਟੂਲ ਕਦੋਂ ਵਰਤਣਾ ਹੈ
- ThunderPhone ਟੂਲ ਆਰਗੂਮੈਂਟਾਂ ਨਾਲ ਤੁਹਾਡੇ ਐਂਡਪੌਇੰਟ ਨੂੰ ਕਾਲ ਕਰਦਾ ਹੈ
- ਗੱਲਬਾਤ ਜਾਰੀ ਰੱਖਣ ਲਈ ਤੁਹਾਡਾ API ਜਵਾਬ ਵਾਪਸ AI ਨੂੰ ਦਿੱਤਾ ਜਾਂਦਾ ਹੈ
| ਸਮਰੱਥਾ | ਇਹ ਕਿੱਥੇ ਚੱਲਦਾ ਹੈ | ਸੈੱਟਅੱਪ |
|---|---|---|
| ਬਿਲਟ-ਇਨ ਟੂਲ | ThunderPhone | ਪ੍ਰੌਮਪਟ ਹਦਾਇਤਾਂ; ਕੁਝ ਟੂਲਾਂ ਨੂੰ ਏਜੰਟ ਸੈਟਿੰਗ ਦੀ ਵੀ ਲੋੜ ਹੁੰਦੀ ਹੈ |
| ਐਪ ਕਨੈਕਸ਼ਨ | ThunderPhone ਅਤੇ ਕਨੈਕਟ ਕੀਤਾ ਪ੍ਰੋਵਾਈਡਰ | ਖਾਤਾ ਕਨੈਕਟ ਕਰੋ ਅਤੇ ਮਨਜ਼ੂਰਸ਼ੁਦਾ ਕਾਰਵਾਈਆਂ ਅਟੈਚ ਕਰੋ |
| API ਕਨੈਕਸ਼ਨ ਅਤੇ ਫੰਕਸ਼ਨ ਟੂਲ | ਤੁਹਾਡੀ HTTP API | ਐਂਡਪੌਇੰਟ ਅਤੇ ਸਕੀਮਾ ਪਰਿਭਾਸ਼ਿਤ ਕਰੋ, ਜਾਂ ਵੈੱਬਹੁੱਕ ਰਾਹੀਂ ਫੰਕਸ਼ਨ ਕਾਲਾਂ ਪ੍ਰਾਪਤ ਕਰੋ |
| MCP ਸਰਵਰ | ਇੱਕ ਰਿਮੋਟ MCP ਸਰਵਰ | ਸਰਵਰ ਜੋੜੋ, ਇਸਦੇ ਟੂਲ ਖੋਜੋ, ਅਤੇ ਇਸਨੂੰ ਏਜੰਟ ਨਾਲ ਅਟੈਚ ਕਰੋ |
ਟੂਲ ਸਕੀਮਾ
ਹਰੇਕ ਟੂਲ ਇਸ ਬਣਤਰ ਦੀ ਪਾਲਣਾ ਕਰਦਾ ਹੈ:
{
"type": "function",
"function": {
"name": "search_appointments",
"description": "Find available appointment slots for a given date",
"parameters": {
"type": "object",
"properties": {
"date": {
"type": "string",
"description": "Date in YYYY-MM-DD format"
},
"service": {
"type": "string",
"description": "Type of service (e.g., 'consultation', 'follow-up')"
}
},
"required": ["date"]
}
},
"endpoint": {
"url": "https://api.example.com/appointments/search",
"method": "POST",
"headers": {
"X-Api-Key": "your-api-key"
}
},
"timeout": 120
}ਟੂਲ ਕਨਫਿਗਰੇਸ਼ਨ
| ਫੀਲਡ | ਕਿਸਮ | ਲਾਜ਼ਮੀ | ਵੇਰਵਾ |
|---|---|---|---|
timeout | ਨੰਬਰ | ਨਹੀਂ | ਸਕਿੰਟਾਂ ਵਿੱਚ ਵੱਧ ਤੋਂ ਵੱਧ ਐਗਜ਼ਿਕਿਊਸ਼ਨ ਸਮਾਂ (ਡਿਫਾਲਟ: 20, ਵੱਧ ਤੋਂ ਵੱਧ: 180, ਜਾਂ wait_mode: "hold" ਨਾਲ 600) |
wait_mode | ਸਟ੍ਰਿੰਗ | ਨਹੀਂ | ਟੂਲ ਚੱਲਣ ਦੌਰਾਨ ਕਾਲਰ ਕੀ ਸੁਣਦਾ ਹੈ: updates (ਡਿਫਾਲਟ), ਛੋਟੇ ਬੋਲੇ ਗਏ ਅੱਪਡੇਟ; ਜਾਂ hold, ਹੋਲਡ ਸੰਗੀਤ। ਵੇਖੋ ਲੰਬੇ ਇੰਤਜ਼ਾਰ: ਹੋਲਡ ਮੋਡ ਅਤੇ ਬਾਅਦ ਵਿੱਚ ਜਵਾਬ ਦਿਓ |
call_start | ਆਬਜੈਕਟ | ਨਹੀਂ | ਹਰ ਫ਼ੋਨ ਕਾਲ ਦੀ ਸ਼ੁਰੂਆਤ ਵਿੱਚ, ਗ੍ਰੀਟਿੰਗ ਤੋਂ ਪਹਿਲਾਂ, ਟੂਲ ਆਪਣੇ ਆਪ ਵੀ ਚਲਾਓ। ਵੇਖੋ ਕਾਲ ਦੀ ਸ਼ੁਰੂਆਤ ਵਿੱਚ ਟੂਲ ਚਲਾਓ |
ਫੰਕਸ਼ਨ ਪਰਿਭਾਸ਼ਾ
| ਫੀਲਡ | ਕਿਸਮ | ਲਾਜ਼ਮੀ | ਵੇਰਵਾ |
|---|---|---|---|
name | ਸਟ੍ਰਿੰਗ | ਹਾਂ | ਟੂਲ ਲਈ ਪਛਾਣਕਰਤਾ, ਜੋ ਇੱਕ ਕਾਲ ਦੇ ਟੂਲਾਂ ਵਿੱਚ ਵਿਲੱਖਣ ਹੋਵੇ। ਵੱਖ-ਵੱਖ ਏਜੰਟਾਂ ਕੋਲ ਇੱਕੋ ਨਾਮ ਵਾਲਾ ਆਪਣਾ ਟੂਲ ਹੋ ਸਕਦਾ ਹੈ |
description | ਸਟ੍ਰਿੰਗ | ਹਾਂ | AI ਨੂੰ ਦੱਸਦਾ ਹੈ ਕਿ ਇਹ ਟੂਲ ਕਦੋਂ ਵਰਤਣਾ ਹੈ |
parameters | ਆਬਜੈਕਟ | ਹਾਂ | ਟੂਲ ਆਰਗੂਮੈਂਟਾਂ ਲਈ JSON Schema |
ਐਂਡਪੌਇੰਟ ਕਨਫਿਗਰੇਸ਼ਨ
| ਖੇਤਰ | ਕਿਸਮ | ਲਾਜ਼ਮੀ | ਵੇਰਵਾ |
|---|---|---|---|
url | ਸਟ੍ਰਿੰਗ | ਹਾਂ | ਤੁਹਾਡਾ API ਐਂਡਪੌਇੰਟ URL |
method | ਸਟ੍ਰਿੰਗ | ਨਹੀਂ | HTTP ਵਿਧੀ (ਡਿਫਾਲਟ: POST) |
headers | ਆਬਜੈਕਟ | ਨਹੀਂ | ਸ਼ਾਮਲ ਕਰਨ ਲਈ ਕਸਟਮ ਹੈਡਰ |
ਦੋ ਇਨਵੋਕੇਸ਼ਨ ਮਾਰਗ
ਤੁਹਾਡੇ ਸਰਵਰ ਨੂੰ ਕਿਹੜੀ ਬੇਨਤੀ ਮਿਲਦੀ ਹੈ, ਇਹ ਇਸ ਗੱਲ 'ਤੇ ਨਿਰਭਰ ਕਰਦਾ ਹੈ ਕਿ ਟੂਲ ਕੋਲ
endpoint ਹੈ ਜਾਂ ਨਹੀਂ:
endpoint ਵਾਲਾ ਟੂਲ | endpoint ਤੋਂ ਬਿਨਾਂ ਟੂਲ | |
|---|---|---|
| ਬੇਨਤੀ ਕਿੱਥੇ ਜਾਂਦੀ ਹੈ | ਸਿੱਧਾ endpoint.url ਨੂੰ | ਤੁਹਾਡੀ ਸੰਸਥਾ ਦਾ ਪੁਰਾਣਾ webhook URL |
| ਬੌਡੀ | ਚੁਣਿਆ ਬੇਨਤੀ ਫਾਰਮੈਟ (ਮੂਲ ਰੂਪ ਵਿੱਚ ਸਿਰਫ਼ ਆਰਗੂਮੈਂਟ) | telephony.tool / web.tool ਲਿਫਾਫਾ |
| ਹੈਡਰ | ਤੁਹਾਡੇ endpoint.headers + X-ThunderPhone-Call-ID + X-ThunderPhone-Signature-V2 + X-ThunderPhone-Signature, ਨਾਲ ਹੀ ਫੋਨ ਕਾਲਾਂ ਵਿੱਚ ਕਾਲ ਦੇ ਨੰਬਰ | Content-Type + X-ThunderPhone-Signature-V2 + X-ThunderPhone-Signature |
| ਸਾਈਨਿੰਗ ਕੁੰਜੀ | ਸੰਸਥਾ ਦਾ webhook ਸੀਕ੍ਰੇਟ | ਸੰਸਥਾ ਦਾ webhook ਸੀਕ੍ਰੇਟ |
ਦੋਵੇਂ ਮਾਰਗ ਬਲੌਕਿੰਗ ਹਨ — AI ਨਤੀਜੇ ਲਈ ਵਾਕ ਦੇ ਵਿਚਕਾਰ ਉਡੀਕ ਕਰ ਰਿਹਾ ਹੁੰਦਾ ਹੈ। ਡਿਫੌਲਟ ਟਾਈਮਆਉਟ 20 s ਹੈ; ਵੱਧ ਤੋਂ ਵੱਧ 180 s ਪਲੇਟਫਾਰਮ ਸੀਮਾ ਤੱਕ ਲੰਮਾ ਐਗਜ਼ਿਕਿਊਸ਼ਨ ਮਨਜ਼ੂਰ ਕਰਨ ਲਈ ਟੂਲ ਦਾ ਟੌਪ-ਲੈਵਲ timeout ਸੈੱਟ ਕਰੋ। ਹੈਂਡਲਰ ਤੇਜ਼ ਰੱਖੋ। ਕਿਸੇ ਵਿਅਕਤੀ ਜਾਂ ਹੌਲੀ ਜੌਬ ਦੀ ਉਡੀਕ ਲਈ, ਹੋਲਡ ਮੋਡ ਵਰਤੋ। ਮਿਸ਼ਰਣ ਵੀ ਠੀਕ ਹੈ:
ਜਿਸ ਕਾਲ ਦੀ ਸੰਸਥਾ ਕੋਲ webhook URL ਹੈ, ਉਸ ਵਿੱਚ endpoint ਵਾਲੇ ਟੂਲ ਸਿੱਧੇ ਕਾਲ ਹੁੰਦੇ ਹਨ ਅਤੇ ਬਾਕੀ webhook 'ਤੇ ਵਾਪਸ ਚਲੇ ਜਾਂਦੇ ਹਨ।
ਸਿੱਧੀਆਂ ਐਂਡਪੌਇੰਟ ਕਾਲਾਂ
ਜਦੋਂ AI ਕਿਸੇ ਅਜਿਹੇ ਟੂਲ ਨੂੰ ਚਲਾਉਂਦਾ ਹੈ ਜਿਸਦਾ endpoint ਹੋਵੇ, ThunderPhone
ਤੁਹਾਡੇ URL ਨੂੰ ਇੱਕ ਬੇਨਤੀ ਭੇਜਦਾ ਹੈ:
ਬੇਨਤੀ ਹੈਡਰ
POST /appointments/search HTTP/1.1
Host: api.example.com
Content-Type: application/json
X-ThunderPhone-Signature-V2: t=1767225600,v1=5f2c...
X-ThunderPhone-Signature: abc123...
X-ThunderPhone-Call-ID: 987654321
X-ThunderPhone-From-Number: +14155550199
X-ThunderPhone-To-Number: +14155550100
X-ThunderPhone-Call-Direction: inbound
X-Api-Key: your-api-keyਤੁਹਾਡੇ endpoint.headers ਤੋਂ ਕਸਟਮ ਹੈਡਰ ਹਮੇਸ਼ਾ
ਜਿਵੇਂ ਦੇ ਤਿਵੇਂ ਸ਼ਾਮਲ ਕੀਤੇ ਜਾਂਦੇ ਹਨ, ਨਾਲ ਹੀ ਇਹ ThunderPhone-ਨੇਮਸਪੇਸ ਵਾਲੇ ਹੈਡਰ:
X-ThunderPhone-Signature-V2— ਮੈਥਡ, ਪਾਥ, ਕੁਐਰੀ ਅਤੇ ਬਾਡੀ ਉੱਤੇ ਟਾਈਮਸਟੈਂਪ ਵਾਲਾ HMAC-SHA256, ਜਿਸ ਵਿੱਚ ਤੁਹਾਡੀ ਸੰਸਥਾ ਦਾ ਵੈੱਬਹੁੱਕ ਸੀਕ੍ਰੇਟ ਕੁੰਜੀ ਵਜੋਂ ਵਰਤਿਆ ਜਾਂਦਾ ਹੈ। ਇਸਦੀ ਪੁਸ਼ਟੀ ਕਰੋ ਅਤੇ 5 ਮਿੰਟਾਂ ਤੋਂ ਪੁਰਾਣੀਆਂ ਬੇਨਤੀਆਂ ਰੱਦ ਕਰੋ; ਵੇਖੋ ਵੈੱਬਹੁੱਕ ਦਸਤਖਤਾਂ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋX-ThunderPhone-Signature— ਬੇਨਤੀ-ਬਾਡੀ ਦੇ ਸਹੀ ਬਾਈਟਾਂ ਦਾ ਪੁਰਾਣਾ HMAC-SHA256, ਉਹੀ ਕੁੰਜੀ, ਮੌਜੂਦਾ ਵੇਰੀਫਾਇਰਾਂ ਲਈ ਅਜੇ ਵੀ ਭੇਜਿਆ ਜਾਂਦਾ ਹੈX-ThunderPhone-Call-ID— ਮੌਜੂਦਾ ਕਾਲ IDX-ThunderPhone-From-NumberਅਤੇX-ThunderPhone-To-Number— ਕਾਲ ਦੇ E.164 ਵਿੱਚ From ਅਤੇ To ਨੰਬਰ। ਇਨ੍ਹਾਂ ਦਾ ਅਰਥtelephony.completeਵਿੱਚfrom_numberਅਤੇto_numberਵਰਗਾ ਹੀ ਹੈ: ਆਊਟਬਾਊਂਡ ਕਾਲ ਵਿੱਚ, From ਤੁਹਾਡੇ ਏਜੰਟ ਦਾ ਨੰਬਰ ਹੁੰਦਾ ਹੈ ਅਤੇ To ਉਸ ਵਿਅਕਤੀ ਦਾ ਹੁੰਦਾ ਹੈ ਜਿਸਨੂੰ ਕਾਲ ਕੀਤੀ ਜਾਂਦੀ ਹੈ। ਜਦੋਂ ਕਾਲਰ ID ਲੁਕਾਈ ਗਈ ਹੋਵੇ ਜਾਂ ਫ਼ੋਨ ਨੰਬਰ ਨਾ ਹੋਵੇ, ਤਾਂ ਨੰਬਰ ਸ਼ਾਮਲ ਨਹੀਂ ਕੀਤਾ ਜਾਂਦਾX-ThunderPhone-Call-Direction—inboundਜਾਂoutbound, ਤਾਂ ਜੋ ਤੁਸੀਂ ਪਤਾ ਕਰ ਸਕੋ ਕਿ ਕਿਹੜਾ ਨੰਬਰ ਗਾਹਕ ਦਾ ਹੈ
ਕਾਲ-ਨੰਬਰ ਹੈਡਰ ਸਿਰਫ਼ ਫ਼ੋਨ ਕਾਲਾਂ ਵਿੱਚ ਭੇਜੇ ਜਾਂਦੇ ਹਨ। ਵੈੱਬ, ਵਿਜਟ,
ਰੀਅਲਟਾਈਮ ਅਤੇ ਬ੍ਰਾਊਜ਼ਰ ਟਾਕ ਟੈਸਟਾਂ ਵਿੱਚ ਫ਼ੋਨ ਨੰਬਰ ਨਹੀਂ ਹੁੰਦਾ ਅਤੇ ਇਹਨਾਂ ਨੂੰ ਸ਼ਾਮਲ ਨਹੀਂ ਕੀਤਾ ਜਾਂਦਾ। ਏਜੰਟ ਐਡੀਟਰ ਤੋਂ ਟੈਸਟ ਕਾਲਾਂ ਅਤੇ AI ਸਿਮੂਲੇਸ਼ਨਾਂ ਵਿੱਚ
ਸਿਮੂਲੇਟ ਕੀਤੇ ਕਾਲਰ ਦਾ ਨੰਬਰ ਹੁੰਦਾ ਹੈ। ਦਸਤਖਤ
ਹੈਡਰਾਂ ਨੂੰ ਕਵਰ ਨਹੀਂ ਕਰਦੇ: V2 ਟਾਈਮਸਟੈਂਪ, ਮੈਥਡ, ਪਾਥ, ਕੁਐਰੀ ਅਤੇ ਬਾਡੀ ਉੱਤੇ ਦਸਤਖਤ ਕਰਦਾ ਹੈ। ਜੇ
ਤੁਹਾਨੂੰ ਨੰਬਰਾਂ ਉੱਤੇ ਦਸਤਖਤ ਚਾਹੀਦੇ ਹਨ, ਤਾਂ ਇਸਦੀ ਬਜਾਏ ਉਨ੍ਹਾਂ ਨੂੰ ਬਾਡੀ ਤੋਂ ਪੜ੍ਹੋ:
retell ਬੇਨਤੀ ਫਾਰਮੈਟ ਵਿੱਚ ਤਿੰਨੇ ਸ਼ਾਮਲ ਹੁੰਦੇ ਹਨ, ਅਤੇ vapi ਵਿੱਚ
ਗਾਹਕ ਦਾ ਨੰਬਰ ਹੁੰਦਾ ਹੈ।
Content-Type: application/json ਸੈੱਟ ਕੀਤਾ ਜਾਂਦਾ ਹੈ, ਜਦੋਂ ਤੱਕ ਤੁਹਾਡੇ endpoint.headers
ਇਸਨੂੰ ਓਵਰਰਾਈਡ ਨਾ ਕਰਨ — ਕਸਟਮ Content-Type ਨੂੰ ਤਰਜੀਹ ਮਿਲਦੀ ਹੈ।
ਬੇਨਤੀ ਫਾਰਮੈਟ
ਹਰੇਕ API ਕਨੈਕਸ਼ਨ ਵਿੱਚ ਇੱਕ request_format ਸੈਟਿੰਗ ਹੁੰਦੀ ਹੈ। ਜਦੋਂ ਇੰਪੋਰਟ ਕੀਤਾ ਟੂਲ ਉਸ ਪਲੇਟਫਾਰਮ ਲਈ ਬਣੇ ਐਂਡਪੌਇੰਟ ਨੂੰ ਕਾਲ ਕਰਦਾ ਰਹੇ, ਤਾਂ vapi ਜਾਂ
retell ਚੁਣੋ। ਨਵੇਂ ਅਤੇ ਮੌਜੂਦਾ ਕਨੈਕਸ਼ਨ ਡਿਫੌਲਟ ਰੂਪ ਵਿੱਚ standard ਵਰਤਦੇ ਹਨ।
POST / PUT / PATCH ਲਈ, ThunderPhone ਚੁਣੇ ਗਏ
ਐਨਵਲਪ ਨੂੰ ਕੈਨੋਨਿਕਲ ਢੰਗ ਨਾਲ ਸੀਰੀਅਲਾਈਜ਼ ਕਰਦਾ ਹੈ (ਲੜੀਬੱਧ ਕੀਜ਼, ਸੰਖੇਪ ਸੈਪਰੇਟਰ)। ਦੋਵੇਂ ਸਿਗਨੇਚਰ ਇਨ੍ਹਾਂ ਸਹੀ ਬਾਈਟਾਂ ਨੂੰ ਕਵਰ ਕਰਦੇ ਹਨ।
ਸਟੈਂਡਰਡ
standard ਬਿਨਾਂ ਕਿਸੇ ਰੈਪਰ ਦੇ ਸਿਰਫ਼ ਟੂਲ ਆਰਗੂਮੈਂਟ ਭੇਜਦਾ ਹੈ। ਇਹ ਡਿਫਾਲਟ ਹੈ ਅਤੇ ThunderPhone ਦੀ ਮੂਲ ਰਿਕਵੇਸਟ ਬਾਡੀ ਨੂੰ ਬਾਈਟ-ਦਰ-ਬਾਈਟ ਸੁਰੱਖਿਅਤ ਰੱਖਦਾ ਹੈ:
{"date":"2025-01-02","service":"consultation"}Vapi
vapi, Vapi ਦੇ [``tool-callsਸਰਵਰ ਸੁਨੇਹੇ](https://docs.vapi.ai/tools/custom-tools) ਨੂੰ Vapi ਵੱਲੋਂ ਦਸਤਾਵੇਜ਼ਬੱਧ ਫਾਰਮੈਟ ਵਿੱਚ ਭੇਜਦਾ ਹੈ।call.idThunderPhone ਕਾਲ ID ਹੈ। ਫ਼ੋਨ ਕਾਲਾਂ ਵਿੱਚ,call.customer.numberਦੂਜੀ ਧਿਰ ਦਾ ਨੰਬਰ ਹੁੰਦਾ ਹੈ, ਜਿਵੇਂ Vapi ਦੇ ਕਾਲ ਆਬਜੈਕਟ ਵਿੱਚ ਹੁੰਦਾ ਹੈ: ਇਨਬਾਊਂਡ ਕਾਲ ਵਿੱਚ ਕਾਲਰ ਅਤੇ ਆਊਟਬਾਊਂਡ ਕਾਲ ਵਿੱਚ ਜਿਸ ਵਿਅਕਤੀ ਨੂੰ ਕਾਲ ਕੀਤੀ ਜਾਂਦੀ ਹੈ। ਜਦੋਂ ਉਹ ਨੰਬਰ ਲੁਕਾਇਆ ਗਿਆ ਹੋਵੇ ਜਾਂ ਫ਼ੋਨ ਨੰਬਰ ਨਾ ਹੋਵੇ, ਤਾਂ ਇਸਨੂੰ ਸ਼ਾਮਲ ਨਹੀਂ ਕੀਤਾ ਜਾਂਦਾ। ਟੂਲ-ਕਾਲidਉਸ ਕਾਲ ਲਈ ਵਿਲੱਖਣ ਹੁੰਦੀ ਹੈ ਅਤੇ ਐਂਡਪੁਆਇੰਟ ਦੇ ਨਤੀਜੇ ਨਾਲ ਮਿਲਾਣ ਲਈ ਦੁਬਾਰਾ ਵਰਤੀ ਜਾਂਦੀ ਹੈ। ਕਾਲtoolCallListਅਤੇtoolWithToolCallListਦੋਵਾਂ ਵਿੱਚ ਦਿਖਾਈ ਦਿੰਦੀ ਹੈ, ਜਿਸ ਵਿੱਚfunction.arguments` ਇੱਕ JSON ਆਬਜੈਕਟ ਹੁੰਦਾ ਹੈ:
{
"message": {
"type": "tool-calls",
"timestamp": 1725000000123,
"call": { "id": "987654321" },
"toolCallList": [
{
"id": "call_00112233445566778899aabbccddeeff",
"type": "function",
"function": {
"name": "search_appointments",
"arguments": { "date": "2025-01-02", "service": "consultation" }
}
}
],
"toolWithToolCallList": [
{
"type": "function",
"function": { "name": "search_appointments" },
"toolCall": {
"id": "call_00112233445566778899aabbccddeeff",
"type": "function",
"function": {
"name": "search_appointments",
"arguments": { "date": "2025-01-02", "service": "consultation" }
}
}
}
]
}
}assistant, artifact ਅਤੇ ਪੂਰਾ call ਆਬਜੈਕਟ ਵਰਗੇ ਸਿਰਫ਼-Vapi ਫੀਲਡ ਨਹੀਂ ਭੇਜੇ ਜਾਂਦੇ।
ਮਿਲਦੀ ਟੂਲ-ਕਾਲ ID ਨਾਲ Vapi ਦਾ ਰਿਸਪਾਂਸ ਐਨਵਲਪ ਵਾਪਸ ਕਰੋ:
{
"results": [
{
"toolCallId": "call_00112233445566778899aabbccddeeff",
"result": "{\"available_slots\":[\"9:00 AM\",\"2:00 PM\"]}"
}
]
}ThunderPhone AI ਨੂੰ ਅਨਰੈਪ ਕੀਤੀ result ਸਟਰਿੰਗ ਦਿੰਦਾ ਹੈ। ਉਹ ਉਹਨਾਂ ਐਂਡਪੌਇੰਟਾਂ ਨਾਲ ਅਨੁਕੂਲਤਾ ਲਈ JSON ਮੁੱਲ ਵੀ ਸਵੀਕਾਰ ਕਰਦਾ ਹੈ ਜੋ ਪਹਿਲਾਂ ਹੀ ਇੱਕ ਮੁੱਲ ਵਾਪਸ ਕਰਦੇ ਹਨ। result ਦੀ ਥਾਂ error ਹੋਣ 'ਤੇ ਇਸਨੂੰ AI ਨੂੰ ਟੂਲ ਗਲਤੀ ਵਜੋਂ ਵਾਪਸ ਕੀਤਾ ਜਾਂਦਾ ਹੈ। ਜੇ ਐਂਡਪੌਇੰਟ ਖਰਾਬ ਫਾਰਮੈਟ ਵਾਲਾ ਜਾਂ ਨਾ ਮਿਲਦਾ Vapi ਐਨਵਲਪ ਵਾਪਸ ਕਰਦਾ ਹੈ, ਤਾਂ ThunderPhone ਚੇਤਾਵਨੀ ਲੌਗ ਕਰਦਾ ਹੈ ਅਤੇ ਕਾਲ ਨੂੰ ਅਸਫਲ ਕਰਨ ਦੀ ਬਜਾਏ ਆਪਣੇ ਮਿਆਰੀ ਰਿਸਪਾਂਸ ਪਾਰਸਿੰਗ 'ਤੇ ਵਾਪਸ ਆ ਜਾਂਦਾ ਹੈ।
Retell
retell ਇੱਕ Retell ਕਸਟਮ
ਫੰਕਸ਼ਨ ਲਈ ਦਸਤਾਵੇਜ਼ਬੱਧ ਬੇਨਤੀ ਭੇਜਦਾ ਹੈ:
{
"name": "search_appointments",
"call": {
"call_id": "987654321",
"from_number": "+14155550199",
"to_number": "+14155550100",
"direction": "inbound"
},
"args": { "date": "2025-01-02", "service": "consultation" }
}ਫੋਨ ਕਾਲਾਂ ਵਿੱਚ, call ਆਬਜੈਕਟ ਵਿੱਚ call_id, from_number,
to_number ਅਤੇ direction (inbound ਜਾਂ outbound) ਹੁੰਦੇ ਹਨ, ਜੋ
Retell ਦੇ ਫੋਨ ਕਾਲ ਆਬਜੈਕਟ ਵੱਲੋਂ ਵਰਤੇ ਜਾਣ ਵਾਲੇ ਫੀਲਡ ਨਾਂ ਹਨ। ਇਹ ਕਾਲ-ਨੰਬਰ
ਹੈਡਰਾਂ ਨਾਲ ਮੇਲ ਖਾਂਦੇ ਹਨ ਅਤੇ ਹੈਡਰਾਂ ਤੋਂ ਉਲਟ, ਦੋਵਾਂ ਸਿਗਨੇਚਰਾਂ ਦੁਆਰਾ ਕਵਰ
ਹੁੰਦੇ ਹਨ। ਜਿਹੜਾ ਨੰਬਰ ਲੁਕਾਇਆ ਗਿਆ ਹੋਵੇ ਜਾਂ ਫੋਨ ਨੰਬਰ ਨਾ ਹੋਵੇ, ਉਹ ਸ਼ਾਮਲ ਨਹੀਂ
ਕੀਤਾ ਜਾਂਦਾ। ਵੈੱਬ, ਵਿਜਿਟ, ਰੀਅਲਟਾਈਮ ਅਤੇ ਬ੍ਰਾਊਜ਼ਰ Talk ਟੈਸਟਾਂ ਵਿੱਚ ਇਸ ਵਿੱਚ
ਸਿਰਫ਼ call_id ਹੁੰਦਾ ਹੈ। ThunderPhone
Retell-ਵਿਸ਼ੇਸ਼ ਫੀਲਡ ਸ਼ਾਮਲ ਨਹੀਂ ਕਰਦਾ ਜੋ ਇਹ ਡਿਸਪੈਚ ਵੇਲੇ ਇਮਾਨਦਾਰੀ ਨਾਲ ਮੁਹੱਈਆ
ਨਹੀਂ ਕਰ ਸਕਦਾ, ਜਿਵੇਂ ਕਿ agent_id, transcript, transcript_object,
metadata ਜਾਂ ਡਾਇਨਾਮਿਕ ਵੇਰੀਏਬਲ। Retell ਕਿਸੇ ਵੀ ਰਿਸਪਾਂਸ ਬਾਡੀ ਨੂੰ ਸਵੀਕਾਰ
ਕਰਦਾ ਹੈ; ThunderPhone ਮਿਆਰੀ ਰਿਸਪਾਂਸ ਹੈਂਡਲਿੰਗ ਵਰਤ ਕੇ ਇਸਨੂੰ ਅੱਗੇ ਭੇਜਦਾ ਹੈ।
GET / DELETE ਲਈ, ਆਰਗੂਮੈਂਟ ਕੁਏਰੀ ਪੈਰਾਮੀਟਰਾਂ ਵਜੋਂ ਭੇਜੇ ਜਾਂਦੇ ਹਨ
ਅਤੇ request_format ਦੀ ਪਰਵਾਹ ਕੀਤੇ ਬਿਨਾਂ ਬੌਡੀ ਖਾਲੀ ਹੁੰਦੀ ਹੈ। V2 ਸਿਗਨੇਚਰ ਭੇਜੀ ਗਈ ਕੁਏਰੀ ਸਟਰਿੰਗ ਨੂੰ ਕਵਰ ਕਰਦਾ ਹੈ; ਲੈਗੇਸੀ ਸਿਗਨੇਚਰ ਖਾਲੀ ਬਾਈਟ ਸਟਰਿੰਗ ਉੱਤੇ ਗਿਣਿਆ ਜਾਂਦਾ ਹੈ। ਵੇਖੋ
ਵੈੱਬਹੁੱਕ ਸਿਗਨੇਚਰਾਂ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ।
ਜਵਾਬ
ਟੂਲ ਨਤੀਜੇ ਦੇ ਨਾਲ ਇੱਕ JSON ਜਵਾਬ ਵਾਪਸ ਕਰੋ:
{
"available_slots": ["9:00 AM", "2:00 PM", "4:30 PM"],
"timezone": "America/Los_Angeles"
}ਜਵਾਬ ਨੂੰ ਫਾਰਮੈਟ ਕਰਕੇ ਗੱਲਬਾਤ ਜਾਰੀ ਰੱਖਣ ਲਈ AI ਨੂੰ ਦਿੱਤਾ ਜਾਂਦਾ ਹੈ।
ਗੈਰ-JSON ਜਵਾਬਾਂ ਨੂੰ {"data": "<text>"} ਵਜੋਂ ਰੈਪ ਕੀਤਾ ਜਾਂਦਾ ਹੈ;
ਟਾਈਮਆਉਟ ਅਤੇ ਕਨੈਕਸ਼ਨ ਅਸਫਲਤਾਵਾਂ AI ਨੂੰ ਗਲਤੀਆਂ ਵਜੋਂ ਦੱਸੀਆਂ ਜਾਂਦੀਆਂ ਹਨ, ਤਾਂ ਜੋ
ਏਜੰਟ ਰੁਕਣ ਦੀ ਬਜਾਏ ਮਾਫ਼ੀ ਮੰਗ ਕੇ ਅੱਗੇ ਵਧ ਸਕੇ।
ਵੈੱਬਹੁੱਕ-ਮੋਡ ਡਿਸਪੈਚ
endpoint ਤੋਂ ਬਿਨਾਂ ਟੂਲ ਤੁਹਾਡੇ ਸੰਗਠਨ ਦੇ ਪੁਰਾਣੇ
ਵੈੱਬਹੁੱਕ URL ਨੂੰ ਸਾਈਨ ਕੀਤੀ telephony.tool (ਫ਼ੋਨ ਕਾਲਾਂ) ਜਾਂ web.tool
(ਵੈੱਬ ਕਾਲਾਂ) ਬੇਨਤੀ ਵਜੋਂ ਭੇਜੇ ਜਾਂਦੇ ਹਨ। ਐਗਜ਼ੀਕਿਊਸ਼ਨ ਤੋਂ ਬਾਅਦ ਵੈੱਬਹੁੱਕ ਐਂਡਪੌਇੰਟਾਂ ਨੂੰ ਭੇਜੀਆਂ ਜਾਣ ਵਾਲੀਆਂ
ਆਡਿਟ ਸੂਚਨਾਵਾਂ ਤੋਂ ਵੱਖਰਾ, ਇਹ ਬੇਨਤੀ ਹੀ
ਐਗਜ਼ੀਕਿਊਸ਼ਨ ਹੈ — ਤੁਹਾਡਾ HTTP ਜਵਾਬ ਹੀ ਟੂਲ ਦਾ ਨਤੀਜਾ ਹੈ।
{
"type": "telephony.tool",
"data": {
"call_id": 987654321,
"tool_name": "search_appointments",
"arguments": { "date": "2026-04-21" },
"from_number": "+14155550199",
"to_number": "+15551234567"
}
}web.tool ਵਿੱਚ from_number / to_number ਦੀ ਥਾਂ origin_domain ਹੁੰਦਾ ਹੈ। ਟੂਲ ਦੇ ਨਤੀਜੇ ਨਾਲ JSON ਵਜੋਂ ਜਵਾਬ ਦਿਓ — ਸਿੱਧੀਆਂ endpoint ਕਾਲਾਂ ਵਾਲਾ ਹੀ ਜਵਾਬ ਕਰਾਰ। ਬੇਨਤੀ ਉੱਤੇ ਹਰ ਹੋਰ webhook ਵਾਂਗ, ਦੋਵੇਂ signature headers ਸਮੇਤ org ਦੇ webhook secret ਨਾਲ ਦਸਤਖ਼ਤ ਹੁੰਦੇ ਹਨ।
ਲੰਬੀਆਂ ਉਡੀਕਾਂ: ਹੋਲਡ ਮੋਡ ਅਤੇ ਬਾਅਦ ਵਿੱਚ ਜਵਾਬ
ਕੁਝ ਟੂਲ ਕਿਸੇ ਵਿਅਕਤੀ ਦੀ ਉਡੀਕ ਕਰਦੇ ਹਨ: ਮੈਨੇਜਰ ਵੱਲੋਂ ਛੂਟ ਮਨਜ਼ੂਰ ਕਰਨਾ, ਮਾਲਕ ਵੱਲੋਂ
Slack ਵਿੱਚ ਕਿਸੇ ਸਵਾਲ ਦਾ ਜਵਾਬ ਦੇਣਾ। ਉਹਨਾਂ ਟੂਲਾਂ ਲਈ wait_mode ਨੂੰ "hold" ਸੈੱਟ ਕਰੋ।
wait_mode: "updates" (ਡਿਫਾਲਟ) | wait_mode: "hold" | |
|---|---|---|
| ਕਾਲਰ ਕੀ ਸੁਣਦਾ ਹੈ | ਟੂਲ-ਸ਼ੁਰੂ ਲਾਈਨ, ਫਿਰ ਲਗਭਗ 12 s ਬਾਅਦ ਇੱਕ ਛੋਟੀ "ਹਾਲੇ ਵੀ ਕੰਮ ਕਰ ਰਿਹਾ ਹੈ" ਲਾਈਨ ਅਤੇ ਲਗਭਗ ਹਰ 15 s ਬਾਅਦ ਇੱਕ ਹੋਰ | ਟੂਲ-ਸ਼ੁਰੂ ਲਾਈਨ, ਫਿਰ ਨਤੀਜਾ ਆਉਣ ਤੱਕ ਹੋਲਡ ਸੰਗੀਤ |
timeout ਦੀ ਅਧਿਕਤਮ ਮਿਆਦ | 180 s | 600 s |
| ਬਕਾਇਆ ਜਵਾਬ | ਨਤੀਜੇ ਵਜੋਂ ਏਜੰਟ ਨੂੰ ਭੇਜੇ ਜਾਂਦੇ ਹਨ | ਜਦੋਂ ਤੱਕ ਤੁਸੀਂ ਨਤੀਜਾ ਨਹੀਂ ਭੇਜਦੇ, ਟੂਲ ਖੁੱਲ੍ਹਾ ਰਹਿੰਦਾ ਹੈ |
ਹੋਲਡ ਮੋਡ ਵਿੱਚ ਟੂਲ ਸ਼ੁਰੂ ਹੋਣ ਵੇਲੇ ਏਜੰਟ ਇੱਕ ਲਾਈਨ ਕਹਿੰਦਾ ਹੈ (ਆਪਣੇ ਸ਼ਬਦਾਂ ਵਿੱਚ, ਜਾਂ ਏਜੰਟ 'ਤੇ ਸੈੱਟ ਕੀਤੀ ਟੂਲ-ਸ਼ੁਰੂ ਲਾਈਨ), ਫਿਰ ਕਾਲਰ ਹੋਲਡ ਸੰਗੀਤ ਸੁਣਦਾ ਹੈ। ਏਜੰਟ ਵੱਲੋਂ ਨਤੀਜਾ ਬੋਲਣ ਤੋਂ ਪਹਿਲਾਂ ਸੰਗੀਤ ਹੌਲੀ-ਹੌਲੀ ਬੰਦ ਹੋ ਜਾਂਦਾ ਹੈ। ਜਿਹੜੇ ਟੂਲ ਇੱਕ ਜਾਂ ਦੋ ਸਕਿੰਟ ਵਿੱਚ ਜਵਾਬ ਦੇ ਦਿੰਦੇ ਹਨ, ਉਹਨਾਂ ਲਈ ਕੋਈ ਸੰਗੀਤ ਨਹੀਂ ਚੱਲਦਾ। ਜਦੋਂ ਏਜੰਟ ਕਿਸੇ ਫ਼ੋਨ ਮੀਨੂ ਜਾਂ ਵੌਇਸਮੇਲ ਬਾਕਸ ਨਾਲ ਗੱਲ ਕਰ ਰਿਹਾ ਹੁੰਦਾ ਹੈ, ਤਾਂ ਇਹ ਇਸਦੀ ਬਜਾਏ ਬੋਲੇ ਗਏ ਅੱਪਡੇਟ ਵਰਤਦਾ ਹੈ, ਕਿਉਂਕਿ ਸੰਗੀਤ ਨੂੰ ਜਵਾਬ ਸਮਝਿਆ ਜਾ ਸਕਦਾ ਹੈ। ਇਸ ਵਿੱਚ ਉਹ ਕਾਲ ਵੀ ਸ਼ਾਮਲ ਹੈ ਜਿਸਨੂੰ ਹੋਲਡ ਦੌਰਾਨ ਮੀਨੂ ਜਾਂ ਮੇਲਬਾਕਸ ਵਜੋਂ ਪਛਾਣਿਆ ਜਾਂਦਾ ਹੈ: ਸੰਗੀਤ ਰੁਕ ਜਾਂਦਾ ਹੈ ਅਤੇ ਬੋਲੇ ਗਏ ਅੱਪਡੇਟ ਸ਼ੁਰੂ ਹੋ ਜਾਂਦੇ ਹਨ। ਇਹ ਉਸ ਕਾਲ ਲਈ ਵੀ ਹੁੰਦਾ ਹੈ ਜਿਸ ਵਿੱਚ ਸੰਗੀਤ ਨਹੀਂ ਚਲ ਸਕਦਾ।
ਜੇ ਕਾਲਰ ਹੋਲਡ ਦੌਰਾਨ ਬੋਲਦਾ ਹੈ, ਤਾਂ ਸੰਗੀਤ ਚਲਦਾ ਰਹਿੰਦਾ ਹੈ ਅਤੇ ਏਜੰਟ ਹਾਲੇ ਜਵਾਬ ਨਹੀਂ ਦਿੰਦਾ। ਇਹ ਕਾਲਰ ਦੀ ਗੱਲ ਸੁਣਦਾ ਹੈ ਅਤੇ ਨਤੀਜੇ ਦੇ ਨਾਲ ਉਸਦਾ ਜਵਾਬ ਦਿੰਦਾ ਹੈ। ਕਾਲ ਕੱਟਣ ਨਾਲ ਕਾਲ ਅਤੇ ਖੁੱਲ੍ਹਾ ਟੂਲ ਸਮਾਪਤ ਹੋ ਜਾਂਦੇ ਹਨ।
ਬਾਅਦ ਵਿੱਚ ਜਵਾਬ ਦਿਓ
ਤੁਹਾਡੇ ਐਂਡਪੌਇੰਟ ਦਾ ਆਪਣਾ ਜਵਾਬ ਫਿਰ ਵੀ 180 s ਦੇ ਅੰਦਰ ਆਉਣਾ ਲਾਜ਼ਮੀ ਹੈ। ਕਾਲਰ ਨੂੰ ਹੋਰ ਦੇਰ ਹੋਲਡ 'ਤੇ ਰੱਖਣ ਲਈ, ਤੁਰੰਤ ਇੱਕ ਬਕਾਇਆ ਨਤੀਜੇ ਨਾਲ ਜਵਾਬ ਦਿਓ:
{ "status": "pending", "request_id": "ask-4471" }request_id ਵੱਧ ਤੋਂ ਵੱਧ 200 ਅੱਖਰਾਂ ਦੀ ਕੋਈ ਵੀ ਸਤਰ ਹੈ ਜੋ ਤੁਹਾਡੇ ਪਾਸੇ ਇਸ
ਬੇਨਤੀ ਦੀ ਪਛਾਣ ਕਰਦੀ ਹੈ। ਕਾਲਰ ਉਦੋਂ ਤੱਕ ਹੋਲਡ 'ਤੇ ਰਹਿੰਦਾ ਹੈ ਜਦੋਂ ਤੱਕ ਤੁਸੀਂ ਇਸ ਲਈ ਨਤੀਜਾ
POST /v1/calls/{call_id}/tool-results
ਰਾਹੀਂ ਨਹੀਂ ਭੇਜਦੇ। call_id, ਟੂਲ ਬੇਨਤੀ ਦਾ X-ThunderPhone-Call-ID ਹੈਡਰ ਹੈ।
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": "ask-4471",
"result": { "answer": "Yes, book Tuesday at 10." }
}'ਏਜੰਟ result ਨੂੰ ਟੂਲ ਦੇ ਜਵਾਬ ਵਜੋਂ ਪੜ੍ਹਦਾ ਹੈ, ਬਿਲਕੁਲ ਇਸੇ ਤਰ੍ਹਾਂ ਜਿਵੇਂ ਤੁਹਾਡੇ
ਐਂਡਪੌਇੰਟ ਨੇ ਇਹ ਵਾਪਸ ਕੀਤਾ ਹੋਵੇ। ਜੇ ਟੂਲ ਨੂੰ ਕਾਲ ਕੀਤੇ ਜਾਣ ਤੋਂ ਗਿਣੇ ਗਏ ਟੂਲ ਦੇ
timeout ਤੋਂ ਪਹਿਲਾਂ ਕੋਈ ਨਤੀਜਾ ਨਹੀਂ ਆਉਂਦਾ, ਤਾਂ ਏਜੰਟ ਨੂੰ ਦੱਸਿਆ ਜਾਂਦਾ ਹੈ ਕਿ ਕੋਈ
ਜਵਾਬ ਵਾਪਸ ਨਹੀਂ ਆਇਆ ਅਤੇ ਉਹ ਕਾਲਰ ਨੂੰ ਅਗਲੇ ਕਦਮ ਪੇਸ਼ ਕਰਦਾ ਹੈ, ਜਿਵੇਂ ਸੁਨੇਹਾ ਲੈਣਾ।
ਤੁਸੀਂ ਜਦੋਂ ਚਾਹੋ ਨਤੀਜਾ ਪੋਸਟ ਕਰ ਸਕਦੇ ਹੋ, ਤੁਹਾਡਾ ਬਕਾਇਆ ਜਵਾਬ ThunderPhone ਤੱਕ ਪਹੁੰਚਣ
ਤੋਂ ਪਹਿਲਾਂ ਵੀ। 202 ਦਾ ਮਤਲਬ ਹੈ ਕਿ ਕਾਲ ਨੇ ਇਸਨੂੰ ਸਵੀਕਾਰ ਕਰ ਲਿਆ: ਕਿਸੇ ਖੁੱਲ੍ਹੀ ਬੇਨਤੀ
ਨੇ ਇਸਨੂੰ ਲੈ ਲਿਆ, ਜਾਂ ਟੂਲ ਦੀ ਆਪਣੀ ਬੇਨਤੀ ਹਾਲੇ ਪ੍ਰਗਤੀ ਵਿੱਚ ਹੈ ਅਤੇ ਇਸਦਾ ਬਕਾਇਆ ਜਵਾਬ
ਇਸਨੂੰ ਲੈ ਲਵੇਗਾ। ਅਜਿਹਾ ਨਤੀਜਾ ਜਿਸਨੂੰ ਕੋਈ ਵੀ ਬੇਨਤੀ ਕਦੇ ਨਹੀਂ ਲੈਂਦੀ (ਤੁਹਾਡੇ ਐਂਡਪੌਇੰਟ ਨੇ
ਫਿਰ ਉਸ request_id ਲਈ ਬਕਾਇਆ ਤੋਂ ਇਲਾਵਾ ਕੁਝ ਹੋਰ ਜਵਾਬ ਦਿੱਤਾ) ਰੱਦ ਕਰ ਦਿੱਤਾ ਜਾਂਦਾ ਹੈ।
ਜੇ ਕਨੈਕਸ਼ਨ ਵਿੱਚ ਰਿਸਪਾਂਸ ਟ੍ਰਾਂਸਫ਼ਾਰਮ ਹੈ (ਉਹ ਕੋਡ ਜੋ ਏਜੰਟ ਵੱਲੋਂ ਦੇਖਣ ਤੋਂ ਪਹਿਲਾਂ ਤੁਹਾਡੇ
ਐਂਡਪੌਇੰਟ ਦੇ ਜਵਾਬ ਨੂੰ ਦੁਬਾਰਾ ਲਿਖਦਾ ਹੈ), ਤਾਂ ThunderPhone ਵੱਲੋਂ ਬਕਾਇਆ ਜਵਾਬ ਦੀ ਜਾਂਚ
ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ ਟ੍ਰਾਂਸਫ਼ਾਰਮ ਤੁਹਾਡੇ ਐਂਡਪੌਇੰਟ ਦੇ ਆਪਣੇ ਜਵਾਬ 'ਤੇ ਚੱਲਦਾ ਹੈ, ਇਸ ਲਈ ਬਕਾਇਆ
ਜਵਾਬ ਵਿੱਚ ਇਸਨੂੰ status ਅਤੇ request_id ਰੱਖਣੇ ਲਾਜ਼ਮੀ ਹਨ। ਇਹ ਤੁਹਾਡੇ ਬਾਅਦ ਵਿੱਚ
ਪੋਸਟ ਕੀਤੇ ਨਤੀਜੇ 'ਤੇ ਨਹੀਂ ਚੱਲਦਾ: ਏਜੰਟ ਨੂੰ ਉਹ ਨਤੀਜਾ ਉਸੇ ਰੂਪ ਵਿੱਚ ਮਿਲਦਾ ਹੈ ਜਿਸ ਰੂਪ ਵਿੱਚ
ਤੁਸੀਂ ਭੇਜਦੇ ਹੋ।
ਫੁੱਲ-ਡੁਪਲੈਕਸ ਏਜੰਟ ਵਿੱਚ ਕੋਈ ਹੋਲਡ ਸੰਗੀਤ ਜਾਂ ਅੱਪਡੇਟ ਲਾਈਨਾਂ ਨਹੀਂ ਹੁੰਦੀਆਂ, ਇਸ ਲਈ ਇਸਦੀਆਂ
ਕਾਲਾਂ ਵਿੱਚ ਹੋਲਡ ਟੂਲ updates ਟੂਲ ਵਾਂਗ ਵਰਤਾਅ ਕਰਦਾ ਹੈ: ਬਕਾਇਆ ਜਵਾਬ ਟੂਲ ਦੇ ਨਤੀਜੇ ਵਜੋਂ
ਏਜੰਟ ਤੱਕ ਪਹੁੰਚਦਾ ਹੈ।
updates ਮੋਡ ਵਿੱਚ ਕਿਸੇ ਟੂਲ ਦਾ ਬਕਾਇਆ ਜਵਾਬ ਖੁੱਲ੍ਹਾ ਨਹੀਂ ਰੱਖਿਆ ਜਾਂਦਾ: ਏਜੰਟ ਇਸਨੂੰ ਟੂਲ ਦੇ
ਨਤੀਜੇ ਵਜੋਂ ਪ੍ਰਾਪਤ ਕਰਦਾ ਹੈ।
ਦਸਤਖਤ ਤਸਦੀਕ
ਸਿੱਧੀਆਂ ਟੂਲ ਕਾਲਾਂ ਤੁਹਾਡੇ org webhook secret ਨਾਲ, webhooks ਵਾਂਗ ਹੀ ਸਾਈਨ ਕੀਤੀਆਂ ਜਾਂਦੀਆਂ ਹਨ:
X-ThunderPhone-Signature-V2ਭੇਜੇ ਗਏ timestamp, method, path ਅਤੇ query, ਅਤੇ body ਦੇ ਸਟੀਕ bytes ਨੂੰ ਸਾਈਨ ਕਰਦਾ ਹੈ। ਉਹ ਬੇਨਤੀਆਂ ਅਸਵੀਕਾਰ ਕਰੋ ਜਿਨ੍ਹਾਂ ਦਾ timestamp ਤੁਹਾਡੀ ਘੜੀ ਤੋਂ 5 ਮਿੰਟ ਤੋਂ ਵੱਧ ਵੱਖਰਾ ਹੋਵੇ।X-ThunderPhone-Signature(ਪੁਰਾਣਾ) ਸਿਰਫ਼ body ਦੇ bytes ਨੂੰ ਸਾਈਨ ਕਰਦਾ ਹੈ,GET/DELETEਲਈ ਖਾਲੀ byte string ਨੂੰ। ਇਹ ਅਜੇ ਵੀ ਬਿਨਾਂ ਬਦਲੇ ਭੇਜਿਆ ਜਾਂਦਾ ਹੈ।
SDK helpers 5-ਮਿੰਟ ਦੀ ਮਿਆਦ ਸਮੇਤ V2 header ਦੀ ਜਾਂਚ ਕਰਦੇ ਹਨ:
import json
from fastapi import FastAPI, HTTPException, Request
from thunderphone import verify_signature
app = FastAPI()
@app.post("/appointments/search")
async def search_appointments(request: Request):
body = await request.body()
query = request.scope.get("query_string", b"").decode("latin-1")
path = request.url.path + (f"?{query}" if query else "")
if not verify_signature(
request.headers.get("X-ThunderPhone-Signature-V2"),
secret=WEBHOOK_SECRET,
method=request.method,
path=path,
body=body,
):
raise HTTPException(status_code=401)
data = json.loads(body)
date = data["date"]
# Look up availability
slots = await get_available_slots(date)
return {"available_slots": slots}import express from "express";
import { verifySignature } from "@thunderphone/sdk";
app.post('/appointments/search', express.raw({type: 'application/json'}), (req, res) => {
const ok = verifySignature({
header: req.header('X-ThunderPhone-Signature-V2'),
secret: WEBHOOK_SECRET,
method: req.method,
path: req.originalUrl,
body: req.body,
});
if (!ok) return res.status(401).send('Invalid signature');
const { date, service } = JSON.parse(req.body);
// Look up availability
const slots = getAvailableSlots(date, service);
res.json({ available_slots: slots });
});ਪੂਰੇ ਨੁਸਖੇ — ਸਾਈਨ ਕੀਤੀ string, ਇੱਕ ਕਾਰਜਿਤ ਉਦਾਹਰਨ, SDK ਤੋਂ ਬਿਨਾਂ ਕੋਡ, GET / DELETE ਮਾਮਲਾ ਅਤੇ secret ਨਾ ਹੋਣ ਬਾਰੇ ਸਾਵਧਾਨੀ — Webhook signatures ਦੀ ਤਸਦੀਕ ਕਰੋ ਵਿੱਚ ਹਨ।
ਉਦਾਹਰਨ: ਪੂਰਾ ਬੁਕਿੰਗ ਫਲੋ
ਇੱਥੇ ਪੂਰੀ ਅਪਾਇੰਟਮੈਂਟ ਬੁਕਿੰਗ ਪ੍ਰਣਾਲੀ ਲਈ ਟੂਲਾਂ ਦਾ ਇੱਕ ਸੈੱਟ ਹੈ:
{
"tools": [
{
"type": "function",
"function": {
"name": "search_appointments",
"description": "Find available appointment slots",
"parameters": {
"type": "object",
"properties": {
"date": { "type": "string", "description": "YYYY-MM-DD" },
"service": { "type": "string" }
},
"required": ["date"]
}
},
"endpoint": {
"url": "https://api.example.com/appointments/search",
"method": "POST",
"headers": { "X-Api-Key": "key" }
}
},
{
"type": "function",
"function": {
"name": "book_appointment",
"description": "Book an appointment at a specific time",
"parameters": {
"type": "object",
"properties": {
"date": { "type": "string", "description": "YYYY-MM-DD" },
"time": { "type": "string", "description": "HH:MM format" },
"customer_name": { "type": "string" },
"customer_phone": { "type": "string" }
},
"required": ["date", "time", "customer_name"]
}
},
"endpoint": {
"url": "https://api.example.com/appointments/book",
"method": "POST",
"headers": { "X-Api-Key": "key" }
}
},
{
"type": "function",
"function": {
"name": "cancel_appointment",
"description": "Cancel an existing appointment",
"parameters": {
"type": "object",
"properties": {
"confirmation_number": { "type": "string" }
},
"required": ["confirmation_number"]
}
},
"endpoint": {
"url": "https://api.example.com/appointments/cancel",
"method": "POST",
"headers": { "X-Api-Key": "key" }
}
}
]
}ਕਾਲ ਦੀ ਸ਼ੁਰੂਆਤ 'ਤੇ ਟੂਲ ਚਲਾਓ
ਹਰ ਫ਼ੋਨ ਕਾਲ ਦੀ ਸ਼ੁਰੂਆਤ 'ਤੇ ਟੂਲ ਆਪਣੇ ਆਪ ਵੀ ਚੱਲ ਸਕਦਾ ਹੈ, ਏਜੰਟ ਦੇ ਆਪਣਾ ਪਹਿਲਾ ਸ਼ਬਦ ਬੋਲਣ ਤੋਂ ਪਹਿਲਾਂ, ਤਾਂ ਜੋ ਸਵਾਗਤ ਵਿੱਚ ਨਤੀਜਾ ਵਰਤਿਆ ਜਾ ਸਕੇ। ਆਮ ਮਾਮਲਾ ਕਾਲਰ ਦੇ ਨੰਬਰ ਰਾਹੀਂ CRM ਖੋਜ ਦਾ ਹੁੰਦਾ ਹੈ: "ਵਾਪਸ ਆਉਣ ਲਈ ਸਵਾਗਤ ਹੈ, ਆਰਥੀ! ਕੀ ਤੁਸੀਂ ਆਪਣਾ ਆਮ ਆਰਡਰ ਲੈਣਾ ਚਾਹੋਗੇ?"
ਡੈਸ਼ਬੋਰਡ ਵਿੱਚ, API ਕਨੈਕਸ਼ਨ ਖੋਲ੍ਹੋ ਅਤੇ ਇਹ ਕਦੋਂ ਚੱਲਦਾ ਹੈ ਨੂੰ
ਹਰ ਫ਼ੋਨ ਕਾਲ ਦੀ ਸ਼ੁਰੂਆਤ 'ਤੇ ਸੈੱਟ ਕਰੋ, ਫਿਰ ਹਰੇਕ
ਪੈਰਾਮੀਟਰ ਲਈ ਮਿਲਣ ਵਾਲਾ ਮੁੱਲ ਭਰੋ। API ਰਾਹੀਂ, ਇੰਟੀਗ੍ਰੇਸ਼ਨ ਦੇ trigger ਨੂੰ
call_start ਅਤੇ ਇਸਦੇ call_start_arguments
(API ਕਨੈਕਸ਼ਨ) ਸੈੱਟ ਕਰੋ, ਜਾਂ ਇੱਕ ਇਨਲਾਈਨ ਟੂਲ ਵਿੱਚ call_start
ਬਲਾਕ ਸ਼ਾਮਲ ਕਰੋ:
{
"type": "function",
"function": {
"name": "get_contact_by_phone",
"description": "Look up a customer by phone number.",
"parameters": {
"type": "object",
"properties": {
"business_id": {"type": "string"},
"phone_number": {"type": "string"}
},
"required": ["business_id", "phone_number"]
}
},
"endpoint": {"url": "https://crm.example.com/contacts/lookup"},
"call_start": {
"arguments": {
"business_id": "a0a81c23",
"phone_number": "{{caller_number}}"
}
}
}ਹਰੇਕ ਲਾਜ਼ਮੀ ਪੈਰਾਮੀਟਰ ਲਈ ਆਰਗੂਮੈਂਟਾਂ ਵਿੱਚ ਮੁੱਲ ਹੋਣਾ ਜ਼ਰੂਰੀ ਹੈ, ਕਿਉਂਕਿ ਕਾਲ ਸ਼ੁਰੂ ਹੋਣ ਵੇਲੇ ਕੋਈ ਵੀ ਕੁਝ ਨਹੀਂ ਭਰਦਾ। ਮੁੱਲ ਸਟਰਿੰਗਾਂ, ਨੰਬਰ ਜਾਂ ਬੂਲੀਅਨ ਹੁੰਦੇ ਹਨ। ਇਹ ਸਾਦੇ ਟੈਕਸਟ ਵਜੋਂ ਸਟੋਰ ਅਤੇ ਵਾਪਸ ਕੀਤੇ ਜਾਂਦੇ ਹਨ ਅਤੇ ਏਜੰਟ ਇਨ੍ਹਾਂ ਨੂੰ ਦੇਖਦਾ ਹੈ, ਇਸ ਲਈ API ਕੁੰਜੀਆਂ ਵਰਗੇ ਗੁਪਤ ਵੇਰਵੇ ਇੱਥੇ ਨਹੀਂ, ਕਨੈਕਸ਼ਨ ਦੇ ਹੈਡਰਾਂ ਵਿੱਚ ਰੱਖੋ। ਸਟਰਿੰਗਾਂ ਇਹ ਪਲੇਸਹੋਲਡਰ ਵਰਤ ਸਕਦੀਆਂ ਹਨ:
| ਪਲੇਸਹੋਲਡਰ | ਮੁੱਲ |
|---|---|
{{caller_number}} | E.164 ਫਾਰਮੈਟ ਵਿੱਚ ਕਾਲ 'ਤੇ ਦੂਜਾ ਵਿਅਕਤੀ, ਉਦਾਹਰਨ ਲਈ +61402122887: ਇਨਬਾਊਂਡ ਕਾਲ ਵਿੱਚ ਕਾਲਰ, ਆਊਟਬਾਊਂਡ ਕਾਲ ਵਿੱਚ ਜਿਸ ਵਿਅਕਤੀ ਨੂੰ ਕਾਲ ਕੀਤੀ ਗਈ ਹੈ |
{{caller_number_national}} | ਉਸੇ ਦੇਸ਼ ਦੇ ਰਾਸ਼ਟਰੀ ਫਾਰਮੈਟ ਵਿੱਚ ਉਹੀ ਨੰਬਰ, ਬਿਨਾਂ ਖਾਲੀ ਥਾਵਾਂ ਦੇ, ਉਦਾਹਰਨ ਲਈ 0402122887 |
{{agent_number}} | ਏਜੰਟ ਦਾ ਆਪਣਾ ਨੰਬਰ |
ਇਹ ਕਿਵੇਂ ਕੰਮ ਕਰਦਾ ਹੈ:
- ਬੇਨਤੀ ਉਹੀ ਹੁੰਦੀ ਹੈ ਜੋ ਏਜੰਟ ਦੇ ਆਪਣੇ ਟੂਲ ਕਾਲਾਂ ਭੇਜਦੀਆਂ ਹਨ (ਉਹੀ ਐਂਡਪੌਇੰਟ, ਹੈਡਰ, ਬੇਨਤੀ ਫਾਰਮੈਟ ਅਤੇ ਸਿਗਨੇਚਰ)।
- ਕਾਲ ਸ਼ੁਰੂ ਹੋਣ 'ਤੇ ਟੂਲ ਸ਼ੁਰੂ ਹੁੰਦਾ ਹੈ ਅਤੇ ਕਿਸੇ ਵੀ ਕਨੈਕਟ ਟੋਨ, ਜਾਣ-ਪਛਾਣ ਜਾਂ ਰਿਕਾਰਡਿੰਗ ਸੂਚਨਾ ਦੇ ਚੱਲਣ ਦੌਰਾਨ ਚੱਲਦਾ ਹੈ। ਸਵਾਗਤ ਉਸ ਬਿੰਦੂ ਤੋਂ ਲਗਭਗ 3 ਸਕਿੰਟ ਤੱਕ ਇਸਦੀ ਉਡੀਕ ਕਰਦਾ ਹੈ। ਜੇ ਨਤੀਜਾ ਦੇਰ ਨਾਲ ਆਉਂਦਾ ਹੈ, ਤਾਂ ਉਹ ਪਹੁੰਚਦੇ ਹੀ ਬਾਕੀ ਕਾਲ ਲਈ ਏਜੰਟ ਨੂੰ ਦਿੱਤਾ ਜਾਂਦਾ ਹੈ। ਆਊਟਬਾਊਂਡ ਕਾਲ ਵਿੱਚ ਇਹ ਕਾਲ ਲਗਾਏ ਜਾਣ 'ਤੇ ਸ਼ੁਰੂ ਹੁੰਦਾ ਹੈ, ਇਸ ਲਈ ਇਹ ਹਰ ਕੋਸ਼ਿਸ਼ 'ਤੇ ਚੱਲਦਾ ਹੈ, ਉਹਨਾਂ ਕੋਸ਼ਿਸ਼ਾਂ ਸਮੇਤ ਜਿਨ੍ਹਾਂ ਦਾ ਕੋਈ ਜਵਾਬ ਨਹੀਂ ਦਿੰਦਾ।
- ਜਿਸ ਏਜੰਟ ਵਿੱਚ ਕਾਲਰ ਪਹਿਲਾਂ ਬੋਲਦਾ ਹੈ, ਉਸ ਵਿੱਚ ਉਡੀਕ ਕਰਨ ਲਈ ਕੋਈ ਸਵਾਗਤ ਨਹੀਂ ਹੁੰਦਾ; ਨਤੀਜਾ ਪਹੁੰਚਦੇ ਹੀ ਏਜੰਟ ਨੂੰ ਮਿਲ ਜਾਂਦਾ ਹੈ।
- ਨਤੀਜਾ ਪੂਰੀ ਕਾਲ ਲਈ ਏਜੰਟ ਨੂੰ ਸੰਦਰਭ ਵਜੋਂ ਦਿੱਤਾ ਜਾਂਦਾ ਹੈ। ਆਪਣੇ prompt ਵਿੱਚ ਏਜੰਟ ਨੂੰ ਦੱਸੋ ਕਿ ਇਸਨੂੰ ਕਿਵੇਂ ਵਰਤਣਾ ਹੈ; ਨਹੀਂ ਤਾਂ ਇਹ ਪੜ੍ਹ ਕੇ ਨਹੀਂ ਸੁਣਾਇਆ ਜਾਂਦਾ।
- ਜੇ ਟੂਲ ਅਸਫਲ ਹੋ ਜਾਵੇ ਜਾਂ ਸਮਾਂ ਸਮਾਪਤ ਹੋ ਜਾਵੇ, ਤਾਂ ਏਜੰਟ ਕਾਲਰ ਦਾ ਆਮ ਤਰ੍ਹਾਂ ਸਵਾਗਤ ਕਰਦਾ ਹੈ ਅਤੇ ਇਸ ਬਾਰੇ ਕੁਝ ਨਹੀਂ ਕਹਿੰਦਾ।
- ਏਜੰਟ ਬਾਅਦ ਵਿੱਚ ਕਾਲ ਦੌਰਾਨ ਵੀ ਖੁਦ ਟੂਲ ਨੂੰ ਕਾਲ ਕਰ ਸਕਦਾ ਹੈ।
- ਇਹ ਫ਼ੋਨ ਕਾਲਾਂ 'ਤੇ ਚੱਲਦਾ ਹੈ, ਜਿਸ ਵਿੱਚ ਤੁਹਾਡੇ ਫ਼ੋਨ ਲਈ ਡੈਸ਼ਬੋਰਡ ਟੈਸਟ ਕਾਲਾਂ, ਅਤੇ AI ਸਿਮੂਲੇਸ਼ਨਾਂ ਸ਼ਾਮਲ ਹਨ, ਜੋ ਸਿਮੂਲੇਟ ਕੀਤੇ ਕਾਲਰ ਦਾ ਨੰਬਰ ਤੁਹਾਡੇ ਐਂਡਪੌਇੰਟ ਨੂੰ ਭੇਜਦੀਆਂ ਹਨ। ਇਹ ਬ੍ਰਾਊਜ਼ਰ ਗੱਲਬਾਤ ਟੈਸਟਾਂ ਜਾਂ ਵੈੱਬ ਵਿਜਟ ਸੈਸ਼ਨਾਂ ਵਿੱਚ ਨਹੀਂ ਚੱਲਦਾ, ਜਿਨ੍ਹਾਂ ਕੋਲ ਕਾਲਰ ਨੰਬਰ ਨਹੀਂ ਹੁੰਦਾ, ਉਹਨਾਂ ਕਾਲਾਂ ਵਿੱਚ ਨਹੀਂ ਜਿਨ੍ਹਾਂ ਦਾ ਕਾਲਰ ID ਲੁਕਿਆ ਹੋਵੇ, ਜਾਂ ਕਦਮਾਂ ਵਾਲੇ ਏਜੰਟਾਂ ਵਿੱਚ ਨਹੀਂ ਚੱਲਦਾ।
- ਇੱਕ ਏਜੰਟ ਵੱਧ ਤੋਂ ਵੱਧ ਤਿੰਨ ਕਾਲ-ਸ਼ੁਰੂਆਤ ਟੂਲ ਇੱਕੋ ਸਮੇਂ ਚਲਾਉਂਦਾ ਹੈ।
ਆਪਣੇ prompt ਵਿੱਚ ਨਤੀਜੇ ਦਾ ਜ਼ਿਕਰ ਕਰੋ ਤਾਂ ਜੋ ਏਜੰਟ ਨੂੰ ਪਤਾ ਹੋਵੇ ਕਿ ਇਸਨੂੰ ਕਿਵੇਂ ਵਰਤਣਾ ਹੈ, ਉਦਾਹਰਨ ਲਈ: "ਜੇ ਕਾਲ ਸ਼ੁਰੂਆਤ ਖੋਜ ਵਿੱਚ ਕਾਲਰ ਮਿਲੇ, ਤਾਂ ਉਸਦਾ ਪਹਿਲੇ ਨਾਮ ਨਾਲ ਸਵਾਗਤ ਕਰੋ।"
ਸਭ ਤੋਂ ਵਧੀਆ ਤਰੀਕੇ
ਸਪਸ਼ਟ ਵੇਰਵੇ ਲਿਖੋ
description ਫ਼ੀਲਡ AI ਨੂੰ ਇਹ ਸਮਝਣ ਵਿੱਚ ਮਦਦ ਕਰਦੀ ਹੈ ਕਿ ਟੂਲ ਨੂੰ ਕਦੋਂ ਵਰਤਣਾ ਹੈ। ਇਹ ਕੀ ਕਰਦਾ ਹੈ ਅਤੇ ਕਦੋਂ ਢੁਕਵਾਂ ਹੈ, ਇਸ ਬਾਰੇ ਸਪਸ਼ਟ ਰਹੋ।
ਗਲਤੀਆਂ ਨੂੰ ਸੁਚੱਜੇ ਢੰਗ ਨਾਲ ਸੰਭਾਲੋ
ਅਜਿਹੇ ਗਲਤੀ ਸੁਨੇਹੇ ਵਾਪਸ ਕਰੋ ਜੋ AI ਸਮਝ ਸਕੇ: ਆਮ 500 ਗਲਤੀਆਂ ਦੀ ਬਜਾਏ {"error": "No slots available for that date"}।
ਜਵਾਬ ਸੰਖੇਪ ਰੱਖੋ
ਗੱਲਬਾਤ ਜਾਰੀ ਰੱਖਣ ਲਈ AI ਨੂੰ ਸਿਰਫ਼ ਉਹੀ ਵਾਪਸ ਭੇਜੋ ਜੋ ਉਸਨੂੰ ਲੋੜੀਂਦਾ ਹੈ। ਟੂਲ ਦਾ ਨਤੀਜਾ ਗੱਲਬਾਤ ਵਿੱਚ ਰਹਿੰਦਾ ਹੈ ਅਤੇ ਹਰ ਅਗਲੀ ਵਾਰੀ ਦੁਬਾਰਾ ਪੜ੍ਹਿਆ ਜਾਂਦਾ ਹੈ, ਇਸ ਲਈ ਵੱਡਾ ਨਤੀਜਾ ਕਾਲ ਦੇ ਬਾਕੀ ਹਿੱਸੇ ਲਈ ਲਾਗਤ ਅਤੇ ਦੇਰੀ ਵਧਾਉਂਦਾ ਹੈ। 100,000 ਅੱਖਰਾਂ ਤੋਂ ਵੱਧ ਦੇ ਨਤੀਜਿਆਂ ਨੂੰ ਇੱਕ ਪ੍ਰੀਵਿਊ ਤੱਕ ਘਟਾ ਦਿੱਤਾ ਜਾਂਦਾ ਹੈ, ਜਿਸਨੂੰ AI ਅਧੂਰਾ ਜਾਣਦਾ ਹੈ, ਅਤੇ ਬਹੁਤ ਲੰਬੀ ਕਾਲ ਵਿੱਚ ਪੁਰਾਣੇ ਨਤੀਜੇ ਹਟਾਏ ਜਾ ਸਕਦੇ ਹਨ (AI ਟੂਲ ਨੂੰ ਦੁਬਾਰਾ ਕਾਲ ਕਰ ਸਕਦਾ ਹੈ)। ਇੱਕ ਪੈਰਾਮੀਟਰ ਸ਼ਾਮਲ ਕਰੋ ਤਾਂ ਜੋ AI ਇੱਕ ਵਾਰ ਵਿੱਚ ਇੱਕ ਆਈਟਮ ਜਾਂ ਸ਼੍ਰੇਣੀ ਲੱਭ ਸਕੇ, ਅਤੇ ਮੀਨੂ ਜਾਂ ਕੈਟਾਲਾਗ ਵਰਗੀ ਵੱਡੀ ਸੰਦਰਭ ਸਮੱਗਰੀ ਨੂੰ ਗਿਆਨ ਅਧਾਰ ਵਿੱਚ ਰੱਖੋ। ਡੈਸ਼ਬੋਰਡ ਵਿੱਚ ਟੈਸਟ ਬੇਨਤੀ ਭੇਜੋ ਹਰ ਨਤੀਜੇ ਦਾ ਆਕਾਰ ਦਿਖਾਉਂਦਾ ਹੈ ਅਤੇ ਵੱਡਾ ਹੋਣ 'ਤੇ ਚੇਤਾਵਨੀ ਦਿੰਦਾ ਹੈ।
ਲਾਜ਼ਮੀ ਫ਼ੀਲਡਾਂ ਨੂੰ ਸਮਝਦਾਰੀ ਨਾਲ ਵਰਤੋ
ਫ਼ੀਲਡਾਂ ਨੂੰ required ਸਿਰਫ਼ ਤਦੋਂ ਚਿੰਨ੍ਹਿਤ ਕਰੋ ਜਦੋਂ ਉਹ ਸੱਚਮੁੱਚ ਜ਼ਰੂਰੀ ਹੋਣ। ਟੂਲ ਨੂੰ ਕਾਲ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ AI ਵਰਤੋਂਕਾਰ ਤੋਂ ਲੋੜੀਂਦੀ ਜਾਣਕਾਰੀ ਪੁੱਛੇਗਾ।
ਸੰਬੰਧਿਤ
ਐਂਡਪੌਇੰਟ ਪਰਿਭਾਸ਼ਿਤ ਕੀਤੇ ਬਿਨਾਂ ਪਲੇਟਫਾਰਮ-ਪ੍ਰਬੰਧਿਤ ਕਾਲ ਕਾਰਵਾਈਆਂ ਲਈ prompt ਦਿਓ।
HubSpot, Salesforce, Google Calendar, Google Sheets ਅਤੇ Cal.com ਲਈ ਪਲੇਟਫਾਰਮ-ਪ੍ਰਬੰਧਿਤ ਟੂਲ — ਕਿਸੇ ਐਂਡਪੌਇੰਟ ਦੀ ਲੋੜ ਨਹੀਂ।
ਇੱਕ MCP ਸਰਵਰ ਜੋੜੋ ਅਤੇ ਏਜੰਟ ਨੂੰ ਇਸਦੇ ਟੂਲ ਕਾਲ ਕਰਨ ਦਿਓ।
ਮੁੜ ਵਰਤਣਯੋਗ REST ਇੰਟੀਗ੍ਰੇਸ਼ਨ ਜੋ ਤੁਸੀਂ ਏਜੰਟਾਂ ਨਾਲ ਜੋੜ ਸਕਦੇ ਹੋ।
ਵੈੱਬਹੁੱਕਾਂ ਅਤੇ ਟੂਲ ਕਾਲਾਂ ਲਈ ਇੱਕ ਤਸਦੀਕ ਸਹਾਇਕ।