{"id":9763,"date":"2023-08-09T13:19:35","date_gmt":"2023-08-09T20:19:35","guid":{"rendered":"https:\/\/www.serviceobjects.com\/docs\/?page_id=9763"},"modified":"2023-08-11T07:03:54","modified_gmt":"2023-08-11T14:03:54","slug":"tv-placecall","status":"publish","type":"page","link":"https:\/\/test.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-operations\/tv-placecall\/","title":{"rendered":"TV &#8211; PlaceCall &#8211; Deprecated"},"content":{"rendered":"\n<ul class=\"is-style-bullets-list wp-block-list\">\n<li><a href=\"#TV-PlaceCall-Recommended-URLEndpoints\">URL Endpoints<\/a><\/li>\n\n\n\n<li><a href=\"#TV-PlaceCall-Recommended-PlaceCallInputs\">PlaceCall Inputs<\/a><\/li>\n\n\n\n<li><a href=\"#TV-PlaceCall-Recommended-PlaceCallOutputs\">PlaceCall Outputs<\/a><\/li>\n<\/ul>\n\n\n\n<p>The PlaceCall operation dials the phone number and reads a verification code aloud. Applications should require an end user to input the same code to verify he is accessible via this phone number.<\/p>\n\n\n\n<div style=\"height:30px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h1 class=\"wp-block-heading\" id=\"TV-PlaceCall-Recommended-URLEndpoints\">URL Endpoints<\/h1>\n\n\n\n<ul class=\"is-style-no-bullets-indented-list wp-block-list\">\n<li><strong>XML<\/strong>\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/trial.serviceobjects.com\/tv\/TelephoneVerification.asmx\/PlaceCall?CountryCode={COUNTRYCODE}&amp;PhoneNumber={PHONENUMBER}&amp;Extension={EXTENSION}&amp;ExtensionPauseTime={EXTENSIONPAUSETIME}&amp;VerificationCode={VERIFICATIONCODE}&amp;CallerID={CALLERID}&amp;Language={LANGUAGE}&amp;LicenseKey={LICENSEKEY} \">https:\/\/trial.serviceobjects.com\/tv\/TelephoneVerification.asmx\/PlaceCall?CountryCode={COUNTRYCODE}&amp;PhoneNumber={PHONENUMBER}&amp;Extension={EXTENSION}&amp;ExtensionPauseTime={EXTENSIONPAUSETIME}&amp;VerificationCode={VERIFICATIONCODE}&amp;CallerID={CALLERID}&amp;Language={LANGUAGE}&amp;LicenseKey={LICENSEKEY} <\/a><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<h1 class=\"wp-block-heading\" id=\"TV-PlaceCall-Recommended-PlaceCallInputs\">PlaceCall Inputs<\/h1>\n\n\n\n<figure class=\"wp-block-table is-style-table-section\"><table><thead><tr><th>Name<\/th><th>Type<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>CountryCode<\/td><td>String<\/td><td>CountryCode string CountryCode for the destination phone number.  Name of business associated with this address. Used to append Suite data.<\/td><\/tr><tr><td>PhoneNumber<\/td><td>String<\/td><td>PhoneNumber to be verified.<\/td><\/tr><tr><td>Extension<\/td><td>String (optional)<\/td><td>Extension to be dialed after initial pickup.<\/td><\/tr><tr><td>ExtensionPauseTime<\/td><td>String (optional)<\/td><td>Seconds to wait before dialing the Extension.<\/td><\/tr><tr><td>VerificationCode<\/td><td>String (optional)<\/td><td>Code that will be read aloud to the end use.<\/td><\/tr><tr><td>CallerID<\/td><td>String<\/td><td>Caller ID that will display  to the end user.  This field only excepts numeric characters.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<div class=\"wp-block-group is-style-card-note is-layout-constrained wp-block-group-is-layout-constrained\">\n<p><strong>Important Notes!<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>As of May 1, 2010, the only CountryCode supported is 1 (USA and Canada). As more CountryCodes are supported, the cost for the PlaceCall operation may be determined by destination country or region.<\/li>\n\n\n\n<li>If the end user is at an extension, you may specify the extension and the amount of time to wait after the initial pick up to dial the extension digits. We recommend a value of 5 for ExtenionPauseTime (5 seconds).<\/li>\n\n\n\n<li>If the VerificationCode is not specified, TV will generate a random 3-digit code to read aloud and return this code in the output fields.<\/li>\n\n\n\n<li>The CallerID field must be a valid contact phone number for your organization.<\/li>\n\n\n\n<li>As of May 1, 2010, the only Language supported is &#8220;en&#8221; (English). In the future, other languages may be supported.<\/li>\n\n\n\n<li>VerificationCodes should be stored in server-side session variables or in a database&#8212;they should remain unknown to the enduser except through the phone line. For example, do not use a form variable to post the verification code from page to page.<\/li>\n<\/ul>\n<\/div>\n\n\n\n<h1 class=\"wp-block-heading\" id=\"TV-PlaceCall-Recommended-PlaceCallOutputs\">PlaceCall Outputs<\/h1>\n\n\n\n<figure class=\"wp-block-table is-style-table-section\"><table><thead><tr><th>Name<\/th><th>Type<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>Description<\/td><td>string<\/td><td>A brief description of the CountryCode + PhoneNumber prefix<\/td><\/tr><tr><td>TokensUsed<\/td><td>int<\/td><td>Number of tokens consumed in this request (see Appendix B)<\/td><\/tr><tr><td>VerificationCode<\/td><td>string<\/td><td>The code read aloud to the user.<\/td><\/tr><tr><td>TransactionID<\/td><td>string<\/td><td>Unique identifier for this request<\/td><\/tr><tr><td>Debug<\/td><td>string<\/td><td>Utility field; safe to ignore.<\/td><\/tr><tr><td>Error<\/td><td><a href=\"https:\/\/test.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-errors\/(opens in a new tab)\" target=\"_blank\" rel=\"noreferrer noopener\">Errr<\/a><\/td><td>See Errors<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<div class=\"wp-block-group is-style-card-note is-layout-constrained wp-block-group-is-layout-constrained\">\n<p><strong>Important Note<\/strong>!<\/p>\n\n\n\n<p>VerificationCode will return the code read aloud to the end user. If you did not specify this code in the input, a code will be randomly generated for you, and you will need this output value to verify the end user&#8217;s phone number.<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-group is-style-accordion-section is-layout-flow wp-block-group-is-layout-flow\">\n<div class=\"wp-block-group panel is-layout-flow wp-block-group-is-layout-flow\"><\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>The PlaceCall operation dials the phone number and reads a verification code aloud. Applications should require an end user to input the same code to verify he is accessible via this phone number. URL Endpoints PlaceCall Inputs Name Type Description CountryCode String CountryCode string CountryCode for the destination phone number. Name of business associated with [&hellip;]<\/p>\n","protected":false},"author":22,"featured_media":0,"parent":9751,"menu_order":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-9763","page","type-page","status-publish","hentry"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v24.7 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>TV - PlaceCall - Deprecated<\/title>\n<meta name=\"description\" content=\"URL Endpoints PlaceCall Inputs PlaceCall Outputs The PlaceCall operation dials the phone number and reads a verification code aloud. Applications should\" \/>\n<meta name=\"robots\" content=\"noindex, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"TV - PlaceCall - Deprecated\" \/>\n<meta property=\"og:description\" content=\"URL Endpoints PlaceCall Inputs PlaceCall Outputs The PlaceCall operation dials the phone number and reads a verification code aloud. Applications should\" \/>\n<meta property=\"og:url\" content=\"https:\/\/test.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-operations\/tv-placecall\/\" \/>\n<meta property=\"og:site_name\" content=\"Service Objects | Contact, Phone, Email Verification | Data Quality Services\" \/>\n<meta property=\"article:modified_time\" content=\"2023-08-11T14:03:54+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=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/test.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-operations\/tv-placecall\/\",\"url\":\"https:\/\/test.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-operations\/tv-placecall\/\",\"name\":\"TV - PlaceCall - Deprecated\",\"isPartOf\":{\"@id\":\"https:\/\/test.serviceobjects.com\/docs\/#website\"},\"datePublished\":\"2023-08-09T20:19:35+00:00\",\"dateModified\":\"2023-08-11T14:03:54+00:00\",\"description\":\"URL Endpoints PlaceCall Inputs PlaceCall Outputs The PlaceCall operation dials the phone number and reads a verification code aloud. Applications should\",\"breadcrumb\":{\"@id\":\"https:\/\/test.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-operations\/tv-placecall\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/test.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-operations\/tv-placecall\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/test.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-operations\/tv-placecall\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/test.serviceobjects.com\/docs\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"DOTS Telephone Verification\",\"item\":\"https:\/\/test.serviceobjects.com\/docs\/dots-telephone-verification-tv\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"TV &#8211; Operations\",\"item\":\"https:\/\/test.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-operations\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"TV &#8211; PlaceCall &#8211; Deprecated\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/test.serviceobjects.com\/docs\/#website\",\"url\":\"https:\/\/test.serviceobjects.com\/docs\/\",\"name\":\"Service Objects | Contact, Phone, Email Verification | Data Quality Services\",\"description\":\"\",\"publisher\":{\"@id\":\"https:\/\/test.serviceobjects.com\/docs\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/test.serviceobjects.com\/docs\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/test.serviceobjects.com\/docs\/#organization\",\"name\":\"Service Objects | Contact, Phone, Email Verification | Data Quality Services\",\"url\":\"https:\/\/test.serviceobjects.com\/docs\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/test.serviceobjects.com\/docs\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/test.serviceobjects.com\/docs\/wp-content\/uploads\/2022\/08\/SO-logo-2560px-transparent.png\",\"contentUrl\":\"https:\/\/test.serviceobjects.com\/docs\/wp-content\/uploads\/2022\/08\/SO-logo-2560px-transparent.png\",\"width\":2560,\"height\":1440,\"caption\":\"Service Objects | Contact, Phone, Email Verification | Data Quality Services\"},\"image\":{\"@id\":\"https:\/\/test.serviceobjects.com\/docs\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"TV - PlaceCall - Deprecated","description":"URL Endpoints PlaceCall Inputs PlaceCall Outputs The PlaceCall operation dials the phone number and reads a verification code aloud. Applications should","robots":{"index":"noindex","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"og_locale":"en_US","og_type":"article","og_title":"TV - PlaceCall - Deprecated","og_description":"URL Endpoints PlaceCall Inputs PlaceCall Outputs The PlaceCall operation dials the phone number and reads a verification code aloud. Applications should","og_url":"https:\/\/test.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-operations\/tv-placecall\/","og_site_name":"Service Objects | Contact, Phone, Email Verification | Data Quality Services","article_modified_time":"2023-08-11T14:03:54+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/test.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-operations\/tv-placecall\/","url":"https:\/\/test.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-operations\/tv-placecall\/","name":"TV - PlaceCall - Deprecated","isPartOf":{"@id":"https:\/\/test.serviceobjects.com\/docs\/#website"},"datePublished":"2023-08-09T20:19:35+00:00","dateModified":"2023-08-11T14:03:54+00:00","description":"URL Endpoints PlaceCall Inputs PlaceCall Outputs The PlaceCall operation dials the phone number and reads a verification code aloud. Applications should","breadcrumb":{"@id":"https:\/\/test.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-operations\/tv-placecall\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/test.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-operations\/tv-placecall\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/test.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-operations\/tv-placecall\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/test.serviceobjects.com\/docs\/"},{"@type":"ListItem","position":2,"name":"DOTS Telephone Verification","item":"https:\/\/test.serviceobjects.com\/docs\/dots-telephone-verification-tv\/"},{"@type":"ListItem","position":3,"name":"TV &#8211; Operations","item":"https:\/\/test.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-operations\/"},{"@type":"ListItem","position":4,"name":"TV &#8211; PlaceCall &#8211; Deprecated"}]},{"@type":"WebSite","@id":"https:\/\/test.serviceobjects.com\/docs\/#website","url":"https:\/\/test.serviceobjects.com\/docs\/","name":"Service Objects | Contact, Phone, Email Verification | Data Quality Services","description":"","publisher":{"@id":"https:\/\/test.serviceobjects.com\/docs\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/test.serviceobjects.com\/docs\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/test.serviceobjects.com\/docs\/#organization","name":"Service Objects | Contact, Phone, Email Verification | Data Quality Services","url":"https:\/\/test.serviceobjects.com\/docs\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/test.serviceobjects.com\/docs\/#\/schema\/logo\/image\/","url":"https:\/\/test.serviceobjects.com\/docs\/wp-content\/uploads\/2022\/08\/SO-logo-2560px-transparent.png","contentUrl":"https:\/\/test.serviceobjects.com\/docs\/wp-content\/uploads\/2022\/08\/SO-logo-2560px-transparent.png","width":2560,"height":1440,"caption":"Service Objects | Contact, Phone, Email Verification | Data Quality Services"},"image":{"@id":"https:\/\/test.serviceobjects.com\/docs\/#\/schema\/logo\/image\/"}}]}},"_links":{"self":[{"href":"https:\/\/test.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/9763","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/test.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/test.serviceobjects.com\/docs\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/test.serviceobjects.com\/docs\/wp-json\/wp\/v2\/users\/22"}],"replies":[{"embeddable":true,"href":"https:\/\/test.serviceobjects.com\/docs\/wp-json\/wp\/v2\/comments?post=9763"}],"version-history":[{"count":14,"href":"https:\/\/test.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/9763\/revisions"}],"predecessor-version":[{"id":9865,"href":"https:\/\/test.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/9763\/revisions\/9865"}],"up":[{"embeddable":true,"href":"https:\/\/test.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/9751"}],"wp:attachment":[{"href":"https:\/\/test.serviceobjects.com\/docs\/wp-json\/wp\/v2\/media?parent=9763"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}