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" platform to enrich contact information by adding various types of details to a contact record. Specifically, the "Contato - Adicionar Informações" operation allows users to add detailed data such as CPF (Brazilian individual taxpayer registry), CNPJ (Brazilian company registry), postal code (CEP), email, or social media profiles to an existing contact.

This functionality is beneficial in scenarios where you want to maintain comprehensive and up-to-date contact records within your CRM or customer engagement system. For example, after collecting partial contact data, you can enrich contacts with official identification numbers, address details, or social media links to improve personalization and communication accuracy.

Practical examples:

  • Adding a CPF number to a contact for tax or identity verification.
  • Linking a contact's Instagram profile URL to their record for marketing segmentation.
  • Registering a full postal address (CEP, street, number, neighborhood, city, state) to enable location-based services or deliveries.

Properties

Name Meaning
ID Do Contato The unique identifier of the contact to be enriched. This is required to specify which contact will receive the additional information.
Tipo De Enriquecimento The type of data to add to the contact. Options include: CEP (postal code), CNPJ (company registry), CPF (individual registry), Email, Rede Social (social media).
CPF The CPF number of the contact. Required if the enrichment type is CPF. Format example: 000.000.000-00.
CNPJ The CNPJ number of the contact. Required if the enrichment type is CNPJ. Format example: 00.000.000/0000-00.
CEP The postal code of the contact. Required if the enrichment type is CEP. Format example: 00.000-000.
Endereço The street address linked to the CEP. Required if the enrichment type is CEP.
Número The street number of the address. Required if the enrichment type is CEP.
Complemento Additional address information (e.g., apartment, suite). Required if the enrichment type is CEP.
Bairro Neighborhood name. Required if the enrichment type is CEP.
Cidade City name. Required if the enrichment type is CEP.
Estado (UF) State abbreviation. Required if the enrichment type is CEP.
Tipo De Rede Social The social media platform type. Required if the enrichment type is Rede Social. Options include Bitbucket, Facebook, Flickr, GitHub, Google, Instagram, LinkedIn, Pinterest, Reddit, Spotify, Steam, Trello, Tumblr, Twitter, Vimeo, Vine, Web, WeChat, WordPress, Yahoo, YouTube.
URL Da Rede Social The URL of the social media profile. Required if the enrichment type is Rede Social.
Email The email address of the contact. Required if the enrichment type is Email.
Primário Boolean flag indicating whether this added information should be marked as primary for the contact. Applicable when the type is CNPJ, CPF, or CEP.

Output

The node outputs JSON data representing the result of the enrichment operation. This typically includes confirmation of the updated contact details or the enriched contact object as returned by the Clientes Online API.

No binary data output is indicated for this operation.

Dependencies

  • Requires an API key credential for authentication with the Clientes Online platform.
  • The node depends on the Clientes Online API service to perform contact enrichment actions.
  • Proper configuration of the API credentials in n8n is necessary for successful execution.

Troubleshooting

  • Missing Required Fields: If required fields for the selected enrichment type are not provided (e.g., CPF number when type is CPF), the node may throw validation errors. Ensure all mandatory fields for the chosen type are filled.
  • Invalid Contact ID: Providing an incorrect or non-existent contact ID will likely cause the API call to fail. Verify that the contact ID exists in the Clientes Online system.
  • API Authentication Errors: Incorrect or expired API credentials will prevent the node from connecting to the service. Check and update the API key credential if needed.
  • Network Issues: Connectivity problems can cause timeouts or failures. Confirm network access to the Clientes Online API endpoint.
  • Primary Flag Misuse: Setting the "Primário" flag incorrectly might lead to conflicts if multiple primary entries exist. Use this flag carefully according to business rules.

Links and References

Discussion