> For the complete documentation index, see [llms.txt](https://docs.gpt4business.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gpt4business.ai/hu/getting-started/apis/message-ai-agent.md).

# Message AI Agent

### **Üzenet Küldése az AI Ügynöknek**

A **GPT4Business API** lehetővé teszi az AI ügynökkel való interakciót **POST kérés küldésével**. Ezáltal üzeneteket küldhetsz, válaszokat fogadhatsz és még sok más lehetőséget kihasználhatsz.

***

### **API Végpont**

Az alábbi URL-t kell használnod az API eléréséhez:

```
https://admin.gpt4business.ai/en/chatbot/api/v1/message/
```

***

### **Kérés Fejlécek**

Az API használatához a következő fejléc mezőket kell megadni:

* `Content-Type: application/json`
* `Authorization: Token <Your-API-Token>`

***

### **Kérés Törzse (Request Body)**

A kérés törzsének az alábbi paramétereket kell tartalmaznia:

* **`chatbot_uuid`** (Típus: UUID, **Kötelező**)
  * Az AI chatbot egyedi azonosítója (**UUID**), amelyet a chatbot adatlapján találhatsz meg.
* **`query`** (Típus: String, **Kötelező**)
  * A chatbot számára elküldendő üzenet/kérdés (**max. 5000 karakter**).
* **`user_key`** (Típus: String, **Kötelező**)
  * Egyedi azonosító, amely megkülönbözteti a felhasználókat.

### **Példa API Kérésre**

```
import requests

# API végpont
url = "https://admin.gpt4business.ai/en/chatbot/api/v1/message/"

# Kérés fejlécek
headers = {
    'Authorization': 'Token <YOUR-API-TOKEN>',
    'Content-Type': 'application/json'
}

# Kérés törzs adat
data = {
    "chatbot_uuid": "12345678-1234-5678-1234-567812345678",
    "query": "Your message/string here.",
    "user_key": "Your message/string here."
}

# API kérés küldése
response = requests.post(url, headers=headers, json=data)

# Válasz ellenőrzése
if response.status_code == 200:
    print("Válasz:", response.json().get('data'))
else:
    error_data = response.json()
    print("Hiba:", error_data.get('message', '') + error_data.get('error', ''))
```

### **Példa API Válaszra**

```
{
    "message": "AI Agent successfully answered.",
    "data": {
        "answer": "If you have a specific question or need assistance with something, please let me know and I`ll be happy to help.",
        "chat_id": 634
    }
}
```

***

### **Hibakezelés**

Az **API hibás kérés esetén** strukturált válaszokat küld. Fontos, hogy minden **nem 200-as státuszkódot** megfelelően kezelj.

#### **Példa Hibás Kérésekre**

**Ha nincs megadva API token:**

```
{
    "detail": "Authentication credentials were not provided."
}
```

**Ha a paraméterek hibásak vagy hiányoznak:**

```
{
    "message": "The provided parameters are not valid. Please check and try again.",
    "errors": {
        "chatbot_uuid": [
            "This field is required."
        ]
    }
}
```

***

📌 **Megjegyzés:** Győződj meg róla, hogy minden kötelező paramétert megadsz, és hogy az API tokent helyesen illeszted be a kérés fejlécébe.