---
title: "API ਕਨੈਕਸ਼ਨ"
description: "ਕਿਸੇ ਵੀ HTTP API ਨੂੰ ਇੱਕ ਅਜਿਹੇ ਫੰਕਸ਼ਨ ਵਿੱਚ ਬਦਲੋ ਜਿਸਨੂੰ ਤੁਹਾਡਾ ਏਜੰਟ ਗੱਲਬਾਤ ਦੌਰਾਨ ਕਾਲ ਕਰ ਸਕੇ: ਇੱਕ cURL ਕਮਾਂਡ ਪੇਸਟ ਕਰੋ ਅਤੇ ਵਿਜ਼ਾਰਡ ਟੂਲ ਡੈਫਿਨੀਸ਼ਨ, ਪੈਰਾਮੀਟਰ ਅਤੇ auth ਬਣਾਉਂਦਾ ਹੈ।"
---

API ਕਨੈਕਸ਼ਨ ਕਸਟਮ HTTP ਫੰਕਸ਼ਨ ਹਨ ਜਿਨ੍ਹਾਂ ਨੂੰ ਤੁਹਾਡੇ ਏਜੰਟ ਗੱਲਬਾਤ ਦੌਰਾਨ ਕਾਲ ਕਰ ਸਕਦੇ ਹਨ — ਆਰਡਰ ਲੱਭਣਾ, ਟਿਕਟ ਬਣਾਉਣਾ, ਜਾਂ ਆਪਣੇ ਬੈਕਐਂਡ ਤੋਂ ਖਾਤੇ ਦੀ ਸਥਿਤੀ ਪ੍ਰਾਪਤ ਕਰਨਾ। ਤੁਸੀਂ ਐਂਡਪੌਇੰਟ ਨੂੰ ਇੱਕ ਵਾਰ **ਕਨੈਕਸ਼ਨ → APIs** (`/dashboard/api-connections`) ਵਿੱਚ ਪਰਿਭਾਸ਼ਿਤ ਕਰਦੇ ਹੋ; ਜਿਨ੍ਹਾਂ ਏਜੰਟਾਂ ਨਾਲ ਕਨੈਕਸ਼ਨ ਜੋੜਿਆ ਹੁੰਦਾ ਹੈ, ਉਹ ਗੱਲਬਾਤ ਦੀ ਲੋੜ ਅਨੁਸਾਰ ਇਸਨੂੰ ਕਾਲ ਕਰ ਸਕਦੇ ਹਨ।

ਇਸਨੂੰ ਬਣਾਉਣ ਦੇ ਦੋ ਤਰੀਕੇ ਹਨ: ਕੋਈ ਅਜਿਹੀ ਚੀਜ਼ ਪੇਸਟ ਕਰੋ ਜਿਸਦਾ ਵਿਜ਼ਾਰਡ ਵਿਸ਼ਲੇਸ਼ਣ ਕਰ ਸਕੇ, ਜਾਂ ਕਨੈਕਸ਼ਨ ਨੂੰ ਹੱਥੀਂ ਸੈਟ ਅੱਪ ਕਰੋ।

## ਤੇਜ਼ ਤਰੀਕਾ: ਪੇਸਟ ਕਰੋ ਅਤੇ ਵਿਸ਼ਲੇਸ਼ਣ ਕਰੋ

<Steps>
  <Step title="ਨਵਾਂ API ਕਨੈਕਸ਼ਨ 'ਤੇ ਕਲਿੱਕ ਕਰੋ">
    ਡਾਇਲਾਗ ਵਿਜ਼ਾਰਡ ਵਿੱਚ ਖੁੱਲ੍ਹਦਾ ਹੈ। ਬਾਕਸ ਵਿੱਚ ਇੱਕ ਨਮੂਨਾ **cURL ਕਮਾਂਡ**,
    **OpenAPI/Swagger ਸਪੈਸਿਫਿਕੇਸ਼ਨ**, **Postman ਐਕਸਪੋਰਟ**, **TypeScript
    ਇੰਟਰਫੇਸ**, ਜਾਂ **Zod ਸਕੀਮਾ** ਪੇਸਟ ਕਰੋ।
  </Step>
  <Step title="ਵਿਸ਼ਲੇਸ਼ਣ ਕਰੋ 'ਤੇ ਕਲਿੱਕ ਕਰੋ">
    ThunderPhone ਤੁਹਾਡੇ ਪੇਸਟ ਕੀਤੇ ਡਾਟੇ ਤੋਂ ਪੂਰਾ ਕਨੈਕਸ਼ਨ ਅਨੁਮਾਨਿਤ ਕਰਦਾ ਹੈ — URL,
    ਮੈਥਡ, ਹੈਡਰ, ਅਤੇ ਇਸਨੂੰ ਮਿਲੇ ਕਵੇਰੀ ਪੈਰਾਮੀਟਰਾਂ ਅਤੇ ਰਿਕਵੇਸਟ ਬਾਡੀ ਤੋਂ ਤਿਆਰ ਕੀਤਾ
    ਪੈਰਾਮੀਟਰ ਸਕੀਮਾ। ਤੁਹਾਡੇ ਵੱਲੋਂ ਪੇਸਟ ਕੀਤੇ ਹੈਡਰਾਂ ਨੂੰ (ਪ੍ਰਮਾਣੀਕਰਨ ਹੈਡਰਾਂ ਸਮੇਤ)
    ਐਂਡਪੌਇੰਟ ਕੌਂਫਿਗਰੇਸ਼ਨ ਵਿੱਚ ਸ਼ਾਮਲ ਕੀਤਾ ਜਾਂਦਾ ਹੈ।
  </Step>
  <Step title="ਹਾਈਲਾਈਟ ਕੀਤੇ ਫੀਲਡਾਂ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ">
    ਅਨੁਮਾਨਿਤ ਕੌਂਫਿਗਰੇਸ਼ਨ ਸਮੀਖਿਆ ਲਈ ਅਨੁਮਾਨ ਲਗਾਏ ਫੀਲਡਾਂ ਨੂੰ ਹਾਈਲਾਈਟ ਕਰਕੇ ਖੁੱਲ੍ਹਦੀ ਹੈ।
    ਨਾਮਾਂ, ਵੇਰਵਿਆਂ ਅਤੇ ਪੈਰਾਮੀਟਰ ਕਿਸਮਾਂ ਨੂੰ ਵਿਵਸਥਿਤ ਕਰੋ ਤਾਂ ਜੋ ਏਜੰਟ ਸਮਝ ਸਕੇ ਕਿ
    ਫੰਕਸ਼ਨ ਨੂੰ ਕਦੋਂ ਅਤੇ ਕਿਵੇਂ ਕਾਲ ਕਰਨਾ ਹੈ — ਵੇਰਵਾ ਉਹੀ ਹੈ ਜੋ ਮਾਡਲ ਪੜ੍ਹਦਾ ਹੈ।
  </Step>
  <Step title="ਪ੍ਰਮਾਣਿਤ ਕਰੋ ਅਤੇ ਸੇਵ ਕਰੋ">
    ਸੇਵ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ ਤੁਹਾਡੇ ਐਂਡਪੌਇੰਟ ਵਿਰੁੱਧ ਇੱਕ ਲਾਈਵ ਟੈਸਟ ਰਿਕਵੇਸਟ ਚਲਾਈ ਜਾਂਦੀ ਹੈ।
    ਜੇ ਰਿਕਵੇਸਟ ਅਸਫਲ ਹੁੰਦੀ ਹੈ, ਤਾਂ ਕਨੈਕਸ਼ਨ ਸੇਵ ਨਹੀਂ ਹੁੰਦਾ — URL, ਪ੍ਰਮਾਣੀਕਰਨ
    ਹੈਡਰਾਂ ਜਾਂ ਬਾਡੀ ਨੂੰ ਠੀਕ ਕਰੋ ਅਤੇ ਦੁਬਾਰਾ ਕੋਸ਼ਿਸ਼ ਕਰੋ। ਸਫਲਤਾ ਉੱਤੇ ਕਨੈਕਸ਼ਨ ਨੂੰ
    **ਪ੍ਰਮਾਣਿਤ** ਬੈਜ ਨਾਲ ਸਟੋਰ ਕੀਤਾ ਜਾਂਦਾ ਹੈ।
  </Step>
</Steps>

ਜੇ ਵਿਜ਼ਾਰਡ ਨੂੰ ਤੁਹਾਡੇ ਪੇਸਟ ਕੀਤੇ ਡਾਟੇ ਵਿੱਚ ਰਿਕਵੇਸਟ URL ਨਹੀਂ ਮਿਲਦਾ, ਤਾਂ ਇਹ ਤੁਹਾਨੂੰ ਦੱਸੇਗਾ —
ਪੂਰਾ `http(s)` ਐਂਡਪੌਇੰਟ ਸ਼ਾਮਲ ਕਰੋ ਅਤੇ ਦੁਬਾਰਾ ਕੋਸ਼ਿਸ਼ ਕਰੋ।

## ਹੱਥੀਂ ਸੈਟ ਅੱਪ

ਵਿਜ਼ਾਰਡ ਵਿੱਚ **ਹੱਥੀਂ ਸੈਟ ਅੱਪ ਕਰੋ →** 'ਤੇ ਕਲਿੱਕ ਕਰੋ (ਜਾਂ ਵਾਪਸ ਜਾਣ ਲਈ **ਕੀ ਤੁਸੀਂ ਚਾਹੁੰਦੇ ਹੋ ਕਿ AI ਇਸਦਾ ਅਨੁਮਾਨ ਲਗਾਏ?
ਵਿਜ਼ਾਰਡ ਅਜ਼ਮਾਓ →** 'ਤੇ ਕਲਿੱਕ ਕਰੋ)। ਹੱਥੀਂ ਬਿਲਡਰ ਵਿੱਚ ਦੋ ਐਡੀਟਰ ਹਨ:

- **ਵਿਜ਼ੂਅਲ** — ਡਿਸਪਲੇ ਨਾਮ, ਫੰਕਸ਼ਨ ਨਾਮ, ਰਿਕਵੇਸਟ
  **URL**, **ਮੈਥਡ** (`POST`, `GET`, `PUT`, `PATCH`, `DELETE`), ਕਸਟਮ
  **ਹੈਡਰਾਂ**, ਅਤੇ ਪੈਰਾਮੀਟਰ ਸਕੀਮਾ ਲਈ ਫਾਰਮ ਫੀਲਡ (**ਪ੍ਰਾਪਰਟੀ ਸ਼ਾਮਲ ਕਰੋ** ਹਰ ਉਸ
  ਆਰਗੂਮੈਂਟ ਲਈ ਜੋ ਏਜੰਟ ਦੇ ਸਕਦਾ ਹੈ)।
- **JSON** — ਕੱਚੇ JSON ਵਜੋਂ ਉਹੀ ਪਰਿਭਾਸ਼ਾ, ਟੂਲ ਸਪੈਸਿਫਿਕੇਸ਼ਨ ਨੂੰ ਸਿੱਧਾ ਪੇਸਟ ਕਰਨ ਜਾਂ
  ਸੁਧਾਰਨ ਲਈ।

ਇੱਕ **ਟੈਸਟ ਰਿਕਵੇਸਟ** ਪੈਨਲ (ਵਿਕਲਪਿਕ) ਤੁਹਾਨੂੰ ਸੇਵ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ ਕੌਂਫਿਗਰ ਕੀਤੀ ਰਿਕਵੇਸਟ
ਭੇਜਣ ਦਿੰਦਾ ਹੈ ਅਤੇ ਸਥਿਤੀ, ਲੇਟੈਂਸੀ, ਅਤੇ ਜਵਾਬ ਦਾ ਪ੍ਰੀਵਿਊ ਦਿਖਾਉਂਦਾ ਹੈ।
**ਪ੍ਰਮਾਣਿਤ ਕਰੋ ਅਤੇ ਸੇਵ ਕਰੋ** ਹਮੇਸ਼ਾ ਇਹ ਟੈਸਟ ਚਲਾਉਂਦਾ ਹੈ ਅਤੇ ਸਿਰਫ਼ ਸਫਲਤਾ ਉੱਤੇ ਸੇਵ ਕਰਦਾ ਹੈ।

<Tip>
  ਪੈਰਾਮੀਟਰਾਂ ਨੂੰ ਸਪਸ਼ਟ-ਭਾਸ਼ਾ ਵੇਰਵੇ ਦਿਓ ("ਗਾਹਕ ਦਾ ਈਮੇਲ ਪਤਾ,
  ਉਦਾਹਰਨ ਲਈ jane@example.com")। ਏਜੰਟ ਕਾਲ ਦੌਰਾਨ, ਰੀਅਲ ਟਾਈਮ ਵਿੱਚ, ਇਨ੍ਹਾਂ
  ਵੇਰਵਿਆਂ ਤੋਂ ਆਰਗੂਮੈਂਟ ਚੁਣਦਾ ਹੈ।
</Tip>

## ਆਪਣੇ ਕਨੈਕਸ਼ਨਾਂ ਦਾ ਪ੍ਰਬੰਧਨ ਕਰੋ

ਹਰ ਕਨੈਕਸ਼ਨ ਕਤਾਰ ਆਪਣੀ ਪ੍ਰਮਾਣੀਕਰਨ ਸਥਿਤੀ — **ਪ੍ਰਮਾਣਿਤ**,
**ਨਾ-ਟੈਸਟ ਕੀਤਾ**, ਜਾਂ **ਗਲਤੀ** — ਆਪਣਾ ਫੰਕਸ਼ਨ ਨਾਮ, ਅਤੇ ਇਸਨੂੰ ਵਰਤਣ ਵਾਲੇ ਏਜੰਟ ਦਿਖਾਉਂਦੀ ਹੈ।
ਕਤਾਰ ਦੇ ਐਕਸ਼ਨ ਮੀਨੂ ਤੋਂ ਤੁਸੀਂ ਇਹ ਕਰ ਸਕਦੇ ਹੋ:

- **ਸੰਪਾਦਿਤ ਕਰੋ** — ਕੌਂਫਿਗਰੇਸ਼ਨ ਦੁਬਾਰਾ ਖੋਲ੍ਹੋ।
- **ਕਲੋਨ ਕਰੋ** — ਸ਼ੁਰੂਆਤੀ ਬਿੰਦੂ ਵਜੋਂ ਇਸਦੀ ਨਕਲ ਬਣਾਓ (ਨਕਲ ਨਾ-ਟੈਸਟ ਕੀਤੀ ਸ਼ੁਰੂ ਹੁੰਦੀ ਹੈ)।
- **ਰਿਵੀਜ਼ਨ ਇਤਿਹਾਸ** — ਪਹਿਲਾਂ ਦੇ ਵਰਜਨ ਦੇਖੋ ਅਤੇ ਇੱਕ ਨੂੰ ਐਡੀਟਰ ਵਿੱਚ ਰੀਸਟੋਰ ਕਰੋ।
- **ਟ੍ਰਾਂਸਫਰ ਕਰੋ** — ਕਨੈਕਸ਼ਨ ਨੂੰ ਕਿਸੇ ਹੋਰ ਸੰਸਥਾ ਵਿੱਚ ਕਾਪੀ ਜਾਂ ਮੂਵ ਕਰੋ ਜਿਸ ਨਾਲ ਤੁਸੀਂ ਸੰਬੰਧਿਤ ਹੋ।
  ਮੂਵ ਕਰਨ ਨਾਲ ਇਹ ਇੱਥੋਂ ਹਟ ਜਾਂਦਾ ਹੈ; ਇਸਨੂੰ ਵਰਤਣ ਵਾਲੇ ਏਜੰਟਾਂ ਨੂੰ ਮੁੜ ਕੌਂਫਿਗਰ ਕਰਨ ਦੀ ਲੋੜ ਪੈ ਸਕਦੀ ਹੈ।
- **ਮਿਟਾਓ** — ਸਥਾਈ ਹੈ; ਕਨੈਕਸ਼ਨ ਵਰਤਣ ਵਾਲੇ ਏਜੰਟਾਂ ਨੂੰ ਮੁੜ ਕੌਂਫਿਗਰ ਕਰਨਾ ਪਵੇਗਾ।

## ਇਸਨੂੰ ਏਜੰਟ ਨਾਲ ਜੋੜੋ

ਬਿਲਡਰ ਦੇ API ਕਨੈਕਸ਼ਨ ਸੈਕਸ਼ਨ ਵਿੱਚ ਕਨੈਕਸ਼ਨ ਨੂੰ ਏਜੰਟ ਨਾਲ ਜੋੜੋ
([ਏਜੰਟ ਬਣਾਓ](/pa/guides/build-an-agent))। ਸੂਚੀ ਦਿਖਾਉਂਦੀ ਹੈ ਕਿ ਹਰ ਕਨੈਕਸ਼ਨ ਨੂੰ ਕਿਹੜੇ ਏਜੰਟ ਵਰਤਦੇ ਹਨ,
ਤਾਂ ਜੋ ਤੁਸੀਂ ਇੱਕ ਨਜ਼ਰ ਵਿੱਚ ਜਾਣ ਸਕੋ ਕਿ ਤਬਦੀਲੀ ਕਿਸ ਨੂੰ ਪ੍ਰਭਾਵਿਤ ਕਰਦੀ ਹੈ।

## ਅਗਲੇ ਕਦਮ

<CardGroup cols={2}>
  <Card title="API ਰਾਹੀਂ ਟੂਲ ਇੰਟੀਗ੍ਰੇਸ਼ਨ" icon="code" href="/pa/guides/build-tool-integration">
    ਉਹੀ ਕਨੈਕਸ਼ਨ ਪ੍ਰੋਗਰਾਮੈਟਿਕ ਤਰੀਕੇ ਨਾਲ ਬਣਾਓ ਅਤੇ ਪ੍ਰਬੰਧਿਤ ਕਰੋ।
  </Card>
  <Card title="ਐਪਾਂ ਕਨੈਕਟ ਕਰੋ" icon="cable" href="/pa/guides/connect-apps">
    ਪਹਿਲਾਂ ਤੋਂ ਬਣੇ Google, Slack, HubSpot, Salesforce ਅਤੇ Cal.com ਕਨੈਕਸ਼ਨ।
  </Card>
  <Card title="ਇੱਕ MCP ਸਰਵਰ ਸ਼ਾਮਲ ਕਰੋ" icon="server" href="/pa/guides/mcp-servers">
    ਆਪਣੇ ਏਜੰਟਾਂ ਲਈ ਪੂਰਾ ਟੂਲ ਸਰਵਰ ਐਕਸਪੋਜ਼ ਕਰੋ।
  </Card>
  <Card title="ਇੰਟੀਗ੍ਰੇਸ਼ਨ API ਰੈਫਰੈਂਸ" icon="book" href="/api-reference/integrations">
    ਇੰਟੀਗ੍ਰੇਸ਼ਨ ਸਰੋਤ ਦਾ ਹਰ ਫੀਲਡ।
  </Card>
</CardGroup>
