Open in
API ਕਨੈਕਸ਼ਨ
ਕਿਸੇ ਵੀ HTTP API ਨੂੰ ਇੱਕ ਅਜਿਹੇ ਫੰਕਸ਼ਨ ਵਿੱਚ ਬਦਲੋ ਜਿਸਨੂੰ ਤੁਹਾਡਾ ਏਜੰਟ ਗੱਲਬਾਤ ਦੌਰਾਨ ਕਾਲ ਕਰ ਸਕੇ: ਇੱਕ cURL ਕਮਾਂਡ ਪੇਸਟ ਕਰੋ ਅਤੇ ਵਿਜ਼ਾਰਡ ਟੂਲ ਡੈਫਿਨੀਸ਼ਨ, ਪੈਰਾਮੀਟਰ ਅਤੇ auth ਬਣਾਉਂਦਾ ਹੈ।
API ਕਨੈਕਸ਼ਨ ਕਸਟਮ HTTP ਫੰਕਸ਼ਨ ਹਨ ਜਿਨ੍ਹਾਂ ਨੂੰ ਤੁਹਾਡੇ ਏਜੰਟ ਗੱਲਬਾਤ ਦੌਰਾਨ ਕਾਲ ਕਰ ਸਕਦੇ ਹਨ — ਆਰਡਰ ਲੱਭਣਾ, ਟਿਕਟ ਬਣਾਉਣਾ, ਜਾਂ ਆਪਣੇ ਬੈਕਐਂਡ ਤੋਂ ਖਾਤੇ ਦੀ ਸਥਿਤੀ ਪ੍ਰਾਪਤ ਕਰਨਾ। ਤੁਸੀਂ ਐਂਡਪੌਇੰਟ ਨੂੰ ਇੱਕ ਵਾਰ ਕਨੈਕਸ਼ਨ → APIs (/dashboard/api-connections) ਵਿੱਚ ਪਰਿਭਾਸ਼ਿਤ ਕਰਦੇ ਹੋ; ਜਿਨ੍ਹਾਂ ਏਜੰਟਾਂ ਨਾਲ ਕਨੈਕਸ਼ਨ ਜੋੜਿਆ ਹੁੰਦਾ ਹੈ, ਉਹ ਗੱਲਬਾਤ ਦੀ ਲੋੜ ਅਨੁਸਾਰ ਇਸਨੂੰ ਕਾਲ ਕਰ ਸਕਦੇ ਹਨ।
ਇਸਨੂੰ ਬਣਾਉਣ ਦੇ ਦੋ ਤਰੀਕੇ ਹਨ: ਕੋਈ ਅਜਿਹੀ ਚੀਜ਼ ਪੇਸਟ ਕਰੋ ਜਿਸਦਾ ਵਿਜ਼ਾਰਡ ਵਿਸ਼ਲੇਸ਼ਣ ਕਰ ਸਕੇ, ਜਾਂ ਕਨੈਕਸ਼ਨ ਨੂੰ ਹੱਥੀਂ ਸੈਟ ਅੱਪ ਕਰੋ।
ਤੇਜ਼ ਤਰੀਕਾ: ਪੇਸਟ ਕਰੋ ਅਤੇ ਵਿਸ਼ਲੇਸ਼ਣ ਕਰੋ
- ਨਵਾਂ API ਕਨੈਕਸ਼ਨ 'ਤੇ ਕਲਿੱਕ ਕਰੋ
ਡਾਇਲਾਗ ਵਿਜ਼ਾਰਡ ਵਿੱਚ ਖੁੱਲ੍ਹਦਾ ਹੈ। ਬਾਕਸ ਵਿੱਚ ਇੱਕ ਨਮੂਨਾ cURL ਕਮਾਂਡ, OpenAPI/Swagger ਸਪੈਸਿਫਿਕੇਸ਼ਨ, Postman ਐਕਸਪੋਰਟ, TypeScript ਇੰਟਰਫੇਸ, ਜਾਂ Zod ਸਕੀਮਾ ਪੇਸਟ ਕਰੋ।
- ਵਿਸ਼ਲੇਸ਼ਣ ਕਰੋ 'ਤੇ ਕਲਿੱਕ ਕਰੋ
ThunderPhone ਤੁਹਾਡੇ ਪੇਸਟ ਕੀਤੇ ਡਾਟੇ ਤੋਂ ਪੂਰਾ ਕਨੈਕਸ਼ਨ ਅਨੁਮਾਨਿਤ ਕਰਦਾ ਹੈ — URL, ਮੈਥਡ, ਹੈਡਰ, ਅਤੇ ਇਸਨੂੰ ਮਿਲੇ ਕਵੇਰੀ ਪੈਰਾਮੀਟਰਾਂ ਅਤੇ ਰਿਕਵੇਸਟ ਬਾਡੀ ਤੋਂ ਤਿਆਰ ਕੀਤਾ ਪੈਰਾਮੀਟਰ ਸਕੀਮਾ। ਤੁਹਾਡੇ ਵੱਲੋਂ ਪੇਸਟ ਕੀਤੇ ਹੈਡਰਾਂ ਨੂੰ (ਪ੍ਰਮਾਣੀਕਰਨ ਹੈਡਰਾਂ ਸਮੇਤ) ਐਂਡਪੌਇੰਟ ਕੌਂਫਿਗਰੇਸ਼ਨ ਵਿੱਚ ਸ਼ਾਮਲ ਕੀਤਾ ਜਾਂਦਾ ਹੈ।
- ਹਾਈਲਾਈਟ ਕੀਤੇ ਫੀਲਡਾਂ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ
ਅਨੁਮਾਨਿਤ ਕੌਂਫਿਗਰੇਸ਼ਨ ਸਮੀਖਿਆ ਲਈ ਅਨੁਮਾਨ ਲਗਾਏ ਫੀਲਡਾਂ ਨੂੰ ਹਾਈਲਾਈਟ ਕਰਕੇ ਖੁੱਲ੍ਹਦੀ ਹੈ। ਨਾਮਾਂ, ਵੇਰਵਿਆਂ ਅਤੇ ਪੈਰਾਮੀਟਰ ਕਿਸਮਾਂ ਨੂੰ ਵਿਵਸਥਿਤ ਕਰੋ ਤਾਂ ਜੋ ਏਜੰਟ ਸਮਝ ਸਕੇ ਕਿ ਫੰਕਸ਼ਨ ਨੂੰ ਕਦੋਂ ਅਤੇ ਕਿਵੇਂ ਕਾਲ ਕਰਨਾ ਹੈ — ਵੇਰਵਾ ਉਹੀ ਹੈ ਜੋ ਮਾਡਲ ਪੜ੍ਹਦਾ ਹੈ।
- ਪ੍ਰਮਾਣਿਤ ਕਰੋ ਅਤੇ ਸੇਵ ਕਰੋ
ਸੇਵ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ ਤੁਹਾਡੇ ਐਂਡਪੌਇੰਟ ਵਿਰੁੱਧ ਇੱਕ ਲਾਈਵ ਟੈਸਟ ਰਿਕਵੇਸਟ ਚਲਾਈ ਜਾਂਦੀ ਹੈ। ਜੇ ਰਿਕਵੇਸਟ ਅਸਫਲ ਹੁੰਦੀ ਹੈ, ਤਾਂ ਕਨੈਕਸ਼ਨ ਸੇਵ ਨਹੀਂ ਹੁੰਦਾ — URL, ਪ੍ਰਮਾਣੀਕਰਨ ਹੈਡਰਾਂ ਜਾਂ ਬਾਡੀ ਨੂੰ ਠੀਕ ਕਰੋ ਅਤੇ ਦੁਬਾਰਾ ਕੋਸ਼ਿਸ਼ ਕਰੋ। ਸਫਲਤਾ ਉੱਤੇ ਕਨੈਕਸ਼ਨ ਨੂੰ ਪ੍ਰਮਾਣਿਤ ਬੈਜ ਨਾਲ ਸਟੋਰ ਕੀਤਾ ਜਾਂਦਾ ਹੈ।
ਜੇ ਵਿਜ਼ਾਰਡ ਨੂੰ ਤੁਹਾਡੇ ਪੇਸਟ ਕੀਤੇ ਡਾਟੇ ਵਿੱਚ ਰਿਕਵੇਸਟ URL ਨਹੀਂ ਮਿਲਦਾ, ਤਾਂ ਇਹ ਤੁਹਾਨੂੰ ਦੱਸੇਗਾ —
ਪੂਰਾ http(s) ਐਂਡਪੌਇੰਟ ਸ਼ਾਮਲ ਕਰੋ ਅਤੇ ਦੁਬਾਰਾ ਕੋਸ਼ਿਸ਼ ਕਰੋ।
ਹੱਥੀਂ ਸੈਟ ਅੱਪ
ਵਿਜ਼ਾਰਡ ਵਿੱਚ ਹੱਥੀਂ ਸੈਟ ਅੱਪ ਕਰੋ → 'ਤੇ ਕਲਿੱਕ ਕਰੋ (ਜਾਂ ਵਾਪਸ ਜਾਣ ਲਈ ਕੀ ਤੁਸੀਂ ਚਾਹੁੰਦੇ ਹੋ ਕਿ AI ਇਸਦਾ ਅਨੁਮਾਨ ਲਗਾਏ? ਵਿਜ਼ਾਰਡ ਅਜ਼ਮਾਓ → 'ਤੇ ਕਲਿੱਕ ਕਰੋ)। ਹੱਥੀਂ ਬਿਲਡਰ ਵਿੱਚ ਦੋ ਐਡੀਟਰ ਹਨ:
- ਵਿਜ਼ੂਅਲ — ਡਿਸਪਲੇ ਨਾਮ, ਫੰਕਸ਼ਨ ਨਾਮ, ਰਿਕਵੇਸਟ
URL, ਮੈਥਡ (
POST,GET,PUT,PATCH,DELETE), ਕਸਟਮ ਹੈਡਰਾਂ, ਅਤੇ ਪੈਰਾਮੀਟਰ ਸਕੀਮਾ ਲਈ ਫਾਰਮ ਫੀਲਡ (ਪ੍ਰਾਪਰਟੀ ਸ਼ਾਮਲ ਕਰੋ ਹਰ ਉਸ ਆਰਗੂਮੈਂਟ ਲਈ ਜੋ ਏਜੰਟ ਦੇ ਸਕਦਾ ਹੈ)। - JSON — ਕੱਚੇ JSON ਵਜੋਂ ਉਹੀ ਪਰਿਭਾਸ਼ਾ, ਟੂਲ ਸਪੈਸਿਫਿਕੇਸ਼ਨ ਨੂੰ ਸਿੱਧਾ ਪੇਸਟ ਕਰਨ ਜਾਂ ਸੁਧਾਰਨ ਲਈ।
ਇੱਕ ਟੈਸਟ ਰਿਕਵੇਸਟ ਪੈਨਲ (ਵਿਕਲਪਿਕ) ਤੁਹਾਨੂੰ ਸੇਵ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ ਕੌਂਫਿਗਰ ਕੀਤੀ ਰਿਕਵੇਸਟ ਭੇਜਣ ਦਿੰਦਾ ਹੈ ਅਤੇ ਸਥਿਤੀ, ਲੇਟੈਂਸੀ, ਅਤੇ ਜਵਾਬ ਦਾ ਪ੍ਰੀਵਿਊ ਦਿਖਾਉਂਦਾ ਹੈ। ਪ੍ਰਮਾਣਿਤ ਕਰੋ ਅਤੇ ਸੇਵ ਕਰੋ ਹਮੇਸ਼ਾ ਇਹ ਟੈਸਟ ਚਲਾਉਂਦਾ ਹੈ ਅਤੇ ਸਿਰਫ਼ ਸਫਲਤਾ ਉੱਤੇ ਸੇਵ ਕਰਦਾ ਹੈ।
ਪੈਨਲ ਰਿਸਪਾਂਸ ਦਾ ਆਕਾਰ ਵੀ ਦਿਖਾਉਂਦਾ ਹੈ, ਅੱਖਰਾਂ ਅਤੇ ਲਗਭਗ ਟੋਕਨਾਂ ਵਿੱਚ। ਤੁਹਾਡਾ ਏਜੰਟ ਕਾਲ ਦੇ ਹਰ ਵਾਰੀ ਟੂਲ ਦੇ ਨਤੀਜੇ ਨੂੰ ਮੁੜ ਪੜ੍ਹਦਾ ਹੈ, ਇਸ ਲਈ 20,000 ਅੱਖਰਾਂ ਤੋਂ ਵੱਧ ਦੇ ਰਿਸਪਾਂਸ ਲਈ ਇਸਨੂੰ ਘਟਾਉਣ ਦੇ ਤਰੀਕਿਆਂ ਸਮੇਤ ਚੇਤਾਵਨੀ ਮਿਲਦੀ ਹੈ, ਅਤੇ 100,000 ਅੱਖਰਾਂ ਤੋਂ ਵੱਧ ਦੇ ਰਿਸਪਾਂਸ ਨੂੰ ਚਿੰਨ੍ਹਿਤ ਕੀਤਾ ਜਾਂਦਾ ਹੈ ਕਿਉਂਕਿ ਏਜੰਟ ਸਿਰਫ਼ ਇਸਦੀ ਸ਼ੁਰੂਆਤ ਹੀ ਦੇਖਦਾ ਹੈ। ਵੇਖੋ ਟੂਲ ਬਹੁਤ ਜ਼ਿਆਦਾ ਡਾਟਾ ਵਾਪਸ ਕਰਦਾ ਹੈ।
ਹੈਡਰ ਮੁੱਲ ਸਿਰਫ਼ ਲਿਖਣ ਲਈ ਹਨ। ਸੇਵ ਹੋਣ ਤੋਂ ਬਾਅਦ ਉਹ ਇਨਕ੍ਰਿਪਟ ਹੋ ਜਾਂਦੇ ਹਨ ਅਤੇ ਡੈਸ਼ਬੋਰਡ ਜਾਂ API ਵਿੱਚ ਦੁਬਾਰਾ ਕਦੇ ਨਹੀਂ ਦਿਖਾਏ ਜਾਂਦੇ। ਜਦੋਂ ਤੁਸੀਂ ਕਿਸੇ ਕਨੈਕਸ਼ਨ ਨੂੰ ਸੰਪਾਦਿਤ ਕਰਦੇ ਹੋ, ਤਾਂ ਸੇਵ ਕੀਤਾ ਹੈਡਰ ਆਪਣਾ ਨਾਮ, ਮੁੱਲ ਦੀ ਥਾਂ ਬਿੰਦੀਆਂ, ਅਤੇ ਇੱਕ ਸੰਭਾਲਿਆ ਗਿਆ ਨੋਟ ਨਾਲ ਦਿਖਾਉਂਦਾ ਹੈ: ਸੇਵ ਕੀਤੇ ਮੁੱਲ ਨੂੰ ਰੱਖਣ ਲਈ ਇਸ ਨੂੰ ਜਿਵੇਂ ਹੈ ਤਿਵੇਂ ਛੱਡੋ, ਜਾਂ ਇਸ ਨੂੰ ਬਦਲਣ ਲਈ ਨਵਾਂ ਮੁੱਲ ਲਿਖੋ। ਟੈਸਟ ਬੇਨਤੀਆਂ ਅਤੇ ਲਾਈਵ ਕਾਲਾਂ ਸੇਵ ਕੀਤੇ ਮੁੱਲ ਦੀ ਵਰਤੋਂ ਕਰਦੀਆਂ ਹਨ। ਕਲੋਨ ਕਰੋ ਸੇਵ ਕੀਤੇ ਮੁੱਲਾਂ ਨੂੰ ਨਵੇਂ ਕਨੈਕਸ਼ਨ ਵਿੱਚ ਕਾਪੀ ਕਰਦਾ ਹੈ।
ਆਪਣੇ ਕਨੈਕਸ਼ਨਾਂ ਦਾ ਪ੍ਰਬੰਧਨ ਕਰੋ
ਹਰ ਕਨੈਕਸ਼ਨ ਕਤਾਰ ਆਪਣੀ ਪ੍ਰਮਾਣੀਕਰਨ ਸਥਿਤੀ — ਪ੍ਰਮਾਣਿਤ, ਨਾ-ਟੈਸਟ ਕੀਤਾ, ਜਾਂ ਗਲਤੀ — ਆਪਣਾ ਫੰਕਸ਼ਨ ਨਾਮ, ਅਤੇ ਇਸਨੂੰ ਵਰਤਣ ਵਾਲੇ ਏਜੰਟ ਦਿਖਾਉਂਦੀ ਹੈ। ਕਤਾਰ ਦੇ ਐਕਸ਼ਨ ਮੀਨੂ ਤੋਂ ਤੁਸੀਂ ਇਹ ਕਰ ਸਕਦੇ ਹੋ:
- ਸੰਪਾਦਿਤ ਕਰੋ — ਕੌਂਫਿਗਰੇਸ਼ਨ ਦੁਬਾਰਾ ਖੋਲ੍ਹੋ।
- ਕਲੋਨ ਕਰੋ — ਸ਼ੁਰੂਆਤੀ ਬਿੰਦੂ ਵਜੋਂ ਇਸਦੀ ਨਕਲ ਬਣਾਓ (ਨਕਲ ਨਾ-ਟੈਸਟ ਕੀਤੀ ਸ਼ੁਰੂ ਹੁੰਦੀ ਹੈ)।
- ਰਿਵੀਜ਼ਨ ਇਤਿਹਾਸ — ਪਹਿਲਾਂ ਦੇ ਵਰਜਨ ਦੇਖੋ ਅਤੇ ਇੱਕ ਨੂੰ ਐਡੀਟਰ ਵਿੱਚ ਰੀਸਟੋਰ ਕਰੋ।
- ਟ੍ਰਾਂਸਫਰ ਕਰੋ — ਕਨੈਕਸ਼ਨ ਨੂੰ ਕਿਸੇ ਹੋਰ ਸੰਸਥਾ ਵਿੱਚ ਕਾਪੀ ਜਾਂ ਮੂਵ ਕਰੋ ਜਿਸ ਨਾਲ ਤੁਸੀਂ ਸੰਬੰਧਿਤ ਹੋ। ਮੂਵ ਕਰਨ ਨਾਲ ਇਹ ਇੱਥੋਂ ਹਟ ਜਾਂਦਾ ਹੈ; ਇਸਨੂੰ ਵਰਤਣ ਵਾਲੇ ਏਜੰਟਾਂ ਨੂੰ ਮੁੜ ਕੌਂਫਿਗਰ ਕਰਨ ਦੀ ਲੋੜ ਪੈ ਸਕਦੀ ਹੈ।
- ਮਿਟਾਓ — ਸਥਾਈ ਹੈ; ਕਨੈਕਸ਼ਨ ਵਰਤਣ ਵਾਲੇ ਏਜੰਟਾਂ ਨੂੰ ਮੁੜ ਕੌਂਫਿਗਰ ਕਰਨਾ ਪਵੇਗਾ।
ਇਸਨੂੰ ਏਜੰਟ ਨਾਲ ਜੋੜੋ
ਬਿਲਡਰ ਦੇ API ਕਨੈਕਸ਼ਨ ਸੈਕਸ਼ਨ ਵਿੱਚ ਕਨੈਕਸ਼ਨ ਨੂੰ ਏਜੰਟ ਨਾਲ ਜੋੜੋ (ਏਜੰਟ ਬਣਾਓ)। ਸੂਚੀ ਦਿਖਾਉਂਦੀ ਹੈ ਕਿ ਹਰ ਕਨੈਕਸ਼ਨ ਨੂੰ ਕਿਹੜੇ ਏਜੰਟ ਵਰਤਦੇ ਹਨ, ਤਾਂ ਜੋ ਤੁਸੀਂ ਇੱਕ ਨਜ਼ਰ ਵਿੱਚ ਜਾਣ ਸਕੋ ਕਿ ਤਬਦੀਲੀ ਕਿਸ ਨੂੰ ਪ੍ਰਭਾਵਿਤ ਕਰਦੀ ਹੈ।
ਫੰਕਸ਼ਨ ਨਾਮਾਂ ਨੂੰ ਸਿਰਫ਼ ਇੱਕ ਏਜੰਟ ਦੇ ਅੰਦਰ ਵਿਲੱਖਣ ਹੋਣ ਦੀ ਲੋੜ ਹੁੰਦੀ ਹੈ। ਦੋ ਕਨੈਕਸ਼ਨ ਇੱਕੋ ਨਾਮ ਸਾਂਝਾ ਕਰ ਸਕਦੇ ਹਨ, ਜਿਵੇਂ ਵੱਖ-ਵੱਖ ਥਾਵਾਂ 'ਤੇ ਸੇਵ ਕਰਨ ਵਾਲੇ ਦੋ ਏਜੰਟਾਂ ਲਈ save_information, ਪਰ ਇੱਕ ਏਜੰਟ ਕੋਲ ਦੋਵੇਂ ਨਹੀਂ ਹੋ ਸਕਦੇ: ਇੱਕੋ ਨਾਮ ਵਾਲੇ ਦੋ ਟੂਲਾਂ ਨਾਲ ਏਜੰਟ ਨੂੰ ਸੇਵ ਕਰਨਾ ਅਸਵੀਕਾਰ ਕਰ ਦਿੱਤਾ ਜਾਂਦਾ ਹੈ, ਅਤੇ ਕਨੈਕਸ਼ਨ ਦਾ ਨਾਮ ਉਸ ਨਾਮ ਵਿੱਚ ਬਦਲਣਾ ਵੀ ਅਸਵੀਕਾਰ ਕਰ ਦਿੱਤਾ ਜਾਂਦਾ ਹੈ ਜੋ ਉਸਦੇ ਕਿਸੇ ਏਜੰਟ ਉੱਤੇ ਕੋਈ ਹੋਰ ਟੂਲ ਪਹਿਲਾਂ ਹੀ ਵਰਤ ਰਿਹਾ ਹੈ।