Set the parameter sms_url on your Virtual Phone Number to https://yourapp.example/elks/sms (or wherever your webhook code is). We'll make an HTTP POST (application/x-www-form-urlencoded) request to this URL every time your number receives an SMS.
|The unique id of the message in our systems.
|The sender of the SMS.
|The phone number the SMS was sent to.
|The contents of the SMS.
|The direction of the SMS. Always ”incoming” for incoming SMS.
|The time in UTC when the SMS object was created in our systems.
Your webhook code must respond with a HTTP status in the range 200-204. If not, the API will consider the request failed and keep trying for at least 6 hours and at least 5 times per callback.
You can optionally reply to the SMS directly in your webhook response, instead of calling POST /sms again seperately. Just put the message directly in the body of your response:
The current time is 08:14.