YCloud - Growsales AIInstall

Summary

Send a WhatsApp message directly and synchronously via the YCloud platform, supporting multiple message types including text, media, templates, location, interactive messages, reactions, and contacts.

Inputs

• From Phone Number (required) — WhatsApp Business phone number registered in YCloud to send the message from, selectable from your account or entered manually.
• To Phone Number (required) — Recipient's phone number, selectable from your YCloud contacts or entered manually.
• Message Type (required) — Type of WhatsApp message to send; options include text, audio, contacts, document, image, interactive, location, reaction, sticker, template, and video.
• Text (required) — Message text (up to 4096 characters) with WhatsApp formatting, used when message type is 'text'.
• Preview URL — Enable link preview generation for text messages.
• Template (required) — Name of the WhatsApp message template from your YCloud account, used when message type is 'template'.
• Template Language (required) — Language code of the selected template.
• Template Header Type — Type of header in the template; affects which header fields are shown (text variable, image, video, document).
• Template Header Variable — Value to replace {{1}} placeholder in a text header of the template.
• Template Header Media — URL or media ID for image, video, or document header in the template.
• Template Body Variables — Values for up to eight placeholders in the template body, depending on the template's variable count.
• Template Button URL Variables — URL suffix replacements for up to three buttons in the template, if applicable.
• Media ID or URL (required) — URL or media ID pointing to the media content for image, video, audio, document, or sticker message types.
• Caption — Caption text for image, video, or document messages.
• Filename — Filename shown to the recipient for document messages.
• Latitude (required) — Latitude coordinate for location message type.
• Longitude (required) — Longitude coordinate for location message type.
• Location Name — Name or title of the location for location messages.
• Location Address — Address description for location messages.
• Interactive JSON (required) — JSON string defining the structure of an interactive WhatsApp message, used when message type is 'interactive'.
• Reaction Message ID (required) — ID of the WhatsApp message to react to when sending a reaction message.
• Reaction Emoji — Emoji character to react with; leave empty to remove an existing reaction.
• Contacts JSON (required) — JSON array of contact card objects to send when message type is 'contacts'.
• Additional Fields — Optional additional parameters including reply context message ID, external ID, and unsubscribe filtering to skip sending to unsubscribed recipients.

Output shape

a JSON object representing the response from YCloud API confirming the message was sent or detailing errors

The response includes synchronous confirmation with message details or error information. If "Filter Unsubscribed" is enabled and the recipient has unsubscribed, the message will not be sent and the response will reflect this.

Examples

Example 1: Send a text message

From a registered WhatsApp Business number to a recipient's phone entered manually, with message type 'text' and text body specified.

Example 2: Send a template message

Select a registered WhatsApp Business number, recipient from contacts, choose a template and its language, fill template variables and optional buttons, then send synchronously.

Links

• n8n community nodes installation guide