WSAPI icon

WSAPI

Interact with WSAPI WhatsApp API

Overview

This node integrates with the WSAPI WhatsApp API to perform various operations related to WhatsApp contacts, including updating a contact's full name. The "Update Full Name" operation under the "Contact" resource allows users to modify the display name of a WhatsApp contact in their address book.

Common scenarios for this node include:

  • Keeping your WhatsApp contact list up-to-date with accurate and complete names.
  • Automatically syncing or standardizing contact names from external systems.
  • Personalizing contact names for better identification in messaging workflows.

For example, you might use this node to update a contact's full name from "John" to "John Smith" after receiving more detailed information.

Properties

Name Meaning
Contact ID WhatsApp contact identifier in the format: phone number with country code + @s.whatsapp.net (e.g., 1234567890@s.whatsapp.net). This uniquely identifies the contact to update.
Full Name The complete display name for the contact as it should appear in your contacts (e.g., "John Smith" or "ABC Company").

Output

The node outputs JSON data representing the result of the update operation. Typically, this will include confirmation details such as the updated contact information or status messages indicating success.

If the operation returns binary data (not typical for this operation), it would represent associated media or files, but for updating a contact's full name, output is expected to be purely JSON.

Dependencies

  • Requires an active connection to the WSAPI WhatsApp API via an API key credential configured in n8n.
  • The node uses the base URL provided by the credential configuration to send requests.
  • No additional external dependencies are required beyond the WSAPI service.

Troubleshooting

  • Invalid Contact ID Format: Ensure the Contact ID follows the exact format: phone number with country code plus @s.whatsapp.net. For example, 1234567890@s.whatsapp.net.
  • Missing Required Fields: Both Contact ID and Full Name are mandatory. Omitting either will cause errors.
  • API Authentication Errors: Verify that the API key credential is correctly set up and has sufficient permissions.
  • Operation Not Implemented Error: If you receive an error stating the operation is not implemented, confirm that you selected the correct Resource ("Contact") and Operation ("Update Full Name").
  • Network or API Errors: Check network connectivity and WSAPI service status if requests fail unexpectedly.

Links and References

Discussion