> ## Documentation Index
> Fetch the complete documentation index at: https://social-b97141fb-auto-generate-llmstxt.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting Started

> Step-by-step guide to accessing and setting up your social.plus Console for the first time

Get up and running with your social.plus Console in minutes. This guide covers everything you need to know for initial setup and basic configuration.

## Prerequisites

Before accessing your console, ensure you have:

* An active [social.plus Portal](https://portal.amity.co) account
* At least one social.plus application created in your portal
* Administrative access to your organization's social.plus account

## Accessing Your Console

<Steps>
  <Step title="Login to social.plus Portal">
    Navigate to [portal.amity.co](https://portal.amity.co) and sign in with your credentials.
  </Step>

  <Step title="Select Your Application">
    From the "My Applications" screen, locate the application you want to manage.
  </Step>

  <Step title="Open Console">
    Click the "**Go to Console**" button for your selected application. This will open the social.plus Console in a new tab.
  </Step>

  <Step title="Verify Access">
    You should now see the console dashboard with your application's data and management tools.
  </Step>
</Steps>

<Warning>
  **Already a portal admin but the Console says "no permission"?** Portal and Console use separate permissions. Only a portal **Super Admin** gets Console access automatically; everyone else starts with no Console role, so **Go to Console** shows a no-permission screen.

  A portal **Super Admin** or an existing Console admin must assign you a Console role first. See [Grant first-time access to a portal admin](/analytics-and-moderation/console/management/admin-access-control#grant-first-time-access-to-a-portal-admin).
</Warning>

## Initial Setup Checklist

### **1. Get Your API Key**

Your API key is essential for SDK integration and API access.

<Steps>
  <Step title="Navigate to Settings">
    In the console, go to **Settings** → **Security**
  </Step>

  <Step title="Copy API Key">
    Locate and copy your API key for use in your application
  </Step>

  <Step title="Secure Storage">
    Store your API key securely - never expose it in client-side code
  </Step>
</Steps>

### **2. Configure Basic Moderation**

Set up essential moderation rules to keep your community safe.

<Steps>
  <Step title="Access Moderation Settings">
    Navigate to **Moderation** → **AI Content Moderation**
  </Step>

  <Step title="Enable AI Moderation">
    Turn on automated content filtering for text, images, and videos
  </Step>

  <Step title="Set Confidence Levels">
    Configure AI confidence thresholds for different types of content
  </Step>

  <Step title="Create Keyword Filters">
    Add custom blocked words and phrases specific to your community
  </Step>
</Steps>

### **3. Set Up User Roles**

Configure user roles and permissions for your moderation team.

<Steps>
  <Step title="Review Default Roles">
    Understand the built-in roles: None, Moderator, Super-Moderator, Global-Admin
  </Step>

  <Step title="Assign Moderators">
    Promote trusted users to moderator roles through **User Management**
  </Step>

  <Step title="Configure Permissions">
    Review and adjust permissions for each role level
  </Step>
</Steps>

### **4. Configure Notifications**

Set up push notifications and alerts for your application.

<Steps>
  <Step title="Upload Certificates">
    Add your iOS and Android push notification certificates in **Settings** → **Push Notifications**
  </Step>

  <Step title="Test Notifications">
    Send test notifications to verify your configuration
  </Step>

  <Step title="Set Up Webhooks">
    Configure webhooks for real-time event handling in **Settings** → **Webhooks**
  </Step>
</Steps>

## Understanding the Dashboard

### **Main Navigation**

The console is organized into several key sections:

<AccordionGroup>
  <Accordion title="Social Management">
    * **Communities**: Manage community spaces and membership
    * **Posts**: Review and moderate user posts
    * **Comments**: Handle comment moderation and threading
    * **Users**: User account management and analytics
  </Accordion>

  <Accordion title="Chat Management">
    * **Channels**: Moderate chat channels and conversations
    * **Messages**: Review chat messages and handle reports
    * **Members**: Manage channel membership and permissions
  </Accordion>

  <Accordion title="Content Moderation">
    * **AI Moderation**: Configure automated content filtering
    * **Review Queue**: Process manually flagged content
    * **Reports**: View moderation activity and statistics
  </Accordion>

  <Accordion title="Settings">
    * **Security**: API keys, server keys, and authentication
    * **Push Notifications**: Certificate management and testing
    * **Webhooks**: Real-time event configuration
    * **Admin Users**: Team member management and permissions
  </Accordion>
</AccordionGroup>

### **Key Metrics Dashboard**

Your dashboard shows important metrics at a glance:

* **Active Users**: Current online users and recent activity
* **Content Statistics**: New posts, comments, and messages
* **Moderation Alerts**: Pending reviews and flagged content
* **System Health**: API usage and performance indicators

## Common First Tasks

<Tip>
  **Start Simple**: Begin with basic moderation settings and gradually add more sophisticated rules as you understand your community's needs.
</Tip>

### **Review Existing Content**

1. Check the **Social Management** section for any existing posts or comments
2. Review user activity and identify any immediate moderation needs
3. Set up basic content filtering rules if needed

### **Configure Moderation Team**

1. Identify trusted users who should have moderator privileges
2. Assign appropriate roles through **User Management**
3. Set up moderation workflows and escalation procedures

### **Test Integration**

1. Verify your API key works with a simple SDK integration
2. Test push notifications with your mobile applications
3. Confirm webhook events are being received correctly

## Next Steps

Once you've completed the initial setup:

<CardGroup cols={2}>
  <Card title="Explore Moderation" icon="shield" href="/analytics-and-moderation/console/moderation/overview">
    Learn advanced content moderation techniques and workflows
  </Card>

  <Card title="Review Analytics" icon="chart-line" href="/analytics-and-moderation/console/analytics/overview">
    Understand your community metrics and engagement patterns
  </Card>

  <Card title="Configure Settings" icon="cog" href="/analytics-and-moderation/console/settings">
    Dive deeper into security, notifications, and integrations
  </Card>

  <Card title="Use APIs" icon="code" href="/analytics-and-moderation/social+-apis-and-services/README">
    Implement programmatic administration with social.plus APIs
  </Card>
</CardGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Can't Access Console">
    * Verify you're logged into the correct social.plus Portal account
    * Ensure you have admin permissions for the application
    * Check that your application is active and properly configured
  </Accordion>

  <Accordion title="API Key Not Working">
    * Confirm you're using the correct API key for your environment
    * Verify the key hasn't been regenerated or revoked
    * Check that you're using the right regional endpoint
  </Accordion>

  <Accordion title="Notifications Not Working">
    * Verify push certificates are valid and properly uploaded
    * Check that your application bundle IDs match your certificates
    * Test with a simple notification to isolate the issue
  </Accordion>
</AccordionGroup>

<Warning>
  **Security Note**: Never share your API keys or admin credentials. Regularly review and rotate keys as needed for security.
</Warning>