Team Collaboration Integrations

TendSocial supports notifications to Slack, Discord, and Microsoft Teams. Following are the setup instructions for each platform.

Slack Integration

1. Create a Slack App

1. Go to api.slack.com/apps and click Create New App.
2. Choose From scratch.
3. Enter an App Name (e.g., "TendSocial Notifier") and select your workspace.

2. Configure OAuth & Permissions

1. Navigate to Features > OAuth & Permissions.
2. Under Redirect URLs, add your callback URL:

   {API_BASE}/api/integrations/channels/callback/slack

   (e.g., https://api.tendsocial.com/api/integrations/channels/callback/slack)
3. Scroll down to Scopes > Bot Token Scopes and add the following:
   • channels:read (View public channels)
   • groups:read (View private channels)
   • chat:write (Send messages)
   • incoming-webhook (Optional, for simple posting)

3. Install App

1. Scroll up to OAuth Tokens for Your Workspace and click Install to Workspace.
2. Copy the credentials to your backend .env file.

Required Environment Variables

SLACK_CLIENT_ID=your_client_id
SLACK_CLIENT_SECRET=your_client_secret
# This redirect URI must match exactly what you entered in the Slack dashboard
SLACK_REDIRECT_URI=https://api.tendsocial.com/api/integrations/channels/callback/slack

---

Discord Integration

1. Create a Discord App

1. Go to the Discord Developer Portal.
2. Click New Application and give it a name.

2. Configure OAuth2

1. Navigate to OAuth2.
2. Under Redirects, add your callback URL:

   {API_BASE}/api/integrations/channels/callback/discord

   (e.g., https://api.tendsocial.com/api/integrations/channels/callback/discord)

3. Generate Link (Optional Scope Check)

1. In the OAuth2 > URL Generator section, select scopes:
   • bot
   • webhook.incoming
2. Under Bot Permissions, select:
   • Send Messages
   • View Channels(Note: TendSocial handles the OAuth flow automatically via the frontend connect button using the Client ID).

Required Environment Variables

DISCORD_CLIENT_ID=your_client_id
DISCORD_CLIENT_SECRET=your_client_secret
DISCORD_REDIRECT_URI=https://api.tendsocial.com/api/integrations/channels/callback/discord

---

Microsoft Teams

Currently, Microsoft Teams integration is supported via Incoming Webhooks. This does not require a central Azure App registration for the platform itself, but users must configure a connector in their Teams channel.

User Instructions

1. In Microsoft Teams, navigate to the channel where you want detailed notifications.
2. Click ... (More options) > Connectors.
3. Search for Incoming Webhook and click Configure.
4. Give it a name (e.g., "TendSocial") and upload an image if desired.
5. Click Create.
6. Copy the Webhook URL provided.
7. Paste this URL into TendSocial's integration settings when prompted.

---

Summary of Environment Variables

Add these to apps/backend/.env:

# Slack
SLACK_CLIENT_ID=
SLACK_CLIENT_SECRET=
SLACK_REDIRECT_URI=http://localhost:4000/api/integrations/channels/callback/slack

# Discord
DISCORD_CLIENT_ID=
DISCORD_CLIENT_SECRET=
DISCORD_REDIRECT_URI=http://localhost:4000/api/integrations/channels/callback/discord