Integration

Webhooks

Über Webhooks könne externe System auf Ereignisse reagieren. Aktuell können Webhooks für das Anlegen, Ändern und Löschen von Daten im IMASync gerufen werden. Die Verwaltung erfolgt im geschützten Bereich unter dem Punkt Verwaltung/Webhook .

Authentifizierung

Die Authentifizierung erfolgt per API-Schlüssel. Der Schlüssel kann im geschützten Bereich generiert werden (IMASync/Verwaltung/API Schlüssel).

Der API-Schlüssel muss im Header der Nachricht gesendet werden:

  Authorization : Bearer [API-Schlüssel]

Liste der vorhanden Daten

Über folgende Rest-Schnittstelle kann eine Liste der vorhanden Daten abgerufen werden:

URL: https://www.inveda.net/sync.syncml.interface.script

POST:

{
   "list": {
  "[Person|Company]": {
  "fields": ["hash", "time"]
  }
}

Response:

{
  list : [
     "[Person|Company]": {"id":"..", hash:"..","time":".."}
   ]
  }

Daten zu Person abrufen

Über die folgende Schnittstelle kann ein einzelner Datensatz abrufen werden :

URL: https://www.inveda.net/sync.syncml.interface.script

POST:

  {
  "get": {
  "id":"{[id des Datensatze]}",
  "fields": ["name","email","mobile","phone","phone-business","geboren"],
  "synckey": "[IMASync Key]"
  }
  }

Response:

 {
  "get": {
     "id": "[id]" ,
     "name" : "..",
     "email" : ".."
     ....
  }
}

Wiedervorlage speichern

{
  "put": {
    "FollowUp": {
         "date": "YYYY-DD-MM",
         "subject": "....",
         "text": "HTML",
         "customer": "id"
    }
  }
}

Mail speichern

{
  "put": {
    "Mail": {
         "sender": "[e-mail|name|telefon]",
         "date": "YYYY-MM-DD hh:mm",
         "subject": "...",
         "text":"HTML",
         "customer": "id",
          "attachments": [
           {
               "filename": "testbild.pdf",
               "data": ""
           }
         ]
    }
  }
}

Mail unter gesendete Mail speichern

{
  "put": {
    "Mail": {
         "type": "outgoing",
         "sender": "[e-mail|name|telefon]",
            "receiver": "Max Muster ", 
         "date": "YYYY-MM-DD hh:mm",
         "subject": "...",
         "text":"HTML",
         "customer": "id",
         "attachments": [
           {
               "filename": "testbild.pdf",
               "data": ""
           }
         ]
    }
  }
}

Notiz speichern

{
  "put": {
    "Note": {
         "date": "2025-11-07 12:00:00",
         "text": "",
         "customer": "id",
         "contract": "id",
         "damage": "id"
    }
  }
}

Liste der Verträge des Kunde

  {
  "list": {
    "Contract": {
      "fields": ["hash", "time", "owner"],
      "owner": ""
    }
  }
}

Daten Vertrag abrufen

{
  "get": {
    "id": "",
    "fields": ["type", "number", "class", "supplier"],
    "synckey": ""
  }
}