Zum Inhalt springen
Developer

SupportChat

Offene Daten4 EndpunktePublic / SupportChat

Vorhandenen Support-Chat abrufen

GET/api/public/chat/support

Header

x-public-session-tokenPflichtstringÖffentlicher Sitzungstoken, der den Besucher identifiziert (alternativ übergebbar als Query-Parameter 'x-public-session-token' / 'ps_token' oder bei gesicherten Verbindungen als Cookie 'X-PUBLIC-SESSION-TOKEN')

Antworten

default

Anfrage
curl --request GET \
  --url https://eure-instanz.iw-erp.de/api/public/chat/support

Bestehenden Support-Chat starten oder abrufen

POST/api/public/chat/support

Header

x-public-session-tokenPflichtstringÖffentlicher Sitzungstoken, der den Besucher identifiziert (alternativ übergebbar als Query-Parameter 'x-public-session-token' / 'ps_token' oder bei gesicherten Verbindungen als Cookie 'X-PUBLIC-SESSION-TOKEN')

Request-Body application/json

  • messagestring

    Erster Nachrichtentext

Antworten

200Support-Chatroom angelegt oder abgerufenobject

Felder anzeigen (4)
  • chatroomobject
  • participantobject
  • messageobject
  • office_hoursobject

    enabled, open, text (chatroom_support_office_hours_enabled)

Anfrage
curl --request POST \
  --url https://eure-instanz.iw-erp.de/api/public/chat/support \
  --header 'content-type: application/json' \
  --data '{"message":"string"}'
Antwort 200 application/json
{}

Nachrichten des Support-Chats abrufen

GET/api/public/chat/message

Query-Parameter

chatroomPflichtstringBenachrichtigungs-Token des Chatraums
afterIdintegerNachrichten nach dieser ID laden
searchStringstringText, nach dem in der Liste gesucht wird
orderFieldNamestringName des Bestellfelds
orderFieldSortstringSortiermodusErlaubt: DESCASC
pageintegerSeite der Liste
pageSizeintegerAnzahl der Einträge je Seite
withMaxPageNumberstringgibt die Anzahl verfügbarer Seiten als Header zurück, wenn dies gesetzt ist

Header

x-public-session-tokenPflichtstringÖffentlicher Sitzungstoken, der den Besucher identifiziert (alternativ übergebbar als Query-Parameter 'x-public-session-token' / 'ps_token' oder bei gesicherten Verbindungen als Cookie 'X-PUBLIC-SESSION-TOKEN')

Antworten

default

Anfrage
curl --request GET \
  --url 'https://eure-instanz.iw-erp.de/api/public/chat/message?chatroom=string'

Sendet eine Nachricht in einem bestehenden Support-Chat

POST/api/public/chat/message

Header

x-public-session-tokenPflichtstringÖffentlicher Sitzungstoken, der den Besucher identifiziert (alternativ übergebbar als Query-Parameter 'x-public-session-token' / 'ps_token' oder bei gesicherten Verbindungen als Cookie 'X-PUBLIC-SESSION-TOKEN')

Request-Body application/json

  • chatroomstring

    Benachrichtigungs-Token des Chatraums

  • messagestring

    Nachrichtentext

Antworten

default

Anfrage
curl --request POST \
  --url https://eure-instanz.iw-erp.de/api/public/chat/message \
  --header 'content-type: application/json' \
  --data '
{
  "chatroom": "string",
  "message": "string"
}
'