Help Center Χειριστές

Χειριστές

Διαχειριστείτε τους χειριστές συνομιλίας στους οργανισμούς σας ChatHub. Οι χειριστές είναι πράκτορες που χειρίζονται συνομιλίες πελατών.

Επισκόπηση

Χειριστές στο ChatHub:

Χειριστείτε συνομιλίες συνομιλίας πελατών
Ανήκουν σε συγκεκριμένους οργανισμούς
Έχετε ενεργή, ανενεργή ή διαγραμμένη κατάσταση
Μπορεί να έχει μεμονωμένα διακριτικά ελέγχου ταυτότητας
Λήψη και απάντηση σε μηνύματα

Λίστα χειριστών

Ανάκτηση όλων των χειριστών για έναν συγκεκριμένο οργανισμό.

Τελικό σημείο

GET /api/operator?organizationId={id}

Αίτημα

curl -X GET "https://chatapi.smsbat.com/api/operator?organizationId=24" \
  -H "Authorization: Bearer {company-token}" \
  -H "Accept: text/plain"

Παράμετροι

Παράμετρος	Τύπος	Τοποθεσία	Απαιτείται	Περιγραφή
`organizationId`	ακέραιος	Ερώτημα	Ναι	Αναγνωριστικό οργανισμού

Κεφαλίδες

Κεφαλίδα	Αξία	Απαιτείται
«Εξουσιοδότηση»	Φορέας {token}	Ναι
«Αποδοχή»	κείμενο/απλό	Ναι

Απάντηση

[
  {
    "id": 101,
    "name": "John Smith",
    "status": 0,
    "organization": {
      "id": 24,
      "name": "Customer Support"
    }
  },
  {
    "id": 102,
    "name": "Sarah Johnson",
    "status": 0,
    "organization": {
      "id": 24,
      "name": "Customer Support"
    }
  },
  {
    "id": 103,
    "name": "Mike Wilson",
    "status": 1,
    "organization": {
      "id": 24,
      "name": "Customer Support"
    }
  }
]

Πεδία απόκρισης

Πεδίο	Τύπος	Περιγραφή
`id`	ακέραιος	Μοναδικό αναγνωριστικό χειριστή
«όνομα»	χορδή	Εμφανιζόμενο όνομα χειριστή
«κατάσταση»	ακέραιος	Κατάσταση χειριστή (0=Ενεργός, 1=Ανενεργός, 2=Διαγραμμένος)
«οργάνωση»	αντικείμενο	Στοιχεία γονικού οργανισμού
`organization.id`	ακέραιος	Αναγνωριστικό οργανισμού
`organization.name`	χορδή	Όνομα οργανισμού

Κατάσταση χειριστή

Κατάσταση	Αξία	Περιγραφή
Ενεργός	0	Ο χειριστής εργάζεται αυτήν τη στιγμή και μπορεί να λαμβάνει συνομιλίες
Ανενεργό	1	Ο χειριστής είναι προσωρινά απενεργοποιημένος
Διαγράφηκε	2	Ο χειριστής έχει αφαιρεθεί από το σύστημα

Προσθήκη χειριστή

Προσθέστε νέους τελεστές σε οργανισμούς χρησιμοποιώντας το τελικό σημείο συγχρονισμού.

Τελικό σημείο

POST /api/operator/synchronize

Αίτημα

curl -X POST https://chatapi.smsbat.com/api/operator/synchronize \
  -H "Authorization: Bearer {company-token}" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "organizationId": 24,
      "name": "Alex Brown"
    },
    {
      "organizationId": 24,
      "name": "Emma Davis"
    }
  ]'

Σώμα αιτήματος

Πίνακας αντικειμένων χειριστή:

[
  {
    "organizationId": 24,
    "name": "Alex Brown"
  },
  {
    "organizationId": 24,
    "name": "Emma Davis"
  }
]

Πεδία αιτήματος

Πεδίο	Τύπος	Απαιτείται	Περιγραφή
`organizationId`	ακέραιος	Ναι	Αναγνωριστικό οργανισμού-στόχου
«όνομα»	χορδή	Ναι	Εμφανιζόμενο όνομα χειριστή

Απάντηση

[
  {
    "id": 104,
    "name": "Alex Brown",
    "status": 0
  },
  {
    "id": 105,
    "name": "Emma Davis",
    "status": 0
  }
]

Αλλαγή κατάστασης χειριστή

Ενημέρωση κατάστασης χειριστή (Ενεργό/Ανενεργό/Διαγραμμένο).

Τελικό σημείο

POST /api/operator/status

Αίτημα

curl -X POST https://chatapi.smsbat.com/api/operator/status \
  -H "Authorization: Bearer {company-token}" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 104,
    "status": 1
  }'

Σώμα αιτήματος

{
  "id": 0,
  "status": 0
}

Πεδία αιτήματος

Πεδίο	Τύπος	Απαιτείται	Περιγραφή
`id`	ακέραιος	Ναι	Αναγνωριστικό χειριστή
«κατάσταση»	ακέραιος	Ναι	Νέα κατάσταση (0=Ενεργό, 1=Ανενεργό, 2=Διαγραμμένο)

Απάντηση

200 OK

Η επιτυχία επιστρέφει το HTTP 200 χωρίς σώμα απόκρισης.

Τιμές κατάστασης

Κατάσταση	Αξία	Περιγραφή
Ενεργός	0	Ο χειριστής μπορεί να χειριστεί συνομιλίες
Ανενεργό	1	Ο χειριστής είναι προσωρινά απενεργοποιημένος
Διαγράφηκε	2	Ο χειριστής αφαιρέθηκε από το σύστημα

Παράδειγμα: Απενεργοποίηση χειριστή

curl -X POST https://chatapi.smsbat.com/api/operator/status \
  -H "Authorization: Bearer {company-token}" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 104,
    "status": 1
  }'

Παράδειγμα: Επανενεργοποίηση χειριστή

curl -X POST https://chatapi.smsbat.com/api/operator/status \
  -H "Authorization: Bearer {company-token}" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 104,
    "status": 0
  }'

Παράδειγμα: Διαγραφή χειριστή

curl -X POST https://chatapi.smsbat.com/api/operator/status \
  -H "Authorization: Bearer {company-token}" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 104,
    "status": 2
  }'

Παραδείγματα Εφαρμογής

Python

import requests

class OperatorManager:
    def __init__(self, company_token, base_url='https://chatapi.smsbat.com'):
        self.company_token = company_token
        self.base_url = base_url
        self.headers = {
            'Authorization': f'Bearer {company_token}',
            'Accept': 'text/plain'
        }

    def list_operators(self, organization_id):
        """Get all operators for an organization"""
        response = requests.get(
            f'{self.base_url}/api/operator',
            headers=self.headers,
            params={'organizationId': organization_id}
        )
        response.raise_for_status()
        return response.json()

    def add_operators(self, operators):
        """Add new operators
        Args:
            operators: List of dicts with organizationId and name
        """
        response = requests.post(
            f'{self.base_url}/api/operator/synchronize',
            headers={**self.headers, 'Content-Type': 'application/json'},
            json=operators
        )
        response.raise_for_status()
        return response.json()

    def get_active_operators(self, organization_id):
        """Get only active operators"""
        operators = self.list_operators(organization_id)
        return [op for op in operators if op['status'] == 0]

    def find_operator_by_name(self, organization_id, name):
        """Find operator by name"""
        operators = self.list_operators(organization_id)
        for operator in operators:
            if operator['name'].lower() == name.lower():
                return operator
        return None

    def change_operator_status(self, operator_id, status):
        """Change operator status
        Args:
            operator_id: Operator ID
            status: 0 (Active), 1 (Inactive), 2 (Deleted)
        """
        response = requests.post(
            f'{self.base_url}/api/operator/status',
            headers={**self.headers, 'Content-Type': 'application/json'},
            json={'id': operator_id, 'status': status}
        )
        response.raise_for_status()
        return response.status_code == 200

# Usage
manager = OperatorManager('your-company-token')

# List operators
operators = manager.list_operators(organization_id=24)
print(f"Found {len(operators)} operators")

# Get only active operators
active = manager.get_active_operators(24)
print(f"{len(active)} active operators")

# Add new operators
new_operators = manager.add_operators([
    {'organizationId': 24, 'name': 'John Doe'},
    {'organizationId': 24, 'name': 'Jane Smith'}
])
print(f"Added {len(new_operators)} operators")

# Find operator by name
operator = manager.find_operator_by_name(24, 'John Doe')
if operator:
    print(f"Found operator: {operator['name']} (ID: {operator['id']})")

# Change operator status
manager.change_operator_status(104, 1)  # Deactivate
print("Operator deactivated")

manager.change_operator_status(104, 0)  # Reactivate
print("Operator reactivated")

JavaScript (Node.js)

const axios = require('axios');

class OperatorManager {
  constructor(companyToken, baseUrl = 'https://chatapi.smsbat.com') {
    this.companyToken = companyToken;
    this.baseUrl = baseUrl;
    this.headers = {
      'Authorization': `Bearer ${companyToken}`,
      'Accept': 'text/plain'
    };
  }

  async listOperators(organizationId) {
    const response = await axios.get(
      `${this.baseUrl}/api/operator`,
      {
        headers: this.headers,
        params: { organizationId }
      }
    );

    return response.data;
  }

  async addOperators(operators) {
    const response = await axios.post(
      `${this.baseUrl}/api/operator/synchronize`,
      operators,
      {
        headers: {
          ...this.headers,
          'Content-Type': 'application/json'
        }
      }
    );

    return response.data;
  }

  async getActiveOperators(organizationId) {
    const operators = await this.listOperators(organizationId);
    return operators.filter(op => op.status === 0);
  }

  async findOperatorByName(organizationId, name) {
    const operators = await this.listOperators(organizationId);
    return operators.find(op =>
      op.name.toLowerCase() === name.toLowerCase()
    );
  }

  async getOperatorById(organizationId, operatorId) {
    const operators = await this.listOperators(organizationId);
    return operators.find(op => op.id === operatorId);
  }

  async changeOperatorStatus(operatorId, status) {
    const response = await axios.post(
      `${this.baseUrl}/api/operator/status`,
      { id: operatorId, status },
      {
        headers: {
          ...this.headers,
          'Content-Type': 'application/json'
        }
      }
    );

    return response.status === 200;
  }
}

// Usage
const manager = new OperatorManager('your-company-token');

async function manageOperators() {
  // List operators
  const operators = await manager.listOperators(24);
  console.log(`Found ${operators.length} operators`);

  // Get active operators
  const active = await manager.getActiveOperators(24);
  console.log(`${active.length} active operators`);

  // Add new operators
  const newOperators = await manager.addOperators([
    { organizationId: 24, name: 'John Doe' },
    { organizationId: 24, name: 'Jane Smith' }
  ]);
  console.log(`Added ${newOperators.length} operators`);

  // Find operator by name
  const operator = await manager.findOperatorByName(24, 'John Doe');
  if (operator) {
    console.log(`Found: ${operator.name} (ID: ${operator.id})`);
  }

  // Change operator status
  await manager.changeOperatorStatus(104, 1); // Deactivate
  console.log('Operator deactivated');

  await manager.changeOperatorStatus(104, 0); // Reactivate
  console.log('Operator reactivated');
}

manageOperators();

PHP

<?php

class OperatorManager {
    private $companyToken;
    private $baseUrl;

    public function __construct($companyToken, $baseUrl = 'https://chatapi.smsbat.com') {
        $this->companyToken = $companyToken;
        $this->baseUrl = $baseUrl;
    }

    public function listOperators($organizationId) {
        $url = $this->baseUrl . '/api/operator?organizationId=' . $organizationId;

        $ch = curl_init($url);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_HTTPHEADER, [
            'Authorization: Bearer ' . $this->companyToken,
            'Accept: text/plain'
        ]);

        $response = curl_exec($ch);
        curl_close($ch);

        return json_decode($response, true);
    }

    public function addOperators($operators) {
        $ch = curl_init($this->baseUrl . '/api/operator/synchronize');

        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_POST, true);
        curl_setopt($ch, CURLOPT_HTTPHEADER, [
            'Authorization: Bearer ' . $this->companyToken,
            'Content-Type: application/json',
            'Accept: text/plain'
        ]);
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($operators));

        $response = curl_exec($ch);
        curl_close($ch);

        return json_decode($response, true);
    }

    public function getActiveOperators($organizationId) {
        $operators = $this->listOperators($organizationId);
        return array_filter($operators, function($op) {
            return $op['status'] === 0;
        });
    }

    public function findOperatorByName($organizationId, $name) {
        $operators = $this->listOperators($organizationId);

        foreach ($operators as $operator) {
            if (strcasecmp($operator['name'], $name) === 0) {
                return $operator;
            }
        }

        return null;
    }

    public function changeOperatorStatus($operatorId, $status) {
        $ch = curl_init($this->baseUrl . '/api/operator/status');

        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_POST, true);
        curl_setopt($ch, CURLOPT_HTTPHEADER, [
            'Authorization: Bearer ' . $this->companyToken,
            'Content-Type: application/json'
        ]);
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
            'id' => $operatorId,
            'status' => $status
        ]));

        $response = curl_exec($ch);
        $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        curl_close($ch);

        return $httpCode === 200;
    }
}

// Usage
$manager = new OperatorManager('your-company-token');

// List operators
$operators = $manager->listOperators(24);
echo "Found " . count($operators) . " operators\n";

// Get active operators
$active = $manager->getActiveOperators(24);
echo count($active) . " active operators\n";

// Add new operators
$newOperators = $manager->addOperators([
    ['organizationId' => 24, 'name' => 'John Doe'],
    ['organizationId' => 24, 'name' => 'Jane Smith']
]);
echo "Added " . count($newOperators) . " operators\n";

// Find operator
$operator = $manager->findOperatorByName(24, 'John Doe');
if ($operator) {
    echo "Found: " . $operator['name'] . " (ID: " . $operator['id'] . ")\n";
}

// Change operator status
$manager->changeOperatorStatus(104, 1); // Deactivate
echo "Operator deactivated\n";

$manager->changeOperatorStatus(104, 0); // Reactivate
echo "Operator reactivated\n";

Συνήθεις περιπτώσεις χρήσης

Ενσωματωμένα νέα μέλη της ομάδας

async function onboardOperators(teamMembers, organizationId) {
  const operators = teamMembers.map(member => ({
    organizationId,
    name: member.fullName
  }));

  const created = await addOperators(operators);

  // Generate tokens for each operator
  for (const operator of created) {
    const token = await getOperatorToken(operator.id);
    await sendWelcomeEmail(operator, token);
  }

  return created;
}

Παρακολούθηση κατάστασης χειριστή

async function getOperatorStatistics(organizationId) {
  const operators = await listOperators(organizationId);

  return {
    total: operators.length,
    active: operators.filter(op => op.status === 0).length,
    inactive: operators.filter(op => op.status === 1).length,
    deleted: operators.filter(op => op.status === 2).length
  };
}

Εξισορρόπηση φορτίου

async function assignChatToOperator(organizationId, chatId) {
  const activeOperators = await getActiveOperators(organizationId);

  if (activeOperators.length === 0) {
    throw new Error('No active operators available');
  }

  // Simple round-robin assignment
  const operatorIndex = chatId % activeOperators.length;
  return activeOperators[operatorIndex];
}

Μαζική εισαγωγή

async function importOperatorsFromCSV(csvData, organizationId) {
  const lines = csvData.split('\n').slice(1); // Skip header

  const operators = lines
    .filter(line => line.trim())
    .map(line => {
      const [name] = line.split(',');
      return { organizationId, name: name.trim() };
    });

  // Batch import in chunks of 100
  const chunkSize = 100;
  const results = [];

  for (let i = 0; i < operators.length; i += chunkSize) {
    const chunk = operators.slice(i, i + chunkSize);
    const imported = await addOperators(chunk);
    results.push(...imported);

    console.log(`Imported ${results.length}/${operators.length}`);
  }

  return results;
}

Βέλτιστες πρακτικές

Χειρισμός σφαλμάτων

async function addOperatorsSafely(operators) {
  try {
    return await addOperators(operators);
  } catch (error) {
    if (error.response?.status === 400) {
      console.error('Invalid operator data:', error.response.data);
      // Handle validation errors
    } else if (error.response?.status === 401) {
      console.error('Authentication failed');
      // Refresh token
    } else {
      console.error('Unexpected error:', error);
    }

    throw error;
  }
}

Προσωρινή αποθήκευση

class CachedOperatorManager extends OperatorManager {
  constructor(companyToken) {
    super(companyToken);
    this.cache = new Map();
    this.cacheTTL = 60000; // 1 minute
  }

  async listOperators(organizationId, useCache = true) {
    const cacheKey = `org_${organizationId}`;
    const cached = this.cache.get(cacheKey);

    if (useCache && cached && Date.now() - cached.time < this.cacheTTL) {
      return cached.data;
    }

    const data = await super.listOperators(organizationId);

    this.cache.set(cacheKey, {
      data,
      time: Date.now()
    });

    return data;
  }

  clearCache(organizationId = null) {
    if (organizationId) {
      this.cache.delete(`org_${organizationId}`);
    } else {
      this.cache.clear();
    }
  }
}

Επικύρωση

function validateOperatorData(operators) {
  const errors = [];

  operators.forEach((op, index) => {
    if (!op.organizationId) {
      errors.push(`Operator ${index}: Missing organizationId`);
    }

    if (!op.name || op.name.trim().length === 0) {
      errors.push(`Operator ${index}: Name is required`);
    }

    if (op.name && op.name.length > 100) {
      errors.push(`Operator ${index}: Name too long (max 100 chars)`);
    }
  });

  if (errors.length > 0) {
    throw new Error('Validation failed:\n' + errors.join('\n'));
  }
}

// Usage
try {
  validateOperatorData(operatorData);
  await addOperators(operatorData);
} catch (error) {
  console.error(error.message);
}

Περιορισμός ποσοστού

class RateLimitedOperatorManager extends OperatorManager {
  constructor(companyToken, requestsPerSecond = 5) {
    super(companyToken);
    this.minInterval = 1000 / requestsPerSecond;
    this.lastRequest = 0;
  }

  async throttle() {
    const now = Date.now();
    const timeSinceLastRequest = now - this.lastRequest;

    if (timeSinceLastRequest < this.minInterval) {
      await new Promise(resolve =>
        setTimeout(resolve, this.minInterval - timeSinceLastRequest)
      );
    }

    this.lastRequest = Date.now();
  }

  async listOperators(organizationId) {
    await this.throttle();
    return super.listOperators(organizationId);
  }

  async addOperators(operators) {
    await this.throttle();
    return super.addOperators(operators);
  }
}

Αντιμετώπιση προβλημάτων

Δεν επιστράφηκαν χειριστές

Επαληθεύστε ότι το αναγνωριστικό οργανισμού είναι σωστό
Ο οργανισμός ελέγχου υπάρχει και έχει χειριστές
Βεβαιωθείτε ότι το εταιρικό διακριτικό έχει πρόσβαση στον οργανισμό

Απέτυχε η προσθήκη τελεστών

Επαληθεύστε ότι υπάρχει αναγνωριστικό οργανισμού
Ελέγξτε τη μορφή ονόματος χειριστή
Βεβαιωθείτε ότι το διακριτικό της εταιρείας είναι έγκυρο
Βεβαιωθείτε ότι η μορφή JSON είναι σωστή

401 Μη εξουσιοδοτημένο

Βεβαιωθείτε ότι το διακριτικό της εταιρείας είναι έγκυρο
Το διακριτικό επιταγής δεν έχει λήξει
Ζητήστε νέο διακριτικό εάν χρειάζεται

Διπλότυποι χειριστές

Το τελικό σημείο συγχρονισμού ενδέχεται να επιτρέπει διπλότυπα ονόματα. Εφαρμογή αποδιπλασιασμού:

async function addUniqueOperators(newOperators, organizationId) {
  const existing = await listOperators(organizationId);
  const existingNames = new Set(
    existing.map(op => op.name.toLowerCase())
  );

  const unique = newOperators.filter(op =>
    !existingNames.has(op.name.toLowerCase())
  );

  if (unique.length === 0) {
    return [];
  }

  return await addOperators(unique);
}

Επόμενα βήματα

Έλεγχος ταυτότητας - Λάβετε διακριτικά χειριστή
Οργανισμοί - Διαχείριση οργανισμών
Ενσωμάτωση γραφικών στοιχείων - Ενσωμάτωση γραφικού στοιχείου συνομιλίας

Search Results

Χειριστές

Επισκόπηση

Λίστα χειριστών

Τελικό σημείο

Αίτημα

Παράμετροι

Κεφαλίδες

Απάντηση

Πεδία απόκρισης

Κατάσταση χειριστή

Προσθήκη χειριστή

Τελικό σημείο

Αίτημα

Σώμα αιτήματος

Πεδία αιτήματος

Απάντηση

Αλλαγή κατάστασης χειριστή

Τελικό σημείο

Αίτημα

Σώμα αιτήματος

Πεδία αιτήματος

Απάντηση

Τιμές κατάστασης

Παράδειγμα: Απενεργοποίηση χειριστή

Παράδειγμα: Επανενεργοποίηση χειριστή

Παράδειγμα: Διαγραφή χειριστή

Παραδείγματα Εφαρμογής

Python

JavaScript (Node.js)

PHP

Συνήθεις περιπτώσεις χρήσης

Ενσωματωμένα νέα μέλη της ομάδας

Παρακολούθηση κατάστασης χειριστή

Εξισορρόπηση φορτίου

Μαζική εισαγωγή

Βέλτιστες πρακτικές

Χειρισμός σφαλμάτων

Προσωρινή αποθήκευση

Επικύρωση

Περιορισμός ποσοστού

Αντιμετώπιση προβλημάτων

Δεν επιστράφηκαν χειριστές

Απέτυχε η προσθήκη τελεστών

401 Μη εξουσιοδοτημένο

Διπλότυποι χειριστές

Επόμενα βήματα