# Airtable

Το Airtable συνδέει τον Ψηφιακό Βοηθό AI με έναν πίνακα (table) σε μία από τις βάσεις σας. Ο βοηθός χαιρετά τους γνωστούς καλούντες με το όνομά τους, εντοπίζει τη σωστή εγγραφή όσο ο καλών περιμένει και προσθέτει ή ενημερώνει γραμμές, για παράδειγμα ένα νέο αίτημα ή μια αλλαγμένη διεύθυνση. Η διαδρομή **Ενσωματώσεις - Κατάλογος - Airtable - Σύνδεση** ανοίγει το παράθυρο **Σύνδεση Airtable**. Η σύνδεση είναι μία για όλη την εταιρεία.

  <ShotPlaceholder
    src="/assets/integrations/airtable.png"
    name="airtable-connect"
    alt="Παράθυρο σύνδεσης Airtable με διακριτικό, Βάση, πίνακα και αντιστοίχιση πεδίων"
    capture="Integrations - Catalogue - Airtable - Connect dialog after Test token and a table is picked."
  />

## Τι χρειάζεστε πριν ξεκινήσετε

- Ένα personal access token του Airtable. Στο Airtable μεταβείτε στο **airtable.com/create/tokens**, δημιουργήστε token και δώστε του τα δικαιώματα (scopes) `data.records:read`, `data.records:write` και `schema.bases:read` στη βάση που θέλετε.
- Έναν πίνακα με τουλάχιστον μία στήλη τηλεφώνων. Οι στήλες ονόματος και email βοηθούν τον βοηθό να χαιρετά και να επιβεβαιώνει τους καλούντες.
- Προαιρετικά: ένα πεδίο τύπου "Last modified time" στον πίνακα, ώστε οι αλλαγές να συγχρονίζονται ταχύτερα.

## Τι συμπληρώνετε

- **Προσωπικό διακριτικό πρόσβασης** (required) — Επικολλήστε το και πατήστε **Έλεγχος token**. Ο έλεγχος φορτώνει τις βάσεις στις οποίες έχει πρόσβαση το token.
- **Βάση** (required) — Η βάση που περιέχει τον πίνακά σας.
- **Τραπέζι** (required) — Ο πίνακας (table) της βάσης με τον οποίο δουλεύει ο βοηθός.
- **Πεδίο τηλεφώνου** (required) — Μία ή περισσότερες στήλες με αριθμούς τηλεφώνου. Χρησιμοποιούνται για την αναγνώριση των καλούντων.
- **Πεδίο ονόματος** — Η στήλη με το όνομα του προσώπου.
- **Πεδίο email** — Η στήλη με τη διεύθυνση email.
- **Πεδίο τελευταίας τροποποίησης** — Μια στήλη "Last modified time". Με αυτήν συγχρονίζονται μόνο οι γραμμές που άλλαξαν.

## Πρώτη ρύθμιση

1. Δημιουργήστε το token στο Airtable με τα τρία δικαιώματα στη βάση σας.
2. **Ενσωματώσεις - Κατάλογος - Airtable - Σύνδεση**. Επικολλήστε το token και πατήστε **Έλεγχος token**.
3. Επιλέξτε **Βάση**, στη συνέχεια πίνακα, και αντιστοιχίστε τις στήλες τηλεφώνου, ονόματος και email. Πατήστε **Σύνδεση**.
4. Ανοίξτε **Οι agents μου - ο βοηθός σας - Ικανότητες - Εργαλεία & ροές εργασίας**, ενεργοποιήστε το εργαλείο **Airtable** και ανοίξτε τις ρυθμίσεις του.
5. Επιλέξτε τις λειτουργίες. Η αναγνώριση καλούντος με τηλέφωνο είναι επιλεγμένη εξ ορισμού. Προσθέστε δημιουργία ή ενημέρωση εγγραφής μόνο αν ο βοηθός πρέπει να γράφει στον πίνακα. Ενεργοποιήστε την **Αυτόματη αναγνώριση καλούντος κατά τη σύνδεση** ώστε ο καλών να αναζητείται μόλις ξεκινήσει η κλήση.
6. Πατήστε **Αποθήκευση**.
7. Επαλήθευση: καλέστε από αριθμό που υπάρχει στον πίνακα. Ο βοηθός πρέπει να γνωρίζει ποιος είστε. Στη συνέχεια ζητήστε του να βρει μια εγγραφή με βάση το όνομα.

## Τι μπορεί να κάνει ο βοηθός

**Αναγνώριση του καλούντος**
- Αναγνώριση του καλούντος από τον αριθμό τηλεφώνου και χαιρετισμός με το όνομά του.

**Εύρεση εγγραφών**
- Αναζήτηση με ελεύθερο κείμενο στις αντιστοιχισμένες στήλες ονόματος, email και τηλεφώνου.
- Άνοιγμα εγγραφής με το αναγνωριστικό εγγραφής του Airtable.

**Εγγραφή** (μόνο οι λειτουργίες που ενεργοποιήσατε)
- Δημιουργία νέας εγγραφής στον συνδεδεμένο πίνακα.
- Ενημέρωση πεδίων υπάρχουσας εγγραφής, με τα ονόματα στηλών που είδε στον πίνακα.

Η αναγνώριση καλούντων χρησιμοποιεί αντίγραφο του πίνακα που το Voice Logica διατηρεί συγχρονισμένο στο παρασκήνιο. Η αναζήτηση, η δημιουργία και η ενημέρωση γίνονται απευθείας στο Airtable.

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

**Ο Έλεγχος token δεν βρίσκει καμία βάση**

Το token λειτουργεί αλλά δεν έχει πρόσβαση σε βάση. Επεξεργαστείτε το token στο Airtable, προσθέστε τη βάση σας και τα δικαιώματα `data.records:read`, `data.records:write` και `schema.bases:read`, και δοκιμάστε ξανά.

**Ένας καλών που μόλις προστέθηκε στον πίνακα δεν αναγνωρίζεται**

Η αναγνώριση χρησιμοποιεί το συγχρονισμένο αντίγραφο, το οποίο ανανεώνεται στο παρασκήνιο ανά μερικές ώρες. Στις **Ενσωματώσεις - Συνδεδεμένες** ανοίξτε το Airtable και πατήστε **Συγχρονισμός τώρα** για να ενημερωθούν άμεσα οι νέες γραμμές. Ελέγξτε επίσης ότι ο αριθμός βρίσκεται σε στήλη που αντιστοιχίσατε ως **Πεδίο τηλεφώνου**.

**Ο βοηθός δεν μπορεί να δημιουργήσει ή να ενημερώσει εγγραφή**

Ελέγξτε ότι η δημιουργία ή η ενημέρωση εγγραφής είναι επιλεγμένη στον βοηθό και ότι το token έχει το δικαίωμα `data.records:write`. Οι υποχρεωτικές στήλες του πίνακα πρέπει να λάβουν τιμή, οπότε ορίστε στις οδηγίες του βοηθού ποια στοιχεία πρέπει να ζητά από τον καλούντα.

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

[Get an integration working](https://docs.voicelogica.ai/el/integrations/) - σύνδεση εταιρείας και εργαλείο βοηθού.  
[ClickUp](https://docs.voicelogica.ai/el/integrations/productivity/clickup/) - λίστες εργασιών με αναγνώριση καλούντος.  
[Custom API](https://docs.voicelogica.ai/el/integrations/custom-api/) - όταν τα δεδομένα σας βρίσκονται σε άλλο σύστημα.