Set the parameter mms_url on your MMS-enabled Virtual Phone Number to https://yourapp.example/elks/mms (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 MMS.
POST https://yourapp.example/elks/mmsdirection=incoming&
id=sf8425555e5d8db61dda7a7b3f1b91bdb&
from=%2B46706861004&to=%2B46706860000&
created=2018-07-13T13%3A57%3A23.741000&
message=Hello%20how%20are%20you%3F&
image=https%3A%2F%2Fapi.46elks.com%2Fa1%2F| Parameter | Description |
|---|---|
| id | The unique id of the message in our systems. |
| from | The sender of the MMS. |
| to | The phone number the MMS was sent to. |
| message | The message included with the MMS. |
| image | URL to image. Only present if an image was sent. * |
| created | The time in UTC when the MMS 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.
List of images
A list of four images will look like this:
image: "https://example.com/test.jpg"
image2: "https://example.com/test2.jpg"
image3: "https://example.com/test3.jpg"
image4: "https://example.com/test4.jpg"