Clientes Online - WhatsApp icon

Clientes Online - WhatsApp

Interação com a Plataforma de Relacionamento via WhatsApp - Clientes.Online

Actions59

Overview

This node integrates with the "Clientes Online" WhatsApp relationship platform, enabling various operations related to WhatsApp contacts and messaging. Specifically, the "Contato - Importar" operation allows users to import a new WhatsApp contact into the platform by providing essential contact details such as phone number, name, and optionally the channel ID.

Typical use cases include:

  • Adding new customer contacts from external sources into the WhatsApp communication platform.
  • Automating the onboarding of contacts for marketing or support campaigns.
  • Synchronizing contact lists from other systems into the WhatsApp-based CRM.

For example, a business could use this node to import a customer's WhatsApp number and name automatically when they sign up on a website, ensuring immediate availability for messaging and engagement through the platform.

Properties

Name Meaning
Número De WhatsApp Do Contato The WhatsApp phone number of the contact, including country code (e.g., +5527999999999). Required.
Nome The name of the contact to be imported. Required.
ID Do Canal Do WhatsApp The identifier of the WhatsApp channel from which the contact originates. If omitted, the main channel is used. Recommended not to use the main channel if possible.
O Padrão Do Contato Deve Ser 5511999999999 A notice recommending the standard format for the contact number (Brazilian format suggested).

Output

The node outputs JSON data representing the result of the contact import operation. This typically includes confirmation details about the imported contact, such as its unique identifier within the platform and any metadata returned by the API.

No binary data output is involved in this operation.

Dependencies

  • Requires an API key credential for authenticating with the Clientes Online WhatsApp platform.
  • The node depends on the Clientes Online API service being accessible and properly configured.
  • No additional environment variables are explicitly required beyond the API authentication setup.

Troubleshooting

  • Common Issues:

    • Invalid phone number format: Ensure the phone number includes the country code and follows the recommended pattern (e.g., +5511999999999).
    • Missing required fields: Both the phone number and name must be provided; otherwise, the import will fail.
    • Channel ID errors: If specifying a channel ID, verify it exists and is valid; otherwise, the system defaults to the main channel.
    • API authentication failures: Confirm that the API key credential is correctly set up and has necessary permissions.
  • Error Messages:

    • Errors related to invalid input parameters usually indicate missing or malformed phone numbers or names.
    • Authentication errors suggest issues with the API key or connectivity.
    • Server-side errors may occur if the platform is down or the request payload is incorrect.

Resolving these generally involves validating inputs, checking credentials, and ensuring network connectivity.

Links and References

  • Clientes Online Official Website (for platform documentation and API references)
  • WhatsApp Business API guidelines (for phone number formatting and channel management best practices)

Discussion