Skip to main content

15 - n8n Integration

Use MultiWA with n8n for powerful workflow automation.

Installation​

n8n Community Nodes​

npm install n8n-nodes-multiwa

Or install via n8n UI:

  1. Go to Settings → Community Nodes
  2. Click Install a community node
  3. Enter n8n-nodes-multiwa
  4. Click Install

Setup Credentials​

  1. In n8n, go to Credentials → Add Credential
  2. Search for MultiWA API
  3. Enter:
    • API Base URL: http://localhost:3333/api/v1
    • API Key: Your MultiWA API key

Available Nodes​

MultiWA Node​

Send WhatsApp messages with 7 operations:

OperationDescription
Send TextSend a text message
Send ImageSend an image with caption
Send VideoSend a video with caption
Send DocumentSend a document/file
Send LocationSend a location pin
Send ContactSend a contact card
Send PollSend a poll with options

MultiWA Trigger​

Receive WhatsApp events in real-time:

EventDescription
Message ReceivedIncoming message
Message SentOutgoing message confirmation
Message DeliveredDelivery confirmation
Message ReadRead receipt
Connection ChangedSession status change

Example Workflows​

Auto-Reply Bot​

  1. Trigger: MultiWA Trigger (Message Received)
  2. IF: Check if message contains "help"
  3. MultiWA Node: Send Text reply
[MultiWA Trigger] → [IF] → [MultiWA Send Text]

AI Customer Support​

  1. Trigger: MultiWA Trigger (Message Received)
  2. OpenAI Node: Generate response
  3. MultiWA Node: Send Text reply
[MultiWA Trigger] → [OpenAI] → [MultiWA Send Text]

Order Notification​

  1. Webhook: Receive order from e-commerce
  2. MultiWA Node: Send order confirmation
  3. MultiWA Node: Send invoice PDF
[Webhook] → [MultiWA Text] → [MultiWA Document]

Lead Capture​

  1. Trigger: MultiWA Trigger (Message Received)
  2. Google Sheets: Add contact
  3. MultiWA Node: Send welcome message
[MultiWA Trigger] → [Google Sheets] → [MultiWA Send Text]

Node Configuration​

Send Text​

ParameterDescription
Profile IDWhatsApp profile to use
ToRecipient phone number
TextMessage content

Send Image​

ParameterDescription
Profile IDWhatsApp profile
ToRecipient
Image URLDirect link to image
CaptionOptional caption

Trigger​

ParameterDescription
EventEvent type to listen for
Profile IDFilter by profile (optional)

Tips​

  1. Use expressions for dynamic content: {{ $json.customer_name }}
  2. Error handling: Add Error Trigger for failed messages
  3. Rate limiting: Add Wait node between bulk sends
  4. Logging: Use n8n's execution history

← PHP SDK · Documentation Index · Docker Deployment →