Πραγματοποιήστε μία κλήση από έναν από τους αριθμούς τηλεφώνου του χώρου εργασίας σας. Κάθε αίτημα χρειάζεται ένα μοναδικό Idempotency-Key· η επαναποστολή του ίδιου κλειδιού επιστρέφει την ίδια κλήση αντί να καλέσει δύο φορές.
curl https://evasay.com/api/v1/voice/calls \
-X POST \
-H "Authorization: Bearer sk-your-key" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"agent_id": "AGENT_ID",
"to": "+14155550100",
"variables": { "customer_name": "Alex", "order_id": "1234" }
}'
Το from απαιτείται όταν ο χώρος εργασίας έχει περισσότερους από έναν αριθμούς τηλεφώνου. Τα variables συμπληρώνουν δεσμευτικά θέσης της μορφής {{customer_name}} στο πρώτο μήνυμα και στο prompt του πράκτορα.
Με ενεργό το voicemail_detection (προεπιλογή), μια εξερχόμενη κλήση περιμένει να μιλήσει η άλλη πλευρά πριν χαιρετήσει ο πράκτορας· αν μείνουν σιωπηλοί, ο πράκτορας χαιρετά μετά από δύο ή τρία δευτερόλεπτα. Όταν ο πράκτορας ακούσει τηλεφωνητή ή ηχογράφηση εταιρείας τηλεφωνίας, περιμένει να τελειώσουν ο χαιρετισμός και ο ήχος, αφήνει το voicemail_message, ή κλείνει όταν δεν υπάρχει. Τέτοιες κλήσεις τελειώνουν με ended_reason voicemail, χρεώνονται για τον χρόνο που διήρκεσαν και δεν αναλύονται ούτε ειδοποιούν.
Σε μια καμπάνια, ένας αριθμός που έπεσε σε τηλεφωνητή καλείται ξανά όπως ένας που δεν απάντησε, και το μήνυμα αφήνεται μόνο στην τελευταία προσπάθεια, ώστε κανείς να μη λάβει το ίδιο μήνυμα δύο φορές.
Κάθε εξερχόμενη κλήση, από καμπάνια ή από POST /api/v1/voice/calls, ελέγχει πρώτα τη λίστα «Μην καλείτε» του χώρου εργασίας. Ένας αριθμός της λίστας δεν καλείται ποτέ: το API απαντά 409 με code do_not_call, και μια καμπάνια σημειώνει την επαφή ως canceled με outcome do_not_call και συνεχίζει στην επόμενη.
Όταν το άτομο σε μια κλήση που έκανε ο πράκτορας ζητά να μην το ξανακαλέσουν, ο πράκτορας βάζει μόνος του τον αριθμό του στη λίστα, του το λέει, και στέλνεται το webhook call.do_not_call. Οι αριθμοί μπορούν επίσης να προστεθούν και να αφαιρεθούν στο Καμπάνιες → Λίστα «Μην καλείτε» ή με το API:
curl https://evasay.com/api/v1/voice/do-not-call \
-X POST \
-H "Authorization: Bearer sk-your-key" \
-H "Content-Type: application/json" \
-d '{ "phones": ["+14155550100"], "note": "Asked by email" }'
Οι αριθμοί είναι σε διεθνή μορφή· έως 1.000 τη φορά. Το GET /api/v1/voice/do-not-call τους παραθέτει, πρώτους τους νεότερους (search, limit, page), καθέναν με το source του (call, dashboard ή api). Το DELETE /api/v1/voice/do-not-call/%2B14155550100 αφαιρεί έναν ξανά· κάντε το μόνο όταν το άτομο έχει συμφωνήσει να το καλούν.