{"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":"2025-08-22T15:09:22","modified_gmt":"2025-08-22T22:09:22","slug":"tv-placecall","status":"publish","type":"page","link":"https:\/\/www.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-operations\/tv-placecall\/","title":{"rendered":"TV &#8211; PlaceCall &#8211; Deprecated"},"content":{"rendered":"<nav aria-label=\"Table of contents\">\n<ul class=\"is-style-bullets-list\">\n<li><a href=\"#TV-PlaceCall-Recommended-URLEndpoints\">URL Endpoints<\/a><\/li>\n<li><a href=\"#TV-PlaceCall-Recommended-PlaceCallInputs\">PlaceCall Inputs<\/a><\/li>\n<li><a href=\"#TV-PlaceCall-Recommended-PlaceCallOutputs\">PlaceCall Outputs<\/a><\/li>\n<\/ul>\n<\/nav>\n<p>&nbsp;<\/p>\n<article aria-label=\"Description of the PlaceCall operation\">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.<\/article>\n<p>&nbsp;<\/p>\n<section aria-labelledby=\"TV-PlaceCall-Recommended-URLEndpoints\">\n<h1 id=\"TV-PlaceCall-Recommended-URLEndpoints\" class=\"wp-block-heading\">\nURL Endpoint<\/h1>\n<p>&nbsp;<\/p>\n<ul class=\"is-style-no-bullets-indented-list\">\n<li><strong>XML:<\/strong>\n<ul class=\"is-style-no-bullets-indented-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<\/section>\n<section aria-labelledby=\"TV-PlaceCall-Recommended-PlaceCallInputs\">\n<h1 id=\"TV-PlaceCall-Recommended-PlaceCallInputs\" class=\"wp-block-heading\">PlaceCall Inputs<\/h1>\n<figure class=\"wp-block-table is-style-table-section\">\n<table>\n<thead>\n<tr>\n<th>Name<\/th>\n<th>Type<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>CountryCode<\/td>\n<td>String<\/td>\n<td>CountryCode string CountryCode for the destination phone number. Name of business associated with this address. Used to append Suite data.<\/td>\n<\/tr>\n<tr>\n<td>PhoneNumber<\/td>\n<td>String<\/td>\n<td>PhoneNumber to be verified.<\/td>\n<\/tr>\n<tr>\n<td>Extension<\/td>\n<td>String (optional)<\/td>\n<td>Extension to be dialed after initial pickup.<\/td>\n<\/tr>\n<tr>\n<td>ExtensionPauseTime<\/td>\n<td>String (optional)<\/td>\n<td>Seconds to wait before dialing the Extension.<\/td>\n<\/tr>\n<tr>\n<td>VerificationCode<\/td>\n<td>String (optional)<\/td>\n<td>Code that will be read aloud to the end use.<\/td>\n<\/tr>\n<tr>\n<td>CallerID<\/td>\n<td>String<\/td>\n<td>Caller ID that will display to the end user. This field only excepts numeric characters.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<div class=\"wp-block-group is-style-card-note\">\n<article aria-label=\"Important notes about PlaceCall inputs\"><strong>Important Notes!<\/strong><\/p>\n<ul>\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<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<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<li>The CallerID field must be a valid contact phone number for your organization.<\/li>\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<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<\/article>\n<\/div>\n<\/section>\n<section aria-labelledby=\"TV-PlaceCall-Recommended-PlaceCallOutputs\">\n<h1 id=\"TV-PlaceCall-Recommended-PlaceCallOutputs\" class=\"wp-block-heading\">PlaceCall Outputs<\/h1>\n<figure class=\"wp-block-table is-style-table-section\">\n<table>\n<thead>\n<tr>\n<th>Name<\/th>\n<th>Type<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Description<\/td>\n<td>string<\/td>\n<td>A brief description of the CountryCode + PhoneNumber prefix<\/td>\n<\/tr>\n<tr>\n<td>TokensUsed<\/td>\n<td>int<\/td>\n<td>Number of tokens consumed in this request (see Appendix B)<\/td>\n<\/tr>\n<tr>\n<td>VerificationCode<\/td>\n<td>string<\/td>\n<td>The code read aloud to the user.<\/td>\n<\/tr>\n<tr>\n<td>TransactionID<\/td>\n<td>string<\/td>\n<td>Unique identifier for this request<\/td>\n<\/tr>\n<tr>\n<td>Debug<\/td>\n<td>string<\/td>\n<td>Utility field; safe to ignore.<\/td>\n<\/tr>\n<tr>\n<td>Error<\/td>\n<td><a href=\"\/docs\/dots-telephone-verification-tv\/tv-errors\" target=\"_blank\" rel=\"noreferrer noopener\">Error<\/a><\/td>\n<td>See Errors<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<div class=\"wp-block-group is-style-card-note\">\n<article aria-label=\"Important note about PlaceCall outputs\"><strong>Important Note<\/strong>!<\/p>\n<article aria-label=\"Explanation of verification code in outputs\">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.<\/article>\n<\/article>\n<\/div>\n<\/section>\n","protected":false},"excerpt":{"rendered":"<p>URL Endpoints PlaceCall Inputs PlaceCall Outputs &nbsp; 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. &nbsp; URL Endpoint &nbsp; XML: 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} PlaceCall Inputs Name Type Description CountryCode String CountryCode string [&hellip;]<\/p>\n","protected":false},"author":22,"featured_media":0,"parent":9751,"menu_order":0,"comment_status":"closed","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 v26.2 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>TV - PlaceCall - Deprecated<\/title>\n<meta name=\"description\" content=\"URL Endpoints PlaceCall Inputs PlaceCall Outputs &nbsp; The PlaceCall operation dials the phone number and reads a verification code aloud. Applications\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-operations\/tv-placecall\/\" \/>\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 &nbsp; The PlaceCall operation dials the phone number and reads a verification code aloud. Applications\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.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=\"2025-08-22T22:09:22+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:\/\/www.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-operations\/tv-placecall\/\",\"url\":\"https:\/\/www.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-operations\/tv-placecall\/\",\"name\":\"TV - PlaceCall - Deprecated\",\"isPartOf\":{\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/#website\"},\"datePublished\":\"2023-08-09T20:19:35+00:00\",\"dateModified\":\"2025-08-22T22:09:22+00:00\",\"description\":\"URL Endpoints PlaceCall Inputs PlaceCall Outputs &nbsp; The PlaceCall operation dials the phone number and reads a verification code aloud. Applications\",\"breadcrumb\":{\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-operations\/tv-placecall\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-operations\/tv-placecall\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-operations\/tv-placecall\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.serviceobjects.com\/docs\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"DOTS Telephone Verification\",\"item\":\"https:\/\/www.serviceobjects.com\/docs\/dots-telephone-verification-tv\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"TV &#8211; Operations\",\"item\":\"https:\/\/www.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-operations\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"TV &#8211; PlaceCall &#8211; Deprecated\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/#website\",\"url\":\"https:\/\/www.serviceobjects.com\/docs\/\",\"name\":\"Service Objects | Contact, Phone, Email Verification | Data Quality Services\",\"description\":\"\",\"publisher\":{\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.serviceobjects.com\/docs\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/#organization\",\"name\":\"Service Objects | Contact, Phone, Email Verification | Data Quality Services\",\"url\":\"https:\/\/www.serviceobjects.com\/docs\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/www.serviceobjects.com\/docs\/wp-content\/uploads\/2022\/08\/SO-logo-2560px-transparent.png\",\"contentUrl\":\"https:\/\/www.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:\/\/www.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 &nbsp; The PlaceCall operation dials the phone number and reads a verification code aloud. Applications","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:\/\/www.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-operations\/tv-placecall\/","og_locale":"en_US","og_type":"article","og_title":"TV - PlaceCall - Deprecated","og_description":"URL Endpoints PlaceCall Inputs PlaceCall Outputs &nbsp; The PlaceCall operation dials the phone number and reads a verification code aloud. Applications","og_url":"https:\/\/www.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":"2025-08-22T22:09:22+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-operations\/tv-placecall\/","url":"https:\/\/www.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-operations\/tv-placecall\/","name":"TV - PlaceCall - Deprecated","isPartOf":{"@id":"https:\/\/www.serviceobjects.com\/docs\/#website"},"datePublished":"2023-08-09T20:19:35+00:00","dateModified":"2025-08-22T22:09:22+00:00","description":"URL Endpoints PlaceCall Inputs PlaceCall Outputs &nbsp; The PlaceCall operation dials the phone number and reads a verification code aloud. Applications","breadcrumb":{"@id":"https:\/\/www.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-operations\/tv-placecall\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-operations\/tv-placecall\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-operations\/tv-placecall\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.serviceobjects.com\/docs\/"},{"@type":"ListItem","position":2,"name":"DOTS Telephone Verification","item":"https:\/\/www.serviceobjects.com\/docs\/dots-telephone-verification-tv\/"},{"@type":"ListItem","position":3,"name":"TV &#8211; Operations","item":"https:\/\/www.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-operations\/"},{"@type":"ListItem","position":4,"name":"TV &#8211; PlaceCall &#8211; Deprecated"}]},{"@type":"WebSite","@id":"https:\/\/www.serviceobjects.com\/docs\/#website","url":"https:\/\/www.serviceobjects.com\/docs\/","name":"Service Objects | Contact, Phone, Email Verification | Data Quality Services","description":"","publisher":{"@id":"https:\/\/www.serviceobjects.com\/docs\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.serviceobjects.com\/docs\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/www.serviceobjects.com\/docs\/#organization","name":"Service Objects | Contact, Phone, Email Verification | Data Quality Services","url":"https:\/\/www.serviceobjects.com\/docs\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.serviceobjects.com\/docs\/#\/schema\/logo\/image\/","url":"https:\/\/www.serviceobjects.com\/docs\/wp-content\/uploads\/2022\/08\/SO-logo-2560px-transparent.png","contentUrl":"https:\/\/www.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:\/\/www.serviceobjects.com\/docs\/#\/schema\/logo\/image\/"}}]}},"_links":{"self":[{"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/9763","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/users\/22"}],"replies":[{"embeddable":true,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/comments?post=9763"}],"version-history":[{"count":22,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/9763\/revisions"}],"predecessor-version":[{"id":11970,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/9763\/revisions\/11970"}],"up":[{"embeddable":true,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/9751"}],"wp:attachment":[{"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/media?parent=9763"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}