obo

n8n nodes for Obo, RoboticGen's WhatsApp platform: send to numbers and groups, manage groups, check numbers, work the inbox, and trigger on WhatsApp events.

Package Information

Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.1
Author: RoboticGen

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

  1. 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.
  2. 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.

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, isGroup and groupId, plus the full data from 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/me returns the key's workspace, number limit and scopes.
  • /api/v1/wa/<path> reaches the WhatsApp engine (sessions, messages, groups, contacts).
  • /api/v1/webhooks lists and manages webhooks.
  • GET /api/v1/media/<messageId> downloads a message's file.
  • The inbox operations use the existing POST /api/mcp tools.

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.

Discussion