ConnectorsZernio

Connect Zernio

Connect Zernio with a Read API key, choose which posts, reviews and ads Gurusup reads, bring in past content, and fix a key that lacks a permission.

Admins only. Gurusup learns your social posts, blog articles, reviews and ad campaigns from Zernio, so you can ask "Which posts about the launch drew the most engagement, and what did prospects ask afterwards?" and get the posts joined with your support and CRM conversations. Gurusup only reads Zernio and adds nothing there.

At a glance

TopicDetails
Who can connectAdmins
What you needA Zernio API key with permission set to Read
What Gurusup readsThe areas you choose: posts and blogs, performance, reviews, comments and ads
How changes arrivePosts, performance, reviews and comments every 6 hours. Blog articles and ads every day.
Past contentImport history, from last week to last year
Knowledge accessDefault access, Restricted or Private. See Who can read it.

Before you start

  • You are an admin in Gurusup.
  • In Zernio, you can open Settings and create an API key.
  • Zernio takes one connection per Zernio account in each Gurusup organization.
  • Zernio MCP, a toolkit that lets agents act in Zernio, is a different app. This page is about the connector that reads.

The key and its permissions

Create the key with permission set to Read, and turn off messages, contacts, telephony, commerce and billing. You can also limit the key to selected profiles: Gurusup then reads only those. The key must reach the groups each area you tick needs:

AreaKey group it needs
Every connectionaccounts
Posts and blogspublishing
Performanceanalytics
Reviews and Commentsengagement
Adsads

Gurusup also checks whether the key could read messages, contacts and telephony, only to warn you. It keeps nothing from them.

Connect Zernio

Open the Zernio connector

In the sidebar, open Sources, then Catalog, find Zernio (use Search sources if you need to) and click Connect on its row. Its page opens. Next to Organization accounts, click Connect for the organization. The dialog Connect Zernio for the organization opens.

Choose who can read it

In the dialog, under Who can read it, keep Default access, or choose Restricted or Private from Access mode and pick the people.

Create the key

In the dialog, click Show steps below the fields and follow them to create a Read key in Zernio and copy it.

Paste it and choose what to read

Paste the key in API key (the hint reads "Starts with zrk_ or sk_"). Tick the areas Gurusup may read, see What you choose. Gurusup says "Checking the Zernio API key…" and then shows "Zernio account", the number of profiles and connected accounts, and a check or a cross for each group the ticked areas need.

Connect

Connect stays off until every needed group has a check. Click Connect. A message says "Zernio connected."

What you choose

AreaOn by defaultWhat it covers
Posts and blogsYesPosts, their publishing status, and blog articles
PerformanceYesPost analytics and performance metrics
ReviewsYesReviews from Facebook and Google Business Profile
CommentsNoThe top comments on each post
AdsYesAd campaigns and their performance summaries

To change this later, open the Zernio page and tick or untick the areas under Content. Each change saves at once, and a message says "Zernio reading choices saved." Unticking an area withdraws what it brought in, and ticking it again brings it back.

What Gurusup reads

AreaDocumentWhat it holds
Posts and blogsOne per postContent, the networks it went to with account, status, publish date and link, its dates, hashtags, mentions, tags and visibility
Posts and blogsOne per blog articleTitle, text and address. Articles come from Shopify and WordPress accounts connected in Zernio.
PerformanceAdded to the post's documentThe latest metrics, leaving out counters that are zero
ReviewsOne per reviewText, rating, location, account, reviewer's name, reply and date
CommentsAdded to the post's documentUp to 10 top comments per connected account, with author and text
AdsOne per campaignName, performance summary, and its ads with their status

How changes arrive

EventWhat Gurusup does
You make a post after connectingReads it at the next check. A post scheduled for later comes in when it goes out.
You edit a post Gurusup already holdsUpdates its document
A post was made before you connectedNot read, even if it goes out afterwards. Use Import history.
New metrics arriveRefreshes posts Gurusup holds. Never brings in an older post.
A review, comment or blog article is newReads it at the next check. A new comment updates its post, old or new.
A campaign starts, or gets a new adReads it at the next daily check
Something is deleted in ZernioWithdraws it: what Gurusup learned only from it leaves, and anything other sources also back stays

Follow each document on Follow ingestion. When you connect, only new content comes in. The History section says "Only new content comes in until you import past content."

Import past work

Open Import history

On Sources, open the Zernio page. Under History, click Import history.

Pick how far back

Pick Last week, Last month, Last 3 months, Last 6 months or Last year. Gurusup counts the posts in that window, showing 500+ when there are more, and shows what the import would use out of what you have left this month, in euros.

Import

Click Import. Each ticked area reads the window once, and the import is done when every area has. The row then reads, for example, "Imported the last month".

If an area keeps failing for a day, the import ends as failed: the row says "The import didn't finish. Try again, and contact support if it keeps failing." and the button reads Try again. A window you already imported shows "Already imported", and you can pick a longer one. See Import history.

Who can read it

Zernio is one source.

Knowledge accessWho reads it in Brain
Default accessEveryone, according to what they are already allowed to see: admins every category, members and agent accounts the categories an admin granted them.
RestrictedOnly the people you pick. Administrators are not included unless you pick them.
PrivateOnly you. Administrators are not included.

Set it when you connect and it applies before Gurusup reads anything. To change it later, open the Zernio page and change Access mode under Knowledge access; it saves as soon as you change it. What Gurusup already learned keeps the access it had. See Restrict a source to specific people.

Check that it worked

Check the badge

On Sources, open the Zernio page. Under Organization accounts, the badge reads Connected.

Publish a post

Publish a short post in Zernio.

Follow it

Open Ingest and pick the Zernio source in the filter. The post moves to Learned within about 6 hours.

Reconnect

If Zernio stops accepting the key, the connection shows Needs reconnect. Click Reconnect on the account's row under Organization accounts.

Create a new Read key, paste it in the Reconnect dialog and click Reconnect. Your areas and Knowledge access stay, and the dialog shows only the key. A key from another Zernio account is refused.

Disconnect

On Sources, open the Zernio page. Under Danger zone, open the menu on Disconnect, choose Disconnect and confirm. Gurusup deletes the key it stored and what it learned stays. Gurusup added nothing in Zernio, so there is nothing to remove there, and the key stays valid until you delete it in Zernio. See Remove, disconnect and what stays.

If it does not work

These show under the key while Gurusup reads it, or after "Could not connect Zernio." when you click Connect:

MessageWhat to do
"Zernio didn't accept this API key. Create a Read key in Zernio and paste it here."Create a Read key and paste it.
"This key needs read access to accounts, publishing. Update its permissions in Zernio or turn off those areas." (it names only the missing groups)Give the key those groups in Zernio, or untick the areas that need them.
"This Zernio key needs read access to accounts, publishing. Update its permissions or turn off those areas." (same, after you click Connect)Same.
"This key can also read messages, contacts. Gurusup never reads them; you can disable those groups on the key in Zernio." (a notice, not an error)Optional. Disable those groups on the key.
"This key belongs to a different Zernio account. Use the key from the connection you're reconnecting."Reconnect with a key of the same account.
"We couldn't read this Zernio account because of a problem on our side. Nothing was connected. Contact support for help."Contact support.
"We couldn't finish connecting Zernio because of a problem on our side. Your existing sources are safe; contact support for help."Contact support.
"We couldn't connect Zernio because of a problem on our side. Nothing was connected. Contact support for help."Contact support.
"We couldn't save these Zernio reading choices because of a problem on our side. Your current choices are safe; contact support for help."Your choices are unchanged. Try again, then contact support.
"Zernio connection was not found. Refresh the page and try again."Refresh the page.
Content stops arrivingWhat to do
The badge reads Needs reconnectSee Reconnect.
An area is untickedTick it again under Content.
The key is limited to some profilesGurusup reads only those profiles.
The post is older than the connectionUse Import history.
Ingestion paused, Demo Mode, or the item Paused on IngestSee Connector troubleshooting.

Still stuck? Contact support with the post's title and when it was published.