n8n-nodes-bgos

Community nodes for n8n to integrate with the BGOS AI assistant chat platform.

Nodes

BGOS (Action Node)

Perform operations on the BGOS platform:

| Resource | Operations | |---|---| | Message | Send Message, Create, Bulk Create, Edit, Delete, Button Callback | | Chat | Create, Get, Rename, Delete, Get Messages, Get Unread, Increment Unread, Mark as Read | | Assistant | Create, Get, Update, Delete, Reorder, Get With Chats | | User | Get or Create, Update | | Scheduled Task | Get, Get User Tasks, Delete |

BGOS Trigger (Webhook Node)

Starts workflows when BGOS events occur. Supports 16 event types:

• message, edited_message, voice_message, reply_message
• new_chat, chat_renamed, chat_deleted
• new_assistant, assistant_updated, assistant_deleted
• voice_started, voice_ended
• message_deleted, button_clicked
• user_created, user_updated

Credentials

Configure with your BGOS backend URL and optional API key:

• Base URL: Your BGOS backend URL (default: https://api.brandgrowthos.ai)
• API Key: Optional, for future authentication support

Setup

In BGOS Backend

Set the FORWARDER_WEBHOOK_URL environment variable to your n8n webhook URL:

FORWARDER_WEBHOOK_URL=https://your-n8n-instance.com/webhook/bgos-webhook

In n8n

1. Install the package: pnpm install n8n-nodes-bgos (or add it in Settings → Community nodes).
2. Finding the trigger: Click + (Add node), search for "BGOS Trigger" and pick the one with the cube icon (community node). You can use it as the workflow trigger or add it from the canvas.
3. Configure BGOS API credentials (from the node’s credential dropdown) with your backend Base URL.
4. Use the BGOS Trigger node to receive events and the BGOS node to perform actions.

Development

pnpm install
pnpm build

License

MIT