Instant SMS API Alert
We are able to notify agents instantly when we receive an SMS message about one of their properties. One of these methods is to allow us to call an API on your website. You can select the API method via your user profile, you will need to specify your script URL at that time also.
When we receive an SMS message we immediately notify our agents by posting variables to their script.
The variables posted by our script are listed (and described below), an example of how to gather the data follows.
- datetime - The date and time that we received the SMS message. Format: "yyyy-mm-dd hh:mm:ss"
- sender - The telephone number that the SMS message was sent from, starts with country code (e.g. for UK number starts '44...').
- messageSent - The message that our systems sent back to the customer.
- content - The full content of the message received by our systems.
- status - Delivery status of the message.
- U (undelivered)
- D (delivered)
- I (invalid)
- keyword - The keyword the message was sent to.
- externalReference - The human readable reference you programmed in for the property.
- external - Your system reference for the property (generally some unique identity number)
- message - The message to be sent out in an SMS about the property
- added - The date the property listing was added to our systems or last updated on our systems. Format "yyyy-mm-dd hh:mm:ss"
- shortcode - The reference number of the property (that is added to the agents shortcode to form the reference customers text to our systems)
- street - Street address of the property
- town - Town/Area/Suburb of the property
- city - Nearest city for the property
- flat - Flat number of the property (if required)
- country - Country of the property
- postcode - Postcode of the property
- type - The type of property listing, where,
- 1 = Sales Listing
- 2 = Rental Listing
- price - The list price of the property. Note: If listing is of rental type then price is per calendar month (pcm)
- county - The county that the property resides in
$externalReference = $_REQUEST['externalReference'];
$external = $_REQUEST['external'];
$message = $_REQUEST['message'];
$added = $_REQUEST['added'];
$shortcode = $_REQUEST['shortcode'];
$street = $_REQUEST['street'];
$town = $_REQUEST['town'];
$town = $_REQUEST['city'];
$flat = $_REQUEST['flat'];
$country = $_REQUEST['country'];
$postcode = $_REQUEST['postcode'];
$type = $_REQUEST['type'];
$price = $_REQUEST['price'];
$price = $_REQUEST['county'];
$datetime = $_REQUEST['datetime'];
$sender = $_REQUEST['sender'];
$messageSent = $_REQUEST['messageSent'];
$content = $_REQUEST['content'];
$status = $_REQUEST['status'];
$keyword = $_REQUEST['keyword'];
You are then free to process the variables as required.