Messaging Integrations Setup Guide
Step-by-step guide to configuring Slack, Telegram, and WhatsApp integrations. Learn how to acquire necessary Webhook URLs, Bot Tokens, and API Keys from Meta and Telegram to enable automated messaging and alerts.
Last updated: 04/14/2026, 10:12 AM
<div class="features-wrapper">
<h2>Automated Communication Pipelines</h2>
<p>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.</p>
<hr>
<h2>1. Slack Integration</h2>
<p>Connect your corporate Slack workspace to receive instant notifications on specific channels (e.g., #sales, #devops-alerts).</p>
<h3>Required Credentials</h3>
<ul>
<li><strong>Webhook URL</strong>: A unique endpoint URL generated by Slack targeting a specific channel.</li>
</ul>
<h3>Step-by-Step Setup</h3>
<ol>
<li><strong>Create a Slack App:</strong> Navigate to <a href="https://api.slack.com/apps" target="_blank">Slack API Apps</a> and click "Create New App". Choose "From scratch", name your app (e.g., "Orbitus Alerts"), and select your workspace.</li>
<li><strong>Activate Webhooks:</strong> In the app settings sidebar, click on <strong>Incoming Webhooks</strong> and toggle the switch to "On".</li>
<li><strong>Add Webhook to Workspace:</strong> Scroll down and click "Add New Webhook to Workspace". Select the channel you want Orbitus to post to (e.g., #general or #alerts).</li>
<li><strong>Copy URL:</strong> Slack will generate a URL looking like <code>https://hooks.slack.com/services/T0000/B000/XXXX</code>. Copy this.</li>
<li><strong>Configure Orbitus:</strong> Go to Orbitus > Integrations > Slack. Paste your Webhook URL into the field.</li>
<li><strong>Test & Save:</strong> Enter an optional test message in the input field. Click <strong>Test Connection</strong>. If successful, you will receive a message in your Slack channel. Then click <strong>Save Integration</strong>.</li>
</ol>
<hr>
<h2>2. Telegram Integration</h2>
<p>Connect a Telegram Bot to dispatch alerts directly to your mobile device or a Telegram Group.</p>
<h3>Required Credentials</h3>
<ul>
<li><strong>Bot Token</strong>: Provided by the BotFather.</li>
<li><strong>Chat ID</strong>: The specific user or group ID the bot will message.</li>
</ul>
<h3>Step-by-Step Setup</h3>
<ol>
<li><strong>Create Bot:</strong> Open Telegram and search for <code>@BotFather</code>. Send the message <code>/newbot</code>.</li>
<li><strong>Name Your Bot:</strong> Follow the prompts to give your bot a display name and a username (must end in 'bot').</li>
<li><strong>Get Token:</strong> BotFather will reply with an HTTP API token (e.g., <code>123456789:ABCDefghIJKLmnopQRSTuvwxYZ</code>). Copy this token.</li>
<li><strong>Get Chat ID:</strong> To get your Chat ID, start a conversation with your new bot and send "Hello". Then, forward that message to <code>@userinfobot</code> or use a web utility to extract your numeric Chat ID (e.g., <code>123456789</code>).</li>
<li><strong>Configure Orbitus:</strong> Go to Orbitus > Integrations > Telegram. Paste both the <strong>Bot API Token</strong> and the <strong>Chat ID</strong>.</li>
<li><strong>Test & Save:</strong> Enter a test message and click <strong>Test Connection</strong>. If you receive a Telegram message on your phone, click <strong>Save Integration</strong>.</li>
</ol>
<hr>
<h2>3. WhatsApp Business API</h2>
<p>Connect Meta's official WhatsApp Business API to send template messages (like reservation confirmations or order receipts) to your customers.</p>
<h3>Required Credentials</h3>
<ul>
<li><strong>Access Token</strong>: System user token from Meta Developer Portal.</li>
<li><strong>Phone Number ID</strong>: The unique ID associated with your WhatsApp sending number.</li>
<li><strong>Business Account ID</strong>: Used for billing and template management.</li>
</ul>
<h3>Step-by-Step Setup</h3>
<ol>
<li><strong>Meta Business Suite:</strong> Log into <a href="https://business.facebook.com" target="_blank">Meta Business Suite</a> and ensure you have a verified Business Account.</li>
<li><strong>Developer Portal:</strong> Go to <a href="https://developers.facebook.com" target="_blank">Meta for Developers</a>. Create an "App" and select "Business" as the type. Add the "WhatsApp" product to your app.</li>
<li><strong>API Setup:</strong> Navigate to WhatsApp > API Setup strictly within the developer dashboard sidebar. Here you will see a temporary <strong>Access Token</strong> and your <strong>Phone Number ID</strong>.</li>
<li><strong>Generate Permanent Token:</strong> <em>Important:</em> 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 <code>whatsapp_business_messaging</code> permissions.</li>
<li><strong>Configure Orbitus:</strong> Go to Orbitus > Integrations > WhatsApp. Paste your <strong>Access Token</strong> and <strong>Phone Number ID</strong>.</li>
<li><strong>Test & Save:</strong> Enter a valid phone number (including country code, e.g., +15551234567) in the Test Phone Number field. Click <strong>Test Connection</strong>. Upon success, click <strong>Save Integration</strong>.</li>
</ol>
<div class="usecase-example">
<h3>Important Note on WhatsApp Templates</h3>
<p>Unlike Slack or Telegram, WhatsApp Business API restricts free-form messaging to prevent spam. You can only send free-form messages if the customer has messaged you within the last 24 hours (a "Service Window"). For all other outbound messages (like order confirmations), you must first create and approve a Message Template inside your Meta Business Manager. Orbitus Workflows will utilize these approved templates.</p>
</div>
</div>