Get in Touch

Have a question about the platform, need help with your integration, or want to discuss partnership opportunities and enterprise pricing? Drop us an email — we’ll do our best to get back to you within 3–4 hours.

contact@fiwano.com
Documentation menu

Working with an AI agent? Download the full documentation as a Markdown file to use as context.

Download full .md

n8n Integration

Fiwano is a verified n8n community node — listed on n8n.io/integrations/fiwano/. Use it to build WhatsApp, Instagram and Facebook Messenger automations, AI agent workflows, and chatbots.

Install

  1. Open the nodes panel with + or N
  2. Search for Fiwano
  3. Select Fiwano under More from the community
  4. Click Install

On n8n Cloud, installation may need to be enabled by the instance owner in the Cloud Admin Panel first.

Manual fallback (npm)

Use only when in-app installation is unavailable in your environment (e.g. restricted self-hosted setup).

mkdir -p ~/.n8n/nodes && cd ~/.n8n/nodes
npm install n8n-nodes-fiwano
# Restart n8n

For self-hosted Docker: build this package into a custom n8n image — see the GitHub repository for details.

Nodes

Node Type Description
Fiwano Action Send messages, manage channels, WhatsApp templates, contact profile enrichment, redirect URIs
Fiwano Trigger Webhook Trigger Receive incoming messages and delivery status webhooks with optional HMAC signature verification

Action node — operations

Resource Operations
Message Send Text, Send Template (WhatsApp), Send Media (image/audio/video/document)
Channel Get Many, Get, Generate OAuth URL, Exchange OAuth Code, Update Webhook, Delete
Contact Get Profile (Instagram, Facebook — returns name, profile picture, follower count)
Template Get Many, Get, Create, Delete (WhatsApp only)
Redirect URI Get Many, Add, Delete

Trigger node — events

Starts your workflow for any of these events (filter by event type in node settings):

Event Channels
message.received WhatsApp, Instagram, Facebook
message.delivered WhatsApp, Instagram, Facebook
message.read WhatsApp, Instagram, Facebook
message.sent WhatsApp
message.failed WhatsApp

HMAC-SHA256 signature verification is built into the trigger node. To enable it, set the channel's webhook_secret in the trigger's Webhook Secret field — the node then verifies every webhook against that secret and rejects mismatches with HTTP 401. The secret is the one you configured per-channel (via Exchange OAuth Code or Update Webhook); n8n stores your copy in the node, it is not fetched automatically. Leave the field empty to skip verification (not recommended in production).

Example workflow

A ready-to-import demo workflow is included in the GitHub repository covering every operation: echo bot with profile enrichment, channel management, template CRUD, text and template messaging.

Fiwano API Documentation