Integrations & Connections Guide

To automate cross-platform tasks, you need to securely connect your external accounts. This guide explains the three types of connections available.

🔑 1. OAuth Connections (One-Click)

Used for Google Analytics, Search Console, Gmail, Drive, Calendar, Meet, and Facebook.

1. Go to Integrations.
2. Click Connect on the desired service.
3. You will be redirected to the provider (e.g., Google) to authorize the app.
4. Once authorized, the connection appears in your list.

Multi‑account supported:

• Add multiple connections per tool (e.g., two Google accounts).
• Give each connection a label (ex: “Client A”, “Brand B”).
• Choose a default connection.

🤖 2. API Key Connections

Used for tools like Stripe, PayPal, Telegram, WhatsApp (Twilio), Weather, News, Slack, Discord, AWS S3, Airtable, Shopify, Google PageSpeed, Chrome UX Report (CrUX), and more.

• Telegram: You need a Bot Token from @BotFather. Paste this into the Connect modal.
• WhatsApp: Requires your Twilio Account SID and Auth Token.
• Weather/News: Obtain a free API key from the provider's website (e.g., NewsAPI.org) and paste it into the Connect modal.

Telegram chat IDs

• For private chats, the recipient must open the bot and send /start before the bot can message them.
• For groups, add the bot to the group, send a test message, and use the negative group chat ID.
• For channels, add the bot as an admin and use @publicchannel or the -100... channel ID.
• If Telegram returns 400 chat not found, the bot token is usually valid but the target chat is not reachable by that bot yet.

Multi‑account supported:

• Add multiple API‑key connections per tool.
• Label them, set a default, and remove or reconnect each one independently.

📝 3. WordPress (CMS)

Connecting to WordPress requires an Application Password (not your regular login password).

1. Log in to your WordPress site as an Admin.
2. Go to Users > Profile.
3. Scroll down to Application Passwords.
4. Enter a name (e.g., "AI Workflow") and click Add New.
5. Copy the 24-character password provided.
6. In the Workflow App, paste your Site URL, Username, and this new Application Password.

🧭 How the Editor Uses Connections

In the Tool node editor you can:

• Select which connected account to use via the Connection selector.
• Leave it empty to use the default connection.
• If you enter credentials directly in the node, those override the stored connection.

🛡️ Security & Revocation

• Encrypted Storage: All tokens and keys are encrypted before being stored in our database.
• Disconnecting: You can disconnect a saved connection at any time from the Connected Services page. NeuronFlow removes the stored encrypted tokens or keys for that connection. If the provider has its own app-access screen, revoke access there too when you want provider-side revocation.
• Expired Tokens: If a workflow fails with an "Unauthorized" error, use Reconnect on the integrations page to refresh or replace the saved connection.