Documentation · Zamili

Platform Overview

Zamili.ai is an enterprise-grade workflow automation infrastructure—a full Platform-as-a-Service (PaaS) that powers multi-channel customer engagement, lead capture, content moderation, and business process automation. It is not limited to a single channel: the platform orchestrates Instagram, WhatsApp, email, AI moderation, link tracking, and more through a unified visual workflow engine.

Enterprise-Level Capabilities

Designed for businesses, agencies, and teams at scale: multi-tenant architecture, token-based billing, plan-based permissions, API access (Enterprise), dedicated processing, and extensible node types. From free tier to enterprise, the same infrastructure powers your automation.

Visual Workflow Engine

Drag-and-drop workflow builder with triggers, conditions, actions, and utilities. Create complex automation logic without code.

Multi-Channel Integrations

Instagram (comments, DMs), WhatsApp (messages, templates), Gmail, link tracking. Connect channels and orchestrate flows across them.

AI-Powered Moderation

Slang Detector via OpenRouter: flag profanity, hate speech, spam, harassment. Configurable sensitivity and auto-hide/delete.

Analytics & Publishing

Content scheduling, analytics, inbox, and performance tracking. Plan-based access to advanced features.

Lead Capture & Store

Ask Question, Validate Email, Store Lead, Parse Menu. Build forms and funnels inside conversations.

API & Extensibility

Enterprise API access, webhooks, workflow definitions. Integrate Zamili into your stack.

Getting Started

Video tutorial

Watch this comprehensive tutorial to learn how to get started with Zamili.ai and build your first workflow automation.

Step 1: Connect Your Instagram Account

Navigate to Integrations in your dashboard
Click Connect Instagram
Authorize Zamili.ai to access your Instagram Business account
Your account will appear in the connections list

Note: You need an Instagram Business account to use Zamili.ai. Personal accounts are not supported.

Step 2: Create Your First Workflow

Go to Workflows in the dashboard
Click Create New Workflow
Add a trigger node (e.g., "New Comment" or "New DM")
Add condition nodes to filter messages
Add action nodes to respond automatically
Connect nodes with edges
Save and enable your workflow

Step 3: Test Your Workflow

After creating a workflow, test it by:

Sending a test DM or comment that matches your trigger conditions
Checking the workflow execution logs
Verifying that responses are sent correctly

Instagram Integration

Manage your connected Instagram Business accounts with powerful tools directly from the dashboard.

Account Management

In the Integrations or Instagram page, you can access the "Manage" modal for any connected account:

Refresh Token: Manually refresh your access token if it expires or becomes invalid.
Load Media: View your recent Instagram media (posts, reels) directly in the dashboard to verify connection and content access. Images are loaded in a responsive grid.
Disconnect: Safely remove an account from Zamili.ai.

Token Expiry: Instagram access tokens are valid for 60 days. Zamili.ai automatically attempts to refresh them, but you can do it manually if needed.

OpenRouter Integration (AI)

Zamili.ai uses OpenRouter to power AI nodes such as the Slang Detector. Each user gets a dedicated OpenRouter API key provisioned automatically on registration and first login.

Connecting OpenRouter

Go to Integrations in your dashboard
Click Connect OpenRouter
You will be redirected to OpenRouter to authorize. If you already have an account, you'll see "Already connected" and can proceed to model selection
Select your preferred free AI model from the model selector

Free AI Models

The platform fetches available free models from OpenRouter's API. Default models include:

z-ai/glm-4.5-air:free – Fast, capable model
openai/gpt-oss-120b:free – Large open model
meta-llama/llama-3.3-70b-instruct:free – Meta's Llama 3.3

Scroll horizontally in the model selector to see all available free models. Each card shows context length, vision support, tools support, and other capabilities.

Slang Detector & AI Nodes

The Slang Detector node uses your selected OpenRouter model to moderate content (profanity, hate speech, spam, harassment). Workflows containing AI nodes consume 5 tokens per execution instead of 1. AI nodes require Starter plan or higher; Free plan cannot use them.

One key per user: Each user has a single OpenRouter key. Changing your key revokes the previous one. Keys are provisioned automatically—no manual API key entry required.

WhatsApp Integration

Connect your WhatsApp Business account to trigger workflows on incoming messages and send replies via the WhatsApp Reply node.

Requirements

Plan: Starter, Pro, or Enterprise (Free plan cannot use WhatsApp)
Account: WhatsApp Business API account (via Meta)

Connecting WhatsApp

Go to Integrations in your dashboard
Click Connect WhatsApp (visible only on Starter+ plans)
Follow the Meta Business Suite flow to link your WhatsApp Business number
Once connected, you can use WhatsApp Message (trigger) and WhatsApp Reply (action) nodes in workflows

Account Limits by Plan

Starter: 1 WhatsApp account, 200 messages included
Pro: 3 WhatsApp accounts, 1,000 messages included
Enterprise: Unlimited accounts, 5,000 messages included

Templates vs Session Messages

Outside the 24-hour messaging window, you must use pre-approved templates. The WhatsApp Reply node supports both plain text (within 24hr window) and template messages. Ensure template body parameters match your template definition.

Content Publishing & Scheduling

Plan, create, and schedule your Instagram content ahead of time with our advanced publishing tools.

Calendar View

The visual calendar provides a monthly, weekly, or daily view of your scheduled content. Drag and drop posts to reschedule them instantly.

Post Scheduling

Create new posts with the following features:

Media Upload: Upload images or videos. Our built-in tool automatically resizes and crops images to meet Instagram's aspect ratio requirements (1:1 square, 4:5 portrait, or 1.91:1 landscape).
Captioning: Rich text captions with hashtag and mention support.
Timezone Support: Schedule posts in your specific timezone.
Recurrence: Set posts to repeat daily, weekly, or monthly until a specific date.
Auto-Repost: Automatically repost successful content based on engagement metrics.

Platform Support

While primarily optimized for Instagram, the scheduler supports selecting other platforms (Facebook, LinkedIn, TikTok, etc.) for future cross-posting capabilities.

Understanding Workflows

A workflow is a visual representation of your automation logic. It consists of:

Trigger Node

→

Condition Node

→

Action Node

Workflow Components

Trigger Nodes

TRIGGER

Trigger nodes start your workflow when a specific event occurs (e.g., new comment, new DM).

Condition Nodes

UTILITY

Condition nodes check if certain criteria are met (e.g., keyword contains, post ID matches).

Action Nodes

ACTION

Action nodes perform tasks (e.g., send DM, reply to comment, publish post).

Analytics & Insights

Track the performance of your automations and content strategy with comprehensive analytics.

Visual Dashboards

Our new interactive dashboards provide real-time insights:

Daily Executions Graph: Visualize the volume of workflow runs and automation rule responses over the last 30 days.
Engagement Trends: Track daily Likes and Comments across your connected accounts to measure audience interaction.

Key Metrics

Total Executions: Aggregate count of all automated actions performed.
Response Rate: Percentage of incoming messages/comments handled automatically.
Workflow Success Rate: Ratio of successfully completed workflows vs. failures.

Interactive Workflow Simulator

Try building a workflow yourself! Drag nodes onto the canvas and connect them to see how workflows work.

Build Your Workflow

New Comment

New DM

Condition

Reply DM

Reply Comment

Drop nodes here

Drag nodes from above and connect them

Simulation Results

Workflow JSON Live Simulation

Run the real Zamili.ai workflow definition with realistic Instagram events. Pick a ready-made scenario or craft your own comment/DM data to see how triggers, conditions and actions execute in sequence.

Workflow Overview

Loading Zamili demo workflow…

Triggers

–

Conditions

–

DM Actions

–

Comment Actions

–

{
  "name": "Zamili Demo Workflow",
  "nodes": [
    ["node_comment_trigger", "instagram.new_comment"],
    ["node_slang_guard", "util.slang_detector"],
    ["node_check_keyword", "condition.if"],
    ["node_check_post", "condition.if"],
    ["node_dm_learn", "instagram.reply_dm"],
    ["node_comment_confirm", "instagram.reply_comment"],
    ["node_comment_fallback", "instagram.reply_comment"],
    ["node_comment_default", "instagram.reply_comment"],
    ["node_dm_trigger", "instagram.new_dm"],
    ["node_convo_check", "util.conversation_step"],
    ["node_dm_cond_learn", "condition.if"],
    ["node_parse_menu", "util.parse_menu"],
    ["node_dm_cond_pricing", "condition.if"],
    ["node_dm_send_learn", "instagram.reply_dm"],
    ["node_link_learn", "link.create"],
    ["node_validate_email", "util.validate_email"],
    ["node_email_learn", "email.send"],
    ["node_convo_set_complete", "util.conversation_step"],
    ["node_dm_send_pricing", "instagram.reply_dm"],
    ["node_dm_default", "instagram.reply_dm"]
  ],
  "edges": [
    ["node_comment_trigger", "node_slang_guard"],
    ["node_slang_guard", "node_check_keyword", "true"],
    ["node_slang_guard", "node_comment_default", "false"],
    ["node_check_keyword", "node_check_post", "true"],
    ["node_check_keyword", "node_comment_default", "false"],
    ["node_check_post", "node_dm_learn", "true"],
    ["node_check_post", "node_comment_default", "false"],
    ["node_dm_learn", "node_comment_confirm"],
    ["node_dm_learn", "node_comment_fallback", "error"],
    ["node_dm_trigger", "node_convo_check"],
    ["node_convo_check", "node_dm_cond_learn", "start"],
    ["node_dm_cond_learn", "node_parse_menu", "true"],
    ["node_dm_cond_learn", "node_dm_cond_pricing", "false"],
    ["node_parse_menu", "node_dm_send_learn", "true"],
    ["node_parse_menu", "node_dm_send_learn", "false"],
    ["node_dm_send_learn", "node_link_learn"],
    ["node_link_learn", "node_validate_email"],
    ["node_validate_email", "node_email_learn", "true"],
    ["node_validate_email", "node_dm_default", "false"],
    ["node_email_learn", "node_convo_set_complete"],
    ["node_convo_set_complete", "node_dm_default"],
    ["node_dm_cond_pricing", "node_dm_send_pricing", "true"],
    ["node_dm_cond_pricing", "node_dm_default", "false"],
    ["node_dm_send_pricing", "node_dm_default"]
  ]
}
            

3D Workflow Graph

Triggers (blue), conditions (amber), and actions (green) orbit in real time. Hover nodes for info, click to view details.

Drag to orbit · Scroll to zoom · Double click to reset

Event Type

Commenter Username

Comment Text

Post ID

Sender Username

DM Text

Simulate DM failure (user inbox closed / 24h window expired)

Need inspiration? Select any scenario card or tweak the data above.

Pick a scenario or run a simulation to visualise the workflow execution in real-time.

Fake Meta API Trace

Awaiting workflow run...

Run any scenario and we will fabricate the request & response payloads so reviewers can see what Zamili would send to Meta.

Node Reference

Trigger Nodes

Instagram New Comment

TRIGGER

Triggers when a new comment is posted on your Instagram posts.

Connection: Instagram Business Account

Comment Contains: learn,ai,automation

Example Use Case

When someone comments "learn" or "AI" on your post, trigger a workflow that sends them a DM with educational resources.

Instagram New DM

TRIGGER

Triggers when you receive a new direct message.

Connection: Instagram Business Account

Message Contains: pricing,support,help

Example Use Case

Automatically respond to DMs containing "pricing" with your pricing information, or "support" with help resources.

Link Click Trigger

TRIGGER

Triggers when a user clicks on a specific tracked link (e.g., from Bio or Story).

Link ID: Select Tracked Link...

Example Use Case

Link in Bio: User clicks your "Free Guide" link -> they are redirected to the PDF AND simultaneously receive a DM saying "Thanks for downloading! Here's a 10% off coupon."

WhatsApp Message

TRIGGER

Triggers when you receive a new WhatsApp message. Requires a connected WhatsApp Business account.

Connection: WhatsApp Business Account

Plan requirement: WhatsApp nodes require Starter plan or higher. Free plan cannot use WhatsApp.

Example Use Case

Build a lead capture flow: when someone sends "Hi" on WhatsApp, trigger a workflow that asks for their phone, validates it, and replies with a template or text message.

Condition Nodes

Condition If

UTILITY

Checks if a condition is true or false, routing the workflow accordingly. Supports multiple condition types.

Condition Types: contains, post_id, from, is_equal_to, message_length, is_following

Available Condition Types:

Contains: Checks if message/comment contains specific keywords
Post ID: Checks if comment is on a specific post
From: Checks if message is from specific username(s)
Is Equal To: Exact text match
Message Length: Checks message length (greater than, less than, equals)
Is Following: Checks if user is following your account

Example 1: Keyword Check

Condition Type: contains
Condition Contains: moustawrid,dzair,ai
Result: Routes to "true" if comment contains any of these keywords

Set Variable

UTILITY

Stores a value in the workflow context for use in subsequent nodes.

Variable Name: user_email

Value: {{message}} or static text

Validate Email

UTILITY

Checks email addresses stored in a variable and branches to true/false paths based on format validity.

Email Variable: user_email

Example

After capturing an email via DM, run Validate Email. Route the true edge to an Email Send node, and false back to a DM asking the user to try again.

Parse Menu Selection

UTILITY

Parses quick-reply / menu selections from a DM. Supports numeric choices (1/2/3) and keyword matching.

Message Variable: message

Menu Items: [{ label: "Pricing", value: "pricing" }, …]

Example

Let the user reply "1", "Pricing", or press a quick reply. Parse Menu Selection stores menu_selection plus menu_selection_label so you can branch to the right offer.

Conversation Step

UTILITY

Persists multi-step conversation state (check/set/update/clear) so you can build guided flows with context stored per user/thread.

Action: check · set · update · clear

Step: (for set) e.g. collecting_email

Example

Use check at the top of a workflow to route returning users to the correct step, set when you move to the next form question, and clear when the journey is complete.

Slang Detector

UTILITY

Runs AI-powered content moderation via OpenRouter to flag profanity, hate speech, spam, or harassment. Routes to true/false labels and can automatically hide or delete bad content.

Sensitivity: low · medium · high

Categories: profanity, hate_speech, spam, harassment

Action on Bad Content: None · Hide Comment · Delete Comment

Example 1: Auto-Moderation

Set Action on Bad Content to "Hide Comment" or "Delete Comment" to automatically moderate flagged content. The node will hide/delete the comment and then route to the false edge (content is not clean).

Example 2: Manual Review

Set Action on Bad Content to "None" to only flag content without taking action. Route the true edge (flagged) to a notification or manual review workflow.

Note: Requires an OpenRouter API key configured in your account settings. The Slang Detector uses free AI models for content moderation.

Plan requirement: Slang Detector (AI node) requires Starter plan or higher. Free plan cannot add, save, deploy, or run workflows containing AI nodes.

Create Link

ACTION

Creates a tracked short link that redirects to your URL. Useful for tracking clicks and analytics.

URL: https://example.com/page

Campaign: Optional campaign name

Action Nodes

Reply Instagram DM

ACTION

Sends a direct message to a user. Can be used to reply to DMs or send messages triggered by comments.

Connection: Instagram Business Account

Message Template: Hi {{sender_username}}!

Buttons: Optional quick replies or URL buttons

Example Configuration

Message: "Hi {{sender_username}}! Thanks for reaching out. Here's the link: https://example.com"

Variables Available: {{sender_username}}, {{sender_id}}, {{message}}, {{commenter_username}}

Reply Instagram Comment

ACTION

Replies to an Instagram comment publicly on your post.

Connection: Instagram Business Account

Message Template: Check your DMs!

Example Use Case

After successfully sending a DM, reply to the comment with a short note (e.g. "Check your DMs") so the user knows to look there.

WhatsApp Reply

ACTION

Sends a direct message via WhatsApp. Can send plain text or a pre-approved template (e.g., for 24hr window compliance). Supports variable interpolation.

Connection: WhatsApp Business Account

Message Type: Text or Template

Recipient: sender_phone, user_phone, or configured variable

Template Params: Body params for template messages (e.g., {{user_name}})

Plan requirement: WhatsApp nodes require Starter plan or higher. Free plan cannot use WhatsApp.

Example Use Case

After collecting a phone via Ask Question, validate and reply with a WhatsApp template: "Hi {{name}}, thanks for your interest! Here's your link: {{shortUrl}}"

Send Email (Gmail)

ACTION

Delivers transactional or follow-up emails through your connected Gmail account. Supports HTML or plain text bodies with variable interpolation.

Gmail Account: Connected Gmail ID

To: {{user_email}}

Subject: Welcome to Zamili!

Example

Pair with Validate Email + Parse Menu Selection to send tailored onboarding emails when someone chooses "Get Pricing" or "Book a Demo" inside Instagram DMs.

Edge Types & Routing

Understanding Edges: Edges connect nodes and define the workflow flow. Different edge types route execution differently.

Default Output (→)

Routes to the next node when action succeeds. Used for successful DM sends, comment replies, etc.

Error output

Routes when an action fails (e.g., DM closed, API error). Use for fallback responses.

True output

Routes when a condition evaluates to true (e.g., keyword found, post matches).

False output

Routes when a condition evaluates to false (e.g., keyword not found).

Quick Replies & Buttons

Enhance your DM responses with interactive buttons and quick replies to improve user engagement and streamline conversations.

Quick Replies

Quick replies appear as buttons below your message, allowing users to respond with a single tap.

{
  "recipient": { "id": "1189918569856602" },
  "message": {
    "text": "Choose an option:",
    "quick_replies": [
      {
        "content_type": "text",
        "title": "Pricing",
        "payload": "QR_PRICING"
      },
      {
        "content_type": "text",
        "title": "Support",
        "payload": "QR_SUPPORT"
      }
    ]
  }
}
            

Workflow Examples

Example 1: Keyword-Based Comment Automation

Scenario

Automatically send DMs to users who comment specific keywords on your posts, then reply to their comment.

Comment Trigger
Contains: learn,ai

→

Condition
Contains "learn"?

→

Send DM
Workshop link

→

Reply Comment
Check DMs!

Automation Rules

Automation Rules are post-specific automation configurations that automatically respond to comments on individual Instagram posts. Unlike workflows, automation rules are simpler and tied directly to specific posts.

Creating Automation Rules

Navigate to Posts in your dashboard
Select a post you want to automate
Click Manage or Automation Rules
Click Add Rule
Configure your rule:
- Rule Name: A descriptive name for your rule
- Trigger Type: Any Comment, Keyword, or Specific User
- Trigger Value: Keywords (comma-separated) or username
- Action Type: Reply to Comment, Send DM, or Both
- Max Responses: Limit how many times the rule can execute
Save and activate your rule

Rule configuration

Trigger Types: any_comment · keyword · specific_user

Action Types: reply_comment · send_dm · both

Response Limit: 1-100 responses per rule

Automation Rules vs Workflows

Automation Rules

Post-specific automation
Simple trigger → action
No visual builder
Quick setup
Limited to comments

Workflows

Account-wide automation
Complex logic with conditions
Visual workflow builder
More powerful
Comments, DMs, and more

Tip: Use Automation Rules for simple post-specific responses, and Workflows for complex, multi-step automation logic.

Subscription Plans & Limits

Zamili.ai offers different subscription tiers with varying limits and features. Understanding your plan's limits helps you optimize your automation strategy.

Available Plans

Free

Price: $0/month
Tokens: 500/month
Workflows: 5 max
Automation Rules: 5 max
Executions: 200 max
Instagram: 1 account
WhatsApp: Not available (0 accounts)
Features: Analytics, Posts, Workflows (no chat, no publish, no inbox)
Restricted: AI nodes (Slang Detector), WhatsApp nodes, Publish Content, Inbox

Starter

Price: $9/month or $90/year
Tokens: 10,000/month
Workflows: 20 max
Automation Rules: 20 max
Executions: Unlimited
Instagram: 3 accounts
WhatsApp: 1 account (200 messages included)
Features: All Free + Chat, Publish, Inbox, AI nodes, WhatsApp nodes

Pro

Price: $29.99/month or $290/year
Tokens: 50,000/month
Workflows: 50 max
Automation Rules: 50 max
Executions: Unlimited
Instagram: 5 accounts
WhatsApp: 3 accounts (1,000 messages included)
Features: All Starter + Advanced analytics, WhatsApp Flow Builder

Enterprise

Price: $140/month or $1,400/year
Tokens: 200,000/month
Workflows: Unlimited
Automation Rules: Unlimited
Executions: Unlimited
Instagram / WhatsApp: Unlimited
WhatsApp: 5,000 messages included
Features: All Pro + API access, dedicated processing, priority support

Plan-Based Node Restrictions

AI Nodes (Slang Detector)

Starter+ required. The Slang Detector and other AI-powered nodes use OpenRouter for content moderation. Free plan users cannot add, save, deploy, or run workflows containing AI nodes. The node appears as a locked card in the palette with "Starter+ required."

WhatsApp Nodes

Starter+ required. WhatsApp Message (trigger) and WhatsApp Reply (action) nodes are only available on Starter, Pro, and Enterprise plans. Free plan has 0 WhatsApp accounts. The nodes appear as locked cards in the palette with "Starter+ required."

Token Usage

Workflow Execution Tokens

Normal workflow: 1 token per execution
AI-heavy workflow (contains Slang Detector or other AI nodes): 5 tokens per execution

Token top-up packs are available if you exceed your monthly allowance.

Understanding Limits

Execution Limit (Free Tier)

Free tier users have a limit of 200 workflow executions. Once reached:

All workflows are automatically disabled
You'll see a notification to upgrade
Workflows cannot be enabled until you upgrade or the limit resets

Note: Both workflow executions and automation rule executions count toward this limit.

Workflow & Rule Limits

Each plan has limits on the number of workflows and automation rules you can create:

You cannot create new workflows/rules once you reach your plan's limit
Deleting workflows/rules frees up slots for new ones
Upgrading your plan increases your limits

Important: Check your current usage in the dashboard before creating new workflows or automation rules to avoid hitting limits unexpectedly.

Variables & Placeholders

Zamili.ai supports dynamic variable interpolation in message templates. Use placeholders to personalize your automated responses.

Available Variables

Comment-Related Variables

{comment_text} The full text of the comment

{commenter_username} Instagram username of the commenter

{username} Alias for commenter_username

{commenter_id} Instagram user ID of the commenter

{comment_id} Unique ID of the comment

{post_id} ID of the post where comment was made

DM-Related Variables

{sender_username} Instagram username of the DM sender

{sender_id} Instagram user ID of the sender

{message} The DM message text

{message_id} Unique ID of the message

WhatsApp-Related Variables

{sender_phone} Phone number of the WhatsApp message sender

{user_phone} Phone number stored in workflow (e.g., from Ask Question)

{wa_user_id} WhatsApp user ID (waba ID format)

{message} The WhatsApp message text

Note: WhatsApp Reply uses sender_phone, user_phone, or wa_user_id to resolve the recipient. Configure "Recipient Phone" as {{user_phone}} when the phone was collected in a previous step.

System Variables

{time} Current time (e.g., "3:45 PM")

{date} Current date (e.g., "Dec 20, 2025")

Using Variables

Example 1: Comment Reply

Template: "Hi {username}! Thanks for your comment: {comment_text}. Check your DMs for more info."

Result: "Hi @john_doe! Thanks for your comment: This is amazing!. Check your DMs for more info."

Example 2: DM Response

Template: "Hey {sender_username}! I received your message at {time} on {date}. How can I help?"

Result: "Hey @jane_smith! I received your message at 3:45 PM on Dec 20, 2025. How can I help?"

Note: Variables support both single braces {variable} and double braces {{variable}} formats for compatibility.

Testing & Validation

Before deploying your workflows, Zamili.ai provides built-in testing and validation to ensure your automation works correctly.

Test Before Deploy

Every workflow must pass validation and testing before it can be deployed:

Validation: The system checks:
- At least one trigger node exists
- All required fields are filled
- Logical connections are valid (e.g., DM trigger can't connect to comment reply)
- All nodes are reachable from a trigger
Test Run: The system simulates the workflow with random data:
- Generates random Instagram IDs and usernames
- Simulates webhook events
- Executes nodes in sequence
- Shows detailed execution logs
Deployment: Only proceeds if test is successful

Validation checks

Trigger node present
Required fields completed (connection, message template, etc.)
Valid node connections (no incompatible node chains)
All nodes reachable
Gmail account selected for email nodes
Instagram connection selected for Instagram nodes

Common Validation Errors

"No trigger node found": Add at least one trigger node (New Comment or New DM)
"Missing required field": Fill in all required configuration fields
"Invalid connection": DM trigger cannot connect to comment reply node
"Unreachable node": Ensure all nodes are connected to a trigger

Test Workflow Button

The Test Workflow button allows you to:

Run validation checks
Simulate workflow execution with random data
View detailed execution logs
Debug issues before deployment

Best practice: Always test your workflow before deploying to production. The test uses simulated data, so it won't affect your real Instagram account.

Troubleshooting

Common issues and solutions to help you resolve problems quickly.

Workflow Issues

Workflow Not Triggering

Check Status: Ensure workflow is enabled (green toggle)
Verify Trigger Filters: Check if your comment/DM matches the trigger filters
Check Execution Limit: Free tier users may have reached the 200 execution limit
Verify Instagram Connection: Ensure your Instagram account is connected and active
Check Webhook Logs: View logs in the workflow console to see if events are being received

Workflow Disabling Takes Too Long

This is usually due to active SSE (Server-Sent Events) connections
Wait a few seconds - the system will timeout after 5 seconds
Refresh the page if it's stuck
The workflow will be disabled even if the UI shows loading

Automation Rules Issues

Rule Not Executing

Check Rule Status: Ensure rule is active
Verify Post ID: Rule must match the exact Instagram post ID
Check Trigger Match: Comment must match trigger type (keyword, any comment, or specific user)
Response Limit: Rule may have reached its max_responses limit
Self-Comment Filter: Rules don't trigger on your own comments

Instagram Connection Issues

Cannot Connect Instagram Account

Business Account Required: Only Instagram Business accounts are supported
Facebook Page Required: Your Instagram Business account must be connected to a Facebook Page
Permissions: Ensure you grant all required permissions during OAuth
Token Expired: Reconnect your account if tokens have expired

Message Template Issues

Variables Not Replacing

Check Syntax: Use {variable} or {{variable}} format
Variable Name: Ensure variable name matches exactly (case-sensitive)
Available Variables: Check which variables are available for your node type
Empty Result: If variable doesn't exist, it will be replaced with empty string

Subscription & Limits

Cannot Create Workflow

Check Limit: You may have reached your plan's workflow limit
Upgrade Plan: Consider upgrading to increase limits
Delete Old Workflows: Remove unused workflows to free up slots

Execution Limit Reached

Free Tier: 200 execution limit includes both workflows and automation rules
Upgrade Required: Upgrade to Starter+ for unlimited executions
Check Dashboard: View your current execution count in the dashboard

Slang Detector / AI Node Locked

Plan Restriction: AI nodes (Slang Detector) require Starter plan or higher
Free Plan: The node appears as a locked card with "Starter+ required"
Cannot Save/Deploy: Workflows with AI nodes cannot be saved or deployed on Free plan
Upgrade: Upgrade to Starter+ to unlock AI nodes

WhatsApp Nodes Locked or Not Working

Plan Restriction: WhatsApp Message and WhatsApp Reply require Starter plan or higher
Free Plan: Free has 0 WhatsApp accounts; nodes appear as locked in the palette
Connect WhatsApp: In Integrations, connect your WhatsApp Business account (Starter+ only)
Template Parameters: For template messages, ensure body params match the template; use {{variable}} in template params

Getting Help

Support: If you're still experiencing issues, check the workflow execution logs, automation rule responses, and webhook logs for detailed error messages. Contact support at support@zamili.ai with error details.

Security & compliance

Zamili.ai is built for production use with industry-standard authentication, encryption in transit, and least-privilege access to social and messaging APIs.

Authentication

JWT-based sessions with HTTP-only cookies where applicable
Instagram / Meta OAuth 2.0 — credentials are never stored as plaintext passwords
Rotate and revoke tokens from the dashboard when staff change roles

Data handling

Customer messages and workflow payloads are processed only to execute your configured automation
Use Automation Rules and Workflows aligned with your data-retention and DPA policies
Export or delete user data per your organisational procedures (contact support for bulk requests)

Platform compliance

Instagram integrations use official Meta APIs — avoid circumvention tools that violate channel terms
WhatsApp templates must follow Meta template approval rules
Maintain accurate business information for billing, taxation, and audit trails

Enterprise: Dedicated processing and custom integrations are available on Enterprise. For security questionnaires or DPIA assistance, email support@zamili.ai.

Best Practices

Workflow Design

Start Simple: Begin with basic workflows and gradually add complexity
Test Thoroughly: Always test workflows before enabling them
Use Conditions: Add condition nodes to filter and route messages appropriately
Handle Errors: Always add error edges to handle failed actions gracefully

Need Help?

Visit zamili.ai or contact our support team