Plug Chat icon

Plug Chat

Create and edit data in PlugChat

Actions6

Overview

The Plug Chat node for n8n allows you to create and manage WhatsApp groups via the PlugChat API. Specifically, when using the Group resource with the Create operation, this node enables automated creation of new WhatsApp groups and addition of members by their phone numbers. This is useful in scenarios such as onboarding users into a support or community group, automating marketing campaign group creation, or managing event-based group chats.

Example use cases:

  • Automatically create a WhatsApp group for new customers and add them upon signup.
  • Set up temporary groups for event participants and send them updates.
  • Batch-create groups for segmented marketing campaigns.

Properties

Name Type Meaning
Name String The name of the WhatsApp group to be created.
Phones Collection/List A list of phone numbers (with country code) to add as group members.

Details

  • Name: The display name for the group; required for group creation.
  • Phones: A collection where each entry contains a "Phone" field (string), representing a member's phone number including the country code.

Output

The node returns the response from the PlugChat API after attempting to create the group. The structure of the json output field will depend on the API's response, but typically includes information about the newly created group or an error message if the operation fails.

Example output (success):

{
  "groupId": "1234567890@group.whatsapp.com",
  "status": "created",
  "groupName": "My New Group",
  "phonesAdded": ["+12345678901", "+10987654321"]
}

Example output (error):

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

Dependencies

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

Troubleshooting

Common Issues:

  • Invalid Phone Numbers: If phone numbers are not in the correct format (including country code), the API may return an error.
  • Missing Required Fields: Omitting the group name or phone list will result in validation errors.
  • Authentication Errors: Incorrect or missing API credentials will prevent the node from working.

Error Messages:

  • "Invalid phone number format": Ensure all phone numbers include the country code and contain only digits.
  • "Missing required parameter: groupName": Provide a valid group name.
  • "Authentication failed": Check your PlugChat API credentials in n8n.

Links and References

Discussion