360 Dialog by YOOV icon

360 Dialog by YOOV

Interact with 360 Dialog API
Join our community

Actions2

Overview

This n8n node allows you to send messages via the 360 Dialog API, specifically for WhatsApp messaging. It supports sending different types of messages: simple text, interactive messages (such as lists and reply buttons), and raw JSON payloads. This node is useful for automating WhatsApp communications, such as sending notifications, customer support replies, or interactive menus to users.

Practical examples:

  • Sending a plain text message to a customer's WhatsApp number.
  • Delivering an interactive list for users to select options (e.g., menu selection).
  • Sending a message with quick reply buttons for fast user responses.
  • Passing custom raw JSON data for advanced use cases.

Properties

Name Meaning
Recipient Number The WhatsApp phone number of the recipient. Required.
Type The type of message to send. Options: Text, Interactive, Raw Data.
Content The text content of the message. Only used when Type is Text.
Interactive Type The kind of interactive message. Options: List Messages, Reply Button. Only shown when Type is Interactive.
Header Header text for the interactive message. Only for Interactive messages.
Body Main body text for the interactive message. Required for Interactive messages.
Footer Footer text for the interactive message. Only for Interactive messages.
Reply Buttons Collection of reply buttons (each with Button ID and Button Title). Used when Interactive Type is Reply Button. Multiple buttons can be added.
Button Name The name displayed on the button that opens the list. Required when Interactive Type is List Messages.
List Sections Collection of sections for list messages. Each section has a title and rows; each row has a Title, ID, and Description. Used when Interactive Type is List Messages.
Raw Data Custom JSON payload to send as the message. Only used when Type is Raw Data.

Output

The node outputs a JSON object containing the response from the 360 Dialog API after attempting to send the message. The structure of this output will typically include:

  • Message ID: Unique identifier for the sent message.
  • Status: Delivery status or confirmation.
  • Error: If an error occurs and "Continue On Fail" is enabled, an error field with the error message will be present in the output.

Example output:

{
  "messages": [
    {
      "id": "gBEGkYiEB1VXAglK1ZEqA1YKPrU"
    }
  ]
}

If an error occurs and "Continue On Fail" is enabled:

{
  "error": "Invalid recipient number format"
}

Dependencies

  • External Service: Requires access to the 360 Dialog API for WhatsApp.
  • API Key: You must configure the yoov360DialogApi credential in n8n with your 360 Dialog API key.
  • n8n Configuration: No additional environment variables are required beyond the credential setup.

Troubleshooting

Common Issues:

  • Invalid recipient number: Ensure the phone number is in the correct international format.
  • Missing required fields: For interactive messages, ensure all required fields (like Body, Button Name, etc.) are filled.
  • API authentication errors: Make sure the API key is valid and correctly configured in n8n credentials.

Common Error Messages:

  • "Invalid recipient number format": Check the number formatting.
  • "Missing required parameter": Ensure all mandatory fields are provided based on the selected message type.
  • "Authentication failed": Verify your API credentials.

Links and References

Discussion