# ਪਲੇਟਫਾਰਮ ਸੰਖੇਪ


# ਪਲੇਟਫਾਰਮ ਸੰਖੇਪ

imatic ਤਿੰਨ ਉਤਪਾਦਾਂ ਵਾਲਾ ਇੱਕ ਪਲੇਟਫਾਰਮ ਹੈ — Voice Portal, Calendar, ਅਤੇ Survey। ਇਹ ਵੱਖਰੇ ਦਿਸਦੇ ਅਤੇ ਮਹਿਸੂਸ ਹੁੰਦੇ ਹਨ ਕਿਉਂਕਿ ਇਹ ਵੱਖ-ਵੱਖ ਕੰਮਾਂ ਦੀ ਸੇਵਾ ਕਰਦੇ ਹਨ, ਪਰ ਇਹ ਉਹੀ ਨੀਂਹ ਸਾਂਝੀ ਕਰਦੇ ਹਨ: ਤੁਸੀਂ ਕਿਵੇਂ ਸਾਈਨ ਇਨ ਕਰਦੇ ਹੋ, ਤੁਸੀਂ API ਕਾਲਾਂ ਨੂੰ ਕਿਵੇਂ ਪ੍ਰਮਾਣਿਤ ਕਰਦੇ ਹੋ, ਤੁਸੀਂ ਵੈੱਬਹੁੱਕ ਕਿਵੇਂ ਪ੍ਰਾਪਤ ਕਰਦੇ ਹੋ, ਅਤੇ AI ਏਜੰਟ MCP ਉੱਤੇ ਕਿਵੇਂ ਜੁੜਦੇ ਹਨ। ਇਹ ਪੰਨਾ ਉਨ੍ਹਾਂ ਸਾਂਝੇ ਟੁਕੜਿਆਂ ਦਾ ਨਕਸ਼ਾ ਬਣਾਉਂਦਾ ਹੈ ਤਾਂ ਜੋ ਤੁਹਾਨੂੰ ਪਤਾ ਲੱਗੇ ਕਿ ਹਰ ਉਤਪਾਦ ਕਿੱਥੇ ਰਹਿੰਦਾ ਹੈ ਅਤੇ ਉਨ੍ਹਾਂ ਵਿਚਕਾਰ ਕੀ ਅੱਗੇ ਚੱਲਦਾ ਹੈ।

## ਤਿੰਨ ਉਤਪਾਦ

| ਉਤਪਾਦ | ਇਹ ਕੀ ਕਰਦਾ ਹੈ | ਖਾਤਾ ਮਾਡਲ |
| --- | --- | --- |
| **Voice Portal** | AI ਵੌਇਸ-ਕਾਲਿੰਗ ਏਜੰਟ, ਮੁਹਿੰਮਾਂ, ਸੰਪਰਕ, ਕਾਲ ਲੌਗ | ਸੰਸਥਾ (ਟੀਮ) |
| **Calendar** | ਸਾਂਝੇ-ਕਰਨ-ਯੋਗ ਬੁਕਿੰਗ ਲਿੰਕ, ਕੈਲੰਡਰ ਸਿੰਕ, ਅਪੌਇੰਟਮੈਂਟਾਂ | ਵਿਅਕਤੀਗਤ |
| **Survey** | ਫਾਰਮ ਅਤੇ ਸਰਵੇਖਣ, ਜਵਾਬ, ਲਾਈਵ ਵਿਸ਼ਲੇਸ਼ਣ | ਵਿਅਕਤੀਗਤ |

ਹਰ ਉਤਪਾਦ ਦਾ ਆਪਣਾ ਜਾਣ-ਪਛਾਣ ਪੰਨਾ ਹੈ: [Voice Portal](/voice/introduction), [Calendar](/calendar/introduction), ਅਤੇ [Survey](/survey/introduction)।

## ਖਾਤੇ ਅਤੇ ਸੰਸਥਾਵਾਂ

ਤੁਹਾਨੂੰ ਕਿਵੇਂ ਸੰਗਠਿਤ ਕੀਤਾ ਜਾਂਦਾ ਹੈ ਇਹ ਉਤਪਾਦ 'ਤੇ ਨਿਰਭਰ ਕਰਦਾ ਹੈ:

- **Voice Portal ਸੰਸਥਾ-ਪਹਿਲਾਂ ਹੈ।** ਜਦੋਂ ਤੁਸੀਂ ਸਾਈਨ ਅੱਪ ਕਰਦੇ ਹੋ, ਤੁਸੀਂ ਇੱਕ ਸੰਸਥਾ ਬਣਾਉਂਦੇ ਹੋ ਅਤੇ ਇਸ ਦੇ ਐਡਮਿਨ ਬਣ ਜਾਂਦੇ ਹੋ। org ਅੰਦਰ ਤੁਸੀਂ ਕੰਮ ਨੂੰ **Projects** ਵਿੱਚ ਸਮੂਹਬੱਧ ਕਰਦੇ ਹੋ, ਅਤੇ ਪ੍ਰੋਜੈਕਟਾਂ ਵਿੱਚ **Agents** ਹੁੰਦੇ ਹਨ। ਤੁਸੀਂ ਟੀਮ ਦੇ ਸਾਥੀਆਂ ਨੂੰ ਸੱਦਾ ਦਿੰਦੇ ਹੋ ਅਤੇ ਉਨ੍ਹਾਂ ਨੂੰ ਭੂਮਿਕਾਵਾਂ ਦਿੰਦੇ ਹੋ। ਦੇਖੋ [Organization login](/voice/organization-login)।
- **Calendar ਅਤੇ Survey ਵਿਅਕਤੀ-ਪਹਿਲਾਂ ਹਨ।** ਤੁਸੀਂ ਇੱਕ ਵਿਅਕਤੀ ਵਜੋਂ ਸਾਈਨ ਅੱਪ ਕਰਦੇ ਹੋ ਅਤੇ ਤੁਰੰਤ ਕੰਮ ਸ਼ੁਰੂ ਕਰ ਦਿੰਦੇ ਹੋ — ਤੁਹਾਡੇ ਆਪਣੇ ਬੁਕਿੰਗ ਲਿੰਕ ਜਾਂ ਤੁਹਾਡੇ ਆਪਣੇ ਫਾਰਮ। ਦੋਵੇਂ ਉਤਪਾਦ ਅਜੇ ਵੀ ਲੋਕਾਂ ਨੂੰ ਸੱਦਾ ਦੇਣ ਅਤੇ ਐਡਮਿਨ ਭੂਮਿਕਾਵਾਂ ਦਾ ਸਮਰਥਨ ਕਰਦੇ ਹਨ ਜਿੱਥੇ ਤੁਹਾਨੂੰ ਆਪਣੇ ਖਾਤੇ ਦੇ ਦੁਆਲੇ ਇੱਕ ਟੀਮ ਦੀ ਲੋੜ ਹੁੰਦੀ ਹੈ।

### ਭੂਮਿਕਾਵਾਂ

ਤਿੰਨੋਂ ਉਤਪਾਦ ਇੱਕ ਭੂਮਿਕਾ ਲੜੀ ਵਰਤਦੇ ਹਨ, ਇੱਕ **ਸੰਸਥਾ ਐਡਮਿਨ** (ਮਾਲਕ) ਤੋਂ ਲੈ ਕੇ ਦ੍ਰਿਸ਼ ਅਤੇ ਸੀਮਤ-ਸੰਪਾਦਨ ਪਹੁੰਚ ਵਾਲੇ ਇੱਕ **ਮੈਂਬਰ** ਤੱਕ। Voice Portal ਇੱਕ ਪ੍ਰੋਜੈਕਟ ਤੱਕ ਸਕੋਪ ਕੀਤਾ ਇੱਕ **ਪ੍ਰੋਜੈਕਟ ਮੈਨੇਜਰ** ਜੋੜਦਾ ਹੈ। Calendar ਅਤੇ Survey ਉਹੀ ਮੋਟਾ ਆਕਾਰ ਵਰਤਦੇ ਹਨ, ਇੱਕ ਵਿਅਕਤੀਗਤ ਖਾਤੇ ਅਨੁਸਾਰ ਮਾਪਿਆ ਗਿਆ।

## ਸਾਂਝੀਆਂ ਧਾਰਨਾਵਾਂ

ਇਹ ਚਾਰ ਵਿਚਾਰ ਹਰ ਉਤਪਾਦ ਵਿੱਚ ਇੱਕੋ ਤਰ੍ਹਾਂ ਕੰਮ ਕਰਦੇ ਹਨ। ਇਨ੍ਹਾਂ ਨੂੰ ਇੱਕ ਵਾਰ ਸਿੱਖੋ ਅਤੇ ਇਹ ਅੱਗੇ ਚੱਲਦੇ ਹਨ।

### ਪ੍ਰਮਾਣੀਕਰਨ

ਤੁਸੀਂ ਹਰ ਉਤਪਾਦ ਦੀ ਵੈੱਬ ਐਪ ਵਿੱਚ ਆਪਣੀ ਈਮੇਲ ਅਤੇ ਪਾਸਵਰਡ ਨਾਲ ਸਾਈਨ ਇਨ ਕਰਦੇ ਹੋ (Calendar Google ਅਤੇ Outlook ਸਾਈਨ-ਇਨ ਵੀ ਪੇਸ਼ ਕਰਦਾ ਹੈ)। ਪਰਦੇ ਪਿੱਛੇ ਐਪ ਤੁਹਾਡੇ ਸੈਸ਼ਨ ਲਈ ਇੱਕ **JWT** ਵਰਤਦੀ ਹੈ। ਪ੍ਰੋਗਰਾਮੈਟਿਕ ਪਹੁੰਚ ਲਈ ਤੁਸੀਂ ਆਪਣਾ ਪਾਸਵਰਡ ਨਹੀਂ ਵਰਤਦੇ — ਇਸ ਦੀ ਬਜਾਏ ਤੁਸੀਂ ਇੱਕ **ਸਕੋਪ ਕੀਤੀ API ਕੁੰਜੀ** ਬਣਾਉਂਦੇ ਹੋ। ਦੋਵਾਂ ਲਈ [REST API](./api) ਪੰਨਾ ਦੇਖੋ।

### API ਕੁੰਜੀਆਂ

ਹਰ ਉਤਪਾਦ ਤੁਹਾਨੂੰ ਇਸ ਦੇ REST API ਨੂੰ ਕਾਲ ਕਰਨ ਲਈ API ਕੁੰਜੀਆਂ ਬਣਾਉਣ ਦਿੰਦਾ ਹੈ। ਇੱਕ ਕੁੰਜੀ `prefix.secret` ਰੂਪ ਵਿੱਚ ਦਿਖਾਈ ਜਾਂਦੀ ਹੈ, **ਸਕੋਪ** ਰੱਖਦੀ ਹੈ ਜੋ ਸੀਮਤ ਕਰਦੇ ਹਨ ਕਿ ਇਹ ਕੀ ਕਰ ਸਕਦੀ ਹੈ, ਅਤੇ ਬਣਾਉਣ ਵੇਲੇ **ਸਿਰਫ਼ ਇੱਕ ਵਾਰ ਦਿਖਾਈ ਜਾਂਦੀ ਹੈ**। ਤੁਸੀਂ ਹਰ ਉਤਪਾਦ ਦੇ ਡਿਵੈਲਪਰ ਖੇਤਰ ਵਿੱਚ ਕੁੰਜੀਆਂ ਪ੍ਰਬੰਧਿਤ ਕਰਦੇ ਹੋ।

:::danger[API ਕੁੰਜੀਆਂ ਰਾਜ਼ ਹਨ]

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

:::

### ਵੈੱਬਹੁੱਕ

ਪੋਲ ਕਰਨ ਦੀ ਬਜਾਏ, ਤੁਸੀਂ ਇੱਕ **ਵੈੱਬਹੁੱਕ** ਰਜਿਸਟਰ ਕਰ ਸਕਦੇ ਹੋ ਤਾਂ ਜੋ imatic ਤੁਹਾਡੇ ਸਰਵਰ ਨੂੰ ਸੂਚਿਤ ਕਰੇ ਜਦੋਂ ਕੁਝ ਵਾਪਰਦਾ ਹੈ — ਇੱਕ ਬੁਕਿੰਗ ਬਣਦੀ ਹੈ, ਇੱਕ ਜਵਾਬ ਜਮ੍ਹਾਂ ਹੁੰਦਾ ਹੈ, ਅਤੇ ਇਸੇ ਤਰ੍ਹਾਂ। ਵੈੱਬਹੁੱਕ ਡਿਲੀਵਰੀਆਂ **HMAC ਨਾਲ ਹਸਤਾਖਰਿਤ** ਹੁੰਦੀਆਂ ਹਨ ਤਾਂ ਜੋ ਤੁਸੀਂ ਪੁਸ਼ਟੀ ਕਰ ਸਕੋ ਕਿ ਇਹ ਸੱਚਮੁੱਚ imatic ਤੋਂ ਆਈਆਂ ਹਨ। ਦੇਖੋ [REST API ਗਾਈਡ ਵਿੱਚ ਵੈੱਬਹੁੱਕ](./api#ਵੈੱਬਹੁੱਕ)।

### AI ਏਜੰਟਾਂ ਲਈ MCP

imatic **Model Context Protocol (MCP)** ਸਰਵਰ ਉਜਾਗਰ ਕਰਦਾ ਹੈ ਤਾਂ ਜੋ AI ਸਹਾਇਕ ਸਹੀ ਅਨੁਮਤੀਆਂ ਨਾਲ ਤੁਹਾਡੇ ਡੇਟਾ ਨੂੰ ਪੜ੍ਹ ਅਤੇ ਉਸ 'ਤੇ ਕਾਰਵਾਈ ਕਰ ਸਕਣ। ਪ੍ਰਮਾਣ-ਪੱਤਰ ਉਤਪਾਦ ਅਨੁਸਾਰ ਵੱਖਰਾ ਹੁੰਦਾ ਹੈ: Calendar ਦਾ MCP `mcp` ਸਕੋਪ ਰੱਖਣ ਵਾਲੀ ਇੱਕ **ਸਕੋਪ ਕੀਤੀ API ਕੁੰਜੀ** ਨਾਲ ਪ੍ਰਮਾਣਿਤ ਹੁੰਦਾ ਹੈ; Survey ਦਾ MCP ਤੁਹਾਡੇ **ਪੋਰਟਲ JWT** ਨਾਲ ਪ੍ਰਮਾਣਿਤ ਹੁੰਦਾ ਹੈ; Voice Portal ਇਸ ਦੀ ਬਜਾਏ ਤੁਹਾਨੂੰ ਆਪਣੇ ਏਜੰਟਾਂ ਲਈ **ਬਾਹਰੀ MCP ਸਰਵਰ ਰਜਿਸਟਰ** ਕਰਨ ਦਿੰਦਾ ਹੈ। ਹਰ ਮਾਮਲੇ ਵਿੱਚ ਕਾਲਾਂ ਤੁਹਾਡੀ ਸੰਸਥਾ ਦੇ ਅਲੱਗਾਓ ਅੰਦਰ ਰਹਿੰਦੀਆਂ ਹਨ। ਦੇਖੋ [AI ਏਜੰਟਾਂ ਲਈ MCP](./mcp)।

## ਹਰ ਉਤਪਾਦ ਦਾ API ਕਿੱਥੇ ਰਹਿੰਦਾ ਹੈ

ਉੱਪਰ ਦਿੱਤੀਆਂ ਸਾਂਝੀਆਂ ਧਾਰਨਾਵਾਂ ਹਰ ਥਾਂ ਇੱਕੋ ਜਿਹੀਆਂ ਹਨ, ਪਰ ਹਰ ਉਤਪਾਦ ਆਪਣੇ ਖ਼ੁਦ ਦੇ **ਸਰੋਤ** ਉਜਾਗਰ ਕਰਦਾ ਹੈ। ਅੰਤ-ਬਿੰਦੂ ਨਾਮਾਂ, ਪੇਲੋਡਾਂ, ਅਤੇ ਉਦਾਹਰਨਾਂ ਲਈ ਉਤਪਾਦ ਦੇ ਡਿਵੈਲਪਰ ਪੰਨੇ ਤੋਂ ਸ਼ੁਰੂ ਕਰੋ:

- **Calendar** — ਇਵੈਂਟ ਕਿਸਮਾਂ, ਉਪਲਬਧਤਾ/ਸਲਾਟ, ਬੁਕਿੰਗਾਂ, ਕੈਲੰਡਰ, ਵੈੱਬਹੁੱਕ, API ਕੁੰਜੀਆਂ, ਅਤੇ ਇੱਕ 7-ਟੂਲ MCP ਸਰਵਰ। ਦੇਖੋ [ਡਿਵੈਲਪਰਾਂ ਲਈ Calendar](/calendar/developers)।
- **Survey** — ਫਾਰਮ, ਜਵਾਬ, ਇਕੱਤਰੀਕਰਨ, AI ਫਾਰਮ ਨਿਰਮਾਣ, ਵੈੱਬਹੁੱਕ, ਅਤੇ MCP ਟੂਲ। ਦੇਖੋ [ਡਿਵੈਲਪਰਾਂ ਲਈ Survey](/survey/developers)।
- **Voice Portal** — ਏਜੰਟ, ਟੂਲ, ਅਤੇ ਤੁਹਾਡੇ ਏਜੰਟਾਂ ਨਾਲ ਬਾਹਰੀ ਟੂਲ ਜੋੜਨ ਲਈ MCP ਸਰਵਰ ਰਜਿਸਟ੍ਰੇਸ਼ਨ। ਦੇਖੋ [ਏਜੰਟਾਂ ਲਈ ਟੂਲ ਅਤੇ MCP](/voice/agents/tools-mcp)।

## ਭਾਸ਼ਾਵਾਂ

imatic ਐਪਾਂ ਅਤੇ ਇਹ ਦਸਤਾਵੇਜ਼ 13 ਭਾਸ਼ਾਵਾਂ ਵਿੱਚ ਉਪਲਬਧ ਹਨ, ਜਿਸ ਵਿੱਚ ਅਰਬੀ ਅਤੇ ਉਰਦੂ ਲਈ ਸੱਜੇ-ਤੋਂ-ਖੱਬੇ ਰੈਂਡਰਿੰਗ ਸ਼ਾਮਲ ਹੈ। ਉੱਪਰਲੀ ਨੈਵੀਗੇਸ਼ਨ ਵਿੱਚ ਭਾਸ਼ਾ ਡ੍ਰੌਪਡਾਊਨ ਵਰਤ ਕੇ ਬਦਲੋ। ਦੇਖੋ [ਭਾਸ਼ਾਵਾਂ ਅਤੇ RTL](./languages)।

## ਸਹਾਇਤਾ ਪ੍ਰਾਪਤ ਕਰਨਾ

- ਇਨ੍ਹਾਂ ਦਸਤਾਵੇਜ਼ਾਂ ਨਾਲ ਸ਼ੁਰੂ ਕਰੋ — ਜ਼ਿਆਦਾਤਰ ਪੰਨੇ ਤੁਹਾਨੂੰ ਡੂੰਘਾਈ ਵਿੱਚ ਲੈ ਜਾਣ ਲਈ **ਅਗਲੇ ਕਦਮ** ਜਾਂ **ਸੰਬੰਧਿਤ** ਲਿੰਕਾਂ ਨਾਲ ਖ਼ਤਮ ਹੁੰਦੇ ਹਨ।
- Voice Portal ਸੰਸਥਾਵਾਂ ਐਪ-ਅੰਦਰਲੇ **Tickets** ਖੇਤਰ ਵਿੱਚ ਇੱਕ ਬੇਨਤੀ ਉਠਾ ਸਕਦੀਆਂ ਹਨ।
- ਖਾਤਾ ਜਾਂ ਬਿਲਿੰਗ ਸਵਾਲਾਂ ਲਈ, ਆਪਣੇ ਉਤਪਾਦ ਦੀਆਂ ਸੈਟਿੰਗਾਂ ਅੰਦਰ ਦਿਖਾਏ ਸਹਾਇਤਾ ਸੰਪਰਕ ਵੇਰਵੇ ਵਰਤੋ।

## ਸੰਬੰਧਿਤ

- [ਸ਼ੁਰੂਆਤ ਕਰਨਾ](../getting-started) — ਇੱਕ ਉਤਪਾਦ ਚੁਣੋ ਅਤੇ ਆਪਣੇ ਪਹਿਲੇ ਕਦਮ ਚੁੱਕੋ।
- [REST API](./api) — ਪ੍ਰਮਾਣੀਕਰਨ, API ਕੁੰਜੀਆਂ, ਵੈੱਬਹੁੱਕ, ਅਤੇ ਨਿਯਮ।
- [AI ਏਜੰਟਾਂ ਲਈ MCP](./mcp) — Model Context Protocol ਉੱਤੇ AI ਸਹਾਇਕ ਜੋੜੋ।
- [ਭਾਸ਼ਾਵਾਂ ਅਤੇ RTL](./languages) — ਐਪਾਂ ਅਤੇ ਦਸਤਾਵੇਜ਼ 13 ਭਾਸ਼ਾਵਾਂ ਵਿੱਚ ਪੜ੍ਹੋ।