Docs / Packages

How to use

Give the Agent a source, confirm the draft, then check each platform's result.

Last updated 2026-11-04

Every server-side action is done by your Agent with your own Blotato key. The Page only shows the Package data; it does not go online itself and does not write data back.

From source to published post#

  1. Send the source to the Agent#

    In the Thread on the right, give the Agent a web address (article, YouTube, TikTok, PDF, audio) or some copy. The Agent adds a source to the data, then submits it to Blotato to extract the content. Once the submission is accepted, the extraction job is "pending" and the content cannot be used yet.

  2. Wait for the Agent to write a draft#

    The Agent checks the extraction job and only writes a draft from the extracted content once its status becomes "done". The draft keeps only a one or two sentence summary; the full text of the source does not go into the Package data. Instagram, TikTok, Pinterest and YouTube need an image or video; if there is none, the Agent tells you first.

  3. Confirm the draft and schedule#

    The Agent lists the draft, the target accounts and the scheduled time (your local time and time zone) for you. Only after you clearly say "go ahead and post" is the draft marked approved. Target accounts are chosen from the accounts already connected in Blotato; the Agent does not pick them for you.

  4. Let the Agent submit#

    One draft sent to several platforms is that many separate submissions. A successful submission is only "accepted": the Agent tells you the submission ID and says it is not published yet. If the network drops during submission, the Agent does not resend on its own; it tells you first, so the post is not duplicated.

  5. Check the results#

    For submissions that have not reached a final status, the Agent checks Blotato and records the status exactly as returned. Only when Blotato returns "published" with a public link does the right column of the Page show the link. You can ask the Agent to resend one that failed. A resend is a new record, and the old record is kept.

How to read the statuses on the Page#

StatusMeaning
AcceptedBlotato has taken the submission, but it is not published yet
In progressBlotato is working on it
PublishedBlotato confirms it is published, with a public link
FailedBlotato clearly refused it, with a reason
Could not confirmBlotato cannot be reached or the key is invalid; the last confirmed status and its time are kept

The top of the Page also shows the result and time of the last status check with Blotato. When it cannot connect, only records that have not reached a final status are marked "could not confirm"; published and failed records stay as they are.

Scheduled checks#

The Package comes with a Routine proposal: every 30 minutes, check submissions and extraction jobs that have not reached a final status. It only checks and never submits new content. It runs only after you authorize it in Lorevik's Routine. When it is due, it prepares the prompt to send to the Agent, and you send it; nothing is sent automatically.

Where your data is kept#

  • Sources, jobs, drafts, accounts, submissions and published records are all in data.json in this Package folder, written by the Agent.
  • The schedule is recorded three times: the local time and time zone you gave, the time with offset actually sent to Blotato, and the time Blotato returned.
  • What never goes into the data: the API key, your Blotato account email or password, and the full text of sources.

See also#