Package Information
Documentation
n8n-nodes-obo
n8n nodes for Obo, RoboticGen's WhatsApp platform. They do everything the 2Chat n8n node does, plus Obo's groups, inbox, polls, status posts and bulk sends:
- Obo sends messages and manages groups, numbers and the inbox.
- Obo Trigger starts a workflow when something happens on WhatsApp.
Set up
- In Obo, open Developer and create an API key.
- Tick the scopes the workflows need:
- Messages to send.
- Sessions to read numbers and groups. Sessions write is needed to change groups, block numbers or check many numbers at once.
- Webhooks for the Obo Trigger.
- To limit the key to one WhatsApp number, pick that number.
- Tick the scopes the workflows need:
- In n8n, add an Obo API credential.
- API Key: the
wsk_…key from step 1. - Obo URL:
https://obo-whatsapp.roboticgen.co. - Test calls
GET /api/v1/me.
- API Key: the
Obo node
| Resource | Operations |
|---|---|
| Message | Send to a person or a group: text, image, video, GIF, audio, voice note, document, sticker, location, contact card, poll, buttons or list. Text can quote a message; an image can be view-once. Also React, Edit, Delete, Mark as Read and Show Typing. |
| Group | Get Many, Get, Create, Add/Remove Participants, Promote/Demote Admins, Get/Revoke Invite Link, Join With Invite, Leave, Update Name/Description/Picture/Settings. |
| Phone Number | Check (on WhatsApp? business?), Check Many (up to 100), Get Profile Picture, Get About, Block, Unblock. |
| WhatsApp Number | Get Many, Get: the numbers connected to Obo and their status. |
| Conversation (Inbox) | Get Many, Get Messages, Reply, Add Note, Update (status, priority, assignee, tags), Search Contacts. |
| Status | Post a text status, seen by the numbers you list (at most 5 a day). |
| Bulk Send | Send one text to up to 50 numbers with a pause between each; Get Job. |
- Numbers: any format works (
+94 77 123 4567,0094771234567,94771234567). The node keeps only the digits. - Groups: pick a group from the list; it loads that number's groups.
- Errors: each failed item stops the run unless Continue On Fail is on.
- AI agents: the node can be used as a tool.
Obo Trigger
- Events:
- Message Received
- Message Sent (by Obo or the API)
- Message Sent From the Phone
- Poll Vote
- Call Updated
- Chat Tags Changed
- Number Connected / Disconnected / Failed / Needs QR Scan
- All Events, which also brings delivery and read ticks
- Filters: limit the trigger to some WhatsApp numbers, and to people only, groups only, or one group. Status posts (
status@broadcast) come through only with All Chats. - Turning it on and off: when the workflow is turned on, the trigger subscribes itself in Obo (the subscription shows under Webhooks, named
n8n: <workflow name>). When it is turned off, it unsubscribes. - Signatures: every delivery is checked against the webhook's signing secret, and anything unsigned, wrongly signed or more than 10 minutes old is refused with 401.
- Output for message events:
event,whatsappNumber,messageId,phone(who wrote, digits only),text,isGroupandgroupId, plus the fulldatafrom Obo. - Media: the base64 file of incoming media is left out unless Include Media Data is on.
Coming from 2Chat
| 2Chat node | Obo node |
|---|---|
| Message → Send Message (to number) | Message → Send, Send To: Person |
| Message → Send to Group | Message → Send, Send To: Group |
| Message → URL (media) | Message → Send, Message Type: Image / Video / Document… with File URL |
| Message → Pin Location | Message → Send, Message Type: Location |
| Phone Number → Check | Phone Number → Check |
| 2Chat Trigger: WhatsApp Message Received | Obo Trigger: Message Received |
| 2Chat Trigger: Group Message Received | Obo Trigger: Message Received, Chats: One Group |
| 2Chat Trigger: Message Sent | Obo Trigger: Message Sent / Message Sent From the Phone |
| WABA interactive (buttons, list) | Message → Send, Message Type: Buttons or List |
Not in this version: WABA template sends, and 2Chat's phone-call triggers for virtual numbers. WhatsApp calls on Obo come through Call Updated.
The API behind it
The node calls Obo's public API, https://<obo>/api/v1/…, with Authorization: Bearer wsk_…:
GET /api/v1/mereturns the key's workspace, number limit and scopes./api/v1/wa/<path>reaches the WhatsApp engine (sessions, messages, groups, contacts)./api/v1/webhookslists and manages webhooks.GET /api/v1/media/<messageId>downloads a message's file.- The inbox operations use the existing
POST /api/mcptools.
Every call is checked against the key's scopes and number limit.
The engine allows 30 message calls a minute per number. Over that, Obo answers 429 with Retry-After, and n8n's Retry On Fail handles it.
Develop
npm install --workspaces=false
npm test # builds, then runs test/nodes.test.cjs against a fake n8n context
npm pack # n8n-nodes-obo-<version>.tgz
To install on a self-hosted n8n without npm, copy the tarball to the server and run npm install /path/n8n-nodes-obo-<version>.tgz inside ~/.n8n/nodes, then restart n8n.