WaliChat icon

WaliChat

Interact with WaliChat WhatsApp API

Actions148

Send messages → Send meeting event

AI-generated

Overview

This node allows sending a WhatsApp meeting event message via the WaliChat WhatsApp API. It is designed to create and send calendar-like event invitations directly into WhatsApp chats, groups, or channels. This is useful for scheduling meetings, appointments, or reminders with rich event details such as name, description, date/time, location, and call type.

Practical scenarios include:

  • Sending meeting invites to clients or team members through WhatsApp.
  • Broadcasting event notifications to WhatsApp groups or channels.
  • Automating appointment reminders with event details and optional location coordinates.
  • Including voice or video call options linked to the event.

Properties

Name Meaning
WhatsApp number The target WaliChat Number ID used to send the message.
Target Type of target chat: Phone (individual), Group, or Channel.
Phone Number Target phone number in international E.164 format (e.g., +1234567890). Required if Target is Phone.
Group ID ID of the target group chat (e.g., 12345678902401234@g.us). Required if Target is Group.
Channel ID ID of the target channel (e.g., 12345678902402200@newsletter). Required if Target is Channel.
Event Name Name or title of the event (max 100 characters).
Event Description Optional detailed description of the event (up to 2048 characters).
Event Date and Time Date and time of the event in ISO 8601 format.
Event Location Optional location name for the event (up to 255 characters).
Location Coordinates Optional geographical coordinates (latitude between -90 and 90, longitude between -180 and 180) for the event location.
Meeting Call Type Type of WhatsApp call associated with the event: No Call, Voice Call, or Video Call.
Options Additional message options including:
- Priority (Normal, High, Low)
- Label (custom categorization)
- Reference ID
- Team Agent (send on behalf of an agent)
- Live mode (real-time delivery)
- Delivery queue mode
- Maximum retries
- Post-delivery chat actions (assign, resolve, label, metadata management)
Message Expiration Defines message TTL with options:
- Expire after seconds
- Expire after duration (e.g., 1h, 30m)
- Expire at specific date/time
Mark Chat as Read Whether to notify WhatsApp that previous unread messages are read after delivery (blue double-check).
Typing simulation Seconds to simulate typing or recording status before sending (0 disables). Range 2-30 seconds recommended.
Quote Message Message ID to quote when sending this event message (must be in same conversation).
Strict Message Order Ensures messages are sent in strict order to the chat. Useful for chatbots or sequences. Not compatible with live or never queue modes.

Output

The node outputs JSON data representing the result of the send meeting event operation. This typically includes confirmation details such as message IDs, status, timestamps, or error information if the operation failed.

No binary data output is expected from this operation.

Dependencies

  • Requires an active WaliChat WhatsApp API connection authenticated via an API key credential configured in n8n.
  • The node depends on WaliChat backend services to send WhatsApp messages and manage chats.
  • Some properties load dynamic options (e.g., devices, groups, channels, agents, labels) which require proper API access and permissions.

Troubleshooting

  • Invalid phone number format: Ensure phone numbers follow the E.164 format (e.g., +1234567890). Errors will occur if the regex validation fails.
  • Missing required fields: Event name, date/time, and target identifiers (phone/group/channel) are mandatory. Omitting these will cause errors.
  • Delivery failures: Using real-time delivery mode ("live" or "never queue") with high message volume may lead to WhatsApp bans or throttling.
  • Incorrect quoting: Quoting a message ID not in the same conversation will fail.
  • Agent or department IDs: Must be valid 24-character hexadecimal strings; invalid IDs will cause validation errors.
  • Message expiration misconfiguration: Ensure expiration times are within allowed ranges and correctly formatted.
  • Strict order conflicts: Using strict message order with incompatible delivery modes will cause errors.

To resolve issues, verify all inputs against their validation rules, check API credentials, and consult WaliChat API documentation for rate limits and usage policies.

Links and References

Discussion