gallabox

n8n nodes for Gallabox WhatsApp Business platform

Package Information

Released: 3 mo ago
Downloads: 38 weekly / 606 monthly
Latest Version: 0.1.5
Author: Yogesh

Available Nodes

Gallabox icon
Gallabox
Interact with Gallabox WhatsApp Business platform

Documentation

n8n-nodes-gallabox

npm version
License: MIT

An n8n community node package for integrating with the Gallabox WhatsApp Business platform.

Overview

This package provides two nodes:

  • Gallabox – Perform actions against the Gallabox REST API (contacts, conversations, messages, templates, users)
  • Gallabox Trigger – Listen for webhook events from Gallabox and start workflows automatically

Prerequisites

  • n8n >= 0.187.0
  • A Gallabox account with API access
  • Your Gallabox Account ID, API Key, API Secret, and Channel ID

Installation

Via n8n UI (Recommended)

  1. In your n8n instance go to Settings → Community Nodes
  2. Click Install
  3. Enter @gallabox/n8n-nodes-gallabox
  4. Click Install and restart n8n when prompted

Manual (Self-hosted)

npm install @gallabox/n8n-nodes-gallabox

Then restart your n8n instance.

Credentials Setup

Step 1 — Find your credentials in Gallabox

  1. Log in to your Gallabox dashboard
  2. Go to Settings → API & Webhooks
  3. Copy your Account ID, API Key, and API Secret
  4. Go to Settings → Channels and copy your WhatsApp Channel ID

Step 2 — Add credentials in n8n

  1. In n8n go to Credentials → New Credential
  2. Search for Gallabox API and select it
  3. Fill in the fields:
Field Where to find it
Account ID Gallabox → Settings → API & Webhooks
API Key Gallabox → Settings → API & Webhooks
API Secret Gallabox → Settings → API & Webhooks
Channel ID Gallabox → Settings → Channels
  1. Click Save — n8n will test the connection automatically

Available Operations

Contact

Operation Description
Create Create a new contact
Get Get a contact by ID
Upsert Create or update a contact by phone number

Conversation

Operation Description
Get Get a conversation by ID
Get All List conversations with optional status/assignee filters
Assign Assign a conversation to a user
Unassign Remove the current assignee from a conversation
Resolve Mark a conversation as resolved
Reopen Reopen a resolved conversation

Message

Operation Description
Send Text Send a plain text WhatsApp message
Send Template Send an approved WhatsApp template message
Send Interactive Send a button-based interactive message
Send Media Send an image, video, or document

Template

Operation Description
Get Get a template by ID
Get All List all approved templates

User

Operation Description
Get Me Get the currently authenticated user
Get All List all users in the account
Update Availability Set a user's availability (online / offline / busy)

Gallabox Trigger Node

The Gallabox Trigger node starts a workflow automatically when an event occurs in Gallabox.

Supported Events

Contact: contact.created, contact.updated, contact.mapped, contact.unmapped

Conversation: conversation.created, conversation.updated, conversation.UnAttended, conversation.Tag.mapped, conversation.Tag.unmapped

Message: message.received, message.flow.received, message.WA.status.received, message.WA.status.failed, message.WA.Interaction.Received, message.WA.Cart.received, message.WA.Payment.status.received

Template: template.status

Setting Up the Trigger

  1. Add a Gallabox Trigger node to your workflow and activate it — a webhook URL will appear
  2. Copy the webhook URL
  3. In Gallabox go to Settings → Webhooks
  4. Click Add Webhook, paste the URL, and select the events you want
  5. Save — Gallabox will now POST events to your n8n workflow

Example Workflows

1. Send a WhatsApp message when a Google Form is submitted

Nodes: Google Sheets Trigger → Gallabox (Send Template)

Use this to notify a lead or customer on WhatsApp the moment they fill out a form.

2. Auto-reply to incoming WhatsApp messages

Nodes: Gallabox Trigger (message.received) → IF → Gallabox (Send Text)

Use this to send an automated response when a customer messages you outside business hours.

3. Notify your team when a conversation is unattended

Nodes: Gallabox Trigger (conversation.UnAttended) → Slack / Email

Use this to alert your support team when no agent has responded to a conversation within a set time.

4. Create or update a contact from a CRM event

Nodes: HubSpot Trigger → Gallabox (Contact Upsert)

Keep your Gallabox contacts in sync whenever a contact is updated in your CRM.

5. Resolve a conversation after a successful payment

Nodes: Payment Webhook → Gallabox (Conversation Resolve)

Automatically close a conversation once a payment is confirmed.

Troubleshooting

Credential test fails

  • Double-check your Account ID, API Key, and API Secret — copy them fresh from Gallabox
  • Make sure your Gallabox account has API access enabled

Node not appearing in n8n

  • Restart n8n after installing the community node
  • Verify the package installed correctly: npm list @gallabox/n8n-nodes-gallabox

Messages not sending

  • Ensure the Channel ID is correct (found under Settings → Channels in Gallabox)
  • For template messages, confirm the template is approved in your WhatsApp Business Account

Trigger not receiving events

  • Make sure the workflow is active (not just saved)
  • Verify the webhook URL is correctly pasted in Gallabox Settings → Webhooks
  • Check that the event type in Gallabox matches what the trigger node is listening for

Development

npm install       # Install dependencies
npm run build     # Compile TypeScript + copy icon to dist/
npm run dev       # Watch mode
npm run lint      # Lint
npm run lintfix   # Auto-fix lint issues
npm run format    # Prettier

License

MIT

Discussion