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
| Topic | Details |
|---|---|
| Who can connect | Admins |
| What you need | A Zernio API key with permission set to Read |
| What Gurusup reads | The areas you choose: posts and blogs, performance, reviews, comments and ads |
| How changes arrive | Posts, performance, reviews and comments every 6 hours. Blog articles and ads every day. |
| Past content | Import history, from last week to last year |
| Knowledge access | Default 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:
| Area | Key group it needs |
|---|---|
| Every connection | accounts |
| Posts and blogs | publishing |
| Performance | analytics |
| Reviews and Comments | engagement |
| Ads | ads |
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
| Area | On by default | What it covers |
|---|---|---|
| Posts and blogs | Yes | Posts, their publishing status, and blog articles |
| Performance | Yes | Post analytics and performance metrics |
| Reviews | Yes | Reviews from Facebook and Google Business Profile |
| Comments | No | The top comments on each post |
| Ads | Yes | Ad 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
| Area | Document | What it holds |
|---|---|---|
| Posts and blogs | One per post | Content, the networks it went to with account, status, publish date and link, its dates, hashtags, mentions, tags and visibility |
| Posts and blogs | One per blog article | Title, text and address. Articles come from Shopify and WordPress accounts connected in Zernio. |
| Performance | Added to the post's document | The latest metrics, leaving out counters that are zero |
| Reviews | One per review | Text, rating, location, account, reviewer's name, reply and date |
| Comments | Added to the post's document | Up to 10 top comments per connected account, with author and text |
| Ads | One per campaign | Name, performance summary, and its ads with their status |
How changes arrive
| Event | What Gurusup does |
|---|---|
| You make a post after connecting | Reads it at the next check. A post scheduled for later comes in when it goes out. |
| You edit a post Gurusup already holds | Updates its document |
| A post was made before you connected | Not read, even if it goes out afterwards. Use Import history. |
| New metrics arrive | Refreshes posts Gurusup holds. Never brings in an older post. |
| A review, comment or blog article is new | Reads it at the next check. A new comment updates its post, old or new. |
| A campaign starts, or gets a new ad | Reads it at the next daily check |
| Something is deleted in Zernio | Withdraws 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 access | Who reads it in Brain |
|---|---|
| Default access | Everyone, according to what they are already allowed to see: admins every category, members and agent accounts the categories an admin granted them. |
| Restricted | Only the people you pick. Administrators are not included unless you pick them. |
| Private | Only 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:
| Message | What 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 arriving | What to do |
|---|---|
| The badge reads Needs reconnect | See Reconnect. |
| An area is unticked | Tick it again under Content. |
| The key is limited to some profiles | Gurusup reads only those profiles. |
| The post is older than the connection | Use Import history. |
| Ingestion paused, Demo Mode, or the item Paused on Ingest | See Connector troubleshooting. |
Still stuck? Contact support with the post's title and when it was published.