Messaging Integrations Setup Guide

Automated Communication Pipelines

Connecting messaging applications to Orbitus empowers you to dispatch real-time alerts to your team or automated transactional notifications directly to your customers. Follow the detailed guides below to configure each provider.

---

1. Slack Integration

Connect your corporate Slack workspace to receive instant notifications on specific channels (e.g., #sales, #devops-alerts).

Required Credentials

• Webhook URL: A unique endpoint URL generated by Slack targeting a specific channel.

Step-by-Step Setup

1. Create a Slack App: Navigate to Slack API Apps and click "Create New App". Choose "From scratch", name your app (e.g., "Orbitus Alerts"), and select your workspace.
2. Activate Webhooks: In the app settings sidebar, click on Incoming Webhooks and toggle the switch to "On".
3. Add Webhook to Workspace: Scroll down and click "Add New Webhook to Workspace". Select the channel you want Orbitus to post to (e.g., #general or #alerts).
4. Copy URL: Slack will generate a URL looking like https://hooks.slack.com/services/T0000/B000/XXXX. Copy this.
5. Configure Orbitus: Go to Orbitus > Integrations > Slack. Paste your Webhook URL into the field.
6. Test & Save: Enter an optional test message in the input field. Click Test Connection. If successful, you will receive a message in your Slack channel. Then click Save Integration.

---

2. Telegram Integration

Connect a Telegram Bot to dispatch alerts directly to your mobile device or a Telegram Group.

Required Credentials

• Bot Token: Provided by the BotFather.
• Chat ID: The specific user or group ID the bot will message.

Step-by-Step Setup

1. Create Bot: Open Telegram and search for @BotFather. Send the message /newbot.
2. Name Your Bot: Follow the prompts to give your bot a display name and a username (must end in 'bot').
3. Get Token: BotFather will reply with an HTTP API token (e.g., 123456789:ABCDefghIJKLmnopQRSTuvwxYZ). Copy this token.
4. Get Chat ID: To get your Chat ID, start a conversation with your new bot and send "Hello". Then, forward that message to @userinfobot or use a web utility to extract your numeric Chat ID (e.g., 123456789).
5. Configure Orbitus: Go to Orbitus > Integrations > Telegram. Paste both the Bot API Token and the Chat ID.
6. Test & Save: Enter a test message and click Test Connection. If you receive a Telegram message on your phone, click Save Integration.

---

3. WhatsApp Business API

Connect Meta's official WhatsApp Business API to send template messages (like reservation confirmations or order receipts) to your customers.

Required Credentials

• Access Token: System user token from Meta Developer Portal.
• Phone Number ID: The unique ID associated with your WhatsApp sending number.
• Business Account ID: Used for billing and template management.

Step-by-Step Setup

1. Meta Business Suite: Log into Meta Business Suite and ensure you have a verified Business Account.
2. Developer Portal: Go to Meta for Developers. Create an "App" and select "Business" as the type. Add the "WhatsApp" product to your app.
3. API Setup: Navigate to WhatsApp > API Setup strictly within the developer dashboard sidebar. Here you will see a temporary Access Token and your Phone Number ID.
4. Generate Permanent Token: Important: The temporary token expires in 24 hours. To get a permanent token, go to Business Settings > System Users. Create a System User, assign it to your app, and generate a token with whatsapp_business_messaging permissions.
5. Configure Orbitus: Go to Orbitus > Integrations > WhatsApp. Paste your Access Token and Phone Number ID.
6. Test & Save: Enter a valid phone number (including country code, e.g., +15551234567) in the Test Phone Number field. Click Test Connection. Upon success, click Save Integration.