WhatMasterInstall

Overview

This node integrates with the WhatMaster API to perform various WhatsApp-related actions. Specifically, for the Contato (Contact) resource and the Criar Contato (Create Contact) operation, it allows users to create a new contact in the WhatMaster system by providing details such as the WhatsApp number, contact name, email, and an optional external key.

Common scenarios where this node is beneficial include:

• Automating the addition of new contacts from other systems or forms into the WhatsApp contact list managed by WhatMaster.
• Synchronizing customer data between CRM platforms and WhatsApp contact lists.
• Streamlining communication workflows by ensuring contacts are pre-registered before sending messages.

Practical example:

• A business collects customer information via a web form and uses this node to automatically create corresponding WhatsApp contacts, enabling personalized messaging campaigns.

Properties

Output

The node outputs a JSON object representing the response from the WhatMaster API after attempting to create the contact. This typically includes confirmation details about the newly created contact or error information if the creation failed.

No binary data output is produced by this operation.

Example output structure (simplified):

{
  "id": "contact_id",
  "number": "5511999999999",
  "name": "Contact Name",
  "email": "contact@example.com",
  "externalKey": "optional_external_key",
  "status": "created"
}

Dependencies

• Requires configuration of WhatMaster API credentials, including:
  • A Bearer token for authentication.
  • An external code identifier used in the API URL path.
• The node makes HTTP requests to the WhatMaster API endpoint:
  https://back.whatmaster.com.br/v1/api/external/{externalCode}

Troubleshooting

• Missing Credentials: If the API credentials are not configured or incomplete (missing token or external code), the node will throw errors prompting to configure them.
• Required Fields Missing: The WhatsApp number is mandatory; omitting it will cause an error. Ensure the number is in the correct format.
• API Errors: If the API returns an error (e.g., invalid number format, duplicate contact), the node will output the error message in the JSON response.
• Network Issues: Connectivity problems to the WhatMaster API endpoint can cause request failures.

To resolve common errors:

• Verify that the WhatMaster API credentials are correctly set up in n8n.
• Confirm all required input fields are provided and correctly formatted.
• Check network connectivity and API availability.

Links and References

• WhatMaster API Documentation (Assumed based on URL pattern; verify actual docs)
• n8n documentation on HTTP Request Node for understanding API calls.
• WhatsApp number formatting guidelines for international numbers.