Inbox

Reply in a thread

Answers as the account: publicly under the comment, or in a private message within 24 hours of the person's last one (replyWindowEndsAt). A Threads, LinkedIn or YouTube reply comes back sending and goes out within a minute: read the thread to follow it. One that failed says why in deliveryError; retryOf tries it once more, never sending it twice.

post/inbox/threads/{id}/messages

Request

  • Base URL
    https://api.rizamo.com/v1
  • Auth
    HTTP bearer

Path parameters

idstring required

The thread's id (thr_).

Headers

Idempotency-Keystring

1 to 255 printable characters, new for each request (a UUID); the body up to 1 MB. For 24 hours a repeat with the same key, path and body gets the first answer, with Idempotent-Replayed: true, instead of running again; 5xx, 409 and 429 answers are not kept. Errors, Retries, has the rest.

Request body

textstring required

The reply, as the account sends it.

retryOfstring

A failed reply's message id, to try it again: the same message goes out with its own text, after Rizamo looks on the network for an earlier try, so it is never sent twice. One sent or on its way by then is returned as it is, and nothing is sent.

Response

OK

idstring required
threadIdstring required
direction'in' | 'out' required
textstring required

Empty when the network does not share it, as Instagram does not for GIF and sticker comments, or when the message is only an attachment.

atstring date-time required
delivery'sending' | 'sent' | 'failed' nullable required

Where a reply stands. sending: on its way (a Threads, LinkedIn or YouTube reply goes out in the background, within seconds to a minute; read the thread again to follow it). sent: on the network. failed: not sent, with why in deliveryError; reply again with retryOf set to its id to try it once more, which never sends it twice. Null for messages received.

deliveryErrorstring nullable required

Why the reply was not sent, in plain words, when delivery is failed.

hiddenboolean required

Comments: hidden on the network, from Rizamo (Hide a comment) or the network's own app, as Rizamo last read it. Others no longer see it; the person who wrote it may. Always false for messages.

likedboolean nullable required

Facebook comments (and LinkedIn Pages'): whether the Page likes it (Like a comment). Null elsewhere, where Rizamo does not like comments.

firstboolean required

Comments: the thread's first comment, which started it. Deleting it deletes the thread, and it is the only one Threads hides (with the replies under it). False for the replies, and for every message; false for all of a thread whose first comment Rizamo never read.

Changes

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