{"id":11572,"date":"2026-06-30T13:23:10","date_gmt":"2026-06-30T13:23:10","guid":{"rendered":"https:\/\/support.spoki.com\/docs\/uncategorized\/agent-settings\/"},"modified":"2026-06-30T13:38:08","modified_gmt":"2026-06-30T13:38:08","password":"","slug":"agent-settings","status":"publish","type":"docs","link":"https:\/\/support.spoki.com\/en\/docs\/uncategorized\/agent-settings\/","title":{"rendered":"Agent settings"},"content":{"rendered":"\n<h3 class=\"wp-block-heading\"><strong>FIRST MESSAGE<\/strong><\/h3>\n\n\n\n<p>&#8220;Hello, this is [COMPANY NAME] customer support. How can I help you?&#8221;<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>SYSTEM PROMPT<\/strong><\/h3>\n\n\n\n<pre class=\"wp-block-preformatted\" style=\"font-size:16px\">**Role**<br><br>You are the voice assistant for the customer support service, on the phone with the caller. Your task is to collect the essential data and open a support ticket using the `tool-api-open-ticket` tool. You do not solve the problem during the call: you log it. Speak in the same language as the caller.<br><br>**Caller data**<br><br>* %%PHONE%% is the number the user is calling from.<br><br>**Call flow \u2013 ask for the following information one at a time**<br><br>1. First and last name: Ask the user for their first and last name.<br>2. Email: Ask the user for their email address and to spell it out.<br>3. Phone: Ask them to confirm that the contact number is %%PHONE%%.<br>4. Problem: Ask what their request is.<br>5. End of data collection: Summarize the name, email, and problem in one sentence and ask \"Would you like to add anything else before I log the request?\".<br>6. Open ticket: Call `tool-api-open-ticket` with:<br>\u00a0 \u00a0* title: a brief summary of the report.<br>\u00a0 \u00a0* description: the description of the problem along with the first and last name, email, and anything added by the caller.<br>\u00a0 \u00a0* priority: based on the urgency that emerged (Lowest, Low, Medium, High, Highest); use Medium if it is not clear.<br>7. Confirmation: after the tool's response, briefly inform them that the request has been logged. Ask the customer if you can help them with anything else.<br><br>**Tools**<br><br>* `tool-api-open-ticket`: opens the support ticket on Spoki once the data has been collected. The phone contact is already linked to the ticket; you provide the title, description, and priority.<br>* `get_current_datetime`: gives you the current date and time; you only need it for the closing greeting.<br><br>**Limits**<br><br>* Do not make up solutions, prices, policies, or response times. If the caller asks for something you cannot give them, explain that the request will be handled via the ticket.<br>* Regarding timing, only say that the request will be handled by the first available operator.<br><br>**Voice style**<br><br>You are professional and concise, with short, natural sentences.<\/pre>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>Tools<\/strong><\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li>tool-api-open-ticket: opens the support ticket on Spoki once the data has been collected. The phone contact is already linked to the ticket; you provide the title, description, and priority.<\/li>\n\n\n\n<li>get_current_datetime: gives you the current date and time; you only need it for the closing greeting.<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>Limits<\/strong><\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Do not make up solutions, prices, policies, or response times. If the caller asks for something you cannot give them, explain that the request will be handled via the ticket.<\/li>\n\n\n\n<li>Regarding timing, only say that the request will be handled by the first available operator.<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>Voice style<\/strong><\/h4>\n\n\n\n<p>You are professional and concise, with short, natural sentences.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>SUCCESS CRITERIA<\/strong><\/h3>\n\n\n\n<p>The call is successful when:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>The first and last name, an email in a plausible format, and a useful description of the problem have been collected.<\/li>\n\n\n\n<li>The phone contact has been confirmed (%%PHONE%%).<\/li>\n\n\n\n<li>The tool-api-open-ticket tool has been called with title, description, and priority, and has returned confirmation that the ticket was opened.<\/li>\n\n\n\n<li>The caller has received a brief confirmation that the request has been logged, and the call closes with a greeting based on the time of day.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Tool settings<\/strong><\/h2>\n\n\n\n<p>The goal of the agent&#8217;s tool is to create a ticket on Spoki via API. Below are the various agent settings. Except for the authentication key (to be activated from the Integrations &gt; API section).<\/p>\n\n\n\n<p>IMPORTANT: the Spoki API is case sensitive, so failing to respect lowercase or uppercase letters in the names of the parameters and\/or the values passed (for example in the priority) can cause errors. The voice agent is natively able to understand when the tool has been called, but if the API responds with an error that does not result in the creation of the ticket, the agent will say that the ticket was opened anyway.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Basic Configuration<\/strong><\/h2>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>Tool Information<\/strong><\/h4>\n\n\n\n<p><strong>Name:<\/strong> tool-api-open-ticket<\/p>\n\n\n\n<p><strong>Description:<\/strong> Creates a support ticket on Spoki account via API call<\/p>\n\n\n\n<p><strong>Webhook Configuration<\/strong><\/p>\n\n\n\n<p><strong>HTTP Method:<\/strong> POST<\/p>\n\n\n\n<p><strong>Webhook URL:<\/strong><a href=\"https:\/\/api.spoki.com\/api\/1\/tickets\/\"> https:\/\/api.spoki.com\/api\/1\/tickets\/<\/a><\/p>\n\n\n\n<p><strong>Advanced settings:<\/strong> leave the default value<\/p>\n\n\n\n<p><strong>Request configuration<\/strong><\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Headers<\/strong><\/h3>\n\n\n\n<p><strong>HTTP Headers<\/strong><\/p>\n\n\n\n<p>{<\/p>\n\n\n\n<p>&#8220;Content-Type&#8221;: &#8220;application\/json&#8221;,<\/p>\n\n\n\n<p>&#8220;X-Spoki-Api-Key&#8221;: &#8220;&lt;SPOKI_API_KEY&gt;<\/p>\n\n\n\n<p>}<\/p>\n\n\n\n<p><strong>Query Parameters:<\/strong> leave everything blank<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Body<\/strong><\/h3>\n\n\n\n<p><strong>Parameter 1:<\/strong><\/p>\n\n\n\n<p><strong>Type:<\/strong> String<\/p>\n\n\n\n<p><strong>Name:<\/strong> title<\/p>\n\n\n\n<p><strong>Required:<\/strong> yes<\/p>\n\n\n\n<p><strong>Handler:<\/strong> LLM<\/p>\n\n\n\n<p><strong>Description:<\/strong> title of the ticket<\/p>\n\n\n\n<p><strong>Parameter 2:<\/strong><\/p>\n\n\n\n<p><strong>Type:<\/strong> String<\/p>\n\n\n\n<p><strong>Name:<\/strong> description<\/p>\n\n\n\n<p><strong>Required:<\/strong> yes<\/p>\n\n\n\n<p><strong>Handler:<\/strong> LLM<\/p>\n\n\n\n<p><strong>Description:<\/strong> detailed description of the ticket<\/p>\n\n\n\n<p><strong>Parameter 3:<\/strong><\/p>\n\n\n\n<p><strong>Type:<\/strong> String<\/p>\n\n\n\n<p><strong>Name:<\/strong> status<\/p>\n\n\n\n<p><strong>Required:<\/strong> yes<\/p>\n\n\n\n<p><strong>Handler:<\/strong> Static<\/p>\n\n\n\n<p><strong>Value:<\/strong> Open<\/p>\n\n\n\n<p><strong>Description:<\/strong> (you can leave this blank)<\/p>\n\n\n\n<p><strong>Parameter 4:<\/strong><\/p>\n\n\n\n<p><strong>Type:<\/strong> String<\/p>\n\n\n\n<p><strong>Name:<\/strong> priority<\/p>\n\n\n\n<p><strong>Required:<\/strong> Yes<\/p>\n\n\n\n<p><strong>Handler:<\/strong> LLM<\/p>\n\n\n\n<p><strong>Description:<\/strong> The priority of the support ticket, based on the urgency reported by the caller. Must be one of the exact values accepted by the API: Lowest, Low, Medium, High, Highest. Use Medium as the default when the caller does not indicate a clear urgency.<\/p>\n\n\n\n<p><strong>Parameter 5:<\/strong><\/p>\n\n\n\n<p><strong>Type:<\/strong> String<\/p>\n\n\n\n<p><strong>Name:<\/strong> contact_phone<\/p>\n\n\n\n<p><strong>Required:<\/strong> yes<\/p>\n\n\n\n<p><strong>Handler:<\/strong> Dynamic field (select PHONE among the selectable dynamic fields to pass the user\u2019s phone data to the tool)<\/p>\n\n\n\n<p><strong>Description:<\/strong> user\u2019s phone number<\/p>\n","protected":false},"excerpt":{"rendered":"<p>FIRST MESSAGE &#8220;Hello, this is [COMPANY NAME] customer support. How can I help you?&#8221; SYSTEM PROMPT **Role**You are the voice [&hellip;]<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"doc_category":[],"doc_tag":[],"class_list":["post-11572","docs","type-docs","status-publish","hentry"],"year_month":"2026-07","word_count":831,"total_views":0,"reactions":{"happy":0,"normal":0,"sad":0},"author_info":{"name":"Daniela Pascale","author_nicename":"danielapascale","author_url":"https:\/\/support.spoki.com\/en\/author\/danielapascale\/"},"doc_category_info":[],"doc_tag_info":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v26.7 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Agent settings - Supporto Spoki<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/support.spoki.com\/en\/docs\/uncategorized\/agent-settings\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Agent settings - Supporto Spoki\" \/>\n<meta property=\"og:description\" content=\"FIRST MESSAGE &#8220;Hello, this is [COMPANY NAME] customer support. How can I help you?&#8221; SYSTEM PROMPT **Role**You are the voice [&hellip;]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/support.spoki.com\/en\/docs\/uncategorized\/agent-settings\/\" \/>\n<meta property=\"og:site_name\" content=\"Supporto Spoki\" \/>\n<meta property=\"article:modified_time\" content=\"2026-06-30T13:38:08+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/support.spoki.com\/en\/docs\/uncategorized\/agent-settings\/\",\"url\":\"https:\/\/support.spoki.com\/en\/docs\/uncategorized\/agent-settings\/\",\"name\":\"Agent settings - Supporto Spoki\",\"isPartOf\":{\"@id\":\"https:\/\/support.spoki.com\/#website\"},\"datePublished\":\"2026-06-30T13:23:10+00:00\",\"dateModified\":\"2026-06-30T13:38:08+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/support.spoki.com\/en\/docs\/uncategorized\/agent-settings\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/support.spoki.com\/en\/docs\/uncategorized\/agent-settings\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/support.spoki.com\/en\/docs\/uncategorized\/agent-settings\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/support.spoki.com\/en\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Docs\",\"item\":\"https:\/\/support.spoki.com\/docs\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Agent settings\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/support.spoki.com\/#website\",\"url\":\"https:\/\/support.spoki.com\/\",\"name\":\"Supporto Spoki\",\"description\":\"Documentation for Spoki use\",\"publisher\":{\"@id\":\"https:\/\/support.spoki.com\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/support.spoki.com\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/support.spoki.com\/#organization\",\"name\":\"Supporto Spoki\",\"url\":\"https:\/\/support.spoki.com\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/support.spoki.com\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/support.spoki.com\/wp-content\/uploads\/2022\/11\/Logo_Spoki-Primary_Black-01-scaled.jpg\",\"contentUrl\":\"https:\/\/support.spoki.com\/wp-content\/uploads\/2022\/11\/Logo_Spoki-Primary_Black-01-scaled.jpg\",\"width\":2560,\"height\":761,\"caption\":\"Supporto Spoki\"},\"image\":{\"@id\":\"https:\/\/support.spoki.com\/#\/schema\/logo\/image\/\"},\"sameAs\":[\"https:\/\/www.linkedin.com\/company\/spokiapp\/\"]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Agent settings - Supporto Spoki","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/support.spoki.com\/en\/docs\/uncategorized\/agent-settings\/","og_locale":"en_US","og_type":"article","og_title":"Agent settings - Supporto Spoki","og_description":"FIRST MESSAGE &#8220;Hello, this is [COMPANY NAME] customer support. How can I help you?&#8221; SYSTEM PROMPT **Role**You are the voice [&hellip;]","og_url":"https:\/\/support.spoki.com\/en\/docs\/uncategorized\/agent-settings\/","og_site_name":"Supporto Spoki","article_modified_time":"2026-06-30T13:38:08+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/support.spoki.com\/en\/docs\/uncategorized\/agent-settings\/","url":"https:\/\/support.spoki.com\/en\/docs\/uncategorized\/agent-settings\/","name":"Agent settings - Supporto Spoki","isPartOf":{"@id":"https:\/\/support.spoki.com\/#website"},"datePublished":"2026-06-30T13:23:10+00:00","dateModified":"2026-06-30T13:38:08+00:00","breadcrumb":{"@id":"https:\/\/support.spoki.com\/en\/docs\/uncategorized\/agent-settings\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/support.spoki.com\/en\/docs\/uncategorized\/agent-settings\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/support.spoki.com\/en\/docs\/uncategorized\/agent-settings\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/support.spoki.com\/en\/"},{"@type":"ListItem","position":2,"name":"Docs","item":"https:\/\/support.spoki.com\/docs\/"},{"@type":"ListItem","position":3,"name":"Agent settings"}]},{"@type":"WebSite","@id":"https:\/\/support.spoki.com\/#website","url":"https:\/\/support.spoki.com\/","name":"Supporto Spoki","description":"Documentation for Spoki use","publisher":{"@id":"https:\/\/support.spoki.com\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/support.spoki.com\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/support.spoki.com\/#organization","name":"Supporto Spoki","url":"https:\/\/support.spoki.com\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/support.spoki.com\/#\/schema\/logo\/image\/","url":"https:\/\/support.spoki.com\/wp-content\/uploads\/2022\/11\/Logo_Spoki-Primary_Black-01-scaled.jpg","contentUrl":"https:\/\/support.spoki.com\/wp-content\/uploads\/2022\/11\/Logo_Spoki-Primary_Black-01-scaled.jpg","width":2560,"height":761,"caption":"Supporto Spoki"},"image":{"@id":"https:\/\/support.spoki.com\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.linkedin.com\/company\/spokiapp\/"]}]}},"spoki_translations":{"trid":5398,"translations":{"it":{"id":11565,"url":"https:\/\/support.spoki.com\/docs\/uncategorized\/agent-settings\/","status":"publish","original":true},"en":{"id":11572,"url":"https:\/\/support.spoki.com\/en\/docs\/uncategorized\/agent-settings\/","status":"publish","original":false},"es":{"id":11573,"url":"https:\/\/support.spoki.com\/es\/docs\/uncategorized\/agent-settings\/","status":"publish","original":false}}},"_links":{"self":[{"href":"https:\/\/support.spoki.com\/en\/wp-json\/wp\/v2\/docs\/11572","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/support.spoki.com\/en\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/support.spoki.com\/en\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/support.spoki.com\/en\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/support.spoki.com\/en\/wp-json\/wp\/v2\/comments?post=11572"}],"version-history":[{"count":1,"href":"https:\/\/support.spoki.com\/en\/wp-json\/wp\/v2\/docs\/11572\/revisions"}],"predecessor-version":[{"id":11574,"href":"https:\/\/support.spoki.com\/en\/wp-json\/wp\/v2\/docs\/11572\/revisions\/11574"}],"wp:attachment":[{"href":"https:\/\/support.spoki.com\/en\/wp-json\/wp\/v2\/media?parent=11572"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/support.spoki.com\/en\/wp-json\/wp\/v2\/doc_category?post=11572"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/support.spoki.com\/en\/wp-json\/wp\/v2\/doc_tag?post=11572"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}