docs: improve confluence docs (#5049)

## Describe the problem and your solution

- Improve confluence docs and other minor cleanups.

<!-- Issue ticket number and link (if applicable) -->

<!-- Testing instructions (skip if just adding/editing providers) -->

<!-- Summary by @propel-code-bot -->

---

**Refined Confluence integration docs and added OAuth token guidance**

Restructures the Confluence integration documentation into a tabbed
layout that emphasizes quickstart steps, OAuth setup, and refreshed
guidance on `connectionConfig.cloudId`, including the new
`read:page:confluence` scope and a clearer explanation of multi-site
domain handling. Adds a Facebook OAuth note about 60-day token expiry,
updates the companion setup guide, and replaces the
`packages/webapp/public/images/template-logos/apollo.svg` asset with a
higher-contrast yellow version.

<details>
<summary><strong>Key Changes</strong></summary>

• Overhauled `docs/integrations/all/confluence.mdx` to a tabbed
quickstart with updated sample requests and expanded `cloudId`/domain
selection guidance.
• Simplified
`docs/api-integrations/confluence/how-to-register-your-own-confluence-api-oauth-app.mdx`
by removing the prerequisites table and clarifying scope selection and
multi-site behavior.
• Documented Facebook token refresh limitations in
`docs/api-integrations/facebook/how-to-register-your-own-facebook-api-oauth-app.mdx`
and `docs/integrations/all/facebook.mdx`.
• Swapped `packages/webapp/public/images/template-logos/apollo.svg` for
a yellow variant to improve visibility.

</details>

<details>
<summary><strong>Affected Areas</strong></summary>

• docs/integrations/all/confluence.mdx
•
docs/api-integrations/confluence/how-to-register-your-own-confluence-api-oauth-app.mdx
•
docs/api-integrations/facebook/how-to-register-your-own-facebook-api-oauth-app.mdx
• docs/integrations/all/facebook.mdx
• packages/webapp/public/images/template-logos/apollo.svg

</details>

---
*This summary was automatically generated by @propel-code-bot*

Author: hassan254-prog

docs/api-integrations/apollo/form.png

@@ -6,20 +6,6 @@ description: 'Register an OAuth app with Confluence and obtain credentials to co
 
 This guide shows you how to register your own app with Confluence (Atlassian) to obtain your OAuth credentials (client id & secret). These are required to let your users grant your app access to their Confluence account.
 
-## Access requirements
-
-Free Atlassian developer account available - no paid account required. App review is only required if you want to list your app on the Atlassian Marketplace.
-
-| Pre-Requisites | Status | Comment|
-| - | - | - |
-| Paid dev account | ✅ Not required | Free, self-signup for an [Atlassian developer account](https://developer.atlassian.com/). |
-| Paid test account | ✅ Not required | Free Confluence Cloud instance can be used for testing. |
-| Partnership | ✅ Not required | |
-| App review | ⚠️ Conditional | Required only if you want to list your app on the Atlassian Marketplace. |
-| Security audit | ✅ Not required | |
-
-## Setup guide
-
 <Steps>
   <Step title="Create an Atlassian developer account">
     If you don't already have one, sign up for an [Atlassian developer account](https://id.atlassian.com/signup/).
@@ -46,6 +32,7 @@ Free Atlassian developer account available - no paid account required. App revie
        - `write:confluence-content` - Create and update content
        - `delete:confluence-content` - Delete content
        - `manage:confluence-configuration` - Manage Confluence instance settings
+       - `read:page:confluence` - Read Confluence pages
        - `offline_access` - Get refresh tokens (required for long-term access)
     4. Click **Save** to save your changes.
   </Step>
@@ -75,10 +62,18 @@ When working with the Confluence API through Nango, keep these important points
 To allow the possibility of refreshing the token, you must add `offline_access` to your scopes when creating the integration on the Nango UI.
 
 **Cloud ID and domain configuration:**
+A single Confluence OAuth token can be valid for multiple Atlassian sites. For example, the same token might grant access to both "nango-hq.atlassian.net" and "nango-test.atlassian.net". This is why specifying the `domain` during connection creation is important if you need to connect to a specific site.
+
 When connecting to Confluence, you have two options for specifying which Confluence site to connect to:
 1. Provide a `domain` during connection creation (recommended): This ensures you connect to the specific Confluence site you want.
 2. Let Nango auto-select the first available site (legacy behavior): If no baseUrl is specified, Nango will use the first site from the accessible resources api.
 
+The connection process works as follows:
+1. Nango fetches all accessible sites for the OAuth token
+2. If you specified a `domain`, Nango finds the matching site and sets its `cloudId`
+3. If no `domain` is specified, Nango uses the first available site and sets its `cloudId`
+4. The selected site's `cloudId` and `domain` are stored in the connection configuration
+
 You will need to fetch your Cloud ID to be able to make API requests to the Confluence API. You can do this with the proxy by calling:
 
 ```ts

docs/api-integrations/confluence/how-to-register-your-own-confluence-api-oauth-app.mdx

@@ -44,3 +44,7 @@ This guide shows you how to register your own app with Facebook to obtain your O
 </Steps>
 
 For more details, see [Facebook's OAuth documentation](https://developers.facebook.com/docs/facebook-login/guides/advanced/manual-flow#confirm) and [how to create an application](https://developers.facebook.com/docs/development/create-an-app/).
+
+## Important notes for Facebook API
+
+- Facebook tokens expire after 60 days and cannot be refreshed. Once a token expires, users must re-authenticate by [re-authorizing the connection](/implementation-guides/api-auth/implement-api-auth#6-re-authorize-an-existing-connection).

docs/api-integrations/facebook/how-to-register-your-own-facebook-api-oauth-app.mdx

@@ -120,7 +120,7 @@ import { StatusWidget } from "/snippets/api-down-watch/status-widget.jsx"
     <Note>Contribute useful links by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/facebook.mdx)</Note>
   </Tab>
   <Tab title="🚨 API gotchas">
-    _No reported gotchas._
+    - Facebook tokens expire after 60 days and cannot be refreshed. Once a token expires, users must re-authenticate by [re-authorizing the connection](/implementation-guides/api-auth/implement-api-auth#6-re-authorize-an-existing-connection).
 
     <Note>Contribute API gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/facebook.mdx)</Note>
   </Tab>