Submit an inbound message
Submit a message written by one of your users and let the Shortext agent answer it.
Reply modes
sync: the request waits for the agent reply (max ~25 s) and returns it inbody.replies. On timeoutbody.statusispendingand the reply is delivered to your webhook.async: the request returns immediately withaccepted; replies are delivered to your webhook.
Idempotency: message.id is your own message id. Sending the same id again returns
duplicate with the original message, without a second reply.
Webhook: replies (async, sync timeout, human agent answers) are POSTed to the endpoint
webhook as message.sent events (ShortextWebhookEvent body), signed with
X-Shortext-Signature: sha256=hex(hmac_sha256(secret, "{X-Shortext-Timestamp}.{raw_body}")).
Retried for ~21 h on failure; dedupe on the event id.
Authorizations
Body
Response
Message stored. See body.status for the reply outcome.
Envelope of every response (always HTTP 200): only body changes from one endpoint to another.