Wassenger icon

Wassenger

Interact with Wassenger WhatsApp API
Join our community

Actions148

Overview

This node enables creating a new department within the Wassenger WhatsApp API environment. Departments help organize agents managing WhatsApp numbers by grouping them under identifiable units with specific names, colors, icons, and descriptions. This is useful for businesses that want to segment their customer support or sales teams by function, product line, or region.

Practical examples:

  • Creating a "Support" department with a blue color and headset icon to group all support agents.
  • Setting up a "Sales" department with a green color and handshake icon to manage sales team agents.
  • Organizing agents by WhatsApp number (device) so messages are routed appropriately.

Properties

Name Meaning
WhatsApp Number The ID of the WhatsApp number (device) to which this department belongs.
Name Department name, must be between 2 and 25 characters.
Color Department color for quick identification. Options include Ruby, Tomato, Orange, Sunflower, Bubble, Rose, Poppy, Rouge, Raspberry, Purple, Lavender, Violet, Pool, Emerald, Kelly, Apple, Turquoise, Aqua, Gold, Latte, Cocoa, Iron.
Icon Department icon identifier for visual representation. Options include Briefcase, Users, User Tie, Chart Bar, Clipboard List, Comments, Headset, User Cog, User Edit, User Friends, Laptop Code, Network Wired, Building, Handshake, Address Book, Layer Group, Project Diagram, Calendar Check, Clipboard Check, Tasks, Chart Pie, Hands Helping, Shield Alt, User Lock, User Shield, Bullhorn, Comments Dollar, Comment Dots, Fingerprint, Check Circle, Chalkboard Teacher, Cogs, Rocket, Drafting Compass, Lightbulb, Envelope, Inbox, People Carry, Code Branch, Globe, Hand Holding USD, Money Bill Wave, Phone, Wrench, Balance Scale, Thumbs Up, User Secret, User Graduate, Landmark, Archive.
Description Optional description of the department, up to 300 characters.
Agents List of agent IDs to include in the department. Requires between 1 and 30 agents.

Output

The node outputs JSON data representing the newly created department object as returned by the Wassenger API. This typically includes details such as the department's unique ID, name, color, icon, description, associated WhatsApp number, and list of agents.

If the operation fails and "Continue On Fail" is enabled, the output will contain an error message describing the failure.

No binary data output is produced by this node.

Dependencies

  • Requires an API key credential for authenticating with the Wassenger WhatsApp API.
  • The node depends on the Wassenger API being accessible and properly configured.
  • The "WhatsApp Number" (device) and agent IDs must exist and be valid within the Wassenger system.
  • The node uses internal methods to load options dynamically for devices and agents.

Troubleshooting

  • Common issues:

    • Invalid or missing WhatsApp number ID: Ensure the device ID corresponds to an existing WhatsApp number.
    • Agent list empty or exceeding limits: Provide between 1 and 30 valid agent IDs.
    • Department name length violations: Must be between 2 and 25 characters.
    • API authentication errors: Verify the API key credential is correct and has necessary permissions.

  • Error messages:

    • "error": "Invalid device ID" — Check the WhatsApp number input.
    • "error": "Agent list must contain at least one agent" — Add agents to the department.
    • "error": "Unauthorized" — Confirm API key validity and permissions.

  • Enabling "Continue On Fail" allows workflow execution to proceed despite errors, returning error details in output.

Links and References

Discussion