Πίστωση, λεπτά και όρια

Πώς μετριέται ο χρόνος ομιλίας

Τα χρεώσιμα δευτερόλεπτα μιας συνομιλίας αρχίζουν όταν απαντά ο βοηθός και τελειώνουν όταν ολοκληρώνεται. Κουδούνισμα, ουρά και αναμονή είναι δωρεάν — είτε προηγούνται της απάντησης είτε εξαιρούνται. Μια δοκιμαστική φωνητική κλήση χρεώνεται όπως κάθε άλλο λεπτό και επισημαίνεται ως δοκιμή στις αναλύσεις· μια δοκιμαστική συνομιλία κειμένου είναι δωρεάν.

Η τιμολόγηση γίνεται μία φορά την ημέρα, ανά βοηθό, ημέρα και μέσο, χωριστά για δοκιμές. Αυτό είναι σκόπιμο: η χωριστή τιμολόγηση κάθε συνομιλίας θα συσσώρευε εκατοντάδες στρογγυλοποιήσεις σε υπόλοιπο που δεν συμφωνεί. Μια συνομιλία δύο λεπτών και είκοσι δύο δευτερολέπτων συνεισφέρει ακριβώς 142 δευτερόλεπτα στην ημέρα της.

• Το talk_rate_minor_per_minute είναι 50 — EUR 0.50 το λεπτό, EUR 30 την ώρα.
• Κάθε ποσό είναι amount_minor μαζί με currency. Το νόμισμα είναι EUR.
• Η στρογγυλοποίηση είναι στήλη του τιμοκαταλόγου, όχι σταθερά στον κώδικα.

curl -G https://api.wetalk.io/v1/billing/usage \
  -H "Authorization: Bearer $WETALK_API_KEY"
  --data-urlencode "from=2026-09-01" \
  --data-urlencode "to=2026-09-30"

Δύο υπόλοιπα και μόνο ένα σταματά μια κλήση

Το `balance_minor` είναι όσα έχουν χρεωθεί και εκκαθαριστεί. Το `available_minor` είναι αυτό το ποσό μείον τα σημερινά αχρέωτα δευτερόλεπτα και όσα έχουν δεσμεύσει οι τρέχουσες συνομιλίες. Το δεύτερο ελέγχει ο ελεγκτής εισαγωγής και καθορίζει αν απαντάται ο επόμενος καλών.

Η δωρεάν δοκιμή καταναλώνεται πριν από την πίστωση, γι’ αυτό το υπόλοιπο δοκιμαστικού λογαριασμού δεν αλλάζει μέχρι να εξαντληθούν τα δωρεάν δευτερόλεπτα.

• Το state είναι ένα από trial, in_credit, exhausted ή hard_stopped.
• Τα exhausted και hard_stopped διαφέρουν: στο ένα εξαντλήθηκε το διαθέσιμο, το άλλο απενεργοποιήθηκε.
• Το trial_second_remaining μετρά τα δωρεάν δευτερόλεπτα που απομένουν.

curl https://api.wetalk.io/v1/billing/balance \
  -H "Authorization: Bearer $WETALK_API_KEY"

{
  "data": {
    "balance_minor": 15900,
    "unbilled_today_minor": 450,
    "reserved_minor": 200,
    "available_minor": 15250,
    "currency": "EUR",
    "trial_second_remaining": 0,
    "talk_rate_minor_per_minute": 50,
    "hard_stop_enabled": true,
    "state": "in_credit",
    "computed_at": "2026-09-14T19:22:31Z"
  }
}

Προϋπολογισμοί, υποχρεωτική διακοπή και αυτόματη ανανέωση

Ο προϋπολογισμός είναι μηνιαίο ποσό, ποσοστιαίο όριο ειδοποίησης και επιλογή αν η επίτευξή του σταματά τους βοηθούς ή μόνο σας ενημερώνει. Η υποχρεωτική διακοπή παύει τις απαντήσεις αντί να υπερβεί τη δαπάνη και αίρεται μόλις αυξήσετε τον προϋπολογισμό.

Η αυτόματη ανανέωση προσθέτει σταθερό ποσό όταν το διαθέσιμο υπόλοιπο πέσει κάτω από το όριό σας, με χρέωση αποθηκευμένης κάρτας και μηνιαίο ανώτατο ποσό. Το ανώτατο ποσό πρέπει να καλύπτει τουλάχιστον μία ανανέωση: μικρότερο όριο θα ήταν πολιτική που δεν μπορεί ποτέ να χρεώσει και απορρίπτεται αντί να αποτύχει σιωπηλά.

curl https://api.wetalk.io/v1/billing/budget \
  -X PUT \
  -H "Authorization: Bearer $WETALK_API_KEY"
  -H "Content-Type: application/json" \
  -d '{
    "month_budget_minor": 50000,
    "alert_threshold_percent": 80,
    "hard_stop_enabled": true
  }'

curl https://api.wetalk.io/v1/billing/auto-reload \
  -X PUT \
  -H "Authorization: Bearer $WETALK_API_KEY"
  -H "Content-Type: application/json" \
  -d '{
    "enabled": true,
    "threshold_minor": 2000,
    "top_up_minor": 20000,
    "monthly_cap_minor": 100000,
    "payment_method_id": "0199f1c2-6b4a-7f9c-9add-c3a45fc618cb"
  }'

Όταν η χρέωση αρνείται

Οι αρνήσεις χρέωσης είναι συνηθισμένα σφάλματα με δικούς τους κωδικούς και αξίζει να αντιμετωπίζονται χωριστά, επειδή δεν διορθώνονται με επανάληψη. Ειδικά το `payment_outcome_ambiguous` σημαίνει *ελέγξτε τι συνέβη* — ποτέ *δοκιμάστε ξανά*: η αναφορά στον επεξεργαστή απορρίπτει διπλότυπα, δεν παρέχει idempotency. Μια τυφλή επανάληψη μπορεί να χρεώσει κάποιον δύο φορές.

• credit_exhausted, trial_exhausted — δεν απομένει τίποτα προς δαπάνη.
• hard_stop_reached, budget_exceeded — όριο που ορίσατε.
• payment_declined, payment_requires_action, payment_requires_reauth — η κάρτα.
• payment_outcome_ambiguous — ελέγξτε το· μην επαναλάβετε.

curl -G https://api.wetalk.io/v1/billing/ledger \
  -H "Authorization: Bearer $WETALK_API_KEY"
  --data-urlencode "limit=100"

Πόσες ταυτόχρονα

Το πακέτο σας θέτει όριο ταυτόχρονων συνομιλιών για ολόκληρο τον χώρο εργασίας και το όριο κάθε βοηθού ανήκει στην ενεργή έκδοσή του. Ένας καλών που φτάνει πέρα από το όριο μπαίνει σε ουρά, δεν απορρίπτεται, και οι εισερχόμενες κλήσεις δεν εκτοπίζονται ποτέ από τις εξερχόμενες.

curl https://api.wetalk.io/v1/agents/$AGENT/concurrency \
  -H "Authorization: Bearer $WETALK_API_KEY"