Qiscus Omnichannel icon

Qiscus Omnichannel

Consume Qiscus Omnichannel API

Actions6

SDK → Send System Event

AI-generated

Summary

Posts a custom system event message into a Qiscus chat room via the Qiscus SDK REST API (post_system_event_message). Use it to insert a non-user, system-style notice into a conversation.

Inputs

  • roomId (required) — ID of the Qiscus room that will receive the system event (e.g. 345737961).
  • message (required) — Text of the system event message to post in the room.

Output shape

One output item per input item, containing the JSON response from the Qiscus SDK API (an array response is split into one item per element).

The request body is fixed to system_event_type 'custom' plus room_id and message. It is sent to the credential's SDK base URL with the App ID and secret in the QISCUS_SDK_APP_ID and QISCUS_SDK_SECRET headers, so the Qiscus credentials must include appId, appSecret and sdkBaseUrl. The Type field in the UI properties doesn't affect this operation's execution. With 'Continue On Fail' enabled, errors are returned as an item with an 'error' message.

Examples

Example 1: Announce in a customer chat room that the conversation was transferred to another agent.

Resource: SDK; Operation: Send System Event; Room ID: {{$json.room_id}}; Message: 'Conversation transferred to Billing team'.

Example 2: Add a system notice that a ticket was created.

Resource: SDK; Operation: Send System Event; Room ID: 345737961; Message: 'Ticket #1234 has been created'.

Links

Discussion