Αναφορά API
Αναφορά API
Όλα τα endpoints του Voiceland AI API: αυθεντικοποίηση, διεύθυνση βάσης, έκδοση API και παραδείγματα curl για κάθε ομάδα.
Οι περιγραφές των endpoints και των πεδίων εμφανίζονται στα αγγλικά, όπως ακριβώς τις δημοσιεύει το API. Είναι επιλογή μας, ώστε να διαβάζετε εδώ ό,τι θα δείτε και στις αποκρίσεις.
REST API for building and operating voice agents. Authenticate every request with your API key: Authorization: Bearer vsk_…. Optionally pin the dated API version with the Voiceland-Version header.
Αυθεντικοποίηση#
Κάθε αίτημα στέλνει το κλειδί API σας στην κεφαλίδα Authorization, σε μορφή Bearer. Δημιουργείτε κλειδιά στην ενότητα Developers της κονσόλας. Άνοιγμα κονσόλας
Authorization: Bearer VL_API_KEY
Διεύθυνση βάσης#
Τα αιτήματα πηγαίνουν στη διεύθυνση:
https://api.voiceland.ai/v1
Έκδοση API#
Προαιρετικά, κλειδώστε τη χρονολογημένη έκδοση του API στέλνοντας την κεφαλίδα:
Voiceland-Version: 2026-04-26
Ομάδες endpoints#
AI utilities
2 endpoints: Ask a question over a transcript, Transcribe audio.
Account
3 endpoints: Mint a local session, Get your tenant profile, List voices.
Agent assist
2 endpoints: Draft a reply for any conversation, Draft a reply for a live session.
Agent testing
7 endpoints: List test runs, Run a test scenario (synchronous), Get a test run κ.ά.
Agents
11 endpoints: List agents, Create or update an agent, Generate an agent from a brief κ.ά.
Audit
2 endpoints: List audit events, Get an audit event.
Calendar
17 endpoints: List bookings (by member window or by phone), Book an appointment, Get a booking κ.ά.
Calls
15 endpoints: List calls, Place an outbound call, Get a call κ.ά.
Chat takeover
11 endpoints: List representative availability, Set a representative's availability, List chat takeover sessions κ.ά.
Contacts
9 endpoints: List or look up contacts, Create a contact, Recent journalled calls κ.ά.
Data sources
8 endpoints: List connectors, List data sources, Create a data source κ.ά.
Demo tools
3 endpoints: Demo: a customer's bookings, Demo: look up an order, Demo: current weather for a city.
Evaluation
11 endpoints: List eval runs, Run the agent's golden set (pre-deploy eval), Get an eval run κ.ά.
Feedback
8 endpoints: List answer feedback, Rate an answer, Answer satisfaction analytics κ.ά.
Integrations
34 endpoints: Supported integrations as seen from an agent, Remove an integration, Enable or configure an integration κ.ά.
Intents
5 endpoints: List intent candidates, Promote an intent candidate, Dismiss an intent candidate κ.ά.
Knowledge base
39 endpoints: List collections, Create a collection, Delete a collection κ.ά.
Numbers
5 endpoints: Claim a number, List available numbers, Register an external number κ.ά.
Omnichannel
13 endpoints: List channel kinds, List channels, Delete a channel κ.ά.
Operations agents
33 endpoints: List operations agents, Create an operations agent, Design a board with AI κ.ά.
Self-service
31 endpoints: Per-agent call stats, List AI operations reports, AI operations report settings κ.ά.
Web widget
3 endpoints: List test links, Create a test link, Revoke a test link.