← All guides

Connecting your content sources

Point Squawk at where your content already lives, and it pulls new material in on a schedule.

Uploading files by hand works, but it stops the moment you forget to do it. A content source is the other way in: connect a channel, a folder, or a feed once, and Squawk checks it on a schedule and pulls new material into your library automatically. You never re-upload a blog post or a video transcript again.

Add a source

Go to Content Sources and click Add Source. The picker offers:

  • Your website. One address. Squawk finds the feed or sitemap and imports your posts and pages.
  • YouTube channel. Videos and their transcripts, on a read-only connection.
  • Google Drive folder. Docs, Slides, PDFs, Word, and PowerPoint from one folder.
  • Confluence space. Pages from one Confluence space, on a read-only connection.
  • Blog or RSS feed. Pull new posts from an RSS or Atom feed.
  • Documentation site. Crawl a docs site or sitemap for pages.
  • News monitoring. Track a news feed and score items by your keywords.
  • Media feed. A feed of images or video to pull into the library.

If what you need isn't listed, the dialog has an email link to hello@squawkitout.ai with the subject "Source connector request." That's the real path for asking for a new connector.

Your website

Click Your website, then enter a Website address starting with https://, like https://yourcompany.com. Squawk looks for your site's feed or sitemap, imports your posts and pages, and keeps checking for new ones. Public pages only, no login needed. Set Check for new content to Daily, Every 3 days, or Weekly, then click Add website. The first import starts within a few minutes.

YouTube channel

Click YouTube channel and then Connect Google (read-only). That opens Google's authorization screen; approve it and you land back in Squawk with a channel picker. Choose the Channel, optionally set Whose voice is this? if the content should be attributed to a specific expert, pick how often Squawk should check for new content (every hour, every 6 hours, once a day, or once a week), and click Connect channel. The dialog is explicit that this is read-only access to one channel, and you can disconnect anytime.

Google Drive folder

Click Google Drive folder, then Connect Google Drive (read-only) to authorize. Once connected, click Choose a Drive folder, which opens Google's folder picker. Pick one folder: Squawk reads its Docs, Slides, PDFs, Word, and PowerPoint files into your library. Set the voice and sync frequency the same way as YouTube, then confirm.

Confluence space

Click Confluence space, then Connect Confluence (read-only). After authorizing, pick a Site, then a Space, then optionally a Section to narrow it to part of the space instead of the whole thing. Set the voice and sync frequency, then click Connect space. You can come back later and click Change space on the source's detail page to point it at a different space without disconnecting Confluence entirely.

Feeds: blog/RSS, docs, news, media

These four use the same simple form. Pick the type, give the source a Source name (for example "Company Blog"), paste the Feed URL or Site or sitemap URL, and click Connect.

The source detail page

Click into any source from the Content Sources list to see three tabs:

  • Overview. Edit the source's Name inline, change Check for new content (where applicable), and see Status, Last sync, Next sync, Items imported, and the Source URL. There's a toggle to enable or disable the source, and a Sync now button that runs an import immediately (not shown for inbound-email sources, which sync differently).
  • Imported items. Everything this source has pulled in, with title, date, media type, and review status. Click through to open any item in the library.
  • Sync history. A log of past runs, each with a status (success, partial, failed, or running) and counts for discovered, created, skipped, and failed items. Failed runs show the error message.

Forwarding addresses

Below the source list, an accordion called Forwarding addresses ("Forward email straight into your library") lists a unique inbound email address for you and for each expert voice on the team. Forward anything to that address and it lands in the library as a source in its own right, tagged as Forwarded email.

Editing and disconnecting

To rename a source or change how often it checks for new content, open it and edit the fields on the Overview tab; changes save as you go. Toggling a source off pauses its syncing without deleting anything already imported. To remove a source entirely, use Delete on the source detail page. You'll be asked to confirm, and there's a checkbox: "Also remove the content this source imported (keeps anything used in a post or campaign)." Leave it unchecked to keep everything already pulled in; check it to clean up the imported items along with the source, short of anything already attached to a post or campaign.

What happens after import

Imported items land in your library the same as anything you upload by hand, and they need approving before campaigns will draft from them. See Your content library for how approval works.