Plug Chat icon

Plug Chat

Create and edit data in PlugChat

Actions6

Overview

The Plug Chat node for n8n enables sending WhatsApp messages with interactive buttons to specified phone numbers. This is particularly useful for automating customer engagement, support workflows, or marketing campaigns where you want recipients to respond by tapping on predefined options (buttons) within the message.

Common scenarios:

  • Sending quick-reply options to customers (e.g., "Yes", "No", "More Info").
  • Automating surveys or feedback collection via WhatsApp.
  • Streamlining support ticket responses by offering button-based choices.

Example:
A business can send a message like "Would you like to receive our latest offers?" with buttons "Yes" and "No". The recipient simply taps a button to respond.

Properties

Name Type Meaning
Phone String Phone number with country code to which the message will be sent.
Message String The text content of the message to send.
Message ID String (Optional) ID of the message to reply to.
Delay Number (Optional) Delay in seconds before sending the message.
Buttons Fixed Collection A list of buttons to include with the message. Each button has an ID and a label.

Output

The node outputs a JSON object containing the response from the PlugChat API. The structure typically includes:

{
  // ...fields returned by the PlugChat API, such as:
  "status": "success",
  "messageId": "abc123",
  "details": { /* ... */ }
}

If an error occurs and "Continue On Fail" is enabled, the output will contain:

{
  "error": "Error message here"
}

Note: This node does not output binary data.

Dependencies

  • External Service: Requires access to the PlugChat API.
  • API Key: You must configure the plugChatApi credential in n8n.
  • Environment: No special environment variables are required beyond standard n8n setup.

Troubleshooting

Common Issues:

  • Invalid Phone Number: Ensure the phone number includes the country code and contains only digits.
  • Missing Required Fields: All required fields (Phone, Message, Buttons) must be provided.
  • API Authentication Errors: Make sure the plugChatApi credentials are correctly set up in n8n.
  • Button List Format: The "Buttons" property must be a non-empty array with each button having both an ID and a label.

Error Messages:

  • "error": "Missing required parameter: phone"
    Resolution: Provide a valid phone number.
  • "error": "Invalid API key"
    Resolution: Check your PlugChat API credentials in n8n.
  • "error": "Buttons must be provided"
    Resolution: Ensure at least one button is included in the "Buttons" property.

Links and References

Discussion