latestOpenAPI 3.1.1Proprietary – Contact us for usage terms2026-08-20173183551.4 KB

9da73dd2f99e

webhook

Message event

This event is triggered when a message is sent and/or received (according to your settings on the myringover dashboard). The data object contained in the sent object will give you information such as the sending number, the receiving number, the content of the message, the time it was sent etc...

To certify that the request was sent by Ringover, the Authorization header must be a base-64 encoded version of the webhook key you can find in the webhook configuration page of Ringover dashboard.

postWebhookmessage

Payload

event'sent' | 'received'
resourcestring
timestampnumber
attemptinteger

Example payload

{
  "resource": "sms",
  "data": {
    "id": "1234567-234567",
    "message_id": 1234567,
    "conversation_id": 234567,
    "direction": "inbound",
    "from_number": "33601020304",
    "to_number": "33101020304",
    "body": "My SMS content...",
    "user_id": 1234567890987654400
  },
  "attempt": 2
}

Response

Successful operation