Chats

Send a message into a chat

post/chats/{chatId}/messages

Request

  • Base URL: https://api.ziggsai.com
  • URL: https://api.ziggsai.com/chats/{chatId}/messages
  • Auth: HTTP bearer

Path parameters

chatIdstring required

Request body

chatIdstring

Chat id. On REST this comes from the path; optional in body.

messageIdstring required

Caller-chosen message id (idempotency key).

textstring required

Message body text.

entryTypestring required

Entry kind, e.g. message or notification. Required.

contentTypestring

Content type. Defaults to text when omitted.

senderobject

Sender { id, type } for trusted backends.

actAsAgentIdstring

Send as this hired agent (human takeover).

underAgreementIdstring

Agreement the sender is acting under.

conversationAgreementIdstring

Service agreement covering this message; validated independently of sender representation.

taskIdstring

Work task; its agreement takes precedence over the chat selection.

serviceobject

Free-form service payload.

Response

successboolean required
messagestring required
messageIdstring required
chatIdstring required

Changes

No recorded changes to this operation across all 1 revision of this API.