Developer App Setup

Before KronChat can receive messages from social channels (Instagram DM, Facebook Messenger, WhatsApp, TikTok), an administrator must create developer apps on each platform and paste the credentials into KronGage. This is a one-time setup per workspace.

---

Your Tenant URL

Every KronGage workspace has a unique subdomain:

https://[your-tenant].krongage.io

For example: https://test.krongage.io

Use your tenant URL — not web.krongage.io — when registering redirect URIs and webhook URLs in every developer portal. If you use the wrong domain, OAuth callbacks and incoming message webhooks will silently fail.

---

Where to Enter Credentials

Once you have app credentials from a developer portal, go to:

KronGage → Settings → KronChat Social Apps

This section has four sub-panels: Instagram Inbox App, Meta App Credentials (WhatsApp), Facebook / Messenger App Credentials, and TikTok App Credentials.

This section is separate from Social Publishing API Keys, which controls the Socials posting module.

---

Meta — Instagram DM Inbox

Instagram DM conversations are received via a Meta app webhook.

1. Create the Meta App

1. Go to developers.facebook.com → My Apps → Create App
2. Choose Business as the app type
3. Under Add Products, add Instagram Graph API and Webhooks

2. Configure OAuth Redirect URIs

In Facebook Login for Business → Settings, add these Valid OAuth Redirect URIs:

https://[your-tenant].krongage.io/integrations/social/instagram
https://[your-tenant].krongage.io/instagram/callback

3. Configure the Webhook

In Webhooks → Instagram, click Subscribe:

Subscribe to these fields: messages, messaging_postbacks, message_deliveries, message_reads

4. Enter Credentials in KronGage

Go to Settings → KronChat Social Apps → Instagram Inbox App and fill in:

Click Save Instagram Credentials.

5. Required Permissions

Your Meta app needs: instagram_basic, instagram_manage_messages, pages_show_list, pages_messaging

Submit permissions for App Review before going Live mode. Instagram DM inbox will not work while the app is in Development mode for users outside your developer account.

---

Meta — Facebook Messenger Inbox

Facebook Messenger inbox uses a separate set of credentials from the Instagram inbox. You can use the same Meta app or a different one.

1. Add the Messenger Product

In your Meta app, add the Messenger product.

2. Configure OAuth Redirect URIs

In Facebook Login for Business → Settings, add:

https://[your-tenant].krongage.io/integrations/social/facebook

3. Configure the Webhook

In Messenger → Settings → Webhooks, click Add Callback URL:

Subscribe to: messages, messaging_postbacks, message_deliveries, message_reads

4. Enter Credentials in KronGage

Go to Settings → KronChat Social Apps → Facebook / Messenger App Credentials:

Click Save Facebook Credentials.

5. Required Permissions

Your Meta app needs: pages_show_list, pages_messaging, pages_read_engagement

---

Meta — WhatsApp Business API

WhatsApp uses the same Meta Developer platform but a separate credentials panel.

1. Add the WhatsApp Product

In your Meta app, add the WhatsApp product and complete the WhatsApp Business onboarding to get a phone number.

2. Configure the Webhook

In WhatsApp → Configuration → Webhook, click Edit:

Replace [phone-number] with your WhatsApp Business phone number in E.164 format (e.g. +233201234567).

Subscribe to: messages

3. Register the App in Meta Business Manager

After saving credentials in KronGage, you must manually add the app to your WhatsApp Business Account:

1. Go to Meta Business Manager → Business Settings → WhatsApp Accounts → [Your WABA] → Apps
2. Click Add and select your app by its App ID

This one-time step is required for the webhook to register correctly.

4. Enter Credentials in KronGage

Go to Settings → KronChat Social Apps → Meta App Credentials:

Click Save Credentials.

---

TikTok Inbox

TikTok inbox lets you receive TikTok DMs as conversations in KronChat.

1. Create a TikTok App

1. Go to developers.tiktok.com and create an app
2. Add the Login Kit and Direct Message products

2. Configure OAuth Redirect URIs

Add these redirect URIs in your TikTok app settings:

https://[your-tenant].krongage.io/integrations/social/tiktok
https://[your-tenant].krongage.io/tiktok/callback

3. Configure the Webhook

In your TikTok app's Webhooks settings:

4. Enter Credentials in KronGage

Go to Settings → KronChat Social Apps → TikTok App Credentials:

Click Save Credentials.

---

Summary: All URLs Per Tenant

Replace [your-tenant] with your actual subdomain in all of the following: