WhatsApp API icon

WhatsApp API

Integração com WhatsApp API para envio de mensagens e gerenciamento
Join our community

Actions20

Overview

This node integrates with a WhatsApp API to manage contacts, send messages, handle tickets, sessions, and opportunities. Specifically for the Contact - Create operation, it allows users to create a new WhatsApp contact by providing essential details such as the contact's full name, WhatsApp number, and optionally an email address.

Common scenarios where this node is beneficial include:

  • Automating the addition of new customer contacts into a WhatsApp-based CRM system.
  • Synchronizing contact data from other platforms or forms into WhatsApp contact lists.
  • Preparing contact information before sending targeted WhatsApp messages or campaigns.

Practical example:

  • When a new lead fills out a web form, this node can automatically create a corresponding WhatsApp contact to enable direct messaging through WhatsApp.

Properties

Name Meaning
Contact Name Full name of the contact to be created.
Contact Number WhatsApp phone number of the contact in international format (e.g., 5511999999999).
Email Email address of the contact (optional).

Output

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

Example output structure (simplified):

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

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the WhatsApp API service.
  • The node expects configuration of the base URL and instance ID of the WhatsApp API in the credentials.
  • Network access to the WhatsApp API endpoint is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing WhatsApp number format may cause API rejection.
    • Missing required fields like Contact Name or Contact Number will prevent successful creation.
    • Incorrect or expired API credentials will result in authentication errors.
    • Network connectivity problems can cause request failures.

  • Error messages and resolutions:

    • "Unauthorized" or "Authentication failed": Verify that the API key credential is correctly configured and valid.
    • "Invalid phone number": Ensure the contact number is in the correct international format without spaces or special characters.
    • "Missing required fields": Confirm all mandatory properties are provided.
    • "Request timeout" or "Network error": Check network connectivity and API availability.

Links and References

Discussion