21.07.2012 Views

Service Specifications Developer Garden Telekom Tropo API.

Service Specifications Developer Garden Telekom Tropo API.

Service Specifications Developer Garden Telekom Tropo API.

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

<strong>Service</strong> <strong>Specifications</strong><br />

<strong>Developer</strong> <strong>Garden</strong> <strong>Telekom</strong> <strong>Tropo</strong> <strong>API</strong>.<br />

1 General Provisions<br />

Deutsche <strong>Telekom</strong> AG (hereinafter referred to as Deutsche <strong>Telekom</strong>)<br />

operates an online developer portal for the customer under the name<br />

<strong>Developer</strong> <strong>Garden</strong>(www.developergarden.com)<br />

Subject to technical and operational feasibility, Deutsche <strong>Telekom</strong><br />

shall provide the customer with <strong>Developer</strong> <strong>Garden</strong> <strong>Telekom</strong> <strong>Tropo</strong> <strong>API</strong><br />

(hereinafter referred to as <strong>Telekom</strong> <strong>Tropo</strong>)<br />

<strong>Telekom</strong> <strong>Tropo</strong> enables customers to develop their own IVR<br />

(intelligent voice recognition) or voice dialog software applications<br />

and open them up to end users.<br />

The customer needs to register in the <strong>Developer</strong> Center to use Topo.<br />

2 Scope of services provided by Deutsche <strong>Telekom</strong><br />

<strong>Telekom</strong> <strong>Tropo</strong> is a web service interface made available by Deutsche<br />

<strong>Telekom</strong> to customers for use in developing their own IVR software<br />

applications to execute voice-activated self-services for subscribers in<br />

international fixed and mobile communication networks. The<br />

customer must have sufficient credit on his account in order to use<br />

<strong>Telekom</strong> <strong>Tropo</strong>. All calls shall be ended automatically as soon as the<br />

customer's credit has been used up.<br />

<strong>Telekom</strong> <strong>Tropo</strong> does not support calls to special numbers and<br />

emergency numbers.<br />

2.1 <strong>Telekom</strong> <strong>Tropo</strong> functions<br />

2.1.1 Managing <strong>Telekom</strong> <strong>Tropo</strong> applications<br />

Customers manage their <strong>Telekom</strong> <strong>Tropo</strong> applications via the<br />

<strong>Developer</strong> Center. <strong>Developer</strong> Center can be used to register new<br />

applications by entering the relevant metadata, to delete existing<br />

applications, and to move applications between the Sandbox and<br />

production environment.<br />

The customer shall operate his <strong>Telekom</strong> <strong>Tropo</strong> applications from his<br />

own server. Each application operated by the customer using<br />

<strong>Telekom</strong> <strong>Tropo</strong> must be accessible via a unique URL, which must be<br />

registered in the <strong>Developer</strong> Center.<br />

2.1.2 SIP address<br />

Upon registration each application is automatically assigned a SIP<br />

address by <strong>Telekom</strong> <strong>Tropo</strong>; this information can be found on the<br />

relevant <strong>Developer</strong> Center pages. Customers enter the assigned SIP<br />

address into a standard SIP client to establish voice connections with<br />

their <strong>Telekom</strong> <strong>Tropo</strong> applications.<br />

2.1.3 DID/Call number administration<br />

In order to access a <strong>Telekom</strong> <strong>Tropo</strong> application from public telephone<br />

networks, the application must be assigned a DID (direct inward<br />

dial)/call number. In addition to German call numbers, customers can<br />

also assign international call numbers to their application. Customers<br />

can order call numbers in the <strong>Developer</strong> Center.<br />

Depending on the country, the ordering and assignment of call<br />

numbers is subject to varying legitimation steps, which are explained<br />

to the customer during the ordering process.<br />

Call numbers can only be assigned to one application; however,<br />

several call numbers can be set up per application (for example to<br />

make an application available from different countries using national<br />

call numbers in each country). A call number assigned to a certain<br />

application of the customer may be reassigned to another.<br />

2.1.4 Incoming voice calls<br />

<strong>Telekom</strong> <strong>Tropo</strong> applications can be called from the German and<br />

international fixed and mobile communications network either via the<br />

SIP address provided or via call numbers that can be ordered<br />

separately as an add-on option.<br />

<strong>Telekom</strong> <strong>Tropo</strong> is capable of answering several incoming calls in<br />

parallel per application (SIP address/call number). Deutsche <strong>Telekom</strong><br />

constantly monitors traffic volume on the <strong>Telekom</strong> <strong>Tropo</strong> platform<br />

and, if necessary, shall expand the platform to ensure sufficient<br />

capacity is available to customers.<br />

2.1.5 Outgoing voice calls<br />

Customers can make outgoing voice calls from their <strong>Telekom</strong> <strong>Tropo</strong><br />

applications to the German and international fixed and mobile<br />

communications network, for example, to call back a subscriber or to<br />

transfer an incoming call. Outgoing voice calls can be used to<br />

Deutsche <strong>Telekom</strong> AG, last revision: Jul. 3, 2012<br />

This translation is not the authentic text. The German version shall be part of the agreement.<br />

1<br />

connect several subscribers for a conference call.<br />

2.1.6 Managing dialog in <strong>Telekom</strong> <strong>Tropo</strong> applications<br />

<strong>Telekom</strong> <strong>Tropo</strong> offers customers several ways of managing dialog in<br />

their applications. This includes, for example, "say" to play back a<br />

recorded voice message to a subscriber, or "ask" to request a<br />

subscriber to make a selection using the touch-tone function (DTMF).<br />

A full list of all supported methods can be found in the developer<br />

documentation.<br />

2.1.7 Synthesized speech creation and automatic voice recognition<br />

<strong>Telekom</strong> <strong>Tropo</strong> offers customers the option of generating synthesized<br />

voice announcements with personalized wording (text-to-speech). The<br />

customer can choose between a male and a female voice.<br />

In addition to the DTMF input function, <strong>Telekom</strong> <strong>Tropo</strong> also offers<br />

customers the option of using automated speech recognition (ASR) to<br />

accept voice commands from subscribers. The voice recognition<br />

function is suitable for recognizing individual words or commands<br />

predefined by the customer.<br />

A list of all languages supported by <strong>Telekom</strong> <strong>Tropo</strong> for text-to-speech<br />

and ASR can be found in the developer documentation.<br />

2.1.8 SMS<br />

Customers can send SMSs from their <strong>Telekom</strong> <strong>Tropo</strong> applications to<br />

the German and international mobile communications networks.<br />

2.1.9 <strong>Telekom</strong> <strong>Tropo</strong> Sandbox testing environment<br />

Deutsche <strong>Telekom</strong> gives its customers the opportunity to test the<br />

applications they have developed before going live using the provided<br />

testing environment called <strong>Telekom</strong> <strong>Tropo</strong> Sandbox.<br />

Use of the <strong>Telekom</strong> <strong>Tropo</strong> Sandbox is free of charge and for testing<br />

purposes only. Customers can test incoming and outgoing voice calls<br />

using assigned call numbers. During testing, incoming voice calls to<br />

applications in the Sandbox shall be disconnected automatically after<br />

10 minutes and outgoing voice calls after one minute. Outgoing voice<br />

calls to international networks are subject to additional charges.<br />

The text messaging function can also be tested. The words "SMS <strong>API</strong><br />

by developergarden.com“ are added to SMSs sent in the Sandbox.<br />

The customer's original text (max. 129 characters) may be shortened<br />

to make room for this additional text. Customers may send a<br />

maximum of 10 text messages per day from the Sandbox; it is not<br />

possible to link several text messages.<br />

2.2 <strong>Telekom</strong> <strong>Tropo</strong> data interface<br />

The <strong>Telekom</strong> <strong>Tropo</strong> web service interface can be used to upload<br />

different parameters onto the customer's software application to<br />

control <strong>Telekom</strong> <strong>Tropo</strong> features. In addition, <strong>Telekom</strong> <strong>Tropo</strong> sends<br />

back different parameters and error codes to the customer's software<br />

application.<br />

2.3 Reporting and controlling<br />

The customer shall have access to online reports in <strong>Developer</strong> Center.<br />

2.4 Access<br />

Customer access to <strong>Telekom</strong> <strong>Tropo</strong> administration and for testing<br />

software applications is provided online via the Internet.<br />

Each time a customer wants to access the <strong>Telekom</strong> <strong>Tropo</strong><br />

administration site, they will need to enter their access identification<br />

comprising a user ID and password.<br />

2.5 User manual<br />

Deutsche <strong>Telekom</strong> shall provide the customer with a user manual as<br />

an electronic file. This user manual shall contain all pertinent<br />

information.<br />

2.6 Support<br />

a) Online support<br />

Provision of an online support service in the form of a knowledge<br />

and problem database (FAQs, tips, etc.).<br />

b) E-mail support<br />

Deutsche <strong>Telekom</strong> provides the customer with free-of-charge<br />

support via e-mail using a contact form. This form can be used for<br />

general questions as well as technical questions about <strong>Telekom</strong><br />

<strong>Tropo</strong> features. This support service generally responds to<br />

customer inquiries within 24 hours on weekdays.<br />

The support service described under (b) shall only be available to<br />

customers, administrators and their representatives; other users shall


<strong>Service</strong> <strong>Specifications</strong>, <strong>Developer</strong> <strong>Garden</strong> <strong>Telekom</strong> <strong>Tropo</strong> <strong>API</strong>.<br />

not be entitled to receive support.<br />

2.7 Operation of the server and system components<br />

All servers and system components needed to operate <strong>Telekom</strong><br />

<strong>Tropo</strong> shall be operated in a technically and organizationally secure<br />

high-performance computer network that is protected against attacks<br />

and unauthorized access from the Internet by a firewall system. The<br />

basic services (such as network, firewall, backbone, hardware) for<br />

operating <strong>Telekom</strong> <strong>Tropo</strong> shall be available with an annual average<br />

availability of 99.5 %.<br />

The features for operation and system management of this network<br />

include:<br />

– Operating hours: 24 hours a day, seven days a week.<br />

Deutsche <strong>Telekom</strong> AG, last revision: Jul. 3, 2012<br />

This translation is not the authentic text. The German version shall be part of the agreement.<br />

2<br />

– Acceptance of fault reports 24 hours a day, seven days a week<br />

2.8 Maintenance window<br />

<strong>Telekom</strong> <strong>Tropo</strong> service performance may occasionally be limited for<br />

maintenance purposes, in particular for changes and updates to<br />

server configuration (maintenance window).<br />

At Deutsche <strong>Telekom</strong>, maintenance windows are typically scheduled<br />

for Tuesdays through Thursdays from 1.00 a.m. to 6.00 a.m.<br />

Maintenance window periods are not included in the calculation of<br />

availability.

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!