Relacio - WhatsApp icon

Relacio - WhatsApp

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

Actions58

Overview

This node integrates with a WhatsApp-based marketing and communication platform, enabling users to send various types of messages through specified channels. It is particularly useful for automating customer engagement, marketing campaigns, and direct messaging via WhatsApp or similar channels.

The "Marketing - Mensagem - Enviar" operation allows sending different message formats such as text, images, videos, audio, files, location maps, vCards (contact cards), and templated messages compliant with BSP (Business Solution Provider) or WhatsApp Business API Cloud templates.

Practical examples include:

  • Sending promotional text messages or multimedia content to customers.
  • Dispatching location information or contact cards for business purposes.
  • Using pre-approved message templates for consistent branding and compliance.
  • Automating notifications or alerts to clients via WhatsApp channels.

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). Default is Texto (text).
Texto Text content of the message (used if type is text, image, or video).
URL URL of the media to send (for image, video, audio, or file types).
ID Do VCard Name of the VCard contact (used if type is vcard).
Telefone Do VCard Phone number of the VCard contact in international format (used if type is vcard).
Nome Do Local Name of the location to send on the map (used if type is map).
Latitude Latitude coordinate of the location (used if type is map).
Longitude Longitude coordinate of the location (used if type is map).
ID Do Template Template ID for Interaxa, Messangi, or WhatsApp Business API Cloud templates (used if type is template, waba_template, or messangi).
Variáveis Do WABA JSON object containing variables to use in the WhatsApp Business API Cloud template (used if type is waba_template).
Registro Do Template Do WhatsApp Business Api Cloud Notice indicating this is only for templates created in WhatsApp Business API Cloud (used if type is waba_template).
Variáveis Do Messangi JSON object containing variables to use in the Messangi template (used if type is messangi).
Registro Do Template Do BSP Messangi Notice indicating this is only for templates created in BSP Messangi (used if type is messangi).
Registro Do Template Do BSP Interaxa Notice indicating this is only for templates created in BSP Interaxa (used if type is template).

Output

The node outputs JSON data representing the result of the message sending operation. This typically includes confirmation details such as message IDs, status, timestamps, or error information if the sending failed.

If the message involves media, the output confirms successful dispatch but does not contain binary data itself; media is referenced by URLs.

Dependencies

  • Requires an API key credential for authentication with the external WhatsApp marketing platform.
  • The node depends on the platform's API endpoints to send messages and manage templates.
  • Proper channel configuration (e.g., WhatsApp channel ID) must be set up in the external platform.
  • Network access to the media URLs provided is necessary for sending media messages.

Troubleshooting

  • SPAM Penalties: Users must heed the spam notice property; excessive unsolicited messages can lead to account penalties or suspension by WhatsApp.
  • Invalid Phone Number Format: Ensure phone numbers are in the correct international format without spaces or special characters.
  • Template Errors: When using templates, verify that the template IDs and variables match those registered in the respective BSP or WhatsApp Business API Cloud accounts.
  • Missing Media URLs: For media messages, ensure the URL is accessible and points to a valid media file.
  • Authentication Failures: Confirm that the API key credential is valid and has sufficient permissions.
  • Channel Misconfiguration: Verify that the channel ID corresponds to an active and correctly configured channel in the platform.

Common error messages usually relate to invalid parameters, unauthorized access, or template mismatches. Resolving these involves checking input values, credentials, and template registrations.

Links and References

Discussion