ZoalaContent Ops
Waiting for connection Back to dashboard
Page setup

Content pages

Set up one brand for one market at a time. We save your choices as a draft, then check them before any scheduled work starts. Publishing a page requires your review and a safe test of its publishing connections.

Start hereHow to set up a page

What is a “page” here?

It is a saved setup for one brand in one market. It tells us who the content is for, where to find relevant stories and where approved drafts should go.

Follow these seven steps

  1. Identity and audience: choose the brand, market, language and readers. We then look for local news publishers.
  2. News publishers: review the local sources we found. Add another only if you need it.
  3. Knowledge: prepare and approve the brand’s own facts and assets. Add local facts where needed.
  4. Publishing destinations: choose whether this page uses WordPress and select the social accounts it may use.
  5. Writing and safety rules: review the shared model choices and add any page-specific restrictions.
  6. Schedules: choose when this page checks news, prepares campaigns and handles approved posts.
  7. Final review: check what is ready, agree to the setup test and publish only when every requirement is met.

Why save one section at a time?

Later choices often depend on earlier ones. A green check means that section is saved and ready for its next step. If a check fails, your draft remains. Read the note beside the button, make the change and try again.

Where do articles and social posts go?

A brand may have one connected WordPress site and one default page for articles, images and previews. Other market pages can stay social-only. You can also skip WordPress for a new brand while preparing its draft. If you connect a site, use a WordPress application password; we verify and encrypt it, then remove it from this form. For social media, connect the account in Buffer, return here and scan. Buffer credentials do not appear on this page.

What happens after you click Publish page?

We first check the page’s sources and build one test campaign for your review. Zoala keeps its existing campaign rules. Every other brand uses only the knowledge package, links and assets you approved for that brand. After you approve the test, we schedule a temporary Buffer post for a safe future time, check its channel, text, image and time, then delete it and confirm removal. The page goes live only when every check passes. You can close the progress window while it continues.

Things people usually ask

It says “Needs attention”. Did I break it?

Probably not. It just means one check still needs an answer. Open that section and read the short note beside its button. Your saved draft is safe.

Can I add a completely new market?

Yes. Its own market supplies the main stories. Opened stories from the brand’s other markets may help as supporting evidence, but the new page’s own country is kept out of that supporting pool.

I added a Buffer channel. Why can’t I select it?

Press scan and give Buffer a moment to finish connecting it. When it appears below, press Use for this page. If Buffer says the channel is locked or disconnected, fix that in Buffer first.

Do I need LinkedIn, Facebook and Instagram?

No. One working social channel is enough. Artwork follows the channels you actually select, so the page does not make unused formats.

Why did the scheduler refuse my time?

Another page is too close to it. Keep each recurring run at least one hour away from the schedules on other pages so they do not fight for the same AI capacity.

How do I pause it without losing anything?

Open Schedulers and press Pause this page’s work. This pauses only the page’s campaign-building and publishing clocks; the shared news sweep keeps serving the other pages. This page, its campaigns and its history stay put. Archive page also stops its work and hides it from everyday dashboard views, so use that only when retiring the whole page.

Can I change the page later?

Yes. Come back here, edit the section and save it again. The system checks the new setup before using it.

For developersHow page settings reach the workflow

The short version

The page selects the shared content-automation-baseline@1 workflow. Each campaign receives a frozen copy of its page settings, so later edits do not rewrite a running campaign. Zoala continues through its existing adapter. A different brand receives the document-driven adapter only after its own reviewed knowledge package is approved.

What lives where

A region holds countries and a timezone. A brand holds shared knowledge and, when connected, one WordPress site. That site may serve several markets. Each page chooses its own Buffer channels. The browser receives public links and IDs, never provider secrets.

How the automatic bits work

Saving Identity and audience asks the server to search Google News for that market and turn the publishers it finds into fixed, domain-scoped feeds. Buffer scan first asks the API key which workspaces it can see, then reads the channels from all of them. No separate workspace ID should be needed.

Saved does not mean running

A draft can hold its schedules without starting ordinary work. A setup test is allowed only when this page has an approved brand package and every other check passes. Activation also needs consent and a 31-day conflict check that keeps page runs at least an hour apart.

Provider safety

WORDPRESS_DEFAULT and BUFFER_DEFAULT are routing labels, not credentials. A WordPress application password may be submitted once through the protected configuration route; the API verifies the user and category, stores only an AES-256-GCM envelope and never returns the secret. Buffer credentials remain server-only and never enter a redirect URL. A later delegated provider flow should use OAuth Authorization Code with PKCE.

The setup test

content_page_setup_runs remembers the exact checkpoint. Workflow 25 advances source sweep, editorial, human review and a reversible Buffer preflight on one-minute heartbeats, one saved stage at a time. Approval remains a human decision. The preflight custom-schedules the approved social payload, reads it back, deletes it before its due time and verifies deletion. It must never call WordPress publication or Buffer “share now”.

Before you ship a change

  1. Run typecheck, the Agent API tests and the dashboard DOM/proxy tests.
  2. Prove a new market gets its own publishers, not another market’s fallback.
  3. Prove Buffer scan works with only the server API key; do not depend on a hand-entered workspace ID.
  4. Run the whole draft → schedules → consent → setup-test path in memory.
  5. Check generated workflows even if you did not edit a workflow file.
  6. After merge, verify Cloudflare, the exact container SHA, migrations, Workflow 25 and the read-only preflight.

Useful “why?” answers

When does a new brand need code?

Normally, it does not. Prepare and approve that brand’s own knowledge package here and the document-driven adapter will use it. We keep the page as a draft only when required evidence, CTA routes, safety rules or logo approval is missing. A genuinely new publishing integration or output type may still need development work.

Why keep an incomplete draft?

So your work is not lost. Saved does not yet mean safe to run; we check the complete setup before starting campaigns.

Why share WordPress but not Buffer channels?

A brand’s website can serve several markets. Social accounts may be market-specific, so each page chooses its own connected channels.

Why are schedules separate?

A visible page is not permission to start paid work or publish. Every schedule has its own switch, next run time and safety checks.

Page profile

New page

Unsaved draft
1Identity and audienceChoose the reusable brand and market first; dependent fields will be filled from them.Start here. This tells the system which brand, place, language and group of people this page is for, so every later choice stays relevant to the right audience.Not saved
Tell the AI about this page

Say who the page is for and the broad topic. The AI asks a few short questions in plain words, then suggests the readers and topics to look for. You confirm one summary and can change anything. If this page already has readers and topics, the chat starts from them and updates the same list.

AI helper
Saved for this page
Untick an item to switch it off and keep it for later. Save this section to keep your changes. These are campaign readers, not merely people mentioned in an article. A story must match at least one reader and one topic that are switched on.
Use an established specialist topic

This catalogue exists for established pages such as Zoala. It is never selected automatically for a new brand.

Save to check that this brand and market do not already have the same page.

2News publishersReview the local sources we found after you saved Identity.This list controls which news sources the page may watch. It will not add unrelated publishers on its own.Waiting for step 1

The system watches the news sources saved here. You can also let strong matches from other news sites in with the option below.

Complete Identity first so the system can search this market.

No approved defaults are installed for this market yet.

The AI still checks every article against your audience and topic. News from other sites needs a slightly higher score than news from the list above, only real news sites are considered, and each one is tagged "Outside your publishers" so you can see where it came from.

Keep at least one working news feed switched on.

3KnowledgePrepare the brand’s own facts and assets, then review them before approval.This is the page’s fact folder. Approved information stays with its own brand, so the AI does not borrow claims or assets from another one.Waiting for step 2

Each brand uses only its own approved knowledge. Pages can add market-specific facts without borrowing another brand’s claims or assets.

Preparing one RAG document from page linksPaste approved page links into the guide’s prompt, then use a browsing AI tool to prepare one Markdown document. You can upload that file below.

Or let us prepare it here. Paste the page links below and we will check them for you.
Before you start, here are the limits:
  • Up to 100 pasted links and 20 files, 8 MB combined.
  • We check up to 1,000 relevant distinct links, read up to 300 pages or linked PDFs and follow eight link levels. We skip repeated links and duplicate pages.
  • We download no more than 12 assets, and only when the page identifies them as a logo, wordmark or reusable brand asset. We do not collect ordinary page photos, blog thumbnails, decorative icons, favicons or font files.
  • If your pasted pages use the website’s global, unprefixed URLs, we skip `/my/`, `/sg/`, `/zh/` and other locale-prefixed copies. Paste a locale-prefixed page explicitly when you want that version included.
  • We record blocked and out-of-scope links with reasons. This is a bounded check, so some pages may remain unread. To crawl a website linked only inside a file, paste that website’s URL as well.

Prepare, review and approve one brand-owned knowledge package, or continue using an already approved package.

4Publishing destinationsConfirm this page’s WordPress role and map at least one verified social channel.Choose the exact social accounts this page may use. This also decides which image shapes are made: vertical for Instagram or Facebook, and landscape only when LinkedIn or the default WordPress page needs it.Waiting for step 3

If this brand already has WordPress connected, we will show it here. You can leave a new brand’s page social-only. Each page chooses its own social channels.

Checking this brand’s WordPress setup… Save Identity first.
Connect social media without a developer 1. Open Buffer and connect the social profile. 2. Return here and scan. 3. Choose “Use for this page”.
Open Buffer setup ↗

Connect Buffer securely once, then scan to see its social channels here. The secure connection has a separate Buffer request allowance; analytics continues to use the existing personal key.

Social channels used by this page

We will check that each chosen account is connected and not selected twice.

5Writing and safety rulesReview the shared model choices and add restrictions for this page if needed.These shared choices tell the AI how to work. A different brand’s approved knowledge package supplies its identity, claims, links, restrictions and assets.Waiting for step 4
AI models, safety rules and workflow version

Loading the shared AI model choices…

Human review and cross-brand knowledge isolation are permanent system guardrails and cannot be switched off here.

Zoala keeps its existing campaign adapter. Every other brand uses the approved knowledge package for this page. If required brand evidence is missing, we keep the page as a draft and show the exact item that needs attention.

6Poster lookSave looks for your posters, or let the AI choose the whole style.Visual guidance already in your Knowledge is saved first as looks 1, 2, 3, tagged From Knowledge; the AI chat then creates the next ones. Each new campaign takes the next look that is switched on, in order, then starts again from the first. The page colour theme only styles this dashboard and never colours posters.Waiting for step 5

A look describes mood, colours and imagery in plain words, and can also fix the layout, the headline lettering and the logo corner.

Tick this to leave any layout, lettering or logo corner open. The AI then chooses them for each story, so posters can differ from one another while keeping the look's mood, colours and imagery. Leave it unticked if you want to fix those yourself.

Keep at least one look switched on, or tick the box to let the AI choose. Looks that are off are skipped by the rotation.

7Page UI themeOptional: the colours this page uses in the dashboard.This only changes how this page looks in the admin dashboard, so you can tell pages apart. It never changes posters or published content.Optional
Page colour theme

Give this page its own dashboard colours. Pick a ready-made palette or fine-tune the hex values yourself. It never colours posters.

Optional. Every page already has a theme, so this never blocks publishing.

8SchedulersShare the one news sweep, then choose this page’s editorial and publishing times.Think of this as one shared newspaper delivery followed by two page-specific alarm clocks. The shared sweep collects each publisher once for every page. You only choose when this page builds a campaign and handles approved publishing; the system checks those times do not clash.Waiting for step 7

Save a page first. Each run must stay at least one hour away from every other page.

Pausing stops this page’s editorial and publishing runs without stopping the shared news sweep. The page and its history stay put.

The shared news sweep must be live; this page’s editorial and publishing schedules must be enabled, complete and conflict-free.

9Review and publish pageWe test one campaign first. The page stays a draft until your review and the temporary publishing test both pass.This is the final rehearsal. We prepare a campaign for your review, schedule and check a temporary post, remove it, then make the page live only after every check passes.Waiting for required sections
Developer fallbackInstall brands and regions

Most admins should not need this section. Use it to install reusable identity primitives; provider credentials are never entered here.

Set up with AI

Tell me about this page

Two quick answers, then I will ask a few short questions. Nothing is saved until you confirm.

Poster look with AI

How should your posters look?

Any visual guidance in your Knowledge is saved first as the earlier looks. This chat then creates the next one, clearly different, by asking a few short questions about the feel, colours, layout and logo. Nothing new is saved until you confirm.

Page setup

Preparing workflow…

    Your workflow is being prepared.

    Allow up to an hour for your review and the temporary Buffer publishing test.

    You may close this small window. The test runs in the background and its latest status remains on this Configuration page. New content still requires human review before public release.