Webhook SMS CDR

Webhook CDR Integration Example

1. Login into Monogoto hub.

2. Go to Integrations section.

3. From available integrations list please press on Webhook option.

4. Next please press on the button +Setup Webhook.

5. You should see a window open for Webhook configurations.

6. Find your webhook url you wish to push the events to. In this example, we use webhook.site.

7. Go back into your Monogoto hub where you started the Webhook integration and paste your webhook address.

8. Press on the drop list button Select events to track and select SMS CDRs. You can check descriptions of Events in Integrations section.

9. By default Billing updates, Production updates and Daily reports Events notifications are enabled, but if you want only to get SMS CDRs, then please remove them from the list by pressing on x button near each unwanted notification.

10. If you want to can give this integration a description or you can leave the default description.

11. In order to save our integration, please press on button Setup Webhook

12. You should now see your configured Monogoto hub integration with your Webhook.

CDR Payload

Payload is the information contained in the CDR record, below you can see the information that the CDR may include. A common way to deliver CDR payloads is via the use of webhooks.

Field	Type	Description
CdrType	String	Type of service that was used: MO_SMS - outbound SMS MT_SMS - inbound SMS
UniqueID	String	Unique identification of the Call Detail Record record
Iccid	String	SIM integrated circuit card identification number
IMSI	String	International mobile subscriber identity
CallingNumber	String	Source number
CalledNumber	String	Destination number
IMEI	String	The IMEI number of the device using data
MNO	String	Mobile network operator identification number
MnoName	String	Mobile network operator name
MCC	String	Mobile country code
MNC	String	Mobile network code used to identify the operator
ThingName	String	SIM name in the Monogoto portal
ThingId	String	SIM identification number
ThingsGroupId	String	SIM Thing group identification number
ThingsGroupName	String	SIM Thing group name
Timestamp	Number	ISO 8601 DateTime, shown in UTC time. It may be converted to readable date/time using 3rd party tools
Concatenated	Number	Displays status if SMS is divided into multiple SMS messages. Depending on the message symbols amount the message can be divided into multiple messages. However the receiver and sender see it as a one message
ConcatenatedFrom	Number	If SMS is divided into multiple parts, then this parameter shows which part is being sent
ConcatenatedTotal	Number	If SMS is divided into parts this shows the amount of parts the SMS was divided into
Result	String	Displays result of the service Most common results: SUCCESS- delivered/sent successfully. EXPIRED - failed to deliver on set amount of time. ABSENT_SUBSCRIBER_FOR_SM - SIM is in sleep mode or not connected to the network. UNIDENTIFIED_SUBSCRIBER - SIM is not recognized by the operator, SIM might not have full connection to the network. BUSY- UE is not ready to receive SMS messages. NULL- in case of MAP v2 for now the result field will be empty

CDR Examples

Successful Inbound SMS CDR

[
{
	"CdrType": "MT_SMS",
	"UniqueID": "CDR-123abc456def7891",
	"Iccid": "8912372646888991",
	"IMSI": "123456789101112",
	"CallingNumber": "4420412389916",
	"CalledNumber": "4420432161998",
	"IMEI": "86696204060123456",
	"MNO": "MNOId_123a456789-abc1-4862-c0ba-987654321abc",
	"MnoName": "VODAFONE",
	"MCC": "262",
	"MNC": "02",
	"ThingName": "ICCID 8912372646888991",
	"ThingId": "ThingId_ICCID_8912372646888991",
	"ThingsGroupId": "ThingsGroupId_123abc-be66-4ddd-a777-711595c5a30d",
	"ThingsGroupName": "Warehouse",
	"Timestamp": 1655296939604,
	"Concatenated": false,
	"Result": "SUCCESS"
}
]

Failed Inbound SMS CDR (SIM not connected to operator)

[
{
	"CdrType": "MT_SMS",
	"UniqueID": "CDR-123abc456def7891",
	"Iccid": "8912372646888991",
	"IMSI": "123456789101112",
	"CallingNumber": "4420412389916",
	"CalledNumber": "4420432161998",
	"IMEI": "86696204060123456",
	"MNO": "MNOId_123a456789-abc1-4862-c0ba-987654321abc",
	"MnoName": "VODAFONE",
	"MCC": "262",
	"MNC": "02",
	"ThingName": "ICCID 8912372646888991",
	"ThingId": "ThingId_ICCID_8912372646888991",
	"ThingsGroupId": "ThingsGroupId_123abc-be66-4ddd-a777-711595c5a30d",
	"ThingsGroupName": "Warehouse",
	"Timestamp": 1655296939604,
	"Concatenated": false,
	"Result": "ABSENT_SUBSCRIBER_FOR_SM"
}
]

Successful Concatenated SMS CDRs

[
  {
    "CdrType": "MT_SMS",
    "UniqueID": "CDR-AYGGJPCV7hULQTWCmZ58",
    "Iccid": "8912372646888991",
    "IMSI": "123456789101112",
    "CallingNumber": "4420412389916",
    "CalledNumber": "4420432161998",
    "IMEI": "86696204060123456",
    "MNO": "MNOId_d23c4a3f-e62c-46e8-a9ba-a6d4199736f9",
    "MnoName": "PARTNER COMMUNICATIONS COMPANY LTD.",
    "MCC": "425",
    "MNC": "01",
    "ThingName": "ICCID 8912372646888991",
    "ThingId": "ThingId_ICCID_8912372646888991",
    "ThingsGroupId": "ThingsGroupId_ff82cf3e-3b51-4aee-83d7-7e779abcbdb0",
    "ThingsGroupName": "Warehouse",
    "Timestamp": 1655812976441,
    "Concatenated": true,
    "ConcatenatedFrom": "3",
    "ConcatenatedTotal": "3",
    "Result": "SUCCESS"
  },
  {
    "CdrType": "MT_SMS",
    "UniqueID": "CDR-AYGGJO9HrXqt4AT20oZS",
    "Iccid": "8912372646888991",
    "IMSI": "123456789101112",
    "CallingNumber": "4420412389916",
    "CalledNumber": "4420432161998",
    "IMEI": "86696204060123456",
    "MNO": "MNOId_d23c4a3f-e62c-46e8-a9ba-a6d4199736f9",
    "MnoName": "PARTNER COMMUNICATIONS COMPANY LTD.",
    "MCC": "425",
    "MNC": "01",
    "ThingName": "ICCID 8912372646888991",
    "ThingId": "ThingId_ICCID_8912372646888991",
    "ThingsGroupId": "ThingsGroupId_ff82cf3e-3b51-4aee-83d7-7e779abcbdb0",
    "ThingsGroupName": "Warehouse",
    "Timestamp": 1655812975798,
    "Concatenated": true,
    "ConcatenatedFrom": "2",
    "ConcatenatedTotal": "3",
    "Result": "SUCCESS"
  },
  {
    "CdrType": "MT_SMS",
    "UniqueID": "CDR-AYGGJOy0cdGP4eQnyhJ1",
    "Iccid": "8912372646888991",
    "IMSI": "123456789101112",
    "CallingNumber": "4420412389916",
    "CalledNumber": "4420432161998",
    "IMEI": "86696204060123456",
    "MNO": "MNOId_d23c4a3f-e62c-46e8-a9ba-a6d4199736f9",
    "MnoName": "PARTNER COMMUNICATIONS COMPANY LTD.",
    "MCC": "425",
    "MNC": "01",
    "ThingName": "ICCID 8912372646888991",
    "ThingId": "ThingId_ICCID_8912372646888991",
    "ThingsGroupId": "ThingsGroupId_ff82cf3e-3b51-4aee-83d7-7e779abcbdb0",
    "ThingsGroupName": "Warehouse",
    "Timestamp": 1655812974770,
    "Concatenated": true,
    "ConcatenatedFrom": "1",
    "ConcatenatedTotal": "3",
    "Result": "SUCCESS"
  }
]