Relacio - WhatsApp icon

Relacio - WhatsApp

Interação com a Plataforma de Relacionamento via WhatsApp - Relacio

Actions58

Overview

This node integrates with a WhatsApp-based customer relationship platform, enabling users to send various types of messages directly to contacts stored in the client's database. The "Contato - Mensagem - Enviar" operation specifically allows sending customized notifications or messages to individual contacts via WhatsApp.

Common scenarios where this node is beneficial include:

  • Sending personalized text updates or alerts to customers.
  • Delivering multimedia content such as images, videos, audio, files, or location maps.
  • Using predefined message templates for consistent communication.
  • Sharing contact information via vCards.
  • Leveraging WhatsApp Cloud API templates for advanced messaging features.

Practical examples:

  • A business sending appointment reminders with a map location attached.
  • Customer support sending product manuals or instructional videos.
  • Marketing teams dispatching promotional templates to targeted contacts.
  • Sharing a digital business card (vCard) during networking events.

Properties

Name Meaning
Atenção: SPAM Pode Gerar Penalidades Em Seu Canal Notice warning that WhatsApp may penalize accounts identified as sending spam.
ID Do Contato The unique identifier of the contact in the client's database to whom the message will be sent.
Tipo De Mensagem The type of message to send. Options include: Arquivo (file), Áudio (audio), Imagem (image), Mapa (map), Template, Texto (text), vCard, Vídeo (video), WhatsApp Cloud Template.
Texto Da Mensagem Textual content of the message; applicable when sending text, image, or video messages.
URL Da Mídia URL pointing to the media content (image, video, audio, or file) to be sent.
Nome Do vCard Name of the contact in the vCard; used when sending vCard messages.
Telefone Do vCard Phone number included in the vCard.
Lugar No Mapa Name of the place to be sent on the map.
Latitude Latitude coordinate of the location on the map.
Longitude Longitude coordinate of the location on the map.
Template Template model to be used for sending template or WhatsApp Cloud Template messages.
Definir Canal A Ser Utilizado? Boolean flag to enable specifying which channel to use for sending the message.
Canal The specific channel to be used for sending the message if "Definir Canal A Ser Utilizado?" is true.
Utilizar Sempre Canais Secundários Notice advising to always use secondary channels for sending notifications; shown when specifying a channel.
ID De Identificação Do Template JSON object containing variables to personalize the WhatsApp Cloud API template.

Output

The node outputs an array of JSON objects representing the result of the message sending operation. Each output item typically contains details about the success or failure of the message delivery, including any response data from the WhatsApp platform or the integrated service.

If binary data is involved (e.g., media files), it would represent the media content sent or received, but this node primarily handles message sending and does not output binary data itself.

Dependencies

  • Requires an active connection to the Relacio WhatsApp platform via an API key credential configured in n8n.
  • Depends on the external WhatsApp messaging service accessible through the Relacio platform.
  • Network access to URLs provided for media content (images, videos, audio, files) must be available.
  • Proper configuration of channels if the user opts to specify a particular sending channel.

Troubleshooting

  • Spam Penalties: Users should heed the spam notice property. Sending unsolicited or bulk messages may lead to account penalties by WhatsApp.
  • Invalid Contact ID: If the contact ID does not exist or is incorrect, the message will fail to send. Verify the contact ID against the client’s database.
  • Incorrect Media URLs: Providing invalid or inaccessible URLs for media content will cause message sending errors.
  • Template Variables Missing or Malformed: When using WhatsApp Cloud Templates, ensure the JSON variables are correctly formatted and match the template requirements.
  • Channel Specification Errors: If specifying a channel, ensure the channel exists and is authorized for use; otherwise, message sending may fail.
  • API Authentication Failures: Ensure the API key credential is valid and has necessary permissions.

Common error messages might include:

  • "Contact not found" — check the contact ID.
  • "Invalid media URL" — verify the URL accessibility.
  • "Template variable error" — validate JSON structure and template placeholders.
  • "Unauthorized" or "Authentication failed" — confirm API credentials.

Links and References

Discussion