ThunderPhone v3 ਹੁਣ ਲਾਈਵ ਹੈ।ਸੈਲਫ਼-ਸਰਵਿਸ—2¢/ਮਿੰਟ ਤੋਂ।ਐਲਾਨ ਪੜ੍ਹੋ

Function Tools

ਫੰਕਸ਼ਨ ਟੂਲਜ਼

ਆਪਣੇ AI ਏਜੰਟਾਂ ਨੂੰ ਫੰਕਸ਼ਨ ਟੂਲਜ਼ ਦਿਓ ਜੋ ਗੱਲਬਾਤ ਦੌਰਾਨ ਬਾਹਰੀ API ਕਾਲ ਕਰਦੇ ਹਨ — ਗਾਹਕ ਡਾਟਾ ਪ੍ਰਾਪਤ ਕਰੋ, ਅਪਾਇੰਟਮੈਂਟ ਬੁੱਕ ਕਰੋ, ਰਿਕਾਰਡ ਅੱਪਡੇਟ ਕਰੋ — ਟਾਈਪ ਕੀਤੇ ਪੈਰਾਮੀਟਰਾਂ ਨਾਲ।

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

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

  1. ਤੁਸੀਂ ਸਕੀਮਾ ਨਾਲ ਟੂਲ ਪਰਿਭਾਸ਼ਿਤ ਕਰਦੇ ਹੋ (ਟੂਲ ਕਿਹੜੇ ਆਰਗੂਮੈਂਟ ਸਵੀਕਾਰ ਕਰਦਾ ਹੈ)
  2. ਤੁਸੀਂ ਇੱਕ endpoint ਕਨਫਿਗਰੇਸ਼ਨ ਦਿੰਦੇ ਹੋ (ThunderPhone ਤੁਹਾਡੀ API ਨੂੰ ਕਿੱਥੇ ਕਾਲ ਕਰਦਾ ਹੈ) — ਜਾਂ ਆਪਣੀ ਸੰਸਥਾ ਦੇ ਵੈੱਬਹੁੱਕ 'ਤੇ ਟੂਲ ਕਾਲਾਂ ਪ੍ਰਾਪਤ ਕਰਨ ਲਈ ਇਸਨੂੰ ਨਾ ਦਿਓ
  3. ਕਾਲ ਦੌਰਾਨ, AI ਗੱਲਬਾਤ ਦੇ ਆਧਾਰ 'ਤੇ ਫ਼ੈਸਲਾ ਕਰਦਾ ਹੈ ਕਿ ਟੂਲ ਕਦੋਂ ਵਰਤਣਾ ਹੈ
  4. ThunderPhone ਟੂਲ ਆਰਗੂਮੈਂਟਾਂ ਨਾਲ ਤੁਹਾਡੇ ਐਂਡਪੌਇੰਟ ਨੂੰ ਕਾਲ ਕਰਦਾ ਹੈ
  5. ਗੱਲਬਾਤ ਜਾਰੀ ਰੱਖਣ ਲਈ ਤੁਹਾਡਾ 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 — ਮੌਜੂਦਾ ਕਾਲ ID
  • X-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 s600 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 ਦੀ ਜਾਂਚ ਕਰਦੇ ਹਨ:

Python
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}
Node.js
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 ਵਰਤੋਂਕਾਰ ਤੋਂ ਲੋੜੀਂਦੀ ਜਾਣਕਾਰੀ ਪੁੱਛੇਗਾ।


ਸੰਬੰਧਿਤ