How does our Webhook work?

What do we need from you?

1. The URL of your endpoint where we will send the notifications.

2. The token or header with which you want us to authenticate (optional)

Send this information to [email protected] so that your endpoint can be configured in our system.

What information will you receive?

There are different types of events within our platform that can be notified via the webhook. We currently have the following:

Event type	Description	Object sent
STUDY_CREATED	A study is created within the platform	Study
STUDY_SIGNED	A report is signed	Study
STUDY_ADDENDUM_SIGNED	An addendum is signed	Study
STUDY_PDF_FILE_UPDATED	A study PDF file was updated.	Study PDF
STUDY_PDF_FILE_CREATED	A study PDF file was created.	Study PDF
ORDER NEW	An order was created	Order
ORDER_PATIENT_ARRIVED	Notifies when the patient has arrived	Order
ORDER_IN_PROCESS	Notifies when the order changes to status	Order
ORDER_COMPLETED	Notifies when the order changes to status	Order
ORDER_CANCELLED	Notifies when the order changes to status	Order
STUDY_REPORT_BIRADS	Notifies when in a signed study the diagnosis is associated with a Birads value.	Study report

When any of these events is triggered, a request will be generated using the POST to the URL or URLs you indicate. This request will have the following structure

{
  "id": <ID of the event>,
  "event_type": <Event type>,
  "created_at": <Event creation date>,
  "updated_at": <Event last update>,
  "data": <Information of the sent object>
}

Objects sent

Each event sends the information of an object in the attribute data of the JSON. These are the different types of objects you can receive:

Study

{
  "id": 583,
  "data": {
    "id": "019b1dd7-9058-4803-9875-e0a1737ba812",
    "folio": "123456789",
    "status": "SIGNED",
    "orders": [],
    "patient": {
      "id": "a4bb34f6-5b3c-45a1-acb3-41dc1c294044",
      "age": null,
      "email": "[email protected]",
      "gender": "F",
      "name": "NEW",
      "last_surname": "Robles",
      "full_name": "Maria Robles Perez",
      "birth_date": "2018-04-01",
      "identifier": "Case14",
      "phone_code": "52",
      "phone_number": "1234567890",
      "phone_country": {
        "id": "0954cbdc-164a-4bcf-975e-7a692922b68a",
        "iso_code": "MX"
      }
    },
    "reports": [
      {
        "id": "25d65942-ef48-46ac-b7fa-3bd0aecca10e",
        "birads": null,
        "fields": [
          {
            "id": "79055558-f2ce-4a22-a0ed-f7c48e43ad10",
            "value": "<p>Report content</p>"
          }
        ],
        "pdf_url": "https://files.evacenter.com/media/report/pdf_files/0ef7e14c-b4a4-4997-925f-9b2cfb996542/2024-05-08/maria-robles-perez-mg.pdf",
        "signed_at": "2024-05-08T16:55:57.818445+00:00",
        "signed_by": {
          "user": {
            "email": "[email protected]"
          },
          "full_name": "Jessica Anderson Morales",
          "identifier": "user010101",
          "license_number": "40938118"
        },
        "pdf_letterhead_url": "https://files.evacenter.com/media/report/pdf_files/0ef7e14c-b4a4-4997-925f-9b2cfb996542/2024-05-08/maria-robles-perez-mg_letterhead.pdf"
      }
    ],
    "facility": {
      "id": "03ecb7e6-b9d7-4814-89ec-b3fda20b9ae1",
      "name": "CDMX",
      "external_identifier": "FACILITY_01"
    },
    "modalities": "MG",
    "dicom_date_time": "2008-09-15T08:49:48+00:00",
    "study_pdf_files": [],
    "study_viewer_link": "https://pacs.evacenter.com/viewer/019b1dd7-9058-4803-9875-e0a1737ba812",
    "report_viewer_link": "https://apps.evacenter.com/pacs/report-detail/019b1dd7-9058-4803-9875-e0a1737ba812/?ac=dXNlcj1ldmEtY2VudGVyQHZpc2l0YW50LmNvbSZwYXNzd29yZD0zOTc5NzRlNS1hOWExLTQyOWYtYWRmMS02YzJkOTQ4ODhhYmImZXh0cmFfdmFsaWRhdGlvbj1lZjg4MzMxYS0yMTE5LTQ0YTktODY0Zi05MzlkZTFjZjVmNzE===",
    "practitioner_assigned": null,
    "dicom_reason": null,
    "dicom_accession_number": "9876543210",
    "original_dicom_date_time": "2024-12-10T23:50:39.396824+00:00",
    "dicom_referring_physician": null,
    "dicom_requesting_physician": null
    "public_study_viewer_link": "https://pacs.evacenter.com/viewer/019b1dd7-9058-4803-9875-e0a1737ba812/?ac=dXNlcj1ldmEtY2VudGVyQHZpc2l0YW50LmNvbSZwYXNzd29yZD0zOTc5NzRlNS1hOWExLTQyOWYtYWRmMS02YzJkOTQ4ODhhYmImZXh0cmFfdmFsaWRhdGlvbj1lYzE0MTY2My1mNzg4LTRlYWEtODE0OS1jYzcxMGViZWI5MDQ===&mv=1"
  },
  "created_at": "2024-05-08T16:55:59.607763+00:00",
  "event_type": "STUDY_SIGNED",
  "updated_at": "2024-05-08T16:55:59.607789+00:00"
}

How to sign a report in Eden?

Since this event is triggered when the report is signed, it is necessary to perform the following process from the platform.