Settings

Centralized configuration for your SkyLight Chat workspace. Manage account details, API access, integrations, and support from one place.

Purpose

The Settings area lets you:

• Configure your workspace — company name, timezone, country.
• Manage media — upload, organize, and delete images and videos.
• Generate API keys — create keys for programmatic access.
• Whitelist domains — restrict API and widget access to trusted origins.
• Set up webhooks — receive real-time event notifications.
• Contact support — create and manage support tickets.

Who can access

General settings

Configuring your workspace

1. Go to Settings → General.
2. Update:
   • Company Name — displayed in the dashboard and reports.
   • Address — business address (optional).
   • Timezone — affects scheduling, reports, and timestamps.
   • Country — determines locale defaults.
3. Click Save.

Field reference

Media Manager

Purpose

Store images and videos for use in campaigns, templates, knowledge base, and AI agent responses.

Uploading media

1. Go to Settings → Media Manager.
2. Click Upload or drag-and-drop files.
3. Supported formats:
   • Images: JPG, JPEG, PNG, GIF (max 50 MB)
   • Videos: MP4, AVI, MOV, WMV, FLV, WEBM (max 50 MB)
4. Files appear in the media grid immediately.

Managing media

Searching and filtering

• Search by filename or display name.
• Filter by type: All, Images, Videos.

Field reference

API Keys

Purpose

API keys authenticate requests to the SkyLight Chat REST API. Generate keys for integrations, automation, and third-party apps.

Generating a key

1. Go to Settings → API Keys.
2. Click + Generate Key.
3. Enter a Name (e.g., Production Backend, Zapier Integration).
4. Click Create.
5. Copy the key immediately — it's shown only once.

Managing keys

Security best practices

• Never share keys publicly — don't commit them to source control.
• Rotate keys periodically — revoke old keys and generate new ones.
• Use environment variables — store keys in secure configuration.
• Whitelist domains — restrict key usage to trusted origins.

Domain Whitelist

Purpose

Restrict API requests and widget embedding to specific domains. Requests from non-whitelisted origins are rejected.

Adding a domain

1. Go to Settings → Domain Whitelist.
2. Click + Add Domain.
3. Enter the domain (e.g., yourdomain.com, app.yourdomain.com).
4. Click Add.

Managing domains

Wildcard support

• Use *.yourdomain.com to allow all subdomains.
• Wildcards apply to subdomains only, not paths.

When to use

• Web Chat widget — ensure the widget only loads on your sites.
• API calls from browsers — prevent unauthorized frontend usage.
• Partner integrations — whitelist partner domains.

Webhooks

Purpose

Receive real-time HTTP notifications when events occur in your SkyLight Chat account.

Creating a webhook

1. Go to Settings → Webhooks.
2. Click + Create Webhook.
3. Enter:
   • Name — descriptive label (e.g., Order Notifications).
   • URL — your HTTPS endpoint.
   • Events — select which events to subscribe to.
4. Click Create.
5. Copy the secret — used to verify webhook signatures.

Available events

Managing webhooks

Delivery logs

Signature verification

Each webhook includes an X-SkyLight-Signature header. Verify it using HMAC-SHA256 with your webhook secret. See Webhook Security for implementation details.

Regenerating the secret

1. Open the webhook.
2. Click Regenerate Secret.
3. Copy the new secret immediately.
4. Update your server to use the new secret.

Support Tickets

Purpose

Contact SkyLight Chat support directly from your dashboard. Track issues, ask questions, and receive responses without leaving the app.

Creating a ticket

1. Go to Settings → Tickets.
2. Click + New Ticket.
3. Fill in:
   • Subject — brief description of the issue.
   • Body — detailed explanation.
   • Priority — Low, Medium, High.
   • Department — Billing, Technical Support, Sales (if applicable).
4. Click Submit.

Viewing tickets

Replying to a ticket

1. Open the ticket.
2. Read the conversation history.
3. Type your reply in the input field.
4. Click Send.

Replying to an answered ticket reopens it to open.

Closing a ticket

1. Open the ticket.
2. Click Close Ticket.
3. Confirm.

Closed tickets cannot receive further replies.

Ticket statuses

Connections to other areas

Limits and plan behavior

Troubleshooting

Related articles

• Account API — programmatic account management
• Media API — upload and manage media via API
• Webhooks Guide — detailed webhook implementation
• Webhooks API — manage webhooks via API
• Tickets API — create and manage tickets via API