# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gpt4business.ai/hu/getting-started/apis/message-ai-agent.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.