Τεκμηρίωση

Ζητήστε πρόσβαση και ένα API key

Τα API keys εκδίδονται κατά το onboarding ή σε πιλοτικό έργο. Επικοινωνήστε μαζί μας για να ενεργοποιήσουμε το tenant και το κλειδί σας.

Εγκαταστήστε το πακέτο του widget

Το React widget διατίθεται δημόσια στο npm. Ενσωματώνεται εντός Shadow DOM με τα δικά του στυλ, ώστε να μην επηρεάζει το CSS σας.

npm install @eworx-org/ccbot-react

Ανταλλάξτε το API key σας στον server

Κρατήστε το API key αποκλειστικά στον server. Το endpoint σας το ανταλλάσσει με ένα βραχύβιο Chat Session Token, ώστε το κλειδί να μη φτάνει ποτέ στον browser. Στείλτε τη διεύθυνση IP του επισκέπτη στην κεφαλίδα X-Visitor-IP ώστε κάθε επισκέπτης να έχει το δικό του όριο αιτημάτων (rate limit), χρησιμοποιώντας την τελευταία εγγραφή του X-Forwarded-For που προσθέτει ο δικός σας proxy.

// POST /api/ccbot/token  (server-side only)
const visitorIp = req.headers.get('x-forwarded-for')?.split(',').pop().trim();
const res = await fetch(
  'https://www.contentcloud.com/services/chat-token-service/exchange',
  {
    method: 'POST',
    headers: {
      'X-Api-Key': process.env.CONTENT_CLOUD_API_KEY,
      ...(visitorIp && { 'X-Visitor-IP': visitorIp }),
    },
  },
);
const { token } = await res.json();

Προσαρτήστε το widget

Συνδέστε το widget με το token endpoint σας. Με αυτόν ακριβώς τον τρόπο είναι ρυθμισμένο το widget σε αυτόν τον ιστότοπο.

import { CCbotWidget } from '@eworx-org/ccbot-react';

<CCbotWidget auth={{ tokenEndpoint: '/api/ccbot/token' }} />