Clientes Online - WhatsApp icon

Clientes Online - WhatsApp

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

Actions59

Overview

This node integrates with the "Clientes Online - WhatsApp" platform to send marketing messages via WhatsApp and other channels. Specifically, the "Marketing - Mensagem - Enviar" operation allows users to send various types of messages (text, media, templates, location, vCard) to recipients through specified communication channels.

Common scenarios include:

  • Sending promotional or informational text messages to customers.
  • Delivering multimedia content such as images, videos, audio, or files.
  • Using pre-approved message templates for consistent branding and compliance.
  • Sharing location information or contact cards (vCards) for business purposes.

Practical examples:

  • A marketing team sending a campaign message with an image and caption to a WhatsApp contact.
  • Customer support sending a location map to guide a customer to a store.
  • Automated systems dispatching WABA (WhatsApp Business API) template messages with dynamic variables.

Properties

Name Meaning
Atenção: SPAM pode gerar penalidades em seu Canal Notice warning that WhatsApp may penalize accounts suspected of spamming.
Número De Telefone Recipient's phone number in international format (e.g., 5527998282828).
Nome Do Destinatário Recipient's name.
ID Canal Channel ID through which the message will be sent (e.g., Y0 for WhatsApp).
Tipo De Mensagem Type of message to send. Options: Arquivo (file), Áudio (audio), BSP Template (Interaxa), BSP Template (Messangi), Imagem (image), Mapa (map), Texto (text), VCard, Vídeo (video), WABA Template (WhatsApp Cloud API).
Texto Text content of the message (used for text, image, and video message types).
URL URL of the media to send (for image, video, audio, or file message types).
ID Do VCard Name of the vCard contact (for vCard message type).
Telefone Do VCard Phone number of the vCard contact in international format (for vCard message type).
Nome Do Local Name of the location to send on the map (for map message type).
Latitude Latitude coordinate of the location (for map message type).
Longitude Longitude coordinate of the location (for map message type).
ID Do Template Template ID for Interaxa BSP, Messangi BSP, or WABA templates (depending on message type).
Variáveis Template JSON object containing variables for WABA templates to dynamically fill placeholders.
Registro Do Template Do WhatsApp Business Api Cloud Notice indicating this is only for templates created in WhatsApp Business API Cloud (WABA templates).
Variáveis Do Messangi JSON object with variables used in Messangi BSP templates.
Registro Do Template Do BSP Messangi Notice indicating this is only for templates created in BSP Messangi.
Registro Do Template Do BSP Interaxa Notice indicating this is only for templates created in BSP Interaxa.

Output

The node outputs JSON data representing the response from the Clientes Online platform after attempting to send the message. This typically includes status information about the message delivery, any error messages, and identifiers related to the sent message.

If the message involves media, the output confirms successful transmission or provides error details.

Binary data output is not indicated for this operation.

Dependencies

  • Requires connection credentials to the Clientes Online API platform (an API key or token).
  • The node depends on the external Clientes Online service to send WhatsApp and other channel messages.
  • Proper configuration of the API credentials within n8n is necessary.
  • Network access to the Clientes Online API endpoints must be available.

Troubleshooting

  • SPAM Penalties: Users must heed the spam notice property; excessive or unsolicited messaging can lead to account penalties or suspension by WhatsApp.
  • Invalid Phone Number Format: Ensure the recipient phone number is in the correct international format without spaces or special characters.
  • Template Errors: When using templates (Interaxa, Messangi, WABA), ensure the template IDs are valid and variables match the expected structure. Incorrect template usage may cause message rejection.
  • Media URL Issues: For media messages, verify that the provided URLs are accessible and point to supported media formats.
  • Channel ID Misconfiguration: The channel ID must correspond to a valid and active channel configured in the Clientes Online platform.
  • API Credential Problems: Authentication failures due to invalid or missing API credentials will prevent message sending.
  • Error Messages: The node returns error details from the API response; review these messages to identify issues like quota limits, invalid parameters, or service outages.

Links and References

  • Clientes Online API Documentation — Reference for sending notifications including WABA template variable structures.
  • WhatsApp Business API official documentation for template messages and media message guidelines.
  • General best practices for WhatsApp messaging to avoid spam penalties.

Discussion