2 Way SMS with Google Voice -- Inbound API Doc

Inbound API Documentation

1. Set up your RESTful API that accepts inbound SMS like this: http(s)://www.yourdomain.com/yourpath
Please note that a login should NOT be required to access your inbound API. Disable authentication and authorization on your API so that gvsms.com can call your API without any problem.

2. Configure your GVA and GMail account,and tell us your inbound API on your profile page.

3. When call your API, we add the following POST parameters to it:

Name	Description		Sample Value
phoneNumber	Phone number from Google Voice SMS		+12027309498
text	SMS text from Google Voice SMS		Hello Mike!
startTime	SMS timestamp from Google Voice SMS. Time in milliseconds after January 1, 1970 00:00:00 GMT		1248920647764


4. Your API should return one of the following status codes:

Status Code		Description
200		OK
Any other value		Fail

5. What will happen when push fails?

When get a non-200 status code from your API, we will send you a reminding email, and put your inbound service on hold until you fix it and update the vaule of your inbound API on your profile. When detect a failure due to change of your domain,port, we will send you a reminding email, and put your inbound service on hold until you fix it and update the vaule of your inbound API on your profile. When your server is down, we do nothing. In each case above, the SMS is re-pushed every 10 minutes for total 24 hours.

6. Security conciderations

Disable authentication and authorization on your API so that gvsms.com can call your API without any problem. Use https(SSL) instead of http on inbound API. Add your security parameters to your inbound API. Only accept requests from our IP addresses: 64.186.154.192

Outbound API Documentation