List system tags
GET
https://api.telvana.com/tags
Retrieve all system-defined tags and their descriptions. These tags are automatically applied to conversations by the AI analyzer.
Example request
curl "https://api.telvana.com/tags" \
-H "x-api-key: $TELVANA_API_KEY"
Response 200
System tags retrieved successfully. Errors use the format in Errors .
Example response
{
"data": {
"transferred": "The Agent initiated a transfer to a human representative. Do not apply when the Agent was transferred by an IVR or routing system.",
"voicemail": "The Agent left a voicemail message: the call reached a voicemail or answering system and the Agent delivered its message into it. Voicemail greetings take many forms: a personal greeting, a carrier greeting that only reads back a phone number and says it is not available or cannot take the call, \"please leave your message for ...\", \"record your message after the tone\", and mailbox menus such as \"to replay your message, press one\". Apply whenever the Agent spoke its message after such a greeting, even if the recording never confirms it. Do not apply if the call reached voicemail but the Agent left no message, if a live person answered, or if the Agent only spoke into a call-screening prompt (\"record your name and reason for calling, I'll see if this person is available\").",
"voicemail_no_message": "The call reached a voicemail or answering system and the Agent left no message: the mailbox was full, had not been set up (\"has a voicemail box that has not been set up yet\"), the number was reported not available with nothing recorded, or the Agent was cut off after a word or two. Do not apply when the Agent delivered its message (use voicemail), or when a live person answered.",
"appointment_booked": "A specific appointment or meeting was booked for a definite date and time. Do not apply when the User only asked to be contacted again later without settling on a slot.",
"callback_scheduled": "The User asked to be called back later without booking a specific appointment slot, for example \"call me back Tuesday\".",
"not_interested": "The User is not interested or asked not to be contacted",
"action_needed": "A real conversation took place and the User raised a question, concern, or request that requires human follow-up, or left information or a message the office has to act on: information the office would need to request records from another provider, a change to who is coming in or when, something the User wants passed to the front desk or a named staff member, or anything the Agent said it would pass on to the office because it could not act on it itself. A transfer does not settle it: apply when the User asked for something the Agent could not resolve itself, even if the Agent then transferred them, since the transfer can ring out. Do NOT apply when the User only asked to be connected to a person and raised nothing else, when the Agent fully resolved the request itself, or when the call reached a voicemail system, busy signal, disconnected number, or any automated telecom message with no real human interaction."
}
}