docs: add FAQ for "BigQuery Streaming Insert Not Allowed in Free Tier" error

[SangeetaMishr]

Summary

Fixes #323

Adds a new FAQ page explaining the Access Denied: BigQuery Streaming Insert not allowed in the free tier error reported on Discord:

• Why it happens: BigQuery's free tier covers storage/queries, but streaming inserts (how Glific writes messages/contacts into BigQuery in real time) require the Google Cloud project to have an upgraded or linked billing account — regardless of whether usage stays within free-tier limits.
• How to fix it: steps to upgrade the free trial / link a billing account in Google Cloud Console for the project connected to Glific.
• Reassurance that this doesn't mean immediate charges — the existing free-tier limits (10GB storage, 1TB queries/month) documented in "BigQuery Setup and link with Glific" still apply.

Cross-links to the existing BigQuery Setup and link with Glific page rather than duplicating its content.

Verification

Confirmed the underlying cause against Google Cloud's documented behavior: streaming inserts (tabledata.insertAll) are blocked until a project's Cloud Billing account is upgraded past the free trial / linked, even when actual usage is within free-tier limits.

Test plan

• Docs site renders the new FAQ page and shows up under the FAQ section (auto-generated index, no _category_.json changes needed)
• Reviewer confirms the fix steps match current Google Cloud Console UI

Summary by CodeRabbit

• Documentation
  • Added a new FAQ page explaining the “BigQuery Streaming Insert Not Allowed in Free Tier” error.
  • Clarified common causes, including missing billing setup and free-trial limitations.
  • Included step-by-step guidance for linking or upgrading billing so syncing can resume.
  • Noted that enabling billing does not necessarily mean immediate charges unless usage exceeds free-tier limits.

[coderabbitai]

Warning

Review limit reached

@SangeetaMishr, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 45 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: 74b33ad1-d1f6-4524-a262-124e70233c75

📥 Commits

Reviewing files that changed from the base of the PR and between fe5abd8 and d696b81.

📒 Files selected for processing (1)

• docs/8. FAQ/Fixing BigQuery Streaming Insert Not Allowed in Free Tier Error.md

📝 Walkthrough

Walkthrough

A new FAQ documentation page was added to explain the "Access Denied: BigQuery Streaming Insert Not Allowed in Free Tier" error encountered during Glific BigQuery syncing. The document outlines the cause of the error, common triggering scenarios such as missing billing links or an active free trial, and provides step-by-step remediation instructions via Google Cloud Console, along with a note clarifying that linking billing does not automatically incur charges unless free-tier limits are exceeded.

Changes

Area	Change
Documentation	Added new FAQ page "Fixing BigQuery Streaming Insert Not Allowed in Free Tier Error.md" covering error cause, scenarios, and resolution steps

Sequence Diagram(s)

Not applicable — this change is a documentation-only addition with no code execution flow.

Estimated code review effort: 1 (Low)

Related issues: None specified

Related PRs: None specified

Suggested labels: documentation

Suggested reviewers: None specified

Poem

A rabbit hops through billing's maze,
Streaming inserts blocked, a free-tier haze,
Now docs explain the fix with cheer,
Link your billing, banish the fear,
Hop along, the error's clear! 🐇📄

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title is concise and accurately summarizes the new FAQ about the BigQuery free-tier streaming insert error.
Description check	✅ Passed	The description is clearly related to the docs change and explains the FAQ, fix steps, and context.
Linked Issues check	✅ Passed	The FAQ covers the error cause and the billing upgrade/auto payment fix required by issue #323.
Out of Scope Changes check	✅ Passed	The changes stay within the documentation scope and add no unrelated code or features.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[github-actions]

🚀 Deployed on https://deploy-preview-643--glific-docs.netlify.app

[Fawas003]

do you think it's better to add screenshot for 3rd point? @SangeetaMishr

[Fawas003]

Is it mandatory to add a credit card as the payment method? I'm not sure, I think I heard that in one of the meetings.
@SangeetaMishr