Comment automations

Create a comment automation

A comment that matches a keyword, on one post or on any post of an Instagram account or Facebook Page, gets a private reply with the message and its link behind a button, once per person by default. Optionally one of up to 5 public replies is posted under it afterwards, and its thread is marked done. On Instagram a follow gate can ask them to follow and reply first, with a button that replies for them. Only top-level comments from others count, made after the automation starts; Rizamo reads comments every few minutes, so answers go out within minutes. Meta takes one private reply per comment, within 7 days of it. An account sends a set number of automated messages a day at most (dailyCap in the numbers), paced well under Meta's limits. Not on TikTok: automations answer by private message, and TikTok does not offer its messaging API to accounts in the EEA, Switzerland or the UK, so a TikTok account is refused with that reason.

post/comment-automations

Request

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

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

namestring required

For people: "Guide on the October reel".

keywordsstring[]

Any of them triggers it, in any case and with or without accents. Empty: every comment.

match'contains' | 'word' | 'exact'

contains: the keyword anywhere, even inside a longer word. word (the default): as a whole word or phrase. exact: the whole comment is the keyword, give or take punctuation and spaces. Always in any case and with or without accents.

excludestring[]

A comment with any of these, as whole words, never triggers it.

publicRepliesstring[]

Up to 5. After the private reply goes out, one is posted under the comment, picked at random, so the replies do not all read the same.

markDoneboolean

Mark the comment's thread done once the private reply went out. Off when left out.

oncePerPersonboolean

One message per person, however many times they comment. On when left out.

status'active' | 'paused'

active (the default) answers comments made from now on; paused saves it without answering.

accountIdstring required

The Instagram account or Facebook Page (acc_) whose comments it answers (not TikTok: see Create a comment automation). It cannot change.

networkPostIdstring nullable

One post on the network (npost_, from List posts on the networks). It cannot change.

postIdstring nullable

Or one Rizamo post (post_) with a target on the account, scheduled or live: it starts once the post is live there. It cannot change.

Response

OK

idstring required
profileIdstring required
accountIdstring required
network'instagram' | 'facebook' | 'threads' | 'linkedin' | 'tiktok' | 'youtube' | 'x' | 'pinterest' | 'google' required
namestring required
status'active' | 'paused' required

Paused: comments are not answered, and those that arrive meanwhile never will be.

pausedReasonstring nullable required

Why Rizamo paused it, such as a permission Meta refused or a link of the message that stopped working: fix it, then resume. Null when it is active or someone paused it.

networkPostIdstring nullable required

Only comments on this post on the network (List posts on the networks). Null with postId null: every post of the account, new ones too.

postIdstring nullable required

Only comments on this Rizamo post, on the account: it can be scheduled, and the automation starts when it goes live there.

armedboolean required

False while its Rizamo post is not live on the account yet.

keywordsstring[] required

Any of them triggers it. Empty: every comment.

match'contains' | 'word' | 'exact' required

contains: the keyword anywhere, even inside a longer word. word (the default): as a whole word or phrase. exact: the whole comment is the keyword, give or take punctuation and spaces. Always in any case and with or without accents.

excludestring[] required

A comment with any of these, as whole words, never triggers it.

publicRepliesstring[] required

After the private reply goes out, one of these is posted under the comment, picked at random. Empty: none.

markDoneboolean required

Marks the comment's thread done in the inbox once the private reply went out.

oncePerPersonboolean required

One message per person for this automation, however many times they comment. On by default.

createdAtstring date-time required
updatedAtstring date-time required

Changes

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