PCE DID Change

When DID numbers for one or more Cloud PBXs are changed, Yeastar Central Management will send an event report to the third-party application.

Report parameters

The report contains a list of Cloud PBXs whose DID numbers have been changed. The parameters for a single Cloud PBX are as follows.

Parameter Type Description
event String Event name.
  • did_change:
    • DID numbers are assigned to a Cloud PBX when creating or editing the PBX.
    • DID numbers are removed from a Cloud PBX when editing the PBX.
  • did_delete: DID numbers assigned to a Cloud PBX are deleted from their associated trunks.
  • trunk_delete: Trunks whose DID numbers have been assigned to a Cloud PBX are deleted.
  • pce_delete: A Cloud PBX assigned with DID numbers is deleted.
sn String PBX's serial number.
trunkDidInfoList Array <DID_info> The list of current DID information for the Cloud PBX.
updateTime Integer The timestamp of the time that the event occurred.
DID_info
Parameter Type Description
did String The DID number.
didId String The unique ID of the DID number.
trunkId String The ID of the trunk associated with the DID number.
trunkName String The name of the trunk associated with the DID number.

Report examples

  • The DID numbers (2113 & 10021215) are removed from a Cloud PBX during the PBX update. The report contains details of current DID numbers for the Cloud PBX as follows:
    [
  {
    "event":"did_change",
    "sn":"36XXXXXXXXXXXXZK",
    "trunkDidInfoList": [
      {
        "did":"10021212",
        "didId":"1192488",
        "trunkId":"114529",
        "trunkName":"register-trunk-shared_32YFS4"
      },
      {
        "did":"10021213",
        "didId":"1192489",
        "trunkId":"114529",
        "trunkName":"register-trunk-shared_32YFS4"
      },
      {
        "did":"10021214",
        "didId":"1192490",
        "trunkId":"114529",
        "trunkName":"register-trunk-shared_32YFS4"
      },
      {
        "did":"2111",
        "didId":"1192495",
        "trunkId":"114538",
        "trunkName":"Peer-shared_NT9H01"
      },
      {
        "did":"2112",
        "didId":"1192496",
        "trunkId":"114538",
        "trunkName":"Peer-shared_NT9H01"
      },
      {
        "did": "83",
        "didId": "1186852",
        "trunkId": "112129",
        "trunkName": "register-docs_5FOV41"
      }
    ],
    "updateTime":1773105500177
  }
]
  • The DID numbers (10021213 & 10021214) assigned to a Cloud PBX are deleted from their associated trunk (trunkID: 114529). The report contains details of current DID numbers for the Cloud PBX as follows:
    [
  {
    "event": "did_delete",
    "sn":"36XXXXXXXXXXXXZK",
    "trunkDidInfoList": [
      {
        "did": "10021212",
        "didId": "1192488",
        "trunkId": "114529",
        "trunkName": "register-trunk-shared_32YFS4"
      },
      {
        "did":"2111",
        "didId":"1192495",
        "trunkId":"114538",
        "trunkName":"Peer-shared_NT9H01"
      },
      {
        "did":"2112",
        "didId":"1192496",
        "trunkId":"114538",
        "trunkName":"Peer-shared_NT9H01"
      },
      {
        "did": "83",
        "didId": "1186852",
        "trunkId": "112129",
        "trunkName": "register-docs_5FOV41"
      }
    ],
    "updateTime": 1773106452589
  }
]
  • The trunks (trunkID: 112129 & 114538) whose DID numbers have been assigned to a Cloud PBX are deleted. The report contains details of current DID numbers for the Cloud PBX as follows:
    [
  {
    "event": "trunk_delete",
    "sn":"36XXXXXXXXXXXXZK",
    "trunkDidInfoList": [
      {
        "did": "10021212",
        "didId": "1192488",
        "trunkId": "114529",
        "trunkName": "register-trunk-shared_32YFS4"
      }
    ],
    "updateTime": 1773049941393
  }
]
  • A Cloud PBX assigned with DID numbers is deleted. The report contains details of current DID numbers for the Cloud PBX as follows:
    [
  {
    "event": "pce_delete",
    "sn":"36XXXXXXXXXXXXZK",
    "trunkDidInfoList": [],
    "updateTime": 1773048881029
  }
]