Required API Keys
Altitut reads credentials from environment variables at startup. Copy.env.example to .env at the root of your project and fill in the values below.
.env and set the following:
.env
OPENAI_API_KEY, EXA_API_KEY, APIFY_TOKEN, UPLOAD_POST_API_KEY, and UPLOAD_POST_PROFILE are all required for core functionality. TELEGRAM_BOT_TOKEN and TELEGRAM_WEBHOOK_SECRET are optional — omitting them simply disables the Telegram bot integration without affecting any other feature.
OPENAI_API_KEY — AI inference and vector embeddings
OPENAI_API_KEY — AI inference and vector embeddings
Altitut uses OpenAI for all generative AI features: the synthesis passes in Competitor Scout, AI Copilot chat responses, Content Pack generation, and Auto-Post caption generation. It also uses OpenAI’s embedding models to power the RAG retrieval that the AI Copilot relies on.You can obtain an API key from the OpenAI platform. Make sure your account has access to the
gpt-4o-mini model before setting up Altitut.EXA_API_KEY — Competitor discovery and research
EXA_API_KEY — Competitor discovery and research
Exa AI powers the Discover and Research stages of the Competitor Scout pipeline. In the Discover stage, Exa performs a semantic search to surface competitors matching your query. In the Research stage, Exa retrieves deep contextual information about each competitor’s brand positioning and messaging.Get your API key from the Exa dashboard.
APIFY_TOKEN — Instagram scraping
APIFY_TOKEN — Instagram scraping
Apify runs the Website and Social stages of the Competitor Scout pipeline. It crawls each competitor’s public website for content and maps their Instagram presence, including reels and post metadata.Get your token from the Apify console.
Social Platform Connection
Altitut publishes to social platforms through the Upload-Post service rather than direct OAuth integrations. This means you manage account connections in the Upload-Post dashboard — not inside Altitut itself.1
Create a Profile in Upload-Post
Log in at app.upload-post.com and create a Profile that matches the value you set for
UPLOAD_POST_PROFILE in your .env file (for example, my-brand).2
Add Connected Accounts
Inside your profile, navigate to Connected Accounts and click Add Account. Authenticate with LinkedIn, Facebook, and/or Instagram through each platform’s OAuth flow.
For Facebook, connect a Facebook Page you administer (not a personal profile). For Instagram, connect a Business or Creator account. For LinkedIn, connect a personal profile or a company page where you have admin access.
3
Verify in Altitut
Start your development server and open the Auto-Post Composer in Altitut. Advance to the Destinations step. All accounts you connected in the previous step should appear automatically. Altitut fetches the account list from Upload-Post on each composer session.
If a connected account does not appear in the Destinations step, verify that your
UPLOAD_POST_API_KEY and UPLOAD_POST_PROFILE match the Upload-Post account and profile where you added the social account. Keys and profiles are scoped per Upload-Post account.Telegram Bot (Optional)
The Telegram bot lets your team send Instagram reel URLs to a bot and receive a generated Content Pack automatically — without opening the Altitut dashboard.1
Create a Bot with BotFather
Open Telegram and start a conversation with @BotFather. Send
/newbot, follow the prompts, and copy the bot token you receive.2
Add the Token to Your Environment
Add the token (and an optional webhook secret) to your The webhook secret is optional but recommended — it lets Altitut verify that incoming webhook requests genuinely originate from Telegram.
.env file:.env
3
Deploy and Register the Webhook
Deploy your app to a public HTTPS URL, then register the webhook using the built-in npm script:
Telegram requires a publicly reachable HTTPS URL for webhooks. During local development, use a tunneling tool such as ngrok to expose your local server.
4
Test the Integration
Send an Instagram reel URL to your bot in Telegram. Within a few seconds, Altitut should respond with a confirmation that a Content Pack is being generated. The finished pack will appear in the Content Packs section of the dashboard.
Firebase (Firestore and Storage)
Altitut uses two Firebase services:- Firestore stores all competitor intelligence packs, content packs, post records, and vector embeddings used for AI Copilot queries.
- Firebase Storage hosts the media files (videos and images) uploaded through the Auto-Post Composer before they are passed to Upload-Post for publishing.
1
Create a Firebase Project
Go to the Firebase console, click Add project, and follow the setup wizard. Enable both Firestore Database and Storage for your project.
2
Set Your Project ID
Add your Firebase project ID to The project ID is shown on the Firebase console home page and in your project settings.
.env:.env
3
Authenticate the Backend
For local development, authenticate using the Google Cloud CLI:Alternatively, download a service account key from Firebase console → Project Settings → Service accounts → Generate new private key and point to it:For production deployments (e.g. Vercel), use your hosting provider’s secret management to inject the service account credentials directly — no file path needed.
.env
Configuration Checklist
Use this checklist to confirm your environment is fully configured before going live:View full configuration checklist
View full configuration checklist
-
OPENAI_API_KEYset and account has access togpt-4o-mini -
EXA_API_KEYset -
APIFY_TOKENset -
UPLOAD_POST_API_KEYset -
UPLOAD_POST_PROFILEset to your Upload-Post profile name - At least one social account connected in the Upload-Post dashboard
- Firebase project created with Firestore and Storage enabled
-
FIREBASE_PROJECT_IDset - Firebase authentication configured (Application Default Credentials or
FIREBASE_SERVICE_ACCOUNT_PATH) -
.envadded to.gitignore - (Optional)
TELEGRAM_BOT_TOKENset and webhook registered