InboundXML Documentation

View REST Docs


InboundXML describes how TelAPI should deal with a call or SMS message. A InboundXML document is made up of various XML elements nested in the response element. Every phone number registered with TelAPI points to a URL containing one of these InboundXML documents.

Upon receiving a call or SMS, TelAPI follows the InboundXML instructions, enabling developers to easily build telephony apps with all the same function and power found in traditional phone systems.

When a call or sms is initiated using the REST API, the URL of a InboundXML document is passed as a parameter to describe what will happen when the contacted party answers.

Implementing InboundXML

Using InboundXML is easy. Simply host a file containing InboundXML. Point the Voice or SMS URL's on one of your TelAPI number's to the file you created, and you're good to go. Call or text into that number and you'll see it in action!

Step 1.

Make a InboundXML document and get it online:

	<Say>Welcome to your new Tel API Account.</Say>
	<Say voice="woman">
	Let us know if we can help you in any way during your development.


Step 2.

Under manage numbers in your account dashboard, set the InboundXML documents URL as one of your TelAPI number's request URLs:

Manage number in account dashboard

Thats it!

You're ready to start receiving calls and SMS messages through TelAPI.

If you are trying to initiate an outbound call or sms from your application, our REST docs probably have the information you're looking for.