n8n-nodes-botbee

This is an n8n community node. It lets you use the BotBee WhatsApp API in your n8n workflows.

BotBee is a WhatsApp Business API platform for sending messages, managing subscribers, labels, sequences, catalogs, and bot flows.

n8n is a fair-code licensed workflow automation platform.

Installation Credentials Usage example Resources and operations Compatibility Resources

Installation

Follow the installation guide in the n8n community nodes documentation.

In short: Settings → Community Nodes → Install a community node, then enter n8n-nodes-botbee.

Credentials

You need a BotBee account and an API token to use this node.

1. Log in to your BotBee dashboard.
2. Go to the API settings section and copy your API token.
3. In n8n, create a new BotBee API credential and paste the token in.

Usage example

Send a WhatsApp text message

1. Add the BotBee node to your workflow and select your BotBee API credential.
2. Set Resource to Message and Operation to Send Text.
3. Fill in the fields:
   • Phone Number ID: 123456789012345 — the WhatsApp Business phone number ID from your BotBee dashboard (Settings → Numbers).
   • Phone Number: 15557323953 — the recipient's WhatsApp number in international format, digits only (no +, spaces, or dashes).
   • Message: Hello! Your order #1024 has shipped.
4. Execute the node. BotBee's API responds with a status field ("1" for success, "0" for failure) and a message field describing the result, for example:

{
  "status": "1",
  "message": "..."
}

If the recipient hasn't messaged your WhatsApp number within the last 24 hours, WhatsApp's messaging policy blocks free-form text and BotBee returns status: "0" with an explanatory message — use a Template message instead in that case.

A typical workflow: a Webhook or Schedule node receives/triggers order data, a Set node maps that data onto phone_number_id, phone_number, and message, and the BotBee node sends the WhatsApp message as the final step. The same node can also be used as a tool by an AI Agent node, letting the agent decide when to send a message based on the conversation.

Resources and operations

This node supports the following resources and operations:

• Message — Send Text, Send Interactive Buttons, Send File, Upload Media, Get Conversation, Get Delivery Status
• Subscriber — Get, List, Create, Update, Delete, Reset Input Flow
• Subscriber Chat — Assign to Team Member, Assign Custom Fields, Assign Labels, Remove Labels, Assign Sequences, Remove Sequences, Add Notes
• Label — List, Create
• Custom Field — List
• Template — List
• Catalog — List Catalogs, List Orders, Sync, Change Order Status
• Bot Flow — Trigger Flow, Get Post-Back List

Compatibility

Tested against n8n 2.x. Requires n8n's community nodes feature to be enabled (the default on self-hosted instances).

Resources

• n8n community nodes documentation
• BotBee API documentation